% Complete documentation on the extended LaTeX markup used for Python
% documentation is available in ``Documenting Python'', which is part
% of the standard documentation for Python.  It may be found online
% at:
%
%     http://www.python.org/doc/current/doc/doc.html

\documentclass{manual}

\title{testosterone}

\author{Chad W. L. Whitacre}

% Please at least include a long-lived email address;
% the rest is at your discretion.
\authoraddress{
	Zeta Design \&\ Development \\
	\url{http://www.zetadev.com/software/testosterone/} \\
	Email: \email{\ulink{chad@zetaweb.com}{mailto:chad@zetaweb.com}}
}

%\date{April 30, 1999}		% update before release!
\date\today
				% Use an explicit date so that reformatting
				% doesn't cause a new date to be used.  Setting
				% the date to \today can be used during draft
				% stages to make it easier to handle versions.

\release{0.4}			% release version; this is used to define the
				% \version macro

\makeindex			% tell \index to actually write the .idx file
\makemodindex			% If this contains a lot of module sections.


\begin{document}

\maketitle

\begin{abstract}

\noindent

\program{testosterone} is an interface for running tests written with the Python
standard library's \module{unittest} module. It delivers summary and detail
reports on \class{TestCase}s discovered in module-space, via both a command-line
and a \manpage{curses}{3} interface. The interactive mode is the default, but it
depends on the non-interactive mode. For debugging, static tracebacks and
interactive Python debugger (Pdb) sessions are available in both scripted and
interactive modes.

Usage:

\begin{verbatim}
$ testosterone [options] module
\end{verbatim}

\var{module} is the dotted name of the module or package you wish to test. See
the sections on scripted and interactive mode for more information.

This software is known to work with \ulink{FreeBSD}{http://www.FreeBSD.org/}
4.11, \ulink{PuTTY}{http://www.chiark.greenend.org.uk/~sgtatham/putty/} 0.58,
and \ulink{Python}{http://www.python.org/} 2.4.2. Additionally, the command-line
interface is known to work with Windows XP and Python 2.4.2.


\end{abstract}

\input{options}
\input{scripted}
\input{interactive}


\end{document}