summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-11-13 17:43:59 +0000
committerKarl Berry <karl@freefriends.org>2008-11-13 17:43:59 +0000
commit5add2428204d8d6ff589a9679141d288cf421152 (patch)
treefcc87e4b9c091a2c4d62ea40401b79db218f7e16 /Master/texmf-dist/doc/support
parent6ff046c12b6896c6b7ace34d964ace11ef5059ed (diff)
new support script latex2man
git-svn-id: svn://tug.org/texlive/trunk@11289 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r--Master/texmf-dist/doc/support/latex2man/CHANGES106
-rw-r--r--Master/texmf-dist/doc/support/latex2man/INSTALL49
-rw-r--r--Master/texmf-dist/doc/support/latex2man/Makefile216
-rw-r--r--Master/texmf-dist/doc/support/latex2man/README34
-rw-r--r--Master/texmf-dist/doc/support/latex2man/THIS-IS-VERSION-1.231
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.11100
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.html1160
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.pdfbin0 -> 206853 bytes
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.tex758
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.texi1005
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.trans67
-rw-r--r--Master/texmf-dist/doc/support/latex2man/latex2man.txt758
12 files changed, 5254 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/latex2man/CHANGES b/Master/texmf-dist/doc/support/latex2man/CHANGES
new file mode 100644
index 00000000000..d7a166dcfda
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/CHANGES
@@ -0,0 +1,106 @@
+
+ Change history of the latex2man package
+ =======================================
+
+$Id: CHANGES,v 1.60 2008/11/11 07:18:18 vollmer Exp $
+1.23 11 Nov 2008 - use /usr/bin/env to locate the perl interpreter
+ Thanks to "J.R. Mauro" <jrm8005-at-gmail.com>
+1.22 05 Dec 2007 - Fixed TROFF code generation if none of -H -T -M -L
+ is given.
+1.21 05 Jul 2007 - Fixed Makefile
+1.20 24 Apr 2007 - Added optional parameter to Table-environment
+ - Fixed generataion of tbl-tables.
+1.19 12 Sep 2005 - Thanks to Aleksey Nogin <nogin@cs.caltech.edu> for
+ his bugfix of the problem he found:
+ "I came across another issue in the latest
+ latex2man - if the source file has "\verb+.foo+" in
+ it, then the ".foo" will be copied to the man page
+ verbatim and if it happens to be placed on the
+ beginning of a line, then troff will consider it to
+ be a command and not display it properly."
+1.18 20 July 2005 - latex2man.sty: Removed option pdf.
+1.17 14 Oct 2004 - Fixed order of gerating &amp; for HTML
+ (Thanks to Aleksey Nogin <nogin@cs.caltech.edu>)
+1.16 06 Sep 2004 - Fixed handling of % in \verb+..+ and verbatim
+ environments
+ (Thanks to Aleksey Nogin <nogin@cs.caltech.edu>)
+ - added \subsubsection
+1.15 12 Dec 2001 - added extra stuff in the headline of man pages
+ (thanks to Andrew Anderson <aja@emulab.ee.mu.oz.au>)
+1.14 18 June 2001 - TROFF generation: fixed handling of leading . and '
+ - removed macro \Dot
+1.13 08 May 2001 - Added \begin{center} / \end{center}.
+ - Reimplemented font changing stuff in TROFF
+ generation (use now troff instead of -man commands).
+1.12.3 10 Apr 2001 - Fixed \oOptArg in man output.
+1.12.2 12 Mar 2001 - Fixed handling of conditional translation to LaTeX
+ (if in a IF .. ELSE .. END-IF, the condition
+ evaluates to true, the ELSE and END-IF are written
+ to the result file, but not the IF...
+ Now all %@% directives are written.)
+1.12.1 13 Sep 2000 - In \setDate and \setVersion a ~ is replaced by the
+ output specific blank.
+1.12 28 Aug 2000 - Fixed error in htmlVerb (thanks to
+ Glunz Wolfgang <Wolfgang.Glunz@icn.siemens.de>)
+ - Fixed error in conditional text handling:
+ (%@%ELSE%@% was not handled correct).
+1.11 25 Aug 2000 - Fixed error in conditional text handling:
+ (MAN was not enabled by default, when calling
+ with -M).
+ - Added eror message, if arguments of \begin{Name},
+ \section, and \subsection are not contained on a
+ single line.
+1.10.1 21 Aug 2000 - Better handling of \Tilde.
+1.10 13 Jun 2000 - added \Begin{Description}[label] (based on an idea of
+ Andi Winter <winter@cocolab.de>)
+ - Thanks to Andi Winter <winter@cocolab.de>:
+ - fixed: removed wrong line break in date for
+ TROFF output
+ - fixed wrong line breaks in some TROFF macros
+ - fixed wrong output of optional arguments in TROFF
+ - allow spaces between `\item' and following `['
+1.9.1 20 Mar 2000 - added \OptoArg \oOptoArg Option with optional
+ argument (Thanks to Andi Winter <winter@cocolab.de>)
+1.9 13 Mar 2000 - latex2man.sty: Added option pdf.
+ latex2man: define names HTML TEXI MAN LATEX
+ automatically.
+1.8 11 Feb 2000 - Added verbatim environment (many thanks to
+ "Olaf Maibaum" <Maibaum@Informatik.Uni-Oldenburg.DE>
+ who provided me the troff generation code)
+ - Added better handling of german Umlaut
+ - Fixed minor HTML tag mismatch.
+1.7.1 17 Nov 1999 - Fixed END_IF handling of -L option.
+1.7 25 July 1999 - Allow german Umlaute to be written as \"a, etc.
+1.6.4 30 May 1999 - Added fix of Frank.Schilder@Mathematik.TU-Ilmenau.DE
+ line 418: from
+ if ($manRS == 0 && $list_nest > 0) {
+ to
+ if ($manRS == 0 && $list_nest > 1) {
+ line 471: from
+
+ # manParagraph;
+ to
+ manParagraph;
+1.6.3 25 Mar 1999 - Added \, Math stuff is matched now after macro
+ arguments
+1.6.2 21 Nov 1998 - Added \LBr / \RBr, added \setlength{}{} and \itemsep
+ \Dollar $\ge$, $\le$, $\leftarrow$, $\Leftarrow$,
+ $\rightarrow$, $\Rightarrow$.
+1.6.1 14 Sep 1998 - Added $<=$, $>=$, $=$ $<>$.
+1.6 08 Sep 1998 - Added \SP macro.
+ - Hyphenation \- is translated for TexInfo into @-.
+ - Runs now under older Versions of Perl (e.g. 5.03).
+1.5 22 Aug 1998 - Support for the fanyhdr package, added latex2man.cfg
+ - Now \% and \- work.
+1.4 23 July 1998 - Fixed typos.
+ - Fixed generated HTML
+ The following is wrong: <a ..> <h..>....</h..></a>
+ Correct is: <h..><a ..>...</a></h..>
+1.3 03 June 1998 - Add conditional text feature
+1.2 18 Jan 1998 - Enumerate/itemize/description environments may
+ be nested now.
+ - Output specific line break macros.
+1.1 14 Jan 1998 - Fixed bug in HTML generation (no blanks emited
+ after \hline)
+1.0 11 Jan 1998 - Initial version
+
diff --git a/Master/texmf-dist/doc/support/latex2man/INSTALL b/Master/texmf-dist/doc/support/latex2man/INSTALL
new file mode 100644
index 00000000000..f87b88d66f7
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/INSTALL
@@ -0,0 +1,49 @@
+How to install latex2man:
+
+Requirements:
+ - Latex2man requires Perl version >= 5.0004_03.
+ - LaTeX2e
+ - If you want to install the system with the distributed Makefile, you need
+ GNU-make. If you don't have it, you should execute the steps shown
+ in the Makefile manually.
+
+Installation:
+ - Edit the Makefile and set
+ BIN_DIR = $(HOME)/bin
+ MAN_DIR = $(HOME)/man
+ HTML_DIR = $(HOME)/public_html
+ INFO_DIR = $(HOME)/info
+ TEX_DIR = $(HOME)/tex/inputs
+ CFG_DIR = $(HOME)/tex/inputs
+ to your needs
+ - If you do not have pdflatex installed, remove in the "all" goal,
+ the sub goal "$(BASE).pdf".
+ - Edit latex2man and set in the first line
+ #!/usr/local/bin/perl
+ to the correct path
+ - make install
+
+That's it.
+
+The following files should be part of this package:
+ latex2man/latex2man
+ latex2man/latex2man.tex
+ latex2man/latex2man.cfg
+ latex2man/latex2man.sty
+ latex2man/latex2man.trans
+ latex2man/latex2man.1
+ latex2man/latex2man.txt
+ latex2man/latex2man.html
+ latex2man/latex2man.texi
+ latex2man/latex2man.info
+ latex2man/latex2man.pdf
+ latex2man/Makefile
+ latex2man/README
+ latex2man/INSTALL
+ latex2man/CHANGES
+ latex2man/THIS-IS-VERSION-x.y
+
+Juergen
+
+$Id: INSTALL,v 1.7 2000/03/13 10:25:48 vollmer Entwurf $
+
diff --git a/Master/texmf-dist/doc/support/latex2man/Makefile b/Master/texmf-dist/doc/support/latex2man/Makefile
new file mode 100644
index 00000000000..f40f285f32b
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/Makefile
@@ -0,0 +1,216 @@
+# Project: Documentation Tools
+# Descr: Latex --> MAN-page (groff -man), Makefile
+# Author: Dr. Jürgen Vollmer, Juergen.Vollmer@informatik-vollmer.de
+# $Id: Makefile,v 1.106 2008/11/11 07:17:29 vollmer Exp $
+
+BASE = latex2man
+
+#-------- user configuration section
+BIN_DIR = $(HOME)/bin
+MAN_DIR = $(HOME)/man
+HTML_DIR = $(HOME)/public_html
+INFO_DIR = $(HOME)/info
+TEX_DIR = $(HOME)/tex/inputs
+CFG_DIR = $(HOME)/tex/inputs
+#-------- end of user configuration section
+
+DATE = `date +%Y-%m-%d`
+DATE2 = `date +%Y/%m/%d`
+TAR_BAK = $(BASE)-$(DATE)-backup.tar.gz
+TAR_SRC = $(BASE)-$(DATE)-source.tar.gz
+TAR_DIST = $(BASE)-$(VERSION).tar.gz
+EX = --exclude "*.o" --exclude core --exclude "*.tar.gz" --exclude "*~" \
+ --exclude "*.a" --exclude "*.php"
+EXrcs = $(EX) --exclude "*/RCS/*" --exclude "*/RCS"
+
+VERSION = 1.23
+V_DATE = 2008/11/11
+latex2man = ./latex2man
+
+D = $
+
+HOMEPAGE = $(HOME)/Privat/informatik-vollmer/software
+
+.PHONY: all clean realclean diff backup src-tar
+#.SUFFIXES: .tex .html .ps .info .texi .txt
+
+all: $(BASE).1 $(BASE).html $(BASE).texi $(BASE).info $(BASE).txt \
+ $(BASE).pdf
+ $(MAKE) clean
+
+%.ps: %.tex
+ latex $*.tex
+ latex $*.tex
+ dvips -o $*.ps $*.dvi
+
+%.pdf: %.tex
+ rm -f /tmp/$*.tex /tmp/$*.pdf /tmp/$*.aux /tmp/$*.toc /tmp/$*.log /tmp/$*.sty
+ (cp $*.tex $*.sty /tmp && \
+ cd /tmp && \
+ pdflatex $*.tex && \
+ pdflatex $*.tex);
+ mv /tmp/$*.pdf .
+
+%.info: %.texi
+ makeinfo $*.texi
+
+%.txt: %.1
+ groff -t -man -Tlatin1 $*.1 | \
+ sed -e 's/.//g' \
+ -e 's/7|//g' \
+ -e 's/[6-9]//g' \
+ -e 's///g' \
+ -e 's/­$$/- /' > $*.txt
+
+%.1: %.tex
+ $(latex2man) -M $*.tex $*.1
+
+%.html: %.tex
+ $(latex2man) -H $*.tex $*.html
+
+%.texi: %.tex
+ $(latex2man) -T $*.tex $*.texi
+
+CHANGES.html: CHANGES
+ sed -e's/&/\&amp;/g' -e's/>/\&gt;/g' -e's/</\&lt;/g' \
+ < CHANGES > CHANGES.html
+
+$(BASE).php: $(BASE).php.src Makefile CHANGES.html
+ sed < $(BASE).php.src \
+ -e "s|@VERSION@|$(VERSION)|g" \
+ -e "s|@DATE@|$(V_DATE)|g" \
+ -e "/@CHANGELOG@/r CHANGES.html" \
+ -e "/^@.*@$$/d" \
+ -e "s|$(BASE).src|$(BASE)|g" \
+ -e "s|$(D)\(Id: $(BASE),v .*\) $(D)|\1|g" |\
+ sed -e "/$(D)Id: CHANGES,v/d" \
+ > $(BASE).php
+ rm -f CHANGES.html
+
+latex2man-html.php: latex2man.html Makefile
+ @ (echo '<?php'; \
+ echo ' $$prefix = "..";'; \
+ echo ' $$logo = "abakus.jpg";'; \
+ echo ' $$logo_text = "russischer Abakus";'; \
+ echo ' $$language = "en";'; \
+ echo ' include "$$prefix/scripts/header.inc"'; \
+ echo '?>'; \
+ sed < latex2man.html \
+ -e "1,/<body*/d" \
+ -e "/<h4 align=center>/d" \
+ -e "s/ align=center//g" \
+ -e "/<\/body>/d" \
+ -e "/<\/html>/d"; \
+ echo '<?php include "$$prefix/scripts/footer.inc"?>'; \
+ ) > latex2man-html.php
+
+latex2man-text.php: latex2man.txt Makefile
+ @ (echo '<?php'; \
+ echo ' $$prefix = "..";'; \
+ echo ' $$logo = "abakus.jpg";'; \
+ echo ' $$logo_text = "russischer Abakus";'; \
+ echo ' $$langauge = "en";'; \
+ echo ' include "$$prefix/scripts/header.inc"'; \
+ echo '?>'; \
+ echo '<h1>LaTeX2MAN<br><small>plain text / UNIX-man</small></h1>'; \
+ echo '<pre'; \
+ echo ' style="border-style:ridge;border-width:2px;">'; \
+ cat latex2man.txt | \
+ sed -e's/&/\&amp;/g' -e's/>/\&gt;/g' -e's/</\&lt;/g' ; \
+ echo '</pre>'; \
+ echo '<?php include "$$prefix/scripts/footer.inc"?>'; \
+ ) > latex2man-text.php
+
+homepage: latex2man.pdf latex2man.txt latex2man.php latex2man-html.php \
+ latex2man-text.php latex2man.info
+ cp -fp $(TAR_DIST) latex2man.pdf latex2man*.php latex2man.info $(HOMEPAGE)
+ cp -fp CHANGES $(HOMEPAGE)/latex2man-CHANGES
+ rm -f *.php
+
+install: realclean all
+ @echo
+ @if [ ! -f $(INFO_DIR)/dir ]; \
+ then \
+ (echo ; \
+ echo ""; \
+ echo "File: dir Node: Top This is the top of the INFO tree"; \
+ echo "* Menu: " ) \
+ > $(INFO_DIR)/dir ; \
+ fi
+ cp -f $(BASE) $(BIN_DIR)
+ cp -f $(BASE).sty $(TEX_DIR)
+ cp -f $(BASE).cfg $(CFG_DIR)
+ cp -f $(BASE).1 $(MAN_DIR)/man1
+ cp -f $(BASE).html $(HTML_DIR)
+ cp -f $(BASE).info $(INFO_DIR)
+ install-info $(BASE).info $(INFO_DIR)/dir
+ $(MAKE) clean
+
+uninstall:
+ rm -f $(BIN_DIR)/$(BASE)
+ rm -f $(TEX_DIR)/$(BASE).sty
+ rm -f $(CFG_DIR)/$(BASE).cfg
+ rm -f $(MAN_DIR)/man1/$(BASE).1
+ rm -f $(HTML_DIR)/$(BASE).html
+ rm -f $(INFO_DIR)/$(BASE).info
+ - install-info --quiet --remove $(BASE).info $(INFO_DIR)/dir
+
+src-tar:
+ $(MAKE) realclean all
+ @cd ..; tar $(EXrcs) -czvf $(BASE)/$(TAR_SRC) $(BASE)
+
+dist:
+ rm -f THIS-IS-VERSION-*
+ @- co -l latex2man latex2man.tex latex2man.sty README
+ @rm -f .xxx; cp latex2man .xxx
+ @sed < .xxx -e 's/$VERSION = .*/$VERSION = "$(VERSION)";/' > latex2man
+ @rm -f .xxx; cp latex2man.tex .xxx
+ @sed < .xxx -e 's/^\\setVersion{[0-9]*\(\.[0-9]*\)*}/\\setVersion{$(VERSION)}/' \
+ -e 's|^\\setDate{[0-9]*/[0-9]*/[0-9]*}|\\setDate{$(V_DATE)}|' \
+ > latex2man.tex
+ @rm -f .xxx; cp latex2man.sty .xxx
+ @sed < .xxx -e 's/^%% VERSION:.*/%% VERSION: $(VERSION)/' \
+ -e "s|^\(\\\\ProvidesPackage{latex2man}\).*|\1[$(DATE2) v$(VERSION)]|"\
+ > latex2man.sty
+ rm -f .xxx; cp README .xxx
+ @sed < .xxx -e 's/^VERSION:.*/VERSION: $(VERSION)/' > README
+ @rm -f .xxx
+ ci -u -m"Distribution" latex2man latex2man.tex latex2man.sty README
+ - $(MAKE) realclean all
+ @echo "VERSION $(VERSION) DATE=$(V_DATE)" > THIS-IS-VERSION-$(VERSION)
+ @cd ..; tar $(EXrcs) -czvf $(BASE)/$(TAR_DIST) \
+ $(BASE)/latex2man \
+ $(BASE)/latex2man.tex \
+ $(BASE)/latex2man.cfg \
+ $(BASE)/latex2man.sty \
+ $(BASE)/latex2man.trans \
+ $(BASE)/latex2man.1 \
+ $(BASE)/latex2man.txt \
+ $(BASE)/latex2man.html \
+ $(BASE)/latex2man.texi \
+ $(BASE)/latex2man.info \
+ $(BASE)/latex2man.pdf \
+ $(BASE)/Makefile \
+ $(BASE)/README \
+ $(BASE)/INSTALL \
+ $(BASE)/CHANGES \
+ $(BASE)/THIS-IS-VERSION-$(VERSION)
+
+backup:
+ @ cd ..; tar $(EX) -czvf /tmp/$(TAR_BAK) $(BASE)
+ @ copy-to-backup -al -d $(BASE) /tmp/$(TAR_BAK)
+ @ rm /tmp/$(TAR_BAK)
+
+clean:
+ rm -f *~ *.aux *.log *.dvi .xxx *.out
+
+realclean: clean
+ rm -f *.ps *.1 *.html *.texi *.info *.txt *.pdf
+
+diff:
+ @echo
+ @echo "Check for differences with RCS"
+ @echo
+ for i in RCS/* ; do [ -f `basename $$i ,v` ] && rcsdiff -q $$i; done
+ @echo
+
diff --git a/Master/texmf-dist/doc/support/latex2man/README b/Master/texmf-dist/doc/support/latex2man/README
new file mode 100644
index 00000000000..bd7e9042288
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/README
@@ -0,0 +1,34 @@
+
+ latex2man
+ =========
+
+Latex2man is a tool to translate UNIX manual pages written with LaTeX into
+the troff format understood by the UNIX man(1)-command.
+Alternatively HTML, TexInfo, or LaTeX code can be produced too.
+Output of parts of the text may be supressed using the conditional text
+feature (for this, LaTeX generation may be used).
+
+There is LaTeX package (latex2man.sty) used for writing the Man-page
+and a PERL script (latex2man) doing the actual translation.
+
+Requirements:
+ - Latex2man requires Perl version >= 5.0004_03.
+ - LaTeX2e
+
+VERSION: 1.23
+
+Author and Copyright (c) 1998:
+ Dr. Jürgen Vollmer
+ Viktoriastraße 15
+ D-76133 Karlsruhe
+ Email: <Juergen.Vollmer@informatik-vollmer.de>
+
+License:
+ This program can be redistributed and/or modified under the terms
+ of the LaTeX Project Public License Distributed from CTAN
+ archives in directory macros/latex/base/lppl.txt; either
+ version 1 of the License, or any later version.
+
+If you find this software useful, please send me a postcard.
+
+$Id: README,v 1.62 2008/11/11 07:21:18 vollmer Exp $
diff --git a/Master/texmf-dist/doc/support/latex2man/THIS-IS-VERSION-1.23 b/Master/texmf-dist/doc/support/latex2man/THIS-IS-VERSION-1.23
new file mode 100644
index 00000000000..b6307fa0d6e
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/THIS-IS-VERSION-1.23
@@ -0,0 +1 @@
+VERSION 1.23 DATE=2008/11/11
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.1 b/Master/texmf-dist/doc/support/latex2man/latex2man.1
new file mode 100644
index 00000000000..587dbf434b8
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.1
@@ -0,0 +1,1100 @@
+'\" t
+.\" Manual page created with latex2man on Di 11. Nov 08:21:27 CET 2008
+.\" NOTE: This file is generated, DO NOT EDIT.
+.de Vb
+.ft CW
+.nf
+..
+.de Ve
+.ft R
+
+.fi
+..
+.TH "LATEX2MAN" "1" "2008/11/11" "Documentation Tools " "Documentation Tools "
+.SH NAME
+
+.PP
+Latex2man
+is a tool to translate UNIX manual pages written with
+LaTeXinto a format understood by the UNIX \fIman\fP(1)\-command.
+Alternatively HTML, TexInfo, or LaTeX code can be produced too.
+Output of parts of the text may be suppressed using the conditional text
+feature (for this, LaTeX generation may be used).
+.PP
+.SH SYNOPSIS
+
+.PP
+latex2man
+[\fB\-t\fP\fItransfile\fP]
+[\fB\-HMTL\fP]
+[\fB\-h\fP]
+[\fB\-V\fP]
+[\fB\-C\fP\fIname\fP]
+[\fB\-a\fP\fIchar\fP]
+\fIinfile\fP
+\fIoutfile\fP
+.PP
+.SH DESCRIPTION
+
+Latex2man
+reads the file \fIinfile\fP
+and writes \fIoutfile\fP\&.
+The
+input must be a LaTeX document using the latex2man
+LaTeXpackage.
+Latex2man
+translates that document into the \fItroff\fP(1)
+format using
+the \fB\-man\fP
+macro package.
+.PP
+Using the \fB\-H\fP
+option, HTML code can be produced, instead of
+\fItroff\fP(1)\&.
+.PP
+Using the \fB\-T\fP
+option, TexInfo code can be produced, instead of
+\fItroff\fP(1)\&.
+.PP
+Using the \fB\-M\fP
+option, \fItroff\fP(1)
+input is produced.
+.PP
+Using the \fB\-L\fP
+option, LaTeX ouput can be produced, instead of
+\fItroff\fP(1)\&.
+.PP
+.SH OPTIONS
+
+.TP
+\fB\-t\fP\fItransfile\fP
+ Translation for user defined LaTeX macros.
+.TP
+\fB\-M\fP
+ Produce output suitable for the \fIman\fP(1)
+command (default).
+.TP
+\fB\-H\fP
+ Instead of producing output suitable for the \fIman\fP(1)
+command, HTML code is produced (despite the name of the command).
+.TP
+\fB\-T\fP
+ Instead of producing output suitable for the \fIman\fP(1)
+command, TexInfo code is produced (despite the name of the command). The
+generated \&.texi\-file
+may be processed with \fImakeinfo\fP(1)
+(to produce an \&.info\-file)
+which in turn may be installed using
+\fIinstall\-info\fP(1)\&.
+The Info tags @dircategory and
+@direntry are provided.
+.TP
+\fB\-L\fP
+ The LaTeX source is written to the \fIoutfile\fP\&.
+This is
+useful in conjunction with the \fB\-C\fP\fIname\fP
+option.
+.TP
+\fB\-C\fP\fIname\fP
+ Output the conditional text for \fIname\fP\&.
+If more
+than one name should be given use quotes: \fB\-C\fP\fI\&'name1 name2 ...\&'\fP
+.br
+The following names are defined automatically:
+.RS
+.TP
+.B *
+\fB\-H\fP defines HTML
+.TP
+.B *
+\fB\-T\fP defines TEXI
+.TP
+.B *
+\fB\-M\fP defines MAN
+.TP
+.B *
+\fB\-L\fP defines LATEX
+.RE
+.RS
+.PP
+.RE
+.TP
+\fB\-a\fP\fIchar\fP
+ Is used only in conjunction with \-T.
+.br
+Background:
+.br
+TexInfo ignores all blanks before the first word on a new line. In order
+to produce some additional space before that word (using \\SP) some
+character has to be printed before the additional space. By default this
+is a \&. (dot). The \fIchar\fP
+specifies an alternative for that first
+character. Giving a blank to
+\fB\-a\fP
+supresses the indentation of a line.
+.br
+Note: only for the first \\SP of a series that \fIchar\fP
+is printed.
+.TP
+\fB\-h\fP
+ Show a help text.
+.TP
+\fB\-V\fP
+ Show version information.
+.PP
+.SH FILES
+
+.PP
+.TP
+latex2man.tex
+ The LaTeX file containing this Man\-page.
+.TP
+latex2man.sty
+ The LaTeX package defining the environments and
+commands.
+.TP
+latex2man.cfg
+ The configuration file for Latex2man
+LaTeX\-package.
+.TP
+latex2man.trans
+ File containing example translations of user
+defined LaTeX macros.
+.TP
+fancyheadings.sty
+ A LaTeX package used to typeset head\- and
+foot lines.
+.TP
+fancyhdr.sty
+ A LaTeX package used to typeset head\- and foot
+lines.
+.TP
+rcsinfo.sty
+ A LaTeX package used to extract and use RCS version
+control information in LaTeX documents.
+.PP
+.SH SEE ALSO
+
+.PP
+LaTeX,TexInfo, \fItroff\fP(1),
+\fIgroff\fP(1),
+\fImakeinfo\fP(1)\&.
+.PP
+.SH LaTeX COMMANDS
+
+.PP
+The LaTeX package latex2man
+is used to write the Man\-pages with
+LaTeX\&.Since we translate into other text formats, not all LaTeX stuff can
+be translated.
+.PP
+.SS PACKAGE OPTIONS
+The latex2man
+package accepts the following options:
+.PP
+.TP
+fancy
+use the LaTeX package fancyheadings\&.
+.TP
+fancyhdr
+use the LaTeX package fancyhdr\&.
+.TP
+nofancy
+neither the LaTeX package fancyheadings
+nor
+fancyhdr
+are used.
+.PP
+The default option may be specified in the file latex2man.cfg\&.
+.PP
+.SS PACKAGE SPECIFIC ENVIRONMENTS
+.PP
+The following environments are provided by the package:
+.TP
+\\begin{Name}{chapter}{name}{author}{info}{title}
+The
+Name
+environment takes five arguments: 1. the Man\-page chapter,
+2. the name of the Man\-page, 3. the author, 4. some short information
+about the tool printed in the footline of the Man\-page, and 5. a text
+which is used as title, for HTML and LaTeX (it\&'s ignored for output of
+the Man\-page or TeXinfo. The Name
+environment must be the first
+environment in the document. Processing starts with this environment. Any
+text before this is ignored (exception: the setVersion and
+setDate commands). (Note: all arguments of \\begin{Name} must
+be written on one line).
+.TP
+\\begin{Table}[width]{columns}
+The Table
+environment takes two arguments: the first optional one specifies
+a width of the last column, the second one gives the number of columns.
+For example:
+.PP
+\\begin{Table}[2cm]{3}
+.br
+Here & am & I \\\\\\hline
+.br
+A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\\\
+.br
+B 1 & B 2 & B 3 \\\\
+.br
+\\end{Table}
+.PP
+will be typeset as:
+.PP
+.TS
+tab(&);
+l l lw(2cm).
+T{
+Here
+T}&T{
+am
+T}&T{
+I
+T}
+_
+T{
+A 1
+T}&T{
+A 2
+T}&T{
+A 3 1 2 3 4 5 A 3 1 2 3 4 5
+T}
+T{
+B 1
+T}&T{
+B 2
+T}&T{
+B 3
+T}
+.TE
+.PP
+If no optional \fIwidth\fP
+argument is given, all entries are
+typeset left justified.
+The \fIwidth\fP
+is a length measured absolutly in \fIcm\fP\&.
+Processing with LaTeX a p{width} column is typeset
+as last column. The translation to \fItroff\fP(1)
+commands
+results in a lw(width)
+column specification. Translating
+to HTML and TexInfo ignores the \fIwidth\fP
+parameter.
+.PP
+\\hline may be used.
+.PP
+If the Man\-page is formatted with \fItroff\fP(1)
+and tables are used, the
+\fItbl\fP(1)
+preprocessor should be called, usually by giving
+a \fB\-t\fP
+to the call of \fItroff\fP(1)\&.
+When viewing the generated
+manula page using \fIman\fP(1),
+\fItbl\fP(1)
+is called automatically.
+.TP
+\\begin{Description}
+is the same as \\begin{description}
+.TP
+\\begin{Description}[label]
+is similar to
+\\begin{description}, but the item labels have at minimum the size
+of the (optional) word \fIlabel\fP\&.
+The difference is visible only
+in the DVI and PDF\-output, not in the troff, TexInfo or HTML output.
+.RS
+.TP
+a
+|a \\begin{description}
+.TP
+ab
+|ab
+.TP
+abc
+|abc
+.RE
+.RS
+.PP
+.RS
+.RE
+.TP
+a
+|a \\begin{Description}
+.TP
+ab
+|ab
+.TP
+abc
+|abc
+.RE
+.RS
+.PP
+.RS
+.RE
+.TP
+a
+|a \\begin{Description}[aa]
+.TP
+ab
+|ab
+.TP
+abc
+|abc
+.RE
+.RS
+.PP
+.RE
+.PP
+.SS ACCEPTED LaTeX ENVIRONMENTS
+.PP
+The following environments are accepted:
+.RE
+.TP
+.B *
+description
+.TP
+.B *
+enumerate
+.TP
+.B *
+itemize
+.TP
+.B *
+verbatim
+.TP
+.B *
+center
+.PP
+They may be nested:
+.TP
+.B *
+Itemize and nested center:
+.ce 100
+A centered line.
+.br
+Another centered line.
+.ce 0
+
+.TP
+.B *
+Another item an nested enumerate
+.RS
+.TP
+1.
+a
+.TP
+2.
+b
+.RE
+.RS
+.PP
+.RE
+.PP
+.SS PACKAGE SPECIFIC MACROS
+.PP
+The following commands are provided:
+.RE
+.TP
+\\Opt{option}
+Option: \\Opt{\-o} will be typeset as \fB\-o\fP\&.
+.TP
+\\Arg{argument}
+Argument: \\Arg{filename} will be typeset as
+\fIfilename\fP\&.
+.TP
+\\OptArg{option}{argument}
+Option with Argument:
+.br
+\\OptArg{\-o}{filename} will be typeset as \fB\-o\fP\fIfilename\fP\&.
+.TP
+\\OptoArg{option}{argument}
+Option with optional Argument:
+.br
+\\OptoArg{\-o}{filename} will be
+typeset as \fB\-o\fP[\fIfilename\fP]\&.
+.TP
+\\oOpt{option}
+Optional option, e.g. \\oOpt{\-o} will be
+typeset as [\fB\-o\fP]\&.
+.TP
+\\oArg{argument}
+Optional argument, e.g. \\oArg{filename}
+will be typeset as [\fIfilename\fP]\&.
+.TP
+\\oOptArg{option}{argument}
+Optional option with argument, e.g.
+.br
+\\oOptArg{\-o}{filename} will be typeset as [\fB\-o\fP\fIfilename\fP]\&.
+.TP
+\\oOptoArg{option}{argument}
+Optional option with optional
+argument, e.g.
+\\oOptoArg{\-o}{filename} will be typeset as [\fB\-o\fP[\fIfilename\fP]]\&.
+.TP
+\\File{filename}
+used to typeset filenames, e.g.
+\\File{filename} will be typeset as filename\&.
+.TP
+\\Prog{prog}
+used to typeset program names, e.g.
+\\Prog{latex2man} will be typeset as latex2man\&.
+.TP
+\\Cmd{command}{chapter}
+used to typeset references to other
+commands, e.g. \\Cmd{latex2man}{1} will be typeset as
+\fIlatex2man\fP(1)\&.
+.TP
+\\Bar
+is typeset as |\&.
+.TP
+\\Bs
+(BackSlash) is typeset as \\\&.
+.TP
+\\Tilde
+is typeset as a ~\&.
+.TP
+\\Dots
+is typeset as \&...
+
+.TP
+\\Bullet
+us typeset as *\&.
+.TP
+\\setVersion{\&.\&.}
+set \&.. as version information.
+.TP
+\\setVersionWord{\&.\&.}
+set \&.. for the word \fIVersion:\fP
+in
+the footline. The default is \\setVersionWord{Version:}\&.
+.TP
+\\Version
+returns the version information.
+.TP
+\\setDate{\&.\&.}
+sets \&.. as date information.
+.TP
+\\Date
+returns the date information.
+.TP
+\\Email{\&.\&.}
+use to mark an Email address:
+.br
+\\Email{Juergen.Vollmer@informatik\-vollmer.de} is typeset as:
+.br
+\fBJuergen.Vollmer@informatik\-vollmer.de\fP\&.
+.TP
+\\URL{\&.\&.}
+use to mark an URL:
+\\URL{http://www.foo.de/\\Tilde vollmer} is typeset as
+\fBhttp://www.foo.de/~vollmer\fP\&.
+.TP
+\\LatexManEnd
+the input file is read and processed until reading
+end\-of\-file or \\LatexManEnd (at the beginning of a line).
+LaTeXignores this command.
+.TP
+\\Lbr, \\Rbr
+is typeset as [ and ] (these variants are
+needed only somtimes like in item[FooBar\\LBr xx \\Lbr]\&. Usually
+[ ] will work.
+.TP
+\\LBr, \\RBr
+is typeset as { and } (these variants are
+needed when using { or } as arguments to macros.
+.TP
+\\Circum
+is typeset as ^\&.
+.TP
+\\Percent
+is typeset as %\&.
+.TP
+\\TEXbr
+If processed with LaTeX causes a linebreak (i.e. is
+equivalent to \\\\).In the output of latex2man
+this macro is
+ignored.
+.TP
+\\TEXIbr
+If TexInfo output is generated, causes a linebreak (i.e. is
+equivalent to \\\\),otherwise ignored.
+.TP
+\\MANbr
+If Man\-Page output is generated, causes a linebreak (i.e. is
+equivalent to \\\\),otherwise ignored.
+.TP
+\\HTMLbr
+If HTML output is generated, causes a linebreak (i.e. is
+equivalent to \\\\),otherwise ignored.
+.TP
+\\medskip
+An empty line.
+.TP
+\\SP
+Produces some extra space, works also at the beginning of lines.
+The code of the second line looks like:
+\\SP abc \\SP\\SP xx\\\\:
+.br
+abc \fB \fP\fB \fP\fB \fPxx
+.br
+\fB \fPabc \fB \fP\fB \fPxx
+.br
+\fB \fP\fB \fPabc \fB \fPxx
+.PP
+Note: Due to some ``problems\&'' with TexInfo, the lines starting with
+\\SP
+have a leading \&. (dot) in the TexInfo output,
+see \fB\-a\fP\fIchar\fP\&.
+.PP
+.SS ACCEPTED MACROS FROM THE RCSINFO PACKAGE
+.PP
+.TP
+\\rcsInfo $Id ...$
+if the LaTeX package rcsinfo
+is used,
+this command is used to extract the date of the Man\-page.
+.TP
+\\rcsInfoLongDate
+if the LaTeX package rcsinfo
+is used, this
+command is used to typeset the date coded in the $Id ..$ string.
+.PP
+.SS ACCEPTED LaTeX MACROS
+.PP
+The following standard LaTeX commands are accepted:
+.TP
+\\section{\&.\&.}
+The section
+macro takes one argument: the
+name of the Man\-page section. Each Man\-page consists of several sections.
+Usually there are the following sections in a Man\-page: \fIName\fP
+(special handling as environment, c.f. above), \fISynopsis\fP,
+\fIDescription\fP,
+\fIOptions\fP,
+\fIFiles\fP,
+\fISee Also\fP,
+\fIDiagnostics\fP,
+\fIReturn Values\fP,
+\fIBugs\fP,
+\fIAuthor\fP,
+\fIversion\fP,
+etc.
+.PP
+\fISynopsis\fP
+must be the first section after the Name
+environment.
+.PP
+Note: Do not use LaTeX\-macrosin section names.
+.TP
+\\subsection{\&.\&.}
+works as well as
+.TP
+\\subsubsection{\&.\&.}
+those.
+.TP
+\\emph{\&.\&.}
+\\emph{example} is typeset as \fIexample\fP\&.
+.TP
+\\textbf{\&.\&.}
+\\textbf{example} is typeset as \fBexample\fP\&.
+.TP
+\\texttt{\&.\&.}
+\\textt{example} is typeset as example\&.
+.TP
+\\underline{\&.\&.}
+\\underline{example} is typeset as
+.ul
+example of underline
+\&.
+.TP
+\\date{\&.\&.}
+uses \&.. as date.
+.TP
+\\verb+..+
+but only + is allowed as delimiter.
+.TP
+$<$ is typeset as <\&.
+.TP
+$>$ is typeset as >\&.
+.TP
+$<=$ is typeset as <=\&.
+.TP
+$>=$ is typeset as >=\&.
+.TP
+$=$ is typeset as =\&.
+.TP
+$<>$ is typeset as <>\&.
+.TP
+$\\ge$
+is typeset as $>=$.
+.TP
+$\\le$
+is typeset as $<=$.
+.TP
+$\\leftarrow$
+is typeset as $<--$.
+.TP
+$\\Leftarrow$
+is typeset as $<==$.
+.TP
+$\\rightarrow$
+is typeset as $-->$.
+.TP
+$\\Rightarrow$
+is typeset as $==>$.
+.TP
+\\{ is typeset as {\&.
+.TP
+\\} is typeset as }\&.
+.TP
+\\$ is typeset as $\&.
+.TP
+\\$ is typeset as $,should be used inside macro
+arguments.
+.TP
+\\_ is typeset as _\&.
+.TP
+\\& is typeset as &\&.
+.TP
+\\# is typeset as #\&.
+.TP
+\\% is typeset as %\&.
+.TP
+\\,
+is typeset as smaller blank \- \- (between the two \-)
+.TP
+\\\-
+is used to mark hyphenation in a word.
+.TP
+\\\\ is typeset as a linebreak or marks the end of a column in the
+Table
+environment.
+.TP
+\\ (a \\ followed by a blank) is typeset as a blank,
+although it cannot be used at the beginning of a line to make indentation
+(see the \\SP
+command).
+.TP
+~ is typeset as a blank.
+.TP
+\\copyright
+is typeset as (C)\&.
+.TP
+\\noindent
+.TP
+\\hline
+inside a Table
+environment.
+.TP
+\\item
+inside a itemize,
+enumerate,
+or
+description
+environment.
+.TP
+\\today
+11 November 2008(see also the rcsinfo
+LaTeXpackage).
+.TP
+\\ss,\\"a, ...
+\\ss = ß, \\"a= ä, \\"o= ö, \\"u= ü,
+\\"A= Ä, \\"O= Ö, \\"U= Ü. It is allowed to surround these
+macros in { and } in all places, even inside other macros, e.g.
+.Vb
+ \\textbf{\\"a\\"o\\"u\\"A\\"O\\"U\\ss}
+ \\textbf{\\"a}{\\"o}{\\"u}{\\"A}{\\"O}{\\"U}{\\ss}}
+ \\textbf{äöüÄÖÜß}
+.Ve
+.PP
+\fBäöüÄÖÜß äöüÄÖÜß äöüÄÖÜß\fP
+.PP
+If these letters are used in their LATIN\-1 8\-bit coding, they are
+translated into the equivalent letter of the desired output format.
+E.g. Ä
+becomes &Auml;
+in HTML and @"A
+in texinfo.
+.PP
+.SS CONDITIONAL TEXT
+.PP
+latex2man
+preprocesses the LaTeX input to allow text to be used
+conditionally. A special sort of LaTeX comment is used for that purpose.
+.TP
+.B *
+%@% IF \fIcondition\fP %@%
+.TP
+.B *
+%@% ELSE %@%
+.TP
+.B *
+%@% END\-IF %@%
+.PP
+A line must contain only such a comment and nothing else. \fIcondition\fP
+is
+a boolean expression containing ``names\&'' and operators. The names given with
+the \fB\-C\fP\fIname\fP
+option have the value ``true\&'', while all other names
+occuring in the expression are assumed to be ``false\&''\&. If the evaluation of
+the boolean expression results in the value ``true\&'', the text in the
+``then\&''\-part is used and the text in the optional ``else\&''\-part is skipped
+(and vice versa). The IF/ELSE/END\-IF
+may be nested. As boolean
+operators the following are allowed:
+.PP
+.TS
+tab(&);
+l l.
+T{
+||T}&T{
+boolean or
+T}
+T{
+&&T}&T{
+boolean and
+T}
+T{
+!
+T}&T{
+negation
+.TE
+.PP
+( and ) for grouping are allowed.
+.PP
+For example:
+.br
+%@% IF abc %@%
+.br
+abc set
+.br
+%@% IF xyz %@%
+.br
+xyz set
+.br
+%@% ELSE %@%
+.br
+xyz NOT set
+.br
+%@% END\-IF %@%
+.br
+%@% ELSE %@%
+.br
+abc NOT set
+.br
+%@% IF xyz || !XYZ %@%
+.br
+xyz OR !XYZ set
+.br
+%@% ELSE %@%
+.br
+xyz OR !XYZ NOT set
+.br
+%@% END\-IF %@%
+.br
+%@% END\-IF %@%
+.PP
+Run this manual page through latex2man
+with e.g.
+\fB\-C\fP\fI\&'abc XYZ\&'\fP
+and have a look to the generated output.
+(If simply running the LaTeX\-document through LaTeX,all lines are shown in the
+\&.dvi file).
+.br
+abc NOT set
+.br
+xyz OR !XYZ set
+.br
+.PP
+To check the conditional text feature, when latex2man
+is called with
+.TP
+\fB\-C\fP\fIHTML\fP
+ the lines 1a, 2b, 3b, and 4b;
+.TP
+\fB\-C\fP\fITEXI\fP
+ the lines 1b, 2a, 3b, and 4b;
+.TP
+\fB\-C\fP\fIMAN\fP
+ the lines 1b, 2b, 3a, and 4b;
+.TP
+\fB\-C\fP\fILATEX\fP
+ the lines 1b, 2b, 3b, and 4a;
+.TP
+calling LaTeX without preprocessing
+all lines
+.PP
+should be shown:
+.PP
+1b. The HTML conditional was not set.
+.PP
+2b. The TEXI conditional was not set.
+.PP
+3a. This text occurs only when viewing the MAN output
+.PP
+4b. The LATEX conditional was not set.
+.PP
+.SS TRANSLATION OF USER DEFINED MACROS
+.PP
+The user macro translation file (given by the [\fB\-t\fP\fItransfile\fP])
+contains
+Perl
+commands specifying the translation of LaTeX macros defined by
+the user. These macros may have none, one or two arguments. The following code
+is expected:
+.PP
+.TP
+.B *
+Comments start with a # up to the end of the line.
+.TP
+.B *
+For a macro \\foo with no arguments, the following code must be
+specified:
+.RS
+.TP
+Translation to Man\-Pages
+$manMacro{'foo'} = '...';
+.TP
+Translation to HTML
+$htmlMacro{'foo'} = '...';
+.TP
+Translation to TexInfo
+$texiMacro{'foo'} = '...';
+.RE
+.RS
+.PP
+where \&... is the translation.
+.PP
+.RE
+.TP
+.B *
+For a macro \\foo{..} with one argument, the following code must be
+specified:
+.RS
+.TP
+Translation to Man\-Pages
+$manMacro1a{'foo'} = '...';
+.br
+$manMacro1b{'foo'} = '...';
+.TP
+Translation to HTML
+$htmlMacro1a{'foo'} = '...';
+.br
+$htmlMacro1b{'foo'} = '...';
+.RS
+.PP
+.RE
+.TP
+Translation to TexInfo
+$texiMacro1a{'foo'} = '...';
+.br
+$texiMacro1b{'foo'} = '...';
+.RE
+.RS
+.PP
+where \&... is the translation. The 1a code is used before the
+argument, while 1b is typeset after the argument is set.
+.PP
+.RE
+.TP
+.B *
+For a macro \\foo{..}{..} with two arguments, the following code
+must be specified:
+.RS
+.TP
+Translation to Man\-Pages
+$manMacro2a{'foo'} = '...';
+.br
+$manMacro2b{'foo'} = '...';
+.br
+$manMacro2c{'foo'} = '...';
+.TP
+Translation to HTML
+$htmlMacro2a{'foo'} = '...';
+.br
+$htmlMacro2b{'foo'} = '...';
+.br
+$htmlMacro2c{'foo'} = '...';
+.TP
+Translation to TexInfo
+$texiMacro2a{'foo'} = '...';
+.br
+$texiMacro2b{'foo'} = '...';
+.br
+$texiMacro2c{'foo'} = '...';
+.RE
+.RS
+.PP
+where \&... is the translation. The 2a code is used before the
+first argument, 2b between the two arguments and 2c is
+typeset after the second argument is set.
+.RE
+.TP
+.B *
+The file latex2man.trans contains some example code.
+.PP
+.SS VERBATIM ENVIRONMENT
+.PP
+.Vb
+This
+ {is}
+ \\texttt{a}
+ $test$
+ _of_
+verbatim
+<this is no HTML tag> and no @* TexInfo command
+.Ve
+.PP
+.SS SUBSECTION WORKS
+.PP
+This is a \\subsection\&.
+.PP
+.SS Subsubsection works
+.PP
+This is a \\subsubsection\&.
+.PP
+.SS Subsubsection still works
+.PP
+This is another \\subsubsection\&.
+.PP
+.SS GENERAL REMARKS
+.PP
+.TP
+1.
+Empty lines are typeset as paragraph separators.
+.TP
+2.
+The arguments of the LaTeX commands must not be split over several
+lines.
+.TP
+3.
+Do not nest calls to macros.
+.TP
+4.
+Except the mentioned environment and macros, the usage of other LaTeX
+environments or macros are not translated. Their usage will cause garbage
+in the output.
+.TP
+5.
+latex2man requires Perl version >= 5.0004_03.
+.TP
+6.
+If you want to install the system with the distributed Makefile,
+you need GNU\-make\&.
+If you don\&'t have it, you should execute the
+steps shown in the Makefile
+manually.
+.PP
+.SS SOME BUG FIX TESTS
+.PP
+.TP
+Leading . and \&'
+Now leading \&. and \&' in generation troff output should work propperly,
+since a \\& is added. Therfore the \\Dot macro has been deleted.
+.br
+Thanks to \fBFrank.Schilder@Mathematik.Tu\-Ilmenau.De\fP\&.
+.br
+Testcase 1:
+.RS
+.TP
+\&'\\n\&'
+\&.\&.\&.
+.RE
+.RS
+.PP
+Testcase 2:
+.br
+\&.foobar
+Testcase 3:
+.br
+\&...
+.PP
+abc \&...
+abc \&. efg \&' 123
+.PP
+.RE
+.TP
+%in verbatim
+A % in a \\verb and verbatim\-environment was not
+emitted correctly. Thanks to Aleksey Nogin \fBnogin@cs.caltech.edu\fP
+for the bug report and bug fix.
+.PP
+% abc
+.PP
+.Vb
+ % abc %
+.Ve
+.PP
+but ignore comments following this:
+.PP
+.SH REQUIREMENTS
+
+.PP
+.TP
+Perl
+latex2man
+requires Perl version >= 5.0004_03.
+.TP
+Make
+If you want to install the system with the distributed
+Makefile,
+you need GNU\-make\&.
+If you don\&'t have it, you
+should execute the steps shown in the Makefile
+manually.
+.TP
+LaTeX LaTeX2e is required.
+.PP
+.SH CHANGES
+
+Please check the file \fBlatex2man\-CHANGES\fP
+for the list of changes.
+.PP
+.SH VERSION
+
+.PP
+Version: 1.23 of 2008/11/11\&.
+.PP
+.SH LICENSE AND COPYRIGHT
+
+.PP
+.TP
+Copyright
+(C)1998, Dr. Jürgen Vollmer, Viktoriastraße 15,
+D\-76133 Karlsruhe, Germany, \fBJuergen.Vollmer@informatik\-vollmer.de\fP
+.PP
+The actual version of Latex2man
+may be found on my homepage
+.br
+\fBhttp://www.informatik\-vollmer.de/software/latex2man.html\fP\&.
+.PP
+.TP
+License
+This program can be redistributed and/or modified under the
+terms of the LaTeX Project Public License Distributed from CTAN archives
+in directory macros/latex/base/lppl.txt;
+either version 1 of the
+License, or any later version.
+.PP
+.TP
+Misc
+If you find this software useful, please send me a postcard from
+the place where you are living.
+.PP
+.SH AUTHOR
+
+.PP
+Dr. Jürgen Vollmer
+.br
+Viktoriastraße 15
+.br
+D\-76133 Karlsruhe
+.br
+Email: \fBJuergen.Vollmer@informatik\-vollmer.de\fP
+.br
+WWW: \fBhttp://www.informatik\-vollmer.de\fP\&.
+.PP
+.\" NOTE: This file is generated, DO NOT EDIT.
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.html b/Master/texmf-dist/doc/support/latex2man/latex2man.html
new file mode 100644
index 00000000000..03612aa1acb
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.html
@@ -0,0 +1,1160 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<!-- Manual page created with latex2man on Di 11. Nov 08:21:27 CET 2008 --
+-- Author of latex2man: Juergen.Vollmer@informatik-vollmer.de --
+-- NOTE: This file is generated, DO NOT EDIT. -->
+<html>
+<head><title>LATEX2MAN</title></head>
+<body bgcolor="white">
+<h1 align=center>
+LaTeX2man -<br>
+A Documentation Tool
+</h1>
+<h4 align=center>Dr.&nbsp;J&uuml;rgen Vollmer </h4>
+<h4 align=center>2008/11/11</h4>
+<h4 align=center>Version 1.23</h4>
+<p>
+<tt>Latex2man</tt>
+is a tool to translate UNIX manual pages written with
+LaTeXinto a format understood by the UNIX <em>man</em>(1)-command.
+Alternatively HTML, TexInfo, or LaTeX code can be produced too.
+Output of parts of the text may be suppressed using the conditional text
+feature (for this, LaTeX generation may be used).
+<h3>Table of Contents</h3>
+<ul>
+<li><a href="#section_1">Synopsis </a></li>
+<li><a href="#section_2">Description </a></li>
+<li><a href="#section_3">Options </a></li>
+<li><a href="#section_4">Files </a></li>
+<li><a href="#section_5">See Also </a></li>
+<li><a href="#section_6">LaTeX commands</a>
+<ul>
+<li><a href="#section_7">Package Options </a></li>
+<li><a href="#section_8">Package Specific Environments </a></li>
+<li><a href="#section_9">Accepted LaTeX Environments</a></li>
+<li><a href="#section_10">Package Specific Macros </a></li>
+<li><a href="#section_11">Accepted Macros from the rcsinfo Package </a></li>
+<li><a href="#section_12">Accepted LaTeX Macros</a></li>
+<li><a href="#section_13">Conditional Text </a></li>
+<li><a href="#section_14">Translation of User Defined Macros </a></li>
+<li><a href="#section_15">Verbatim Environment </a></li>
+<li><a href="#section_16">Subsection works </a>
+<ul>
+<li><a href="#section_17">Subsubsection works </a></li>
+<li><a href="#section_18">Subsubsection still works </a></li>
+</ul>
+<li><a href="#section_19">General Remarks </a></li>
+<li><a href="#section_20">Some Bug Fix Tests </a></li>
+</ul>
+<li><a href="#section_21">Requirements </a></li>
+<li><a href="#section_22">Changes </a></li>
+<li><a href="#section_23">Version </a></li>
+<li><a href="#section_24">License and Copyright </a></li>
+<li><a href="#section_25">Author </a></li>
+</ul>
+<p>
+<h2><a name="section_1">Synopsis</a></h2>
+
+<p>
+<tt>latex2man</tt>
+[<b>-t</b><i>transfile</i>]
+[<b>-HMTL</b>]
+[<b>-h</b>]
+[<b>-V</b>]
+[<b>-C</b><i>name</i>]
+[<b>-a</b><i>char</i>]
+<i>infile</i>
+<i>outfile</i>
+<p>
+<h2><a name="section_2">Description</a></h2>
+
+<tt>Latex2man</tt>
+reads the file <i>infile</i>
+and writes <i>outfile</i>.
+The
+input must be a LaTeX document using the <tt>latex2man</tt>
+LaTeXpackage.
+<tt>Latex2man</tt>
+translates that document into the <em>troff</em>(1)
+format using
+the <b>-man</b>
+macro package.
+<p>
+Using the <b>-H</b>
+option, HTML code can be produced, instead of
+<em>troff</em>(1).
+<p>
+Using the <b>-T</b>
+option, TexInfo code can be produced, instead of
+<em>troff</em>(1).
+<p>
+Using the <b>-M</b>
+option, <em>troff</em>(1)
+input is produced.
+<p>
+Using the <b>-L</b>
+option, LaTeX ouput can be produced, instead of
+<em>troff</em>(1).
+<p>
+<h2><a name="section_3">Options</a></h2>
+
+<dl compact>
+<dt><b>-t</b><i>transfile</i>
+</dt>
+<dd> Translation for user defined LaTeX macros.
+</dd>
+<dt><b>-M</b>
+</dt>
+<dd> Produce output suitable for the <em>man</em>(1)
+command (default).
+</dd>
+<dt><b>-H</b>
+</dt>
+<dd> Instead of producing output suitable for the <em>man</em>(1)
+command, HTML code is produced (despite the name of the command).
+</dd>
+<dt><b>-T</b>
+</dt>
+<dd> Instead of producing output suitable for the <em>man</em>(1)
+command, TexInfo code is produced (despite the name of the command). The
+generated <tt>.texi</tt>-file
+may be processed with <em>makeinfo</em>(1)
+(to produce an <tt>.info</tt>-file)
+which in turn may be installed using
+<em>install-info</em>(1).
+The Info tags <tt>@dircategory</tt> and
+<tt>@direntry</tt> are provided.
+</dd>
+<dt><b>-L</b>
+</dt>
+<dd> The LaTeX source is written to the <i>outfile</i>.
+This is
+useful in conjunction with the <b>-C</b><i>name</i>
+option.
+</dd>
+<dt><b>-C</b><i>name</i>
+</dt>
+<dd> Output the conditional text for <i>name</i>.
+If more
+than one name should be given use quotes: <b>-C</b><i>'name1 name2 ...'</i><br>
+
+The following names are defined automatically:
+<ul compact>
+<li><b>-H</b> defines <tt>HTML</tt>
+</li>
+<li><b>-T</b> defines <tt>TEXI</tt>
+</li>
+<li><b>-M</b> defines <tt>MAN</tt>
+</li>
+<li><b>-L</b> defines <tt>LATEX</tt>
+</li>
+</ul>
+</dd>
+<dt><b>-a</b><i>char</i>
+</dt>
+<dd> Is used only in conjunction with -T.<br>
+
+Background:<br>
+
+TexInfo ignores all blanks before the first word on a new line. In order
+to produce some additional space before that word (using \SP) some
+character has to be printed before the additional space. By default this
+is a . (dot). The <i>char</i>
+specifies an alternative for that first
+character. Giving a blank to
+<b>-a</b>
+supresses the indentation of a line.<br>
+
+Note: only for the first \SP of a series that <i>char</i>
+is printed.
+</dd>
+<dt><b>-h</b>
+</dt>
+<dd> Show a help text.
+</dd>
+<dt><b>-V</b>
+</dt>
+<dd> Show version information.
+</dd>
+</dl>
+<p>
+<h2><a name="section_4">Files</a></h2>
+
+<p>
+<dl compact>
+<dt><tt>latex2man.tex</tt>
+</dt>
+<dd> The LaTeX file containing this Man-page.
+</dd>
+<dt><tt>latex2man.sty</tt>
+</dt>
+<dd> The LaTeX package defining the environments and
+commands.
+</dd>
+<dt><tt>latex2man.cfg</tt>
+</dt>
+<dd> The configuration file for <tt>Latex2man</tt>
+LaTeX-package.
+</dd>
+<dt><tt>latex2man.trans</tt>
+</dt>
+<dd> File containing example translations of user
+defined LaTeX macros.
+</dd>
+<dt><tt>fancyheadings.sty</tt>
+</dt>
+<dd> A LaTeX package used to typeset head- and
+foot lines.
+</dd>
+<dt><tt>fancyhdr.sty</tt>
+</dt>
+<dd> A LaTeX package used to typeset head- and foot
+lines.
+</dd>
+<dt><tt>rcsinfo.sty</tt>
+</dt>
+<dd> A LaTeX package used to extract and use RCS version
+control information in LaTeX documents.
+</dd>
+</dl>
+<p>
+<h2><a name="section_5">See Also</a></h2>
+
+<p>
+LaTeX,TexInfo, <em>troff</em>(1),
+<em>groff</em>(1),
+<em>makeinfo</em>(1).
+<p>
+<h2><a name="section_6">LaTeX commands</a></h2>
+
+<p>
+The LaTeX package <tt>latex2man</tt>
+is used to write the Man-pages with
+LaTeX.Since we translate into other text formats, not all LaTeX stuff can
+be translated.
+<p>
+<h4><a name="section_7">Package Options</a></h4>
+
+The <tt>latex2man</tt>
+package accepts the following options:
+<p>
+<dl compact>
+<dt>fancy</dt>
+<dd> use the LaTeX package <tt>fancyheadings</tt>.
+</dd>
+<dt>fancyhdr</dt>
+<dd> use the LaTeX package <tt>fancyhdr</tt>.
+</dd>
+<dt>nofancy</dt>
+<dd> neither the LaTeX package <tt>fancyheadings</tt>
+nor
+<tt>fancyhdr</tt>
+are used.
+</dd>
+</dl>
+<p>
+The default option may be specified in the file <tt>latex2man.cfg</tt>.
+<p>
+<h4><a name="section_8">Package Specific Environments</a></h4>
+
+<p>
+The following environments are provided by the package:
+<dl compact>
+<dt>\begin{Name}{chapter}{name}{author}{info}{title} </dt>
+<dd> The
+<tt>Name</tt>
+environment takes five arguments: 1. the Man-page chapter,
+2. the name of the Man-page, 3. the author, 4. some short information
+about the tool printed in the footline of the Man-page, and 5. a text
+which is used as title, for HTML and LaTeX (it's ignored for output of
+the Man-page or TeXinfo. The <tt>Name</tt>
+environment must be the first
+environment in the document. Processing starts with this environment. Any
+text before this is ignored (exception: the <tt>setVersion</tt> and
+<tt>setDate</tt> commands). (Note: all arguments of \begin{Name} must
+be written on one line).
+</dd>
+<dt>\begin{Table}[width]{columns}</dt>
+<dd> The <tt>Table</tt>
+environment takes two arguments: the first optional one specifies
+a width of the last column, the second one gives the number of columns.
+For example:
+<p>
+<tt>\begin{Table}[2cm]{3}</tt> <br>
+
+<tt>Here &amp; am &amp; I \\\hline</tt> <br>
+
+<tt>A 1 &amp; A 2 &amp; A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\</tt> <br>
+
+<tt>B 1 &amp; B 2 &amp; B 3 \\</tt> <br>
+
+<tt>\end{Table}</tt>
+<p>
+will be typeset as:
+<p>
+<table>
+<tr>
+<td>Here </td>
+<td> am </td>
+<td> I </td>
+</tr>
+
+<tr>
+<td>A 1 </td>
+<td> A 2 </td>
+<td> A 3 1 2 3 4 5 A 3 1 2 3 4 5</td>
+</tr>
+
+<tr>
+<td>B 1 </td>
+<td> B 2 </td>
+<td> B 3 </td>
+</tr>
+
+</table>
+<p>
+If no optional <em>width</em>
+argument is given, all entries are
+typeset left justified.
+The <em>width</em>
+is a length measured absolutly in <em>cm</em>.
+Processing with LaTeX a <tt>p{width}</tt> column is typeset
+as last column. The translation to <em>troff</em>(1)
+commands
+results in a <tt>lw(width)</tt>
+column specification. Translating
+to HTML and TexInfo ignores the <em>width</em>
+parameter.
+<p>
+<tt>\hline</tt> may be used.
+<p>
+If the Man-page is formatted with <em>troff</em>(1)
+and tables are used, the
+<em>tbl</em>(1)
+preprocessor should be called, usually by giving
+a <b>-t</b>
+to the call of <em>troff</em>(1).
+When viewing the generated
+manula page using <em>man</em>(1),
+<em>tbl</em>(1)
+is called automatically.
+</dd>
+<dt>\begin{Description}</dt>
+<dd> is the same as \begin{description}
+</dd>
+<dt>\begin{Description}[label]</dt>
+<dd> is similar to
+\begin{description}, but the item labels have at minimum the size
+of the (optional) word <em>label</em>.
+The difference is visible only
+in the DVI and PDF-output, not in the troff, TexInfo or HTML output.
+<dl compact>
+<dt>a</dt>
+<dd> |a <tt>\begin{description}</tt>
+</dd>
+<dt>ab</dt>
+<dd> |ab
+</dd>
+<dt>abc</dt>
+<dd> |abc
+</dd>
+</dl>
+<dl compact>
+<dt>a</dt>
+<dd> |a <tt>\begin{Description}</tt>
+</dd>
+<dt>ab</dt>
+<dd> |ab
+</dd>
+<dt>abc</dt>
+<dd>| abc
+</dd>
+</dl>
+<dl compact>
+<dt>a</dt>
+<dd> |a <tt>\begin{Description}[aa]</tt>
+</dd>
+<dt>ab</dt>
+<dd> |ab
+</dd>
+<dt>abc</dt>
+<dd> |abc
+</dd>
+</dl>
+</dd>
+</dl>
+<p>
+<h4><a name="section_9">Accepted LaTeX Environments</a></h4>
+
+<p>
+The following environments are accepted:
+<ul compact>
+<li><tt>description</tt>
+</li>
+<li><tt>enumerate</tt>
+</li>
+<li><tt>itemize</tt>
+</li>
+<li><tt>verbatim</tt>
+</li>
+<li><tt>center</tt>
+</li>
+</ul>
+<p>
+They may be nested:
+<ul compact>
+<li>Itemize and nested center:
+<div align=center>
+A centered line.<br>
+
+Another centered line.
+</div>
+</li>
+<li>Another item an nested enumerate
+<ol compact>
+<li value =1>a
+</li>
+<li value =2>b
+</li>
+</ol>
+</li>
+</ul>
+<p>
+<h4><a name="section_10">Package Specific Macros</a></h4>
+
+<p>
+The following commands are provided:
+<dl compact>
+<dt>\Opt{option}</dt>
+<dd> Option: <tt>\Opt{-o}</tt> will be typeset as <b>-o</b>.
+</dd>
+<dt>\Arg{argument}</dt>
+<dd> Argument: <tt>\Arg{filename}</tt> will be typeset as
+<i>filename</i>.
+</dd>
+<dt>\OptArg{option}{argument}</dt>
+<dd> Option with Argument:<br>
+
+<tt>\OptArg{-o}{filename}</tt> will be typeset as <b>-o</b><i>filename</i>.
+</dd>
+<dt>\OptoArg{option}{argument}</dt>
+<dd> Option with optional Argument:<br>
+
+<tt>\OptoArg{-o}{filename}</tt> will be
+typeset as <b>-o</b>[<i>filename</i>].
+</dd>
+<dt>\oOpt{option}</dt>
+<dd> Optional option, e.g. <tt>\oOpt{-o}</tt> will be
+typeset as [<b>-o</b>].
+</dd>
+<dt>\oArg{argument}</dt>
+<dd> Optional argument, e.g. <tt>\oArg{filename}</tt>
+will be typeset as [<i>filename</i>].
+</dd>
+<dt>\oOptArg{option}{argument}</dt>
+<dd> Optional option with argument, e.g.<br>
+
+<tt>\oOptArg{-o}{filename}</tt> will be typeset as [<b>-o</b><i>filename</i>].
+</dd>
+<dt>\oOptoArg{option}{argument}</dt>
+<dd> Optional option with optional
+argument, e.g.
+<tt>\oOptoArg{-o}{filename}</tt> will be typeset as [<b>-o</b>[<i>filename</i>]].
+</dd>
+<dt>\File{filename}</dt>
+<dd> used to typeset filenames, e.g.
+<tt>\File{filename}</tt> will be typeset as <tt>filename</tt>.
+</dd>
+<dt>\Prog{prog}</dt>
+<dd> used to typeset program names, e.g.
+<tt>\Prog{latex2man}</tt> will be typeset as <tt>latex2man</tt>.
+</dd>
+<dt>\Cmd{command}{chapter}</dt>
+<dd> used to typeset references to other
+commands, e.g. <tt>\Cmd{latex2man}{1}</tt> will be typeset as
+<em>latex2man</em>(1).
+</dd>
+<dt>\Bar</dt>
+<dd> is typeset as |.
+</dd>
+<dt>\Bs</dt>
+<dd> (BackSlash) is typeset as \.
+</dd>
+<dt>\Tilde</dt>
+<dd> is typeset as a ~.
+</dd>
+<dt>\Dots</dt>
+<dd> is typeset as ...
+</dd>
+<dt>\Bullet</dt>
+<dd> us typeset as *.
+</dd>
+<dt>\setVersion{..}</dt>
+<dd> set <tt>..</tt> as version information.
+</dd>
+<dt>\setVersionWord{..}</dt>
+<dd> set <tt>..</tt> for the word <em>Version:</em>
+in
+the footline. The default is <tt>\setVersionWord{Version:}</tt>.
+</dd>
+<dt>\Version</dt>
+<dd> returns the version information.
+</dd>
+<dt>\setDate{..}</dt>
+<dd> sets <tt>..</tt> as date information.
+</dd>
+<dt>\Date</dt>
+<dd> returns the date information.
+</dd>
+<dt>\Email{..}</dt>
+<dd> use to mark an Email address:<br>
+
+<tt>\Email{Juergen.Vollmer@informatik-vollmer.de}</tt> is typeset as:<br>
+
+<a href ="mailto:Juergen.Vollmer@informatik-vollmer.de"><tt>Juergen.Vollmer@informatik-vollmer.de</tt></a>.
+</dd>
+<dt>\URL{..}</dt>
+<dd> use to mark an URL:
+<tt>\URL{http://www.foo.de/\Tilde vollmer}</tt> is typeset as
+<a href ="http://www.foo.de/~vollmer"><tt>http://www.foo.de/~vollmer</tt></a>.
+</dd>
+<dt>\LatexManEnd</dt>
+<dd> the input file is read and processed until reading
+end-of-file or <tt>\LatexManEnd</tt> (at the beginning of a line).
+LaTeXignores this command.
+</dd>
+<dt>\Lbr, \Rbr</dt>
+<dd> is typeset as [ and ] (these variants are
+needed only somtimes like in <tt>item[FooBar\LBr xx \Lbr]</tt>. Usually
+<tt>[ ]</tt> will work.
+</dd>
+<dt>\LBr, \RBr</dt>
+<dd> is typeset as { and } (these variants are
+needed when using { or } as arguments to macros.
+</dd>
+<dt>\Circum</dt>
+<dd> is typeset as ^.
+</dd>
+<dt>\Percent</dt>
+<dd> is typeset as %.
+</dd>
+<dt>\TEXbr</dt>
+<dd> If processed with LaTeX causes a linebreak (i.e. is
+equivalent to \\).In the output of <tt>latex2man</tt>
+this macro is
+ignored.
+</dd>
+<dt>\TEXIbr</dt>
+<dd> If TexInfo output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+</dd>
+<dt>\MANbr</dt>
+<dd> If Man-Page output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+</dd>
+<dt>\HTMLbr</dt>
+<dd> If HTML output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+</dd>
+<dt>\medskip</dt>
+<dd> An empty line.
+</dd>
+<dt>\SP</dt>
+<dd> Produces some extra space, works also at the beginning of lines.
+The code of the second line looks like:
+<tt>\SP abc \SP\SP xx\\</tt>:<br>
+
+abc &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;xx<br>
+
+&nbsp;&nbsp;abc &nbsp;&nbsp;&nbsp;&nbsp;xx<br>
+
+&nbsp;&nbsp;&nbsp;&nbsp;abc &nbsp;&nbsp;xx
+<p>
+Note: Due to some ``problems'' with TexInfo, the lines starting with
+<tt>\SP</tt>
+have a leading . (dot) in the TexInfo output,
+see <b>-a</b><i>char</i>.
+</dd>
+</dl>
+<p>
+<h4><a name="section_11">Accepted Macros from the rcsinfo Package</a></h4>
+
+<p>
+<dl compact>
+<dt>\rcsInfo $Id ...$</dt>
+<dd> if the LaTeX package <tt>rcsinfo</tt>
+is used,
+this command is used to extract the date of the Man-page.
+</dd>
+<dt>\rcsInfoLongDate</dt>
+<dd> if the LaTeX package <tt>rcsinfo</tt>
+is used, this
+command is used to typeset the date coded in the <tt>$Id ..$</tt> string.
+</dd>
+</dl>
+<p>
+<h4><a name="section_12">Accepted LaTeX Macros</a></h4>
+
+<p>
+The following standard LaTeX commands are accepted:
+<dl compact>
+<dt>\section{..}</dt>
+<dd> The <tt>section</tt>
+macro takes one argument: the
+name of the Man-page section. Each Man-page consists of several sections.
+Usually there are the following sections in a Man-page: <em>Name</em>
+(special handling as environment, c.f. above), <em>Synopsis</em>,
+<em>Description</em>,
+<em>Options</em>,
+<em>Files</em>,
+<em>See Also</em>,
+<em>Diagnostics</em>,
+<em>Return Values</em>,
+<em>Bugs</em>,
+<em>Author</em>,
+<em>version</em>,
+etc.
+<p>
+<em>Synopsis</em>
+must be the first section after the <tt>Name</tt>
+environment.
+<p>
+Note: Do not use LaTeX-macrosin section names.
+</dd>
+<dt>\subsection{..}</dt>
+<dd> works as well as
+</dd>
+<dt>\subsubsection{..}</dt>
+<dd> those.
+</dd>
+<dt>\emph{..}</dt>
+<dd> <tt>\emph{example}</tt> is typeset as <em>example</em>.
+</dd>
+<dt>\textbf{..}</dt>
+<dd> <tt>\textbf{example}</tt> is typeset as <strong>example</strong>.
+</dd>
+<dt>\texttt{..}</dt>
+<dd><tt>\textt{example}</tt> is typeset as <tt>example</tt>.
+</dd>
+<dt>\underline{..}</dt>
+<dd><tt>\underline{example}</tt> is typeset as
+<u>example of underline</u>.
+</dd>
+<dt>\date{..}</dt>
+<dd> uses <tt>..</tt> as date.
+</dd>
+<dt>\verb+..+</dt>
+<dd> but only + is allowed as delimiter.
+</dd>
+<dt>$&lt;$</dt>
+<dd> is typeset as &lt;.
+</dd>
+<dt>$&gt;$</dt>
+<dd> is typeset as &gt;.
+</dd>
+<dt>$&lt;=$</dt>
+<dd> is typeset as &lt;=.
+</dd>
+<dt>$&gt;=$</dt>
+<dd> is typeset as &gt;=.
+</dd>
+<dt>$=$</dt>
+<dd> is typeset as =.
+</dd>
+<dt>$&lt;&gt;$</dt>
+<dd> is typeset as &lt;&gt;.
+</dd>
+<dt>$\ge$</dt>
+<dd> is typeset as $&gt;$.
+</dd>
+<dt>$\le$</dt>
+<dd> is typeset as $&lt;=$.
+</dd>
+<dt>$\leftarrow$</dt>
+<dd> is typeset as $&lt;--$.
+</dd>
+<dt>$\Leftarrow$</dt>
+<dd> is typeset as $&lt;==$.
+</dd>
+<dt>$\rightarrow$</dt>
+<dd> is typeset as $--&gt;$.
+</dd>
+<dt>$\Rightarrow$</dt>
+<dd> is typeset as $==&gt;$.
+</dd>
+<dt>\{</dt>
+<dd> is typeset as {.
+</dd>
+<dt>\}</dt>
+<dd> is typeset as }.
+</dd>
+<dt>\$</dt>
+<dd> is typeset as $.
+</dd>
+<dt>\$</dt>
+<dd> is typeset as $,should be used inside macro
+arguments.
+</dd>
+<dt>\_</dt>
+<dd> is typeset as _.
+</dd>
+<dt>\&amp;</dt>
+<dd> is typeset as &amp;.
+</dd>
+<dt>\#</dt>
+<dd> is typeset as #.
+</dd>
+<dt>\%</dt>
+<dd> is typeset as %.
+</dd>
+<dt>\,</dt>
+<dd> is typeset as smaller blank - - (between the two -)
+</dd>
+<dt>\-</dt>
+<dd> is used to mark hyphenation in a word.
+</dd>
+<dt>\\</dt>
+<dd> is typeset as a linebreak or marks the end of a column in the
+<tt>Table</tt>
+environment.
+</dd>
+<dt>\</dt>
+<dd> (a \ followed by a blank) is typeset as a blank,
+although it cannot be used at the beginning of a line to make indentation
+(see the <tt>\SP</tt>
+command).
+</dd>
+<dt>~</dt>
+<dd> is typeset as a blank.
+</dd>
+<dt>\copyright</dt>
+<dd> is typeset as &copy;.
+</dd>
+<dt>\noindent</dt>
+<dd>
+</dd>
+<dt>\hline</dt>
+<dd> inside a <tt>Table</tt>
+environment.
+</dd>
+<dt>\item</dt>
+<dd> inside a <tt>itemize</tt>,
+<tt>enumerate</tt>,
+or
+<tt>description</tt>
+environment.
+</dd>
+<dt>\today</dt>
+<dd> 11 November 2008 (see also the <tt>rcsinfo</tt>
+LaTeXpackage).
+</dd>
+<dt>\ss,\"a, ...</dt>
+<dd> \ss = &szlig;, \"a= &auml;, \"o= &ouml;, \"u= &uuml;,
+\"A= &Auml;, \"O= &Ouml;, \"U= &Uuml;. It is allowed to surround these
+macros in { and } in all places, even inside other macros, e.g.
+<pre>
+ \textbf{\"a\"o\"u\"A\"O\"U\ss}
+ \textbf{\"a}{\"o}{\"u}{\"A}{\"O}{\"U}{\ss}}
+ \textbf{äöüÄÖÜß}
+</pre>
+<p>
+<strong>&auml;&ouml;&uuml;&Auml;&Ouml;&Uuml;&szlig; &auml;&ouml;&uuml;&Auml;&Ouml;&Uuml;&szlig; &auml;&ouml;&uuml;&Auml;&Ouml;&Uuml;&szlig;</strong>
+<p>
+If these letters are used in their LATIN-1 8-bit coding, they are
+translated into the equivalent letter of the desired output format.
+E.g. <tt>&Auml;</tt>
+becomes <tt>&amp;Auml</tt>;
+in HTML and <tt>@"A</tt>
+in texinfo.
+</dd>
+</dl>
+<p>
+<h4><a name="section_13">Conditional Text</a></h4>
+
+<p>
+<tt>latex2man</tt>
+preprocesses the LaTeX input to allow text to be used
+conditionally. A special sort of LaTeX comment is used for that purpose.
+<ul compact>
+<li>%@% IF <em>condition</em> %@%
+</li>
+<li>%@% ELSE %@%
+</li>
+<li>%@% END-IF %@%
+</li>
+</ul>
+<p>
+A line must contain only such a comment and nothing else. <em>condition</em>
+is
+a boolean expression containing ``names'' and operators. The names given with
+the <b>-C</b><i>name</i>
+option have the value ``true'', while all other names
+occuring in the expression are assumed to be ``false''. If the evaluation of
+the boolean expression results in the value ``true'', the text in the
+``then''-part is used and the text in the optional ``else''-part is skipped
+(and vice versa). The <tt>IF/ELSE/END-IF</tt>
+may be nested. As boolean
+operators the following are allowed:
+<p>
+<table>
+<tr>
+<td>||</td>
+<td> boolean or </td>
+</tr>
+
+<tr>
+<td>&amp;&amp; </td>
+<td> boolean and </td>
+</tr>
+
+<tr>
+<td>! </td>
+<td> negation
+</table>
+<p>
+( and ) for grouping are allowed.
+<p>
+For example:<br>
+
+%@% IF abc %@%<br>
+
+<tt></tt>abc set<br>
+
+<tt></tt>%@% IF xyz %@%<br>
+
+<tt></tt>xyz set<br>
+
+<tt></tt>%@% ELSE %@%<br>
+
+<tt></tt>xyz NOT set<br>
+
+<tt></tt>%@% END-IF %@%<br>
+
+%@% ELSE %@%<br>
+
+<tt></tt>abc NOT set<br>
+
+<tt></tt>%@% IF xyz || !XYZ %@%<br>
+
+<tt></tt>xyz OR !XYZ set<br>
+
+<tt></tt>%@% ELSE %@%<br>
+
+<tt></tt>xyz OR !XYZ NOT set<br>
+
+<tt></tt>%@% END-IF %@%<br>
+
+%@% END-IF %@%
+<p>
+Run this manual page through <tt>latex2man</tt>
+with e.g.
+<b>-C</b><i>'abc XYZ'</i>
+and have a look to the generated output.
+(If simply running the LaTeX-document through LaTeX,all lines are shown in the
+.dvi file).<br>
+
+abc NOT set<br>
+
+xyz OR !XYZ set<br>
+
+<p>
+To check the conditional text feature, when <tt>latex2man</tt>
+is called with
+<dl compact>
+<dt><b>-C</b><i>HTML</i>
+</dt>
+<dd> the lines 1a, 2b, 3b, and 4b;
+</dd>
+<dt><b>-C</b><i>TEXI</i>
+</dt>
+<dd> the lines 1b, 2a, 3b, and 4b;
+</dd>
+<dt><b>-C</b><i>MAN</i>
+</dt>
+<dd> the lines 1b, 2b, 3a, and 4b;
+</dd>
+<dt><b>-C</b><i>LATEX</i>
+</dt>
+<dd> the lines 1b, 2b, 3b, and 4a;
+</dd>
+<dt>calling LaTeX without preprocessing</dt>
+<dd> all lines
+</dd>
+</dl>
+should be shown:
+<p>
+1a. This text occurs only when viewing the HTML output.
+<p>
+2b. The TEXI conditional was not set.
+<p>
+3b. The MAN conditional was not set.
+<p>
+4b. The LATEX conditional was not set.
+<p>
+<h4><a name="section_14">Translation of User Defined Macros</a></h4>
+
+<p>
+The user macro translation file (given by the [<b>-t</b><i>transfile</i>])
+contains
+<tt>Perl</tt>
+commands specifying the translation of LaTeX macros defined by
+the user. These macros may have none, one or two arguments. The following code
+is expected:
+<p>
+<ul compact>
+<li>Comments start with a # up to the end of the line.
+</li>
+<li>For a macro <tt>\foo</tt> with no arguments, the following code must be
+specified:
+<dl compact>
+<dt>Translation to Man-Pages</dt>
+<dd>
+<tt>$manMacro{'foo'} = '...';</tt>
+</dd>
+<dt>Translation to HTML</dt>
+<dd>
+<tt>$htmlMacro{'foo'} = '...';</tt>
+</dd>
+<dt>Translation to TexInfo</dt>
+<dd>
+<tt>$texiMacro{'foo'} = '...';</tt>
+</dd>
+</dl>
+<p>
+where <tt>...</tt> is the translation.
+<p>
+</li>
+<li>For a macro <tt>\foo{..}</tt> with one argument, the following code must be
+specified:
+<dl compact>
+<dt>Translation to Man-Pages</dt>
+<dd>
+<tt>$manMacro1a{'foo'} = '...';</tt><br>
+
+<tt>$manMacro1b{'foo'} = '...';</tt>
+</dd>
+<dt>Translation to HTML</dt>
+<dd>
+<tt>$htmlMacro1a{'foo'} = '...';</tt><br>
+
+<tt>$htmlMacro1b{'foo'} = '...';</tt>
+<p>
+</dd>
+<dt>Translation to TexInfo</dt>
+<dd>
+<tt>$texiMacro1a{'foo'} = '...';</tt><br>
+
+<tt>$texiMacro1b{'foo'} = '...';</tt>
+</dd>
+</dl>
+<p>
+where <tt>...</tt> is the translation. The <tt>1a</tt> code is used before the
+argument, while <tt>1b</tt> is typeset after the argument is set.
+<p>
+</li>
+<li>For a macro <tt>\foo{..}{..}</tt> with two arguments, the following code
+must be specified:
+<dl compact>
+<dt>Translation to Man-Pages</dt>
+<dd>
+<tt>$manMacro2a{'foo'} = '...';</tt><br>
+
+<tt>$manMacro2b{'foo'} = '...';</tt><br>
+
+<tt>$manMacro2c{'foo'} = '...';</tt>
+</dd>
+<dt>Translation to HTML</dt>
+<dd>
+<tt>$htmlMacro2a{'foo'} = '...';</tt><br>
+
+<tt>$htmlMacro2b{'foo'} = '...';</tt><br>
+
+<tt>$htmlMacro2c{'foo'} = '...';</tt>
+</dd>
+<dt>Translation to TexInfo</dt>
+<dd>
+<tt>$texiMacro2a{'foo'} = '...';</tt><br>
+
+<tt>$texiMacro2b{'foo'} = '...';</tt><br>
+
+<tt>$texiMacro2c{'foo'} = '...';</tt>
+</dd>
+</dl>
+<p>
+where <tt>...</tt> is the translation. The <tt>2a</tt> code is used before the
+first argument, <tt>2b</tt> between the two arguments and <tt>2c</tt> is
+typeset after the second argument is set.
+</li>
+<li>The file <tt>latex2man.trans</tt> contains some example code.
+</li>
+</ul>
+<p>
+<h4><a name="section_15">Verbatim Environment</a></h4>
+
+<p>
+<pre>
+This
+ {is}
+ \texttt{a}
+ $test$
+ _of_
+verbatim
+&lt;this is no HTML tag&gt; and no @* TexInfo command
+</pre>
+<p>
+<h4><a name="section_16">Subsection works</a></h4>
+
+<p>
+This is a <tt>\subsection</tt>.
+<p>
+<h5><a name="section_17">Subsubsection works</a></h5>
+
+<p>
+This is a <tt>\subsubsection</tt>.
+<p>
+<h5><a name="section_18">Subsubsection still works</a></h5>
+
+<p>
+This is another <tt>\subsubsection</tt>.
+<p>
+<h4><a name="section_19">General Remarks</a></h4>
+
+<p>
+<ol compact>
+<li value =1>Empty lines are typeset as paragraph separators.
+</li>
+<li value =2>The arguments of the LaTeX commands must not be split over several
+lines.
+</li>
+<li value =3>Do not nest calls to macros.
+</li>
+<li value =4>Except the mentioned environment and macros, the usage of other LaTeX
+environments or macros are not translated. Their usage will cause garbage
+in the output.
+</li>
+<li value =5><tt>latex2man</tt> requires Perl version &gt;= 5.0004_03.
+</li>
+<li value =6>If you want to install the system with the distributed <tt>Makefile</tt>,
+you need GNU-<tt>make</tt>.
+If you don't have it, you should execute the
+steps shown in the <tt>Makefile</tt>
+manually.
+</li>
+</ol>
+<p>
+<h4><a name="section_20">Some Bug Fix Tests</a></h4>
+
+<p>
+<dl compact>
+<dt>Leading . and '</dt>
+<dd>
+Now leading . and ' in generation troff output should work propperly,
+since a <tt>\&amp;</tt> is added. Therfore the <tt>\Dot</tt> macro has been deleted.<br>
+
+Thanks to <a href ="mailto:Frank.Schilder@Mathematik.Tu-Ilmenau.De"><tt>Frank.Schilder@Mathematik.Tu-Ilmenau.De</tt></a>.<br>
+
+Testcase 1:
+<dl compact>
+<dt>'\n'</dt>
+<dd> ...
+</dd>
+</dl>
+Testcase 2:<br>
+
+<tt>.foobar</tt>
+Testcase 3:<br>
+
+...<p>
+abc ...abc . efg ' 123
+<p>
+</dd>
+<dt>% in verbatim</dt>
+<dd> A % in a \verb and verbatim-environment was not
+emitted correctly. Thanks to Aleksey Nogin <a href ="mailto:nogin@cs.caltech.edu"><tt>nogin@cs.caltech.edu</tt></a>
+for the bug report and bug fix.
+<p>
+<tt>% abc</tt>
+<p>
+<pre>
+ % abc %
+</pre>
+<p>
+but ignore comments following this:
+<p>
+</dd>
+</dl>
+<p>
+<h2><a name="section_21">Requirements</a></h2>
+
+<p>
+<dl compact>
+<dt>Perl</dt>
+<dd> <tt>latex2man</tt>
+requires Perl version &gt;= 5.0004_03.
+</dd>
+<dt>Make</dt>
+<dd> If you want to install the system with the distributed
+<tt>Makefile</tt>,
+you need GNU-<tt>make</tt>.
+If you don't have it, you
+should execute the steps shown in the <tt>Makefile</tt>
+manually.
+</dd>
+<dt>LaTeX</dt>
+<dd> LaTeX2e is required.
+</dd>
+</dl>
+<p>
+<h2><a name="section_22">Changes</a></h2>
+
+Please check the file <a href ="latex2man-CHANGES"><tt>latex2man-CHANGES</tt></a>
+for the list of changes.
+<p>
+<h2><a name="section_23">Version</a></h2>
+
+<p>
+Version: 1.23 of 2008/11/11.
+<p>
+<h2><a name="section_24">License and Copyright</a></h2>
+
+<p>
+<dl compact>
+<dt>Copyright</dt>
+<dd> &copy; 1998, Dr.&nbsp;J&uuml;rgen Vollmer, Viktoriastra&szlig;e 15,
+D-76133 Karlsruhe, Germany, <a href ="mailto:Juergen.Vollmer@informatik-vollmer.de"><tt>Juergen.Vollmer@informatik-vollmer.de</tt></a>
+<p>
+The actual version of <tt>Latex2man</tt>
+may be found on my homepage<br>
+
+<a href ="http://www.informatik-vollmer.de/software/latex2man.html"><tt>http://www.informatik-vollmer.de/software/latex2man.html</tt></a>.
+<p>
+</dd>
+<dt>License</dt>
+<dd> This program can be redistributed and/or modified under the
+terms of the LaTeX Project Public License Distributed from CTAN archives
+in directory <tt>macros/latex/base/lppl.txt</tt>;
+either version 1 of the
+License, or any later version.
+<p>
+</dd>
+<dt>Misc</dt>
+<dd> If you find this software useful, please send me a postcard from
+the place where you are living.
+</dd>
+</dl>
+<p>
+<h2><a name="section_25">Author</a></h2>
+
+<p>
+Dr.&nbsp;J&uuml;rgen Vollmer <br>
+
+Viktoriastra&szlig;e 15 <br>
+
+D-76133 Karlsruhe <br>
+
+Email: <a href ="mailto:Juergen.Vollmer@informatik-vollmer.de"><tt>Juergen.Vollmer@informatik-vollmer.de</tt></a>
+<br>
+WWW: <a href ="http://www.informatik-vollmer.de"><tt>http://www.informatik-vollmer.de</tt></a>.
+<p>
+</body>
+</html>
+<!-- NOTE: This file is generated, DO NOT EDIT. -->
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.pdf b/Master/texmf-dist/doc/support/latex2man/latex2man.pdf
new file mode 100644
index 00000000000..13768b901c3
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.tex b/Master/texmf-dist/doc/support/latex2man/latex2man.tex
new file mode 100644
index 00000000000..b4d02ad8f83
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.tex
@@ -0,0 +1,758 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Project: Documentation Tools
+%% Descr: Latex --> MAN-page (groff -man), LATEX documentation
+%% Author: Dr. Jürgen Vollmer, Juergen.Vollmer@informatik-vollmer.de
+%% $Id: latex2man.tex,v 1.187 2008/11/11 07:21:18 vollmer Exp $
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%
+%% Latex2man is a tool to translate UNIX manual pages written with LaTeX into a
+%% format understood by the UNIX man(1)-command.
+%% Alternatively HTML or TexInfo code can be produced too.
+%% Output of parts of the text may be supressed using the conditional text
+%% feature.
+%%
+%% There is LaTeX package (latex2man.sty) used for writing the Man-page
+%% and a PERL script (latex2man) doing the actual translation.
+%%
+%% Copyright (C) 1998, Dr. Juergen Vollmer
+%% Viktoriastrasse 15, D-76133 Karlsruhe, Germany
+%% Juergen.Vollmer@informatik-vollmer.de
+%% License:
+%% This program can be redistributed and/or modified under the terms
+%% of the LaTeX Project Public License Distributed from CTAN
+%% archives in directory macros/latex/base/lppl.txt; either
+%% version 1 of the License, or any later version.
+%%
+%% If you find this software useful, please send me a postcard.
+%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\documentclass[english]{article}
+\usepackage[latin1]{inputenc}
+\usepackage{babel}
+\usepackage{verbatim}
+
+%% do we have the `hyperref package?
+\IfFileExists{hyperref.sty}{
+ \usepackage[bookmarksopen,bookmarksnumbered]{hyperref}
+}{}
+
+%% do we have the `fancyhdr' package?
+\IfFileExists{fancyhdr.sty}{
+\usepackage[fancyhdr]{latex2man}
+}{
+%% do we have the `fancyheadings' package?
+\IfFileExists{fancyheadings.sty}{
+\usepackage[fancy]{latex2man}
+}{
+\usepackage[nofancy]{latex2man}
+\message{no fancyhdr or fancyheadings package present, discard it}
+}}
+
+%% do we have the `rcsinfo' package?
+\IfFileExists{rcsinfo.sty}{
+\usepackage[nofancy]{rcsinfo}
+\rcsInfo $Id: latex2man.tex,v 1.187 2008/11/11 07:21:18 vollmer Exp $
+\setDate{\rcsInfoLongDate}
+}{
+\setDate{2008/11/11} %%%% must be manually set, if rcsinfo is not present
+\message{package rcsinfo not present, discard it}
+}
+
+\setVersionWord{Version:} %%% that's the default, no need to set it.
+\setVersion{1.23}
+
+\begin{document}
+
+\begin{Name}{1}{latex2man}{Dr.~J{\"u}rgen Vollmer}{Documentation Tools}{\LaTeX2man\\--\\ A Documentation Tool}
+
+ \Prog{Latex2man} is a tool to translate UNIX manual pages written with
+ \LaTeX\ into a format understood by the UNIX \Cmd{man}{1}-command.
+ Alternatively HTML, TexInfo, or \LaTeX\ code can be produced too.
+ Output of parts of the text may be suppressed using the conditional text
+ feature (for this, LaTeX generation may be used).
+\end{Name}
+
+\section{Synopsis}
+%%%%%%%%%%%%%%%%%%
+
+\Prog{latex2man} \oOptArg{-t}{transfile}
+ \oOpt{-HMTL} \oOpt{-h} \oOpt{-V} \oOptArg{-C}{name} \TEXIbr
+ \oOptArg{-a}{char}
+ \Arg{infile}
+ \Arg{outfile}
+
+\section{Description}
+%%%%%%%%%%%%%%%%%%%%%
+\Prog{Latex2man} reads the file \Arg{infile} and writes \Arg{outfile}. The
+input must be a \LaTeX\ document using the \Prog{latex2man} \LaTeX\ package.
+\Prog{Latex2man} translates that document into the \Cmd{troff}{1} format using
+the \Opt{-man} macro package.
+
+Using the \Opt{-H} option, HTML code can be produced, instead of
+\Cmd{troff}{1}.
+
+Using the \Opt{-T} option, TexInfo code can be produced, instead of
+\Cmd{troff}{1}.
+
+Using the \Opt{-M} option, \Cmd{troff}{1} input is produced.
+
+Using the \Opt{-L} option, \LaTeX\ ouput can be produced, instead of
+\Cmd{troff}{1}.
+
+
+\section{Options}
+%%%%%%%%%%%%%%%%%
+\begin{Description}[\OptArg{-t}{transfile}]\setlength{\itemsep}{0cm}
+\item[\OptArg{-t}{transfile}] Translation for user defined \LaTeX\ macros.
+\item[\Opt{-M}] Produce output suitable for the \Cmd{man}{1} command (default).
+\item[\Opt{-H}] Instead of producing output suitable for the \Cmd{man}{1}
+ command, HTML code is produced (despite the name of the command).
+\item[\Opt{-T}] Instead of producing output suitable for the \Cmd{man}{1}
+ command, TexInfo code is produced (despite the name of the command). The
+ generated \File{.texi}-file may be processed with \Cmd{makeinfo}{1}
+ (to produce an \File{.info}-file) which in turn may be installed using
+ \Cmd{install-info}{1}. The Info tags \verb+@dircategory+ and
+ \verb+@direntry+ are provided.
+\item[\Opt{-L}] The \LaTeX\ source is written to the \Arg{outfile}. This is
+ useful in conjunction with the \OptArg{-C}{name} option.
+\item[\OptArg{-C}{name}] Output the conditional text for \Arg{name}. If more
+ than one name should be given use quotes: \OptArg{-C}{'name1 name2 ...'}\\
+ The following names are defined automatically:
+ \begin{itemize}
+ \item \Opt{-H} defines \texttt{HTML}
+ \item \Opt{-T} defines \texttt{TEXI}
+ \item \Opt{-M} defines \texttt{MAN}
+ \item \Opt{-L} defines \texttt{LATEX}
+ \end{itemize}
+ \item[\OptArg{-a}{char}] Is used only in conjunction with -T.\\
+ Background:\\
+ TexInfo ignores all blanks before the first word on a new line. In order
+ to produce some additional space before that word (using \Bs SP) some
+ character has to be printed before the additional space. By default this
+ is a . (dot). The \Arg{char} specifies an alternative for that first
+ character. Giving a blank to
+ \Opt{-a} supresses the indentation of a line.\\
+ Note: only for the first \Bs SP of a series that \Arg{char} is printed.
+\item[\Opt{-h}] Show a help text.
+\item[\Opt{-V}] Show version information.
+\end{Description}
+
+\section{Files}
+%%%%%%%%%%%%%%%
+
+\begin{Description}\setlength{\itemsep}{0cm}
+\item[\File{latex2man.tex}] The \LaTeX\ file containing this Man-page.
+\item[\File{latex2man.sty}] The \LaTeX\ package defining the environments and
+ commands.
+\item[\File{latex2man.cfg}] The configuration file for \Prog{Latex2man}
+ \LaTeX-package.
+\item[\File{latex2man.trans}] File containing example translations of user
+ defined \LaTeX\ macros.
+\item[\File{fancyheadings.sty}] A \LaTeX\ package used to typeset head- and
+ foot lines.
+\item[\File{fancyhdr.sty}] A \LaTeX\ package used to typeset head- and foot
+ lines.
+\item[\File{rcsinfo.sty}] A \LaTeX\ package used to extract and use RCS version
+ control information in \LaTeX\ documents.
+\end{Description}
+
+\section{See Also}
+%%%%%%%%%%%%%%%%%%
+
+\LaTeX, TexInfo, \Cmd{troff}{1}, \Cmd{groff}{1}, \Cmd{makeinfo}{1}.
+
+\section{\LaTeX\ commands}
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The \LaTeX\ package \texttt{latex2man} is used to write the Man-pages with
+\LaTeX. Since we translate into other text formats, not all \LaTeX\ stuff can
+be translated.
+
+\subsection{Package Options}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+The \texttt{latex2man} package accepts the following options:
+
+\begin{description}\setlength{\itemsep}{0cm}
+\item[fancy] use the \LaTeX\ package \texttt{fancyheadings}.
+\item[fancyhdr] use the \LaTeX\ package \texttt{fancyhdr}.
+\item[nofancy] neither the \LaTeX\ package \texttt{fancyheadings} nor
+ \texttt{fancyhdr} are used.
+\end{description}
+
+The default option may be specified in the file \texttt{latex2man.cfg}.
+
+\subsection{Package Specific Environments}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The following environments are provided by the package:
+\begin{description}\setlength{\itemsep}{0cm}
+\item[\Bs begin\{Name\}\{chapter\}\{name\}\{author\}\{info\}\{title\} ] The
+ \texttt{Name} environment takes five arguments: 1.\ the Man-page chapter,
+ 2.\ the name of the Man-page, 3.\ the author, 4.\ some short information
+ about the tool printed in the footline of the Man-page, and 5.\ a text
+ which is used as title, for HTML and \LaTeX\ (it's ignored for output of
+ the Man-page or TeXinfo. The \texttt{Name} environment must be the first
+ environment in the document. Processing starts with this environment. Any
+ text before this is ignored (exception: the \verb+setVersion+ and
+ \verb+setDate+ commands). (Note: all arguments of \Bs begin\{Name\} must
+ be written on one line).
+\item[\Bs begin\{Table\}\Lbr width\Rbr\{columns\}] The \texttt{Table}
+ environment takes two arguments: the first optional one specifies
+ a width of the last column, the second one gives the number of columns.
+ For example:
+
+ \verb+\begin{Table}[2cm]{3}+ \\
+ \verb+ Here & am & I \\\hline+ \\
+ \verb+ A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\+ \\
+ \verb+ B 1 & B 2 & B 3 \\+ \\
+ \verb+\end{Table}+
+
+ will be typeset as:
+
+ \begin{Table}[2cm]{3}
+ Here & am & I \\\hline
+ A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5\\
+ B 1 & B 2 & B 3 \\
+ \end{Table}
+
+ If no optional \emph{width} argument is given, all entries are
+ typeset left justified.
+ The \emph{width} is a length measured absolutly in \emph{cm}.
+ Processing with \LaTeX\ a \verb+p{width}+ column is typeset
+ as last column. The translation to \Cmd{troff}{1} commands
+ results in a \texttt{lw(width)} column specification. Translating
+ to HTML and TexInfo ignores the \emph{width} parameter.
+
+ \verb+\hline+ may be used.
+
+ If the Man-page is formatted with \Cmd{troff}{1} and tables are used, the
+ \Cmd{tbl}{1} preprocessor should be called, usually by giving
+ a \Opt{-t} to the call of \Cmd{troff}{1}. When viewing the generated
+ manula page using \Cmd{man}{1}, \Cmd{tbl}{1} is called automatically.
+\item[\Bs begin\{Description\}] is the same as \Bs begin\{description\}
+\item[\Bs begin\{Description\}\Lbr label\Rbr] is similar to
+ \Bs begin\{description\}, but the item labels have at minimum the size
+ of the (optional) word \emph{label}. The difference is visible only
+ in the DVI and PDF-output, not in the troff, TexInfo or HTML output.
+ \begin{description}
+ \item[a] \Bar a \verb+\begin{description}+
+ \item[ab] \Bar ab
+ \item[abc] \Bar abc
+ \end{description}
+ \begin{Description}
+ \item[a] \Bar a \verb+\begin{Description}+
+ \item[ab] \Bar ab
+ \item[abc]\Bar abc
+ \end{Description}
+ \begin{Description}[ab]
+ \item[a] \Bar a \verb+\begin{Description}[aa]+
+ \item[ab] \Bar ab
+ \item[abc] \Bar abc
+ \end{Description}
+\end{description}
+
+\subsection{Accepted \LaTeX\ Environments}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The following environments are accepted:
+\begin{itemize}\setlength{\itemsep}{0cm}
+\item \texttt{description}
+\item \texttt{enumerate}
+\item \texttt{itemize}
+\item \texttt{verbatim}
+\item \texttt{center}
+\end{itemize}
+
+They may be nested:
+\begin{itemize}
+\item Itemize and nested center:
+ \begin{center}
+ A centered line.\\
+ Another centered line.
+ \end{center}
+\item Another item an nested enumerate
+ \begin{enumerate}
+ \item a
+ \item b
+ \end{enumerate}
+\end{itemize}
+
+
+\subsection{Package Specific Macros}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The following commands are provided:
+\begin{description}\setlength{\itemsep}{0cm}
+\item[\Bs Opt\{option\}] Option: \verb+\Opt{-o}+ will be typeset as \Opt{-o}.
+\item[\Bs Arg\{argument\}] Argument: \verb+\Arg{filename}+ will be typeset as
+ \Arg{filename}.
+\item[\Bs OptArg\{option\}\{argument\}] Option with Argument:\\
+ \verb+\OptArg{-o}{filename}+ will be typeset as \OptArg{-o}{filename}.
+\item[\Bs OptoArg\{option\}\{argument\}] Option with optional Argument:\\
+ \verb+\OptoArg{-o}{filename}+ will be
+ typeset as \OptoArg{-o}{filename}.
+\item[\Bs oOpt\{option\}] Optional option, e.g.\ \verb+\oOpt{-o}+ will be
+ typeset as \oOpt{-o}.
+\item[\Bs oArg\{argument\}] Optional argument, e.g.\ \verb+\oArg{filename}+
+ will be typeset as \oArg{filename}.
+\item[\Bs oOptArg\{option\}\{argument\}] Optional option with argument, e.g.\\
+ \verb+\oOptArg{-o}{filename}+ will be typeset as \oOptArg{-o}{filename}.
+\item[\Bs oOptoArg\{option\}\{argument\}] Optional option with optional
+ argument, e.g.\
+ \verb+\oOptoArg{-o}{filename}+ will be typeset as \oOptoArg{-o}{filename}.
+\item[\Bs File\{filename\}] used to typeset filenames, e.g.\
+ \verb+\File{filename}+ will be typeset as \File{filename}.
+\item[\Bs Prog\{prog\}] used to typeset program names, e.g.\
+ \verb+\Prog{latex2man}+ will be typeset as \Prog{latex2man}.
+\item[\Bs Cmd\{command\}\{chapter\}] used to typeset references to other
+ commands, e.g.\ \verb+\Cmd{latex2man}{1}+ will be typeset as
+ \Cmd{latex2man}{1}.
+\item[\Bs Bar] is typeset as \Bar.
+\item[\Bs Bs] (BackSlash) is typeset as \Bs.
+\item[\Bs Tilde] is typeset as a \Tilde.
+\item[\Bs Dots] is typeset as \Dots
+\item[\Bs Bullet] us typeset as \Bullet.
+\item[\Bs setVersion\{..\}] set \verb+..+ as version information.
+\item[\Bs setVersionWord\{..\}] set \verb+..+ for the word \emph{Version:} in
+ the footline. The default is \verb+\setVersionWord{Version:}+.
+\item[\Bs Version] returns the version information.
+\item[\Bs setDate\{..\}] sets \verb+..+ as date information.
+\item[\Bs Date] returns the date information.
+\item[\Bs Email\{..\}] use to mark an Email address:\\
+ \verb+\Email{Juergen.Vollmer@informatik-vollmer.de}+ is typeset as:\\
+ \Email{Juergen.Vollmer@informatik-vollmer.de}.
+\item[\Bs URL\{..\}] use to mark an URL:
+ \verb+\URL{http://www.foo.de/\Tilde vollmer}+ is typeset as
+ \URL{http://www.foo.de/\Tilde vollmer}.
+\item[\Bs LatexManEnd] the input file is read and processed until reading
+ end-of-file or \verb+\LatexManEnd+ (at the beginning of a line).
+ \LaTeX\ ignores this command.
+\item[\Bs Lbr, \Bs Rbr] is typeset as \Lbr\ and \Rbr\ (these variants are
+ needed only somtimes like in \verb+item[FooBar\LBr xx \Lbr]+. Usually
+ \verb+[ ]+ will work.
+\item[\Bs LBr, \Bs RBr] is typeset as \LBr\ and \RBr\ (these variants are
+ needed when using \{ or \} as arguments to macros.
+\item[\Bs Circum] is typeset as \Circum.
+\item[\Bs Percent] is typeset as \Percent.
+\item[\Bs TEXbr] If processed with \LaTeX\ causes a linebreak (i.e.\ is
+ equivalent to \Bs\Bs). In the output of \Prog{latex2man} this macro is
+ ignored.
+\item[\Bs TEXIbr] If TexInfo output is generated, causes a linebreak (i.e.\ is
+ equivalent to \Bs\Bs), otherwise ignored.
+\item[\Bs MANbr] If Man-Page output is generated, causes a linebreak (i.e.\ is
+ equivalent to \Bs\Bs), otherwise ignored.
+\item[\Bs HTMLbr] If HTML output is generated, causes a linebreak (i.e.\ is
+ equivalent to \Bs\Bs), otherwise ignored.
+\item[\Bs medskip] An empty line.
+\item[\Bs SP] Produces some extra space, works also at the beginning of lines.
+ The code of the second line looks like:
+ \texttt{\Bs SP abc \Bs SP\Bs SP xx\Bs\Bs}:\\
+ abc \SP\SP\SP xx\\
+ \SP abc \SP\SP xx\\
+ \SP\SP abc \SP xx
+
+ Note: Due to some ``problems'' with TexInfo, the lines starting with
+ \texttt{\Bs SP} have a leading . (dot) in the TexInfo output,
+ see \OptArg{-a}{char}.
+\end{description}
+
+\subsection{Accepted Macros from the rcsinfo Package}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{description}\setlength{\itemsep}{0cm}
+\item[\Bs rcsInfo \$Id ...\$] if the \LaTeX\ package \File{rcsinfo} is used,
+ this command is used to extract the date of the Man-page.
+\item[\Bs rcsInfoLongDate] if the \LaTeX\ package \File{rcsinfo} is used, this
+ command is used to typeset the date coded in the \verb+$Id ..$+ string.
+\end{description}
+
+\subsection{Accepted \LaTeX\ Macros}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The following standard \LaTeX\ commands are accepted:
+\begin{description}\setlength{\itemsep}{0cm}
+\item[\Bs section\{..\}] The \texttt{section} macro takes one argument: the
+ name of the Man-page section. Each Man-page consists of several sections.
+ Usually there are the following sections in a Man-page: \emph{Name}
+ (special handling as environment, c.f.\ above), \emph{Synopsis},
+ \emph{Description}, \emph{Options}, \emph{Files}, \emph{See Also},
+ \emph{Diagnostics}, \emph{Return Values}, \emph{Bugs}, \emph{Author},
+ \emph{version}, etc.
+
+ \emph{Synopsis} must be the first section after the \texttt{Name}
+ environment.
+
+ Note: Do not use \LaTeX-macros in section names.
+\item[\Bs subsection\{..\}] works as well as
+\item[\Bs subsubsection\{..\}] those.
+\item[\Bs emph\{..\}] \verb+\emph{example}+ is typeset as \emph{example}.
+\item[\Bs textbf\{..\}] \verb+\textbf{example}+ is typeset as \textbf{example}.
+\item[\Bs texttt\{..\}]\verb+\textt{example}+ is typeset as \texttt{example}.
+\item[\Bs underline\{..\}]\verb+\underline{example}+ is typeset as
+ \underline{example of underline}.
+\item[\Bs date\{..\}] uses \verb+..+ as date.
+\item[\Bs verb+..+] but only + is allowed as delimiter.
+\item[\$$<$\$] is typeset as $<$.
+\item[\$$>$\$] is typeset as $>$.
+\item[\$$<=$\$] is typeset as $<=$.
+\item[\$$>=$\$] is typeset as $>=$.
+\item[\$$=$\$] is typeset as $=$.
+\item[\$$<>$\$] is typeset as $<>$.
+\item[\$\Bs ge\$] is typeset as $\ge$.
+\item[\$\Bs le\$] is typeset as $\le$.
+\item[\$\Bs leftarrow\$] is typeset as $\leftarrow$.
+\item[\$\Bs Leftarrow\$] is typeset as $\Leftarrow$.
+\item[\$\Bs rightarrow\$] is typeset as $\rightarrow$.
+\item[\$\Bs Rightarrow\$] is typeset as $\Rightarrow$.
+\item[\Bs \{] is typeset as \{.
+\item[\Bs \}] is typeset as \}.
+\item[\Bs \$] is typeset as \$.
+\item[\Bs \Dollar] is typeset as \Dollar, should be used inside macro
+ arguments.
+\item[\Bs \_] is typeset as \_.
+\item[\Bs \&] is typeset as \&.
+\item[\Bs \#] is typeset as \#.
+\item[\Bs \%] is typeset as \%.
+\item[\Bs ,] is typeset as smaller blank -\,- (between the two -)
+\item[\Bs -] is used to mark hyphenation in a word.
+\item[\Bs \Bs] is typeset as a linebreak or marks the end of a column in the
+ \texttt{Table} environment.
+\item[\Bs ] (a \Bs\ followed by a blank) is typeset as a blank,
+ although it cannot be used at the beginning of a line to make indentation
+ (see the \texttt{\Bs SP} command).
+\item[\Tilde] is typeset as a blank.
+\item[\Bs copyright] is typeset as \copyright.
+\item[\Bs noindent]
+\item[\Bs hline] inside a \texttt{Table} environment.
+\item[\Bs item] inside a \texttt{itemize}, \texttt{enumerate}, or
+ \texttt{description} environment.
+\item[\Bs today] \today\ (see also the \texttt{rcsinfo} \LaTeX\ package).
+\item[\Bs ss,\Bs"a, ...] \Bs ss = \ss, \Bs"a = \"a, \Bs"o = \"o, \Bs"u = \"u,
+ \Bs"A = \"A, \Bs"O = \"O, \Bs"U = \"U. It is allowed to surround these
+ macros in \{ and \} in all places, even inside other macros, e.g.
+ \begin{verbatim}
+ \textbf{\"a\"o\"u\"A\"O\"U\ss}
+ \textbf{\"a}{\"o}{\"u}{\"A}{\"O}{\"U}{\ss}}
+ \textbf{äöüÄÖÜß}
+ \end{verbatim}
+
+ \textbf{\"a\"o\"u\"A\"O\"U\ss {\"a}{\"o}{\"u}{\"A}{\"O}{\"U}{\ss} äöüÄÖÜß}
+
+ If these letters are used in their LATIN-1 8-bit coding, they are
+ translated into the equivalent letter of the desired output format.
+ E.g. \texttt{Ä} becomes \texttt{\&Auml}; in HTML and \texttt{@"A}
+ in texinfo.
+\end{description}
+
+\subsection{Conditional Text}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\Prog{latex2man} preprocesses the \LaTeX\ input to allow text to be used
+conditionally. A special sort of \LaTeX\ comment is used for that purpose.
+\begin{itemize}\setlength{\itemsep}{0cm}
+\item \Percent@\Percent\ IF \emph{condition} \Percent@\Percent
+\item \Percent@\Percent\ ELSE \Percent@\Percent
+\item \Percent@\Percent\ END-IF \Percent@\Percent
+\end{itemize}
+
+A line must contain only such a comment and nothing else. \emph{condition} is
+a boolean expression containing ``names'' and operators. The names given with
+the \OptArg{-C}{name} option have the value ``true'', while all other names
+occuring in the expression are assumed to be ``false''. If the evaluation of
+the boolean expression results in the value ``true'', the text in the
+``then''-part is used and the text in the optional ``else''-part is skipped
+(and vice versa). The \texttt{IF/ELSE/END-IF} may be nested. As boolean
+operators the following are allowed:
+
+\begin{Table}{2}
+\Bar\Bar & boolean or \\
+\&\& & boolean and \\
+! & negation
+\end{Table}
+
+( and ) for grouping are allowed.
+
+\noindent
+For example:\\
+\Percent@\Percent\ IF abc \Percent@\Percent\\
+\verb+ +abc set\\
+\verb+ +\Percent@\Percent\ IF xyz \Percent@\Percent\\
+\verb+ +xyz set\\
+\verb+ +\Percent@\Percent\ ELSE \Percent@\Percent\\
+\verb+ +xyz NOT set\\
+\verb+ +\Percent@\Percent\ END-IF \Percent@\Percent\\
+\Percent@\Percent\ ELSE \Percent@\Percent\\
+\verb+ +abc NOT set\\
+\verb+ +\Percent@\Percent\ IF xyz \Bar\Bar\ !XYZ \Percent@\Percent\\
+\verb+ +xyz OR !XYZ set\\
+\verb+ +\Percent@\Percent\ ELSE \Percent@\Percent\\
+\verb+ +xyz OR !XYZ NOT set\\
+\verb+ +\Percent@\Percent\ END-IF \Percent@\Percent\\
+\Percent@\Percent\ END-IF \Percent@\Percent
+
+\noindent
+Run this manual page through \Prog{latex2man} with e.g.\
+\OptArg{-C}{'abc XYZ'} and have a look to the generated output.
+(If simply running the \LaTeX-document\ through \LaTeX, all lines are shown in the
+.dvi file).\\
+%@% IF abc %@%
+ abc set\\
+ %@% IF xyz %@%
+ xyz set\\
+ %@% ELSE %@%
+ xyz NOT set\\
+ %@% END-IF %@%
+%@% ELSE %@%
+ abc NOT set\\
+ %@% IF xyz || !XYZ %@%
+ xyz OR !XYZ set\\
+ %@% ELSE %@%
+ xyz OR !XYZ NOT set
+ %@% END-IF %@%
+%@% END-IF %@%
+
+\noindent
+To check the conditional text feature, when \Prog{latex2man} is called with
+\begin{description}
+\item[\OptArg{-C}{HTML}] the lines 1a, 2b, 3b, and 4b;
+\item[\OptArg{-C}{TEXI}] the lines 1b, 2a, 3b, and 4b;
+\item[\OptArg{-C}{MAN}] the lines 1b, 2b, 3a, and 4b;
+\item[\OptArg{-C}{LATEX}] the lines 1b, 2b, 3b, and 4a;
+\item[calling \LaTeX\ without preprocessing] all lines
+\end{description}
+should be shown:
+
+%@% IF HTML %@%
+1a. This text occurs only when viewing the HTML output.
+
+%@% ELSE %@%
+1b. The HTML conditional was not set.
+
+%@% END-IF %@%
+
+%@% IF TEXI %@%
+2a. This text occurs only when viewing the TEXI output
+
+%@% ELSE %@%
+2b. The TEXI conditional was not set.
+
+%@% END-IF %@%
+
+%@% IF MAN %@%
+3a. This text occurs only when viewing the MAN output
+
+%@% ELSE %@%
+3b. The MAN conditional was not set.
+
+%@% END-IF %@%
+
+%@% IF LATEX %@%
+4a. This text occurs only when viewing the LATEX output
+
+%@% ELSE %@%
+4b. The LATEX conditional was not set.
+
+%@% END-IF %@%
+
+\subsection{Translation of User Defined Macros}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+The user macro translation file (given by the \oOptArg{-t}{transfile}) contains
+\Prog{Perl} commands specifying the translation of \LaTeX\ macros defined by
+the user. These macros may have none, one or two arguments. The following code
+is expected:
+
+\begin{itemize}\setlength{\itemsep}{0cm}
+\item Comments start with a \# up to the end of the line.
+\item For a macro \verb+\foo+ with no arguments, the following code must be
+ specified:
+ \begin{description}\setlength{\itemsep}{0cm}
+ \item[Translation to Man-Pages]\TEXbr
+ \verb+$manMacro{'foo'} = '...';+
+ \item[Translation to HTML]\TEXbr
+ \verb+$htmlMacro{'foo'} = '...';+
+ \item[Translation to TexInfo]\TEXbr
+ \verb+$texiMacro{'foo'} = '...';+
+ \end{description}
+
+ where \verb+...+ is the translation.
+
+\item For a macro \verb+\foo{..}+ with one argument, the following code must be
+ specified:
+ \begin{description}\setlength{\itemsep}{0cm}
+ \item[Translation to Man-Pages]\TEXbr
+ \verb+$manMacro1a{'foo'} = '...';+\\
+ \verb+$manMacro1b{'foo'} = '...';+
+ \item[Translation to HTML]\TEXbr
+ \verb+$htmlMacro1a{'foo'} = '...';+\\
+ \verb+$htmlMacro1b{'foo'} = '...';+
+
+ \item[Translation to TexInfo]\TEXbr
+ \verb+$texiMacro1a{'foo'} = '...';+\\
+ \verb+$texiMacro1b{'foo'} = '...';+
+ \end{description}
+
+ where \verb+...+ is the translation. The \verb+1a+ code is used before the
+ argument, while \verb+1b+ is typeset after the argument is set.
+
+\item For a macro \verb+\foo{..}{..}+ with two arguments, the following code
+ must be specified:
+ \begin{description}\setlength{\itemsep}{0cm}
+ \item[Translation to Man-Pages]\TEXbr
+ \verb+$manMacro2a{'foo'} = '...';+\\
+ \verb+$manMacro2b{'foo'} = '...';+\\
+ \verb+$manMacro2c{'foo'} = '...';+
+ \item[Translation to HTML]\TEXbr
+ \verb+$htmlMacro2a{'foo'} = '...';+\\
+ \verb+$htmlMacro2b{'foo'} = '...';+\\
+ \verb+$htmlMacro2c{'foo'} = '...';+
+ \item[Translation to TexInfo]\TEXbr
+ \verb+$texiMacro2a{'foo'} = '...';+\\
+ \verb+$texiMacro2b{'foo'} = '...';+\\
+ \verb+$texiMacro2c{'foo'} = '...';+
+ \end{description}
+
+ where \verb+...+ is the translation. The \verb+2a+ code is used before the
+ first argument, \verb+2b+ between the two arguments and \verb+2c+ is
+ typeset after the second argument is set.
+\item The file \File{latex2man.trans} contains some example code.
+\end{itemize}
+
+\subsection{Verbatim Environment}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{verbatim}
+This
+ {is}
+ \texttt{a}
+ $test$
+ _of_
+verbatim
+<this is no HTML tag> and no @* TexInfo command
+\end{verbatim}
+
+\subsection{Subsection works}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+This is a \verb+\subsection+.
+
+\subsubsection{Subsubsection works}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+This is a \verb+\subsubsection+.
+
+\subsubsection{Subsubsection still works}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+This is another \verb+\subsubsection+.
+
+
+\subsection{General Remarks}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{enumerate}\setlength{\itemsep}{0cm}
+\item Empty lines are typeset as paragraph separators.
+\item The arguments of the \LaTeX\ commands must not be split over several
+ lines.
+\item Do not nest calls to macros.
+\item Except the mentioned environment and macros, the usage of other \LaTeX\
+ environments or macros are not translated. Their usage will cause garbage
+ in the output.
+\item \Prog{latex2man} requires Perl version $>=$ 5.0004\_03.
+\item If you want to install the system with the distributed \File{Makefile},
+ you need GNU-\Prog{make}. If you don't have it, you should execute the
+ steps shown in the \File{Makefile} manually.
+\end{enumerate}
+
+\subsection{Some Bug Fix Tests}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% TODO: HTML: a blank line after \begin{description} should not emit a <p>
+\begin{description}
+\item[Leading . and ']
+%%%%%%%%%%%%%%%%%%%%%%
+Now leading . and ' in generation troff output should work propperly,
+since a \verb+\&+ is added. Therfore the \verb+\Dot+ macro has been deleted.\\
+Thanks to \Email{Frank.Schilder@Mathematik.Tu-Ilmenau.De}.\\
+Testcase 1:
+\begin{description}
+\item['\Bs n'] ...
+\end{description}
+Testcase 2:\\
+\File{.foobar}
+Testcase 3:\\
+\Dots
+
+abc \Dots abc . efg ' 123
+
+\item[\% in verbatim] A \% in a \Bs verb and verbatim-environment was not
+ emitted correctly. Thanks to Aleksey Nogin \Email{nogin@cs.caltech.edu}
+ for the bug report and bug fix.
+
+\verb+ % abc+
+
+\begin{verbatim}
+ % abc %
+\end{verbatim}
+
+but ignore comments following this: % this should be ignored
+
+\end{description}
+
+\section{Requirements}
+%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{description}\setlength{\itemsep}{0cm}
+\item[Perl] \Prog{latex2man} requires Perl version $>=$ 5.0004\_03.
+\item[Make] If you want to install the system with the distributed
+ \File{Makefile}, you need GNU-\Prog{make}. If you don't have it, you
+ should execute the steps shown in the \File{Makefile} manually.
+\item[\LaTeX] \LaTeX 2e is required.
+\end{description}
+
+\section{Changes}
+%@% IF LATEX %@%
+{\small\verbatiminput{CHANGES}}
+%@% ELSE %@%
+Please check the file \URL{latex2man-CHANGES} for the list of changes.
+%@% END-IF %@%
+
+\section{Version}
+%%%%%%%%%%%%%%%%%
+
+Version: \Version\ of \Date.
+
+\section{License and Copyright}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{description}
+\item[Copyright] \copyright\ 1998, Dr.~Jürgen Vollmer, Viktoriastraße 15,
+ D-76133 Karlsruhe, Germany, \Email{Juergen.Vollmer@informatik-vollmer.de}
+
+
+ The actual version of \Prog{Latex2man} may be found on my homepage\\
+ \URL{http://www.informatik-vollmer.de/software/latex2man.html}.
+
+\item[License] This program can be redistributed and/or modified under the
+ terms of the LaTeX Project Public License Distributed from CTAN archives
+ in directory \File{macros/latex/base/lppl.txt}; either version 1 of the
+ License, or any later version.
+
+\item[Misc] If you find this software useful, please send me a postcard from
+ the place where you are living.
+\end{description}
+
+\section{Author}
+%%%%%%%%%%%%%%%%
+
+\noindent
+Dr.~Jürgen Vollmer \\
+Viktoriastraße 15 \\
+D-76133 Karlsruhe \\
+Email: \Email{Juergen.Vollmer@informatik-vollmer.de} \\
+WWW: \URL{http://www.informatik-vollmer.de}.
+
+\LatexManEnd
+
+\end{document}
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.texi b/Master/texmf-dist/doc/support/latex2man/latex2man.texi
new file mode 100644
index 00000000000..0614458666d
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.texi
@@ -0,0 +1,1005 @@
+\input texinfo @c -*-texinfo-*-
+@c %**start of header
+@setfilename latex2man.info
+@settitle latex2man
+@c %**end of header
+@c Manual page created with latex2man on Di 11. Nov 08:21:27 CET 2008>
+@c NOTE: This file is generated, DO NOT EDIT.
+@dircategory Man-pages
+@direntry
+* Latex2man: (latex2man). Its Man-Page
+@end direntry
+@titlepage
+@title latex2man
+@subtitle Documentation Tools
+@author Dr.~J@"urgen Vollmer
+@end titlepage
+@node Top, Description, (dir), (dir)
+@top latex2man
+
+Latex2man
+is a tool to translate UNIX manual pages written with
+LaTeXinto a format understood by the UNIX man(1)-command.
+Alternatively HTML, TexInfo, or LaTeX code can be produced too.
+Output of parts of the text may be suppressed using the conditional text
+feature (for this, LaTeX generation may be used).
+
+@section Synopsis
+
+
+latex2man
+[ -t@var{transfile} ]
+[ -HMTL ]
+[ -h ]
+[ -V ]
+[ -C@var{name} ]
+@*
+[ -a@var{char} ]
+@var{infile}
+@var{outfile}
+
+@menu
+* Description::
+* Options::
+* Files::
+* See Also::
+* LaTeX commands::
+* Package Options::
+* Package Specific Environments::
+* Accepted LaTeX Environments::
+* Package Specific Macros::
+* Accepted Macros from the rcsinfo Package::
+* Accepted LaTeX Macros::
+* Conditional Text::
+* Translation of User Defined Macros::
+* Verbatim Environment::
+* Subsection works::
+* Subsubsection works::
+* Subsubsection still works::
+* General Remarks::
+* Some Bug Fix Tests::
+* Requirements::
+* Changes::
+* Version::
+* License and Copyright::
+* Author::
+@end menu
+@node Description, Options, Top, Top
+@section Description
+
+Latex2man
+reads the file @var{infile}
+and writes @var{outfile}.
+The
+input must be a LaTeX document using the latex2man
+LaTeXpackage.
+Latex2man
+translates that document into the troff(1)
+format using
+the -man
+macro package.
+
+Using the -H
+option, HTML code can be produced, instead of
+troff(1).
+
+Using the -T
+option, TexInfo code can be produced, instead of
+troff(1).
+
+Using the -M
+option, troff(1)
+input is produced.
+
+Using the -L
+option, LaTeX ouput can be produced, instead of
+troff(1).
+
+@node Options, Files, Description, Top
+@section Options
+
+@table @samp
+@item -t@var{transfile}
+Translation for user defined LaTeX macros.
+@item -M
+Produce output suitable for the man(1)
+command (default).
+@item -H
+Instead of producing output suitable for the man(1)
+command, HTML code is produced (despite the name of the command).
+@item -T
+Instead of producing output suitable for the man(1)
+command, TexInfo code is produced (despite the name of the command). The
+generated @file{.texi}-file
+may be processed with makeinfo(1)
+(to produce an @file{.info}-file)
+which in turn may be installed using
+install-info(1).
+The Info tags @t{@@dircategory} and
+@t{@@direntry} are provided.
+@item -L
+The LaTeX source is written to the @var{outfile}.
+This is
+useful in conjunction with the -C@var{name}
+option.
+@item -C@var{name}
+Output the conditional text for @var{name}.
+If more
+than one name should be given use quotes: -C@var{'name1 name2 ...'}@*
+
+The following names are defined automatically:
+@itemize @bullet
+@item
+-H defines @t{HTML}
+@item
+-T defines @t{TEXI}
+@item
+-M defines @t{MAN}
+@item
+-L defines @t{LATEX}
+@end itemize
+@item -a@var{char}
+Is used only in conjunction with -T.@*
+
+Background:@*
+
+TexInfo ignores all blanks before the first word on a new line. In order
+to produce some additional space before that word (using \SP) some
+character has to be printed before the additional space. By default this
+is a . (dot). The @var{char}
+specifies an alternative for that first
+character. Giving a blank to
+-a
+supresses the indentation of a line.@*
+
+Note: only for the first \SP of a series that @var{char}
+is printed.
+@item -h
+Show a help text.
+@item -V
+Show version information.
+@end table
+
+@node Files, See Also, Options, Top
+@section Files
+
+
+@table @samp
+@item @file{latex2man.tex}
+The LaTeX file containing this Man-page.
+@item @file{latex2man.sty}
+The LaTeX package defining the environments and
+commands.
+@item @file{latex2man.cfg}
+The configuration file for Latex2man
+LaTeX-package.
+@item @file{latex2man.trans}
+File containing example translations of user
+defined LaTeX macros.
+@item @file{fancyheadings.sty}
+A LaTeX package used to typeset head- and
+foot lines.
+@item @file{fancyhdr.sty}
+A LaTeX package used to typeset head- and foot
+lines.
+@item @file{rcsinfo.sty}
+A LaTeX package used to extract and use RCS version
+control information in LaTeX documents.
+@end table
+
+@node See Also, LaTeX commands, Files, Top
+@section See Also
+
+
+LaTeX,TexInfo, troff(1),
+groff(1),
+makeinfo(1).
+
+@node LaTeX commands, Package Options, See Also, Top
+@section LaTeX commands
+
+
+The LaTeX package @t{latex2man}
+is used to write the Man-pages with
+LaTeX.Since we translate into other text formats, not all LaTeX stuff can
+be translated.
+
+@node Package Options, Package Specific Environments, LaTeX commands, Top
+@subsection Package Options
+
+The @t{latex2man}
+package accepts the following options:
+
+@table @samp
+@item fancy
+use the LaTeX package @t{fancyheadings}.
+@item fancyhdr
+use the LaTeX package @t{fancyhdr}.
+@item nofancy
+neither the LaTeX package @t{fancyheadings}
+nor
+@t{fancyhdr}
+are used.
+@end table
+
+The default option may be specified in the file @t{latex2man.cfg}.
+
+@node Package Specific Environments, Accepted LaTeX Environments, Package Options, Top
+@subsection Package Specific Environments
+
+
+The following environments are provided by the package:
+@table @samp
+@item \begin@{Name@}@{chapter@}@{name@}@{author@}@{info@}@{title@}
+The
+@t{Name}
+environment takes five arguments: 1. the Man-page chapter,
+2. the name of the Man-page, 3. the author, 4. some short information
+about the tool printed in the footline of the Man-page, and 5. a text
+which is used as title, for HTML and LaTeX (it's ignored for output of
+the Man-page or TeXinfo. The @t{Name}
+environment must be the first
+environment in the document. Processing starts with this environment. Any
+text before this is ignored (exception: the @t{setVersion} and
+@t{setDate} commands). (Note: all arguments of \begin@{Name@} must
+be written on one line).
+@item \begin@{Table@}[width]@{columns@}
+The @t{Table}
+environment takes two arguments: the first optional one specifies
+a width of the last column, the second one gives the number of columns.
+For example:
+
+@t{\begin@{Table@}[2cm]@{3@}} @*
+
+@t{Here & am & I \\\hline} @*
+
+@t{A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\} @*
+
+@t{B 1 & B 2 & B 3 \\} @*
+
+@t{\end@{Table@}}
+
+will be typeset as:
+
+@multitable @columnfractions 0.3 0.3 0.3
+@item Here @tab am @tab I
+
+@item
+A 1 @tab A 2 @tab A 3 1 2 3 4 5 A 3 1 2 3 4 5
+
+@item B 1 @tab B 2 @tab B 3
+
+@end multitable
+
+If no optional @emph{width}
+argument is given, all entries are
+typeset left justified.
+The @emph{width}
+is a length measured absolutly in @emph{cm}.
+Processing with LaTeX a @t{p@{width@}} column is typeset
+as last column. The translation to troff(1)
+commands
+results in a @t{lw(width)}
+column specification. Translating
+to HTML and TexInfo ignores the @emph{width}
+parameter.
+
+@t{\hline} may be used.
+
+If the Man-page is formatted with troff(1)
+and tables are used, the
+tbl(1)
+preprocessor should be called, usually by giving
+a -t
+to the call of troff(1).
+When viewing the generated
+manula page using man(1),
+tbl(1)
+is called automatically.
+@item \begin@{Description@}
+is the same as \begin@{description@}
+@item \begin@{Description@}[label]
+is similar to
+\begin@{description@}, but the item labels have at minimum the size
+of the (optional) word @emph{label}.
+The difference is visible only
+in the DVI and PDF-output, not in the troff, TexInfo or HTML output.
+@table @samp
+@item a
+|a @t{\begin@{description@}}
+@item ab
+|ab
+@item abc
+|abc
+@end table
+@table @samp
+@item a
+|a @t{\begin@{Description@}}
+@item ab
+|ab
+@item abc
+|abc
+@end table
+@table @samp
+@item a
+|a @t{\begin@{Description@}[aa]}
+@item ab
+|ab
+@item abc
+|abc
+@end table
+@end table
+
+@node Accepted LaTeX Environments, Package Specific Macros, Package Specific Environments, Top
+@subsection Accepted LaTeX Environments
+
+
+The following environments are accepted:
+@itemize @bullet
+@item
+@t{description}
+@item
+@t{enumerate}
+@item
+@t{itemize}
+@item
+@t{verbatim}
+@item
+@t{center}
+@end itemize
+
+They may be nested:
+@itemize @bullet
+@item
+Itemize and nested center:
+
+@center A centered line.@*
+@center Another centered line.
+@center
+@item
+Another item an nested enumerate
+@enumerate
+@item
+a
+@item
+b
+@end enumerate
+@end itemize
+
+@node Package Specific Macros, Accepted Macros from the rcsinfo Package, Accepted LaTeX Environments, Top
+@subsection Package Specific Macros
+
+
+The following commands are provided:
+@table @samp
+@item \Opt@{option@}
+Option: @t{\Opt@{-o@}} will be typeset as -o.
+@item \Arg@{argument@}
+Argument: @t{\Arg@{filename@}} will be typeset as
+@var{filename}.
+@item \OptArg@{option@}@{argument@}
+Option with Argument:@*
+
+@t{\OptArg@{-o@}@{filename@}} will be typeset as -o@var{filename}.
+@item \OptoArg@{option@}@{argument@}
+Option with optional Argument:@*
+
+@t{\OptoArg@{-o@}@{filename@}} will be
+typeset as -o[@var{filename}].
+@item \oOpt@{option@}
+Optional option, e.g. @t{\oOpt@{-o@}} will be
+typeset as [ -o ].
+@item \oArg@{argument@}
+Optional argument, e.g. @t{\oArg@{filename@}}
+will be typeset as [ @var{filename} ].
+@item \oOptArg@{option@}@{argument@}
+Optional option with argument, e.g.@*
+
+@t{\oOptArg@{-o@}@{filename@}} will be typeset as [ -o@var{filename} ].
+@item \oOptoArg@{option@}@{argument@}
+Optional option with optional
+argument, e.g.
+@t{\oOptoArg@{-o@}@{filename@}} will be typeset as [ -o[@var{filename}] ].
+@item \File@{filename@}
+used to typeset filenames, e.g.
+@t{\File@{filename@}} will be typeset as @file{filename}.
+@item \Prog@{prog@}
+used to typeset program names, e.g.
+@t{\Prog@{latex2man@}} will be typeset as latex2man.
+@item \Cmd@{command@}@{chapter@}
+used to typeset references to other
+commands, e.g. @t{\Cmd@{latex2man@}@{1@}} will be typeset as
+latex2man(1).
+@item \Bar
+is typeset as |.
+@item \Bs
+(BackSlash) is typeset as \.
+@item \Tilde
+is typeset as a ~.
+@item \Dots
+is typeset as ...
+@item \Bullet
+us typeset as *.
+@item \setVersion@{..@}
+set @t{..} as version information.
+@item \setVersionWord@{..@}
+set @t{..} for the word @emph{Version:}
+in
+the footline. The default is @t{\setVersionWord@{Version:@}}.
+@item \Version
+returns the version information.
+@item \setDate@{..@}
+sets @t{..} as date information.
+@item \Date
+returns the date information.
+@item \Email@{..@}
+use to mark an Email address:@*
+
+@t{\Email@{Juergen.Vollmer@@informatik-vollmer.de@}} is typeset as:@*
+
+@email{Juergen.Vollmer@@informatik-vollmer.de}.
+@item \URL@{..@}
+use to mark an URL:
+@t{\URL@{http://www.foo.de/\Tilde vollmer@}} is typeset as
+@url{http://www.foo.de/~vollmer}.
+@item \LatexManEnd
+the input file is read and processed until reading
+end-of-file or @t{\LatexManEnd} (at the beginning of a line).
+LaTeXignores this command.
+@item \Lbr, \Rbr
+is typeset as [ and ] (these variants are
+needed only somtimes like in @t{item[FooBar\LBr xx \Lbr]}. Usually
+@t{[ ]} will work.
+@item \LBr, \RBr
+is typeset as @{ and @} (these variants are
+needed when using @{ or @} as arguments to macros.
+@item \Circum
+is typeset as ^.
+@item \Percent
+is typeset as %.
+@item \TEXbr
+If processed with LaTeX causes a linebreak (i.e. is
+equivalent to \\).In the output of latex2man
+this macro is
+ignored.
+@item \TEXIbr
+If TexInfo output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+@item \MANbr
+If Man-Page output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+@item \HTMLbr
+If HTML output is generated, causes a linebreak (i.e. is
+equivalent to \\),otherwise ignored.
+@item \medskip
+An empty line.
+@item \SP
+Produces some extra space, works also at the beginning of lines.
+The code of the second line looks like:
+@t{\SP abc \SP\SP xx\\}:@*
+
+abc @ @ @ @ @ @ xx@*
+
+.@ abc @ @ @ @ xx@*
+
+.@ .@ abc @ @ xx
+
+Note: Due to some ``problems'' with TexInfo, the lines starting with
+@t{\SP}
+have a leading . (dot) in the TexInfo output,
+see -a@var{char}.
+@end table
+
+@node Accepted Macros from the rcsinfo Package, Accepted LaTeX Macros, Package Specific Macros, Top
+@subsection Accepted Macros from the rcsinfo Package
+
+
+@table @samp
+@item \rcsInfo $Id ...$
+if the LaTeX package @file{rcsinfo}
+is used,
+this command is used to extract the date of the Man-page.
+@item \rcsInfoLongDate
+if the LaTeX package @file{rcsinfo}
+is used, this
+command is used to typeset the date coded in the @t{$Id ..$} string.
+@end table
+
+@node Accepted LaTeX Macros, Conditional Text, Accepted Macros from the rcsinfo Package, Top
+@subsection Accepted LaTeX Macros
+
+
+The following standard LaTeX commands are accepted:
+@table @samp
+@item \section@{..@}
+The @t{section}
+macro takes one argument: the
+name of the Man-page section. Each Man-page consists of several sections.
+Usually there are the following sections in a Man-page: @emph{Name}
+(special handling as environment, c.f. above), @emph{Synopsis},
+@emph{Description},
+@emph{Options},
+@emph{Files},
+@emph{See Also},
+@emph{Diagnostics},
+@emph{Return Values},
+@emph{Bugs},
+@emph{Author},
+@emph{version},
+etc.
+
+@emph{Synopsis}
+must be the first section after the @t{Name}
+environment.
+
+Note: Do not use LaTeX-macrosin section names.
+@item \subsection@{..@}
+works as well as
+@item \subsubsection@{..@}
+those.
+@item \emph@{..@}
+@t{\emph@{example@}} is typeset as @emph{example}.
+@item \textbf@{..@}
+@t{\textbf@{example@}} is typeset as @strong{example}.
+@item \texttt@{..@}
+@t{\textt@{example@}} is typeset as @t{example}.
+@item \underline@{..@}
+@t{\underline@{example@}} is typeset as
+example of underline.
+@item \date@{..@}
+uses @t{..} as date.
+@item \verb+..+
+but only + is allowed as delimiter.
+@item $<$
+is typeset as <.
+@item $>$
+is typeset as >.
+@item $<=$
+is typeset as <=.
+@item $>=$
+is typeset as >=.
+@item $=$
+is typeset as =.
+@item $<>$
+is typeset as <>.
+@item $\ge$
+is typeset as $>=$.
+@item $\le$
+is typeset as $<=$.
+@item $\leftarrow$
+is typeset as $<--$.
+@item $\Leftarrow$
+is typeset as $<==$.
+@item $\rightarrow$
+is typeset as $-->$.
+@item $\Rightarrow$
+is typeset as $==>$.
+@item \@{
+is typeset as @{.
+@item \@}
+is typeset as @}.
+@item \$
+is typeset as $.
+@item \$
+is typeset as $,should be used inside macro
+arguments.
+@item \_
+is typeset as _.
+@item \&
+is typeset as &.
+@item \#
+is typeset as #.
+@item \%
+is typeset as %.
+@item \,
+is typeset as smaller blank - - (between the two -)
+@item \-
+is used to mark hyphenation in a word.
+@item \\
+is typeset as a linebreak or marks the end of a column in the
+@t{Table}
+environment.
+@item \
+(a \ followed by a blank) is typeset as a blank,
+although it cannot be used at the beginning of a line to make indentation
+(see the @t{\SP}
+command).
+@item ~
+is typeset as a blank.
+@item \copyright
+is typeset as @copyright{}.
+@item \noindent
+@item \hline
+inside a @t{Table}
+environment.
+@item \item
+inside a @t{itemize},
+@t{enumerate},
+or
+@t{description}
+environment.
+@item \today
+11 November 2008(see also the @t{rcsinfo}
+LaTeXpackage).
+@item \ss,\"a, ...
+\ss = @ss{}, \"a= @"a, \"o= @"o, \"u= @"u,
+\"A= @"A, \"O= @"O, \"U= @"U. It is allowed to surround these
+macros in @{ and @} in all places, even inside other macros, e.g.
+@*
+.@ @ @ @ @ \textbf@{\"a\"o\"u\"A\"O\"U\ss@}@*
+.@ @ @ @ @ \textbf@{\"a@}@{\"o@}@{\"u@}@{\"A@}@{\"O@}@{\"U@}@{\ss@}@}@*
+.@ @ @ @ @ \textbf@{äöüÄÖÜß@}@*
+
+@strong{@"a@"o@"u@"A@"O@"U@ss{} @"a@"o@"u@"A@"O@"U@ss{} @"a@"o@"u@"A@"O@"U@ss{}}
+
+If these letters are used in their LATIN-1 8-bit coding, they are
+translated into the equivalent letter of the desired output format.
+E.g. @t{@"A}
+becomes @t{&Auml};
+in HTML and @t{@@"A}
+in texinfo.
+@end table
+
+@node Conditional Text, Translation of User Defined Macros, Accepted LaTeX Macros, Top
+@subsection Conditional Text
+
+
+latex2man
+preprocesses the LaTeX input to allow text to be used
+conditionally. A special sort of LaTeX comment is used for that purpose.
+@itemize @bullet
+@item
+%@@% IF @emph{condition} %@@%
+@item
+%@@% ELSE %@@%
+@item
+%@@% END-IF %@@%
+@end itemize
+
+A line must contain only such a comment and nothing else. @emph{condition}
+is
+a boolean expression containing ``names'' and operators. The names given with
+the -C@var{name}
+option have the value ``true'', while all other names
+occuring in the expression are assumed to be ``false''. If the evaluation of
+the boolean expression results in the value ``true'', the text in the
+``then''-part is used and the text in the optional ``else''-part is skipped
+(and vice versa). The @t{IF/ELSE/END-IF}
+may be nested. As boolean
+operators the following are allowed:
+
+@multitable @columnfractions 0.45 0.45
+@item ||@tab boolean or
+
+@item && @tab boolean and
+
+@item ! @tab negation
+@end multitable
+
+( and ) for grouping are allowed.
+
+@noindent
+
+For example:@*
+
+%@@% IF abc %@@%@*
+
+@t{}abc set@*
+
+@t{}%@@% IF xyz %@@%@*
+
+@t{}xyz set@*
+
+@t{}%@@% ELSE %@@%@*
+
+@t{}xyz NOT set@*
+
+@t{}%@@% END-IF %@@%@*
+
+%@@% ELSE %@@%@*
+
+@t{}abc NOT set@*
+
+@t{}%@@% IF xyz || !XYZ %@@%@*
+
+@t{}xyz OR !XYZ set@*
+
+@t{}%@@% ELSE %@@%@*
+
+@t{}xyz OR !XYZ NOT set@*
+
+@t{}%@@% END-IF %@@%@*
+
+%@@% END-IF %@@%
+
+@noindent
+
+Run this manual page through latex2man
+with e.g.
+-C@var{'abc XYZ'}
+and have a look to the generated output.
+(If simply running the LaTeX-document through LaTeX,all lines are shown in the
+.dvi file).@*
+
+abc NOT set@*
+
+xyz OR !XYZ set@*
+
+
+@noindent
+
+To check the conditional text feature, when latex2man
+is called with
+@table @samp
+@item -C@var{HTML}
+the lines 1a, 2b, 3b, and 4b;
+@item -C@var{TEXI}
+the lines 1b, 2a, 3b, and 4b;
+@item -C@var{MAN}
+the lines 1b, 2b, 3a, and 4b;
+@item -C@var{LATEX}
+the lines 1b, 2b, 3b, and 4a;
+@item calling LaTeX without preprocessing
+all lines
+@end table
+should be shown:
+
+1b. The HTML conditional was not set.
+
+2a. This text occurs only when viewing the TEXI output
+
+3b. The MAN conditional was not set.
+
+4b. The LATEX conditional was not set.
+
+@node Translation of User Defined Macros, Verbatim Environment, Conditional Text, Top
+@subsection Translation of User Defined Macros
+
+
+The user macro translation file (given by the [ -t@var{transfile} ])
+contains
+Perl
+commands specifying the translation of LaTeX macros defined by
+the user. These macros may have none, one or two arguments. The following code
+is expected:
+
+@itemize @bullet
+@item
+Comments start with a # up to the end of the line.
+@item
+For a macro @t{\foo} with no arguments, the following code must be
+specified:
+@table @samp
+@item Translation to Man-Pages
+@t{$manMacro@{'foo'@} = '...';}
+@item Translation to HTML
+@t{$htmlMacro@{'foo'@} = '...';}
+@item Translation to TexInfo
+@t{$texiMacro@{'foo'@} = '...';}
+@end table
+
+where @t{...} is the translation.
+
+@item
+For a macro @t{\foo@{..@}} with one argument, the following code must be
+specified:
+@table @samp
+@item Translation to Man-Pages
+@t{$manMacro1a@{'foo'@} = '...';}@*
+
+@t{$manMacro1b@{'foo'@} = '...';}
+@item Translation to HTML
+@t{$htmlMacro1a@{'foo'@} = '...';}@*
+
+@t{$htmlMacro1b@{'foo'@} = '...';}
+
+@item Translation to TexInfo
+@t{$texiMacro1a@{'foo'@} = '...';}@*
+
+@t{$texiMacro1b@{'foo'@} = '...';}
+@end table
+
+where @t{...} is the translation. The @t{1a} code is used before the
+argument, while @t{1b} is typeset after the argument is set.
+
+@item
+For a macro @t{\foo@{..@}@{..@}} with two arguments, the following code
+must be specified:
+@table @samp
+@item Translation to Man-Pages
+@t{$manMacro2a@{'foo'@} = '...';}@*
+
+@t{$manMacro2b@{'foo'@} = '...';}@*
+
+@t{$manMacro2c@{'foo'@} = '...';}
+@item Translation to HTML
+@t{$htmlMacro2a@{'foo'@} = '...';}@*
+
+@t{$htmlMacro2b@{'foo'@} = '...';}@*
+
+@t{$htmlMacro2c@{'foo'@} = '...';}
+@item Translation to TexInfo
+@t{$texiMacro2a@{'foo'@} = '...';}@*
+
+@t{$texiMacro2b@{'foo'@} = '...';}@*
+
+@t{$texiMacro2c@{'foo'@} = '...';}
+@end table
+
+where @t{...} is the translation. The @t{2a} code is used before the
+first argument, @t{2b} between the two arguments and @t{2c} is
+typeset after the second argument is set.
+@item
+The file @file{latex2man.trans} contains some example code.
+@end itemize
+
+@node Verbatim Environment, Subsection works, Translation of User Defined Macros, Top
+@subsection Verbatim Environment
+
+
+@*
+.This@*
+.@ @ @ @ @{is@}@*
+.@ @ @ @ @ @ @ @ \texttt@{a@}@*
+.@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ $test$@*
+.@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ _of_@*
+.verbatim@*
+.<this@ is@ no@ HTML@ tag>@ and@ no@ @@*@ TexInfo@ command@*
+
+@node Subsection works, Subsubsection works, Verbatim Environment, Top
+@subsection Subsection works
+
+
+This is a @t{\subsection}.
+
+@node Subsubsection works, Subsubsection still works, Subsection works, Top
+@subsubsection Subsubsection works
+
+
+This is a @t{\subsubsection}.
+
+@node Subsubsection still works, General Remarks, Subsubsection works, Top
+@subsubsection Subsubsection still works
+
+
+This is another @t{\subsubsection}.
+
+@node General Remarks, Some Bug Fix Tests, Subsubsection still works, Top
+@subsection General Remarks
+
+
+@enumerate
+@item
+Empty lines are typeset as paragraph separators.
+@item
+The arguments of the LaTeX commands must not be split over several
+lines.
+@item
+Do not nest calls to macros.
+@item
+Except the mentioned environment and macros, the usage of other LaTeX
+environments or macros are not translated. Their usage will cause garbage
+in the output.
+@item
+latex2man requires Perl version >= 5.0004_03.
+@item
+If you want to install the system with the distributed @file{Makefile},
+you need GNU-make.
+If you don't have it, you should execute the
+steps shown in the @file{Makefile}
+manually.
+@end enumerate
+
+@node Some Bug Fix Tests, Requirements, General Remarks, Top
+@subsection Some Bug Fix Tests
+
+
+@table @samp
+@item Leading . and '
+Now leading . and ' in generation troff output should work propperly,
+since a @t{\&} is added. Therfore the @t{\Dot} macro has been deleted.@*
+
+Thanks to @email{Frank.Schilder@@Mathematik.Tu-Ilmenau.De}.@*
+
+Testcase 1:
+@table @samp
+@item '\n'
+...
+@end table
+Testcase 2:@*
+
+@file{.foobar}
+Testcase 3:@*
+
+...
+abc ...abc . efg ' 123
+
+@item % in verbatim
+A % in a \verb and verbatim-environment was not
+emitted correctly. Thanks to Aleksey Nogin @email{nogin@@cs.caltech.edu}
+for the bug report and bug fix.
+
+@t{% abc}
+
+@*
+.@ @ @ %@ abc@ %@*
+
+but ignore comments following this:
+
+@end table
+
+@node Requirements, Changes, Some Bug Fix Tests, Top
+@section Requirements
+
+
+@table @samp
+@item Perl
+latex2man
+requires Perl version >= 5.0004_03.
+@item Make
+If you want to install the system with the distributed
+@file{Makefile},
+you need GNU-make.
+If you don't have it, you
+should execute the steps shown in the @file{Makefile}
+manually.
+@item LaTeX
+LaTeX2e is required.
+@end table
+
+@node Changes, Version, Requirements, Top
+@section Changes
+
+Please check the file @url{latex2man-CHANGES}
+for the list of changes.
+
+@node Version, License and Copyright, Changes, Top
+@section Version
+
+
+Version: 1.23 of 2008/11/11.
+
+@node License and Copyright, Author, Version, Top
+@section License and Copyright
+
+
+@table @samp
+@item Copyright
+@copyright{}1998, Dr. J@"urgen Vollmer, Viktoriastra@ss{}e 15,
+D-76133 Karlsruhe, Germany, @email{Juergen.Vollmer@@informatik-vollmer.de}
+
+The actual version of Latex2man
+may be found on my homepage@*
+
+@url{http://www.informatik-vollmer.de/software/latex2man.html}.
+
+@item License
+This program can be redistributed and/or modified under the
+terms of the LaTeX Project Public License Distributed from CTAN archives
+in directory @file{macros/latex/base/lppl.txt};
+either version 1 of the
+License, or any later version.
+
+@item Misc
+If you find this software useful, please send me a postcard from
+the place where you are living.
+@end table
+
+@node Author, , License and Copyright, Top
+@section Author
+
+
+@noindent
+
+Dr. J@"urgen Vollmer @*
+
+Viktoriastra@ss{}e 15 @*
+
+D-76133 Karlsruhe @*
+
+Email: @email{Juergen.Vollmer@@informatik-vollmer.de}
+@*
+WWW: @url{http://www.informatik-vollmer.de}.
+
+@bye
+@c NOTE: This file is generated, DO NOT EDIT.
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.trans b/Master/texmf-dist/doc/support/latex2man/latex2man.trans
new file mode 100644
index 00000000000..2b77cc2fc21
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.trans
@@ -0,0 +1,67 @@
+#################################################################################
+# Project: Documentation Tools
+# Descr: Latex --> MAN-page (groff -man), and HTML; example of user macro
+# translations
+# Author: Dr. Jürgen Vollmer, Juergen.Vollmer@acm.org
+# $Id: latex2man.trans,v 1.2 1998/01/03 17:06:52 vollmer Exp $
+#################################################################################
+
+#################################################################################
+# translation for MAN
+#################################################################################
+
+# LaTeX macros without arguments
+$manMacro{'LaTeX'} = 'LaTeX';
+$manMacro{'LATEX'} = 'LaTeX'; # needed, since \LaTeX is contained in a
+ # section name (which are transposed
+ # into uppercase
+
+# LaTeX macros with one argument
+$manMacro1a{'myEmph'} = '\n.IR "'; $manMacro1b{'myEmph'} = '"';
+
+# LaTeX macros with two arguments
+$manMacro2a{'myCmd'} = '\n.I "';
+ $manMacro2b{'myCmd'} = '"\n(';
+ $manMacro2c{'myCmd'} = ')';
+
+#################################################################################
+# translation for HTML
+#################################################################################
+
+# LaTeX macros without arguments
+$htmlMacro{'LaTeX'} = 'LaTeX';
+$htmlMacro{'LATEX'} = 'LaTeX'; # needed, since \LaTeX is contained in a
+ # section name (which are transposed
+ # into uppercase
+
+# LaTeX macros with one argument
+$htmlMacro1a{'myEmph'} = '<em>'; $htmlMacro1b{'myEmph'} = '</em>';
+
+# LaTeX macros with two arguments
+$htmlMacro2a{'Cmymd'} = '<em>';
+ $htmlMacro2b{'myCmd'} = '</em>(';
+ $htmlMacro2c{'myCmd'} = ')';
+
+#################################################################################
+# translation for TexInfo
+#################################################################################
+
+# LaTeX macros without arguments
+$texiMacro{'LaTeX'} = 'LaTeX';
+$texiMacro{'LATEX'} = 'LaTeX'; # needed, since \LaTeX is contained in a
+ # section name (which are transposed
+ # into uppercase
+
+# LaTeX macros with one argument
+$texiMacro1a{'myEmph'} = '@emph{'; $texiMacro1b{'myEmph'} = '}';
+
+# LaTeX macros with two arguments
+$texiMacro2a{'Cmymd'} = '';
+ $texiMacro2b{'myCmd'} = ' (';
+ $texiMacro2c{'myCmd'} = ')';
+
+#################################################################################
+## emacs variables
+## Local Variables: ***
+## mode: perl ***
+## End: ***
diff --git a/Master/texmf-dist/doc/support/latex2man/latex2man.txt b/Master/texmf-dist/doc/support/latex2man/latex2man.txt
new file mode 100644
index 00000000000..2ded2fa1000
--- /dev/null
+++ b/Master/texmf-dist/doc/support/latex2man/latex2man.txt
@@ -0,0 +1,758 @@
+LATEX2MAN(1) Documentation Tools LATEX2MAN(1)
+
+
+
+NAME
+ Latex2man is a tool to translate UNIX manual pages written with LaTeX-
+ into a format understood by the UNIX man(1)-command. Alternatively
+ HTML, TexInfo, or LaTeX code can be produced too. Output of parts of
+ the text may be suppressed using the conditional text feature (for
+ this, LaTeX generation may be used).
+
+
+SYNOPSIS
+ latex2man [-ttransfile] [-HMTL] [-h] [-V] [-Cname] [-achar] infile out-
+ file
+
+
+DESCRIPTION
+ Latex2man reads the file infile and writes outfile. The input must be
+ a LaTeX document using the latex2man LaTeXpackage. Latex2man trans-
+ lates that document into the troff(1) format using the -man macro pack-
+ age.
+
+ Using the -H option, HTML code can be produced, instead of troff(1).
+
+ Using the -T option, TexInfo code can be produced, instead of troff(1).
+
+ Using the -M option, troff(1) input is produced.
+
+ Using the -L option, LaTeX ouput can be produced, instead of troff(1).
+
+
+OPTIONS
+ -ttransfile
+ Translation for user defined LaTeX macros.
+
+ -M Produce output suitable for the man(1) command (default).
+
+ -H Instead of producing output suitable for the man(1) command,
+ HTML code is produced (despite the name of the command).
+
+ -T Instead of producing output suitable for the man(1) command,
+ TexInfo code is produced (despite the name of the command). The
+ generated .texi-file may be processed with makeinfo(1) (to pro-
+ duce an .info-file) which in turn may be installed using
+ install-info(1). The Info tags @dircategory and @direntry are
+ provided.
+
+ -L The LaTeX source is written to the outfile. This is useful in
+ conjunction with the -Cname option.
+
+ -Cname Output the conditional text for name. If more than one name
+ should be given use quotes: -C'name1 name2 ...'
+ The following names are defined automatically:
+
+ * -H defines HTML
+
+ * -T defines TEXI
+
+ * -M defines MAN
+
+ * -L defines LATEX
+
+
+ -achar Is used only in conjunction with -T.
+ Background:
+ TexInfo ignores all blanks before the first word on a new line.
+ In order to produce some additional space before that word
+ (using \SP) some character has to be printed before the addi-
+ tional space. By default this is a . (dot). The char specifies
+ an alternative for that first character. Giving a blank to -a
+ supresses the indentation of a line.
+ Note: only for the first \SP of a series that char is printed.
+
+ -h Show a help text.
+
+ -V Show version information.
+
+
+FILES
+ latex2man.tex
+ The LaTeX file containing this Man-page.
+
+ latex2man.sty
+ The LaTeX package defining the environments and commands.
+
+ latex2man.cfg
+ The configuration file for Latex2man LaTeX-package.
+
+ latex2man.trans
+ File containing example translations of user defined LaTeX
+ macros.
+
+ fancyheadings.sty
+ A LaTeX package used to typeset head- and foot lines.
+
+ fancyhdr.sty
+ A LaTeX package used to typeset head- and foot lines.
+
+ rcsinfo.sty
+ A LaTeX package used to extract and use RCS version control
+ information in LaTeX documents.
+
+
+SEE ALSO
+ LaTeX,TexInfo, troff(1), groff(1), makeinfo(1).
+
+
+LaTeX COMMANDS
+ The LaTeX package latex2man is used to write the Man-pages with
+ LaTeX.Since we translate into other text formats, not all LaTeX stuff
+ can be translated.
+
+
+ PACKAGE OPTIONS
+ The latex2man package accepts the following options:
+
+
+ fancy use the LaTeX package fancyheadings.
+
+ fancyhdr
+ use the LaTeX package fancyhdr.
+
+ nofancy
+ neither the LaTeX package fancyheadings nor fancyhdr are used.
+
+ The default option may be specified in the file latex2man.cfg.
+
+
+ PACKAGE SPECIFIC ENVIRONMENTS
+ The following environments are provided by the package:
+
+ \begin{Name}{chapter}{name}{author}{info}{title}
+ The Name environment takes five arguments: 1. the Man-page
+ chapter, 2. the name of the Man-page, 3. the author, 4. some
+ short information about the tool printed in the footline of the
+ Man-page, and 5. a text which is used as title, for HTML and
+ LaTeX (it's ignored for output of the Man-page or TeXinfo. The
+ Name environment must be the first environment in the document.
+ Processing starts with this environment. Any text before this is
+ ignored (exception: the setVersion and setDate commands). (Note:
+ all arguments of \begin{Name} must be written on one line).
+
+ \begin{Table}[width]{columns}
+ The Table environment takes two arguments: the first optional
+ one specifies a width of the last column, the second one gives
+ the number of columns. For example:
+
+ \begin{Table}[2cm]{3}
+ Here & am & I \\\hline
+ A 1 & A 2 & A 3 1 2 3 4 5 A 3 1 2 3 4 5 \\
+ B 1 & B 2 & B 3 \\
+ \end{Table}
+
+ will be typeset as:
+
+
+ Here am I
+ ----------------------
+ A 1 A 2 A 3 1 2
+ 3 4 5 A
+ 3 1 2 3
+ 4 5
+ B 1 B 2 B 3
+
+ If no optional width argument is given, all entries are typeset left
+ justified. The width is a length measured absolutly in cm. Processing
+ with LaTeX a p{width} column is typeset as last column. The translation
+ to troff(1) commands results in a lw(width) column specification.
+ Translating to HTML and TexInfo ignores the width parameter.
+
+ \hline may be used.
+
+ If the Man-page is formatted with troff(1) and tables are used, the
+ tbl(1) preprocessor should be called, usually by giving a -t to the
+ call of troff(1). When viewing the generated manula page using man(1),
+ tbl(1) is called automatically.
+
+ \begin{Description}
+ is the same as \begin{description}
+
+ \begin{Description}[label]
+ is similar to \begin{description}, but the item labels have at
+ minimum the size of the (optional) word label. The difference
+ is visible only in the DVI and PDF-output, not in the troff,
+ TexInfo or HTML output.
+
+ a |a \begin{description}
+
+ ab |ab
+
+ abc |abc
+
+
+ a |a \begin{Description}
+
+ ab |ab
+
+ abc |abc
+
+
+ a |a \begin{Description}[aa]
+
+ ab |ab
+
+ abc |abc
+
+
+
+ ACCEPTED LaTeX ENVIRONMENTS
+ The following environments are accepted:
+
+ * description
+
+ * enumerate
+
+ * itemize
+
+ * verbatim
+
+ * center
+
+ They may be nested:
+
+ * Itemize and nested center:
+ A centered line.
+ Another centered line.
+
+
+ * Another item an nested enumerate
+
+ 1. a
+
+ 2. b
+
+
+
+ PACKAGE SPECIFIC MACROS
+ The following commands are provided:
+
+ \Opt{option}
+ Option: \Opt{-o} will be typeset as -o.
+
+ \Arg{argument}
+ Argument: \Arg{filename} will be typeset as filename.
+
+ \OptArg{option}{argument}
+ Option with Argument:
+ \OptArg{-o}{filename} will be typeset as -ofilename.
+
+ \OptoArg{option}{argument}
+ Option with optional Argument:
+ \OptoArg{-o}{filename} will be typeset as -o[filename].
+
+ \oOpt{option}
+ Optional option, e.g. \oOpt{-o} will be typeset as [-o].
+
+ \oArg{argument}
+ Optional argument, e.g. \oArg{filename} will be typeset as
+ [filename].
+
+ \oOptArg{option}{argument}
+ Optional option with argument, e.g.
+ \oOptArg{-o}{filename} will be typeset as [-ofilename].
+
+ \oOptoArg{option}{argument}
+ Optional option with optional argument, e.g. \oOp-
+ toArg{-o}{filename} will be typeset as [-o[filename]].
+
+ \File{filename}
+ used to typeset filenames, e.g. \File{filename} will be typeset
+ as filename.
+
+ \Prog{prog}
+ used to typeset program names, e.g. \Prog{latex2man} will be
+ typeset as latex2man.
+
+ \Cmd{command}{chapter}
+ used to typeset references to other commands, e.g.
+ \Cmd{latex2man}{1} will be typeset as latex2man(1).
+
+ \Bar is typeset as |.
+
+ \Bs (BackSlash) is typeset as \.
+
+ \Tilde is typeset as a ~.
+
+ \Dots is typeset as ...
+
+
+ \Bullet
+ us typeset as *.
+
+ \setVersion{..}
+ set .. as version information.
+
+ \setVersionWord{..}
+ set .. for the word Version: in the footline. The default is
+ \setVersionWord{Version:}.
+
+ \Version
+ returns the version information.
+
+ \setDate{..}
+ sets .. as date information.
+
+ \Date returns the date information.
+
+ \Email{..}
+ use to mark an Email address:
+ \Email{Juergen.Vollmer@informatik-vollmer.de} is typeset as:
+ Juergen.Vollmer@informatik-vollmer.de.
+
+ \URL{..}
+ use to mark an URL: \URL{http://www.foo.de/\Tilde vollmer} is
+ typeset as http://www.foo.de/~vollmer.
+
+ \LatexManEnd
+ the input file is read and processed until reading end-of-file
+ or \LatexManEnd (at the beginning of a line). LaTeXignores this
+ command.
+
+ \Lbr, \Rbr
+ is typeset as [ and ] (these variants are needed only somtimes
+ like in item[FooBar\LBr xx \Lbr]. Usually [ ] will work.
+
+ \LBr, \RBr
+ is typeset as { and } (these variants are needed when using { or
+ } as arguments to macros.
+
+ \Circum
+ is typeset as ^.
+
+ \Percent
+ is typeset as %.
+
+ \TEXbr If processed with LaTeX causes a linebreak (i.e. is equivalent
+ to \\).In the output of latex2man this macro is ignored.
+
+ \TEXIbr
+ If TexInfo output is generated, causes a linebreak (i.e. is
+ equivalent to \\),otherwise ignored.
+
+ \MANbr If Man-Page output is generated, causes a linebreak (i.e. is
+ equivalent to \\),otherwise ignored.
+
+ \HTMLbr
+ If HTML output is generated, causes a linebreak (i.e. is equiv-
+ alent to \\),otherwise ignored.
+
+ \medskip
+ An empty line.
+
+ \SP Produces some extra space, works also at the beginning of lines.
+ The code of the second line looks like: \SP abc \SP\SP xx\\:
+ abc xx
+ abc xx
+ abc xx
+
+ Note: Due to some ``problems'' with TexInfo, the lines starting with
+ \SP have a leading . (dot) in the TexInfo output, see -achar.
+
+
+ ACCEPTED MACROS FROM THE RCSINFO PACKAGE
+ \rcsInfo $Id ...$
+ if the LaTeX package rcsinfo is used, this command is used to
+ extract the date of the Man-page.
+
+ \rcsInfoLongDate
+ if the LaTeX package rcsinfo is used, this command is used to
+ typeset the date coded in the $Id ..$ string.
+
+
+ ACCEPTED LaTeX MACROS
+ The following standard LaTeX commands are accepted:
+
+ \section{..}
+ The section macro takes one argument: the name of the Man-page
+ section. Each Man-page consists of several sections. Usually
+ there are the following sections in a Man-page: Name (special
+ handling as environment, c.f. above), Synopsis, Description,
+ Options, Files, See Also, Diagnostics, Return Values, Bugs,
+ Author, version, etc.
+
+ Synopsis must be the first section after the Name environment.
+
+ Note: Do not use LaTeX-macrosin section names.
+
+ \subsection{..}
+ works as well as
+
+ \subsubsection{..}
+ those.
+
+ \emph{..}
+ \emph{example} is typeset as example.
+
+ \textbf{..}
+ \textbf{example} is typeset as example.
+
+ \texttt{..}
+ \textt{example} is typeset as example.
+
+ \underline{..}
+ \underline{example} is typeset as example of underline .
+
+ \date{..}
+ uses .. as date.
+
+ \verb+..+
+ but only + is allowed as delimiter.
+
+ $<$ is typeset as <.
+
+ $>$ is typeset as >.
+
+ $<=$ is typeset as <=.
+
+ $>=$ is typeset as >=.
+
+ $=$ is typeset as =.
+
+ $<>$ is typeset as <>.
+
+ $\ge$ is typeset as $>=$.
+
+ $\le$ is typeset as $<=$.
+
+ $\leftarrow$
+ is typeset as $<--$.
+
+ $\Leftarrow$
+ is typeset as $<==$.
+
+ $\rightarrow$
+ is typeset as $-->$.
+
+ $\Rightarrow$
+ is typeset as $==>$.
+
+ \{ is typeset as {.
+
+ \} is typeset as }.
+
+ \$ is typeset as $.
+
+ \$ is typeset as $,should be used inside macro
+ arguments.
+
+ \_ is typeset as _.
+
+ \& is typeset as &.
+
+ \# is typeset as #.
+
+ \% is typeset as %.
+
+ \, is typeset as smaller blank - - (between the two -)
+
+ \- is used to mark hyphenation in a word.
+
+ \\ is typeset as a linebreak or marks the end of a column in the
+ Table environment.
+
+ \ (a \ followed by a blank) is typeset as a blank,
+ although it cannot be used at the beginning of a line to make
+ indentation (see the \SP command).
+
+ ~ is typeset as a blank.
+
+ \copyright
+ is typeset as (C).
+
+ \noindent
+
+ \hline inside a Table environment.
+
+ \item inside a itemize, enumerate, or description environment.
+
+ \today 11 November 2008(see also the rcsinfo LaTeXpackage).
+
+ \ss,\"a, ...
+ \ss = ß, \"a= ä, \"o= ö, \"u= ü, \"A= Ä, \"O= Ö, \"U= Ü. It is
+ allowed to surround these macros in { and } in all places, even
+ inside other macros, e.g.
+ \textbf{\"a\"o\"u\"A\"O\"U\ss}
+ \textbf{\"a}{\"o}{\"u}{\"A}{\"O}{\"U}{\ss}}
+ \textbf{äöüÄÖÜß}
+
+
+ äöüÄÖÜß äöüÄÖÜß äöüÄÖÜß
+
+ If these letters are used in their LATIN-1 8-bit coding, they are
+ translated into the equivalent letter of the desired output format.
+ E.g. Ä becomes &Auml; in HTML and @"A in texinfo.
+
+
+ CONDITIONAL TEXT
+ latex2man preprocesses the LaTeX input to allow text to be used condi-
+ tionally. A special sort of LaTeX comment is used for that purpose.
+
+ * %@% IF condition %@%
+
+ * %@% ELSE %@%
+
+ * %@% END-IF %@%
+
+ A line must contain only such a comment and nothing else. condition is
+ a boolean expression containing ``names'' and operators. The names
+ given with the -Cname option have the value ``true'', while all other
+ names occuring in the expression are assumed to be ``false''. If the
+ evaluation of the boolean expression results in the value ``true'', the
+ text in the ``then''-part is used and the text in the optional
+ ``else''-part is skipped (and vice versa). The IF/ELSE/END-IF may be
+ nested. As boolean operators the following are allowed:
+
+
+
+ ( and ) for grouping are allowed.
+
+ For example:
+ %@% IF abc %@%
+ abc set
+ %@% IF xyz %@%
+ xyz set
+ %@% ELSE %@%
+ xyz NOT set
+ %@% END-IF %@%
+ %@% ELSE %@%
+ abc NOT set
+ %@% IF xyz || !XYZ %@%
+ xyz OR !XYZ set
+ %@% ELSE %@%
+ xyz OR !XYZ NOT set
+ %@% END-IF %@%
+ %@% END-IF %@%
+
+ Run this manual page through latex2man with e.g. -C'abc XYZ' and have
+ a look to the generated output. (If simply running the LaTeX-document
+ through LaTeX,all lines are shown in the .dvi file).
+ abc NOT set
+ xyz OR !XYZ set
+
+ To check the conditional text feature, when latex2man is called with
+
+ -CHTML the lines 1a, 2b, 3b, and 4b;
+
+ -CTEXI the lines 1b, 2a, 3b, and 4b;
+
+ -CMAN the lines 1b, 2b, 3a, and 4b;
+
+ -CLATEX
+ the lines 1b, 2b, 3b, and 4a;
+
+ calling LaTeX without preprocessing
+ all lines
+
+ should be shown:
+
+ 1b. The HTML conditional was not set.
+
+ 2b. The TEXI conditional was not set.
+
+ 3a. This text occurs only when viewing the MAN output
+
+ 4b. The LATEX conditional was not set.
+
+
+ TRANSLATION OF USER DEFINED MACROS
+ The user macro translation file (given by the [-ttransfile]) contains
+ Perl commands specifying the translation of LaTeX macros defined by the
+ user. These macros may have none, one or two arguments. The following
+ code is expected:
+
+
+ * Comments start with a # up to the end of the line.
+
+ * For a macro \foo with no arguments, the following code must be
+ specified:
+
+ Translation to Man-Pages
+ $manMacro{'foo'} = '...';
+
+ Translation to HTML
+ $htmlMacro{'foo'} = '...';
+
+ Translation to TexInfo
+ $texiMacro{'foo'} = '...';
+
+ where ... is the translation.
+
+
+ * For a macro \foo{..} with one argument, the following code must
+ be specified:
+
+ Translation to Man-Pages
+ $manMacro1a{'foo'} = '...';
+ $manMacro1b{'foo'} = '...';
+
+ Translation to HTML
+ $htmlMacro1a{'foo'} = '...';
+ $htmlMacro1b{'foo'} = '...';
+
+
+ Translation to TexInfo
+ $texiMacro1a{'foo'} = '...';
+ $texiMacro1b{'foo'} = '...';
+
+ where ... is the translation. The 1a code is used before the
+ argument, while 1b is typeset after the argument is set.
+
+
+ * For a macro \foo{..}{..} with two arguments, the following code
+ must be specified:
+
+ Translation to Man-Pages
+ $manMacro2a{'foo'} = '...';
+ $manMacro2b{'foo'} = '...';
+ $manMacro2c{'foo'} = '...';
+
+ Translation to HTML
+ $htmlMacro2a{'foo'} = '...';
+ $htmlMacro2b{'foo'} = '...';
+ $htmlMacro2c{'foo'} = '...';
+
+ Translation to TexInfo
+ $texiMacro2a{'foo'} = '...';
+ $texiMacro2b{'foo'} = '...';
+ $texiMacro2c{'foo'} = '...';
+
+ where ... is the translation. The 2a code is used before the
+ first argument, 2b between the two arguments and 2c is typeset
+ after the second argument is set.
+
+ * The file latex2man.trans contains some example code.
+
+
+ VERBATIM ENVIRONMENT
+ This
+ {is}
+ \texttt{a}
+ $test$
+ _of_
+ verbatim
+ <this is no HTML tag> and no @* TexInfo command
+
+
+
+ SUBSECTION WORKS
+ This is a \subsection.
+
+
+ Subsubsection works
+ This is a \subsubsection.
+
+
+ Subsubsection still works
+ This is another \subsubsection.
+
+
+ GENERAL REMARKS
+ 1. Empty lines are typeset as paragraph separators.
+
+ 2. The arguments of the LaTeX commands must not be split over sev-
+ eral lines.
+
+ 3. Do not nest calls to macros.
+
+ 4. Except the mentioned environment and macros, the usage of other
+ LaTeX environments or macros are not translated. Their usage
+ will cause garbage in the output.
+
+ 5. latex2man requires Perl version >= 5.0004_03.
+
+ 6. If you want to install the system with the distributed Makefile,
+ you need GNU-make. If you don't have it, you should execute the
+ steps shown in the Makefile manually.
+
+
+ SOME BUG FIX TESTS
+ Leading . and '
+ Now leading . and ' in generation troff output should work prop-
+ perly, since a \& is added. Therfore the \Dot macro has been
+ deleted.
+ Thanks to Frank.Schilder@Mathematik.Tu-Ilmenau.De.
+ Testcase 1:
+
+ '\n' ...
+
+ Testcase 2:
+ .foobar Testcase 3:
+ ...
+
+ abc ... abc . efg ' 123
+
+
+ %in verbatim
+ A % in a \verb and verbatim-environment was not emitted cor-
+ rectly. Thanks to Aleksey Nogin nogin@cs.caltech.edu for the bug
+ report and bug fix.
+
+ % abc
+
+ % abc %
+
+
+ but ignore comments following this:
+
+
+REQUIREMENTS
+ Perl latex2man requires Perl version >= 5.0004_03.
+
+ Make If you want to install the system with the distributed Makefile,
+ you need GNU-make. If you don't have it, you should execute the
+ steps shown in the Makefile manually.
+
+ LaTeX LaTeX2e is required.
+
+
+CHANGES
+ Please check the file latex2man-CHANGES for the list of changes.
+
+
+VERSION
+ Version: 1.23 of 2008/11/11.
+
+
+LICENSE AND COPYRIGHT
+ Copyright
+ (C)1998, Dr. Jürgen Vollmer, Viktoriastraße 15, D-76133 Karl-
+ sruhe, Germany, Juergen.Vollmer@informatik-vollmer.de
+
+ The actual version of Latex2man may be found on my homepage
+ http://www.informatik-vollmer.de/software/latex2man.html.
+
+
+ License
+ This program can be redistributed and/or modified under the
+ terms of the LaTeX Project Public License Distributed from CTAN
+ archives in directory macros/latex/base/lppl.txt; either version
+ 1 of the License, or any later version.
+
+
+ Misc If you find this software useful, please send me a postcard from
+ the place where you are living.
+
+
+AUTHOR
+ Dr. Jürgen Vollmer
+ Viktoriastraße 15
+ D-76133 Karlsruhe
+ Email: Juergen.Vollmer@informatik-vollmer.de
+ WWW: http://www.informatik-vollmer.de.
+
+
+
+
+Documentation Tools 2008/11/11 LATEX2MAN(1)