latex2man: Translation of User Defined Macros
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.