head	1.3;
access;
symbols
	tcllib-1-13:1.3
	tcllib-1-12:1.3
	tklib-0-5:1.3
	tcllib-1-11-1:1.3
	tcllib-1-11:1.3;
locks; strict;
comment	@# @;


1.3
date	2008.05.16.06.09.39;	author andreas_kupries;	state Exp;
branches;
next	1.2;

1.2
date	2008.04.27.19.32.47;	author andreas_kupries;	state Exp;
branches;
next	1.1;

1.1
date	2008.04.26.07.28.40;	author andreas_kupries;	state Exp;
branches;
next	;


desc
@@


1.3
log
@
	* checker.tcl: Reworked the (sub)section handling, enabled the
	* doctools_lang_cmdref.man: documentation writer to label
	  (sub)sections with logical names and use these in references.
	  Automatic logical names are improved, taking the current section
	  into account, making for a better ambiguity check. References
	  are now better as well.  Backends are given unique physical
	  (sub)section ids. Added a new formatting command
	  'sectref-external' for references to (sub)sections outside of
	  the current document, to disable checking, and documented it.

	* docidx_plugin_apiref.man: Fixed the external section references
	* doctoc_plugin_apiref.man: in the manpages to prevent false warnings.
	* doctools_plugin_apiref.man:

	* mpformats/c.msg: Message catalogs extended with new warning
	* mpformats/de.msg: 'missingsect' for apparently dangling
	* mpformats/en.msg: (sub)section references.
	* mpformats/fr.msg:

	* mpformats/fmt.html: Updated the backends for the changes in the
	* mpformats/fmt.latex: frontend/backend API, and updated testsuite
	* mpformats/fmt.nroff: results.
	* mpformats/fmt.text:
	* mpformats/fmt.tmml:
	* mpformats/fmt.wiki:
	* mpformats/_common.tcl:
	* tests/latex/00:
	* tests/latex/01:
	* tests/latex/02:
	* tests/latex/03:
	* tests/latex/04:
	* tests/latex/05:
	* tests/latex/06:
	* tests/latex/07:
	* tests/latex/08:
	* tests/tmml/00:
	* tests/tmml/01:
	* tests/tmml/02:
	* tests/tmml/03:
	* tests/tmml/04:
	* tests/tmml/05:
	* tests/tmml/06:
	* tests/tmml/07:
	* tests/tmml/08:
	* tests/html/00:
	* tests/html/01:
	* tests/html/02:
	* tests/html/03:
	* tests/html/04:
	* tests/html/05:
	* tests/html/06:
	* tests/html/07:
	* tests/html/08:

	* mpformats/_nroff.tcl: Modified the nroff backend to convert
	* tests/nroff/03: (sub)section titles into uppercase in the
	  output. Updated testsuite results.
@
text
@
% Generated from file '.FILE.' by tcllib/doctools with format 'latex'
% Copyright (c) **Copyright**
% CVS: @@ID@@ ALL.a
\documentclass{article}
\begin{document}
\author{@@USR@@}
\title{.MODULE. / ALL -- ..THE\_MODULE.. : ..THE\_TITLE..}
\maketitle
\section{Synopsis}\label{synopsis}
\begin{flushleft}
package require {\bf AAA}
package require {\bf BBB VVV}
package require {\bf CCC ?VVV?}
\end{flushleft}
\begin{itemize}
\item[] CMDNAME ...
\item[] CMDNAME ...
\item[] CMDNAME ...
\end{itemize}
\section{Description}\label{section1}
\begin{itemize}
%
\item[] {\bf NAME}
%
 DESCRIPTION ::{\bf Command}::
%
\item[] {\bf NAME}
%
 DESCRIPTION ::::
%
\item[] {\bf NAME}
%
 DESCRIPTION ::{\bf Constant}::
\end{itemize}
\section{API}\label{section2}
\begin{itemize}
%
\item[] TERM
%
 DESCRIPTION ::{\it Emphasis}::
%
\item[] TERM
%
 DESCRIPTION ::"{\it File/Path}"::
\begin{itemize}
%
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
%
 DESCRIPTION {\bf NARGLE (\ref{subsection1})}
%
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
%
 DESCRIPTION ::{\bf Function}::
%
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
%
 DESCRIPTION ::{\bf Method}::
\end{itemize}
%
\item[] TERM
%
 DESCRIPTION
%
\item[] CMDNAME ...
%
 DESCRIPTION ::{\bf Namespace]}::
\begin{itemize}
%
\item[] \underline{NAME} TYPE
%
 DESCRIPTION ::\underline{Argument}::
%
\item[] \underline{NAME} TYPE
%
 DESCRIPTION ::{\bf Option}::
%
\item[] \underline{NAME} TYPE (MODE)
%
 DESCRIPTION ::?Optional?::
\begin{verbatim}
    THE ARGUMENT IS USED IN THIS
    AND/OR THAT MANNER
\end{verbatim}
\end{itemize}
%
\item[] CMDNAME ...
%
 DESCRIPTION ::{\bf Package}::
%
\item[] CMDNAME ...
%
 DESCRIPTION ::{\bf SystemCommand}::
\begin{itemize}
%
\item[] {\bf NAME}
%
 DESCRIPTION ::{\it Term}::
%
\item[] {\bf NAME}
%
 DESCRIPTION ::{\bf Type}::
%
\item[] {\bf NAME} ARGUMENT
%
 DESCRIPTION ::\underline{Uri}::
\end{itemize}
\end{itemize}
\subsection{NARGLE}\label{subsection1}
\begin{enumerate}
%
\item
%
 PARAGRAPH ::\underline{UriLabel} \footnote{Uri}::
%
\item
%
 PARAGRAPH ::{\bf Variable}::
%
\item
%
 PARAGRAPH ::{\bf Widget}::
\begin{itemize}
%
\item
%
 PARAGRAPH ::{\bf Class}::
%
\item
%
 PARAGRAPH
%
\item
%
 PARAGRAPH
\end{itemize}
\end{enumerate}
\section{See Also}\label{see-also}
ELSE, OTHER
\section{Keywords}\label{keywords}
KEYA, KEYZ
\section{Copyright}\label{copyright}
\begin{flushleft}
Copyright (c) **Copyright**\linebreak
\end{flushleft}
\end{document}
@


1.2
log
@
	* tests/man/08: All possible list types are in testcase 5 already.
	* tests/desc/08: Changed to demo all the commands in one file.
	* tests/html/08: This makes trying out styles for the HTML easier too
	* tests/latex/08: as everything can looked at in one file.
	* tests/list/08:
	* tests/nroff/08:
	* tests/null/08:
	* tests/text/08:
	* tests/tmml/08:
	* tests/wiki/08:
@
text
@d10 1
a10 1
\section{SYNOPSIS}
d21 1
a21 1
\section{DESCRIPTION}
d36 1
a36 1
\section{API}
d52 1
a52 1
 DESCRIPTION {\bf NARGLE}
d115 1
a115 1
\subsection{NARGLE}
d144 1
a144 1
\section{SEE ALSO}
d146 1
a146 1
\section{KEYWORDS}
d148 1
a148 1
\section{COPYRIGHT}
@


1.1
log
@
	* tests/man/08: Added test demonstrating all possible list types.
	* tests/desc/08:
	* tests/html/08:
	* tests/latex/08:
	* tests/list/08:
	* tests/nroff/08:
	* tests/null/08:
	* tests/text/08:
	* tests/tmml/08:
	* tests/wiki/08:
@
text
@d3 1
a3 1
% Copyright (c) .COPYRIGHT.
d8 1
a8 1
\title{.MODULE. / ALL --  : }
d11 5
d24 1
a24 1
\item[] \underline{NAME} TYPE
d26 1
a26 1
 DESCRIPTION
d28 1
a28 1
\item[] \underline{NAME} TYPE
d30 1
a30 1
 DESCRIPTION
d32 1
a32 1
\item[] \underline{NAME} TYPE (MODE)
d34 1
a34 1
 DESCRIPTION
d36 1
d39 1
a39 1
\item[] {\bf NAME}
d41 1
a41 1
 DESCRIPTION
d43 1
a43 1
\item[] {\bf NAME}
d45 2
a46 1
 DESCRIPTION
d48 3
a50 1
\item[] {\bf NAME}
d52 1
a52 3
 DESCRIPTION
\end{itemize}
\begin{itemize}
d54 3
a56 1
\item[] TERM
d58 1
a58 1
 DESCRIPTION
d60 3
a62 1
\item[] TERM
d64 2
a65 1
 DESCRIPTION
d73 2
a74 1
 DESCRIPTION
d76 1
a76 1
\item[] CMDNAME ...
d78 1
a78 1
 DESCRIPTION
d80 1
a80 1
\item[] CMDNAME ...
d82 1
a82 3
 DESCRIPTION
\end{itemize}
\begin{enumerate}
d84 1
a84 1
\item
d86 6
a91 1
 PARAGRAPH
d93 1
a93 1
\item
d95 1
a95 1
 PARAGRAPH
d97 1
a97 1
\item
d99 1
a99 2
 PARAGRAPH
\end{enumerate}
d102 1
a102 1
\item
d104 1
a104 1
 PARAGRAPH
d106 1
a106 1
\item
d108 1
a108 1
 PARAGRAPH
d110 1
a110 1
\item
d112 2
a113 1
 PARAGRAPH
d115 2
a116 1
\begin{itemize}
d118 1
a118 1
\item[] {\bf NAME}
d120 1
a120 1
 DESCRIPTION
d122 1
a122 1
\item[] {\bf NAME}
d124 1
a124 1
 DESCRIPTION
d126 1
a126 1
\item[] {\bf NAME} ARGUMENT
d128 1
a128 2
 DESCRIPTION
\end{itemize}
d131 1
a131 3
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
d133 1
a133 1
 DESCRIPTION
d135 1
a135 3
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
d137 1
a137 1
 DESCRIPTION
d139 1
a139 3
\item[] Command-Line Switch:	{\bf NAME}\\
Database Name:	{\bf DBNAME}\\
Database Class:	{\bf CLASS}\\
d141 1
a141 1
 DESCRIPTION
d143 5
d150 1
a150 1
Copyright (c) .COPYRIGHT.\linebreak
@

