Not every command of the interface of aldordoc is actually implemented through LATEX. For simplicity, the Perl script tools/aldordoc2tex.pl.nw is provided. It translates several commands (including their arguments) to an actually implemented LATEX form.
All such names are considered to be private and may change at any time. Currently such names start with \adinternal.
The translated commands are given in the following sections.
Since it is possible to refer (via ∖adname) to a function by giving an optional signature, we have to make sure that hyperref finds both link targets. This explains hyperlabelsignature.
The command ∖adinternaldefinename should be used as follows.
\adinternaldefinename[type]%
{indexkey}{indextext}% {hyperlabelname}{hyperlabelsignature}% {latextext} |
The arguments are computed from the form similar to the one given in Section 25.2.8 where the SIGNATURE part must appear. Thus we have something like
\addefinename[TYPE]{FUNC:SIGNATURE}
|
Then the optional type is identical to TYPE. The other parameters are computed from FUNC and SIGNATURE. The need for several arguments stems from the fact that various characters must be escaped and that we wanted to keep the LATEX implementation simple. Unfortunately, the characters that must be escaped are different for hyperref (see escapeForHyperref) than for makeindex (see escapeForMakeindexKey and escapeForMakeindexText).
See the implementation of splitNameAndSignatureArgument for how FUNC and SIGNATURE are translated. Up to escaped characters, after translation we get something like
\adinternaldefinename[TYPE]%
{FUNC}{FUNC}% {FUNC}{SIGNATURE}% {FUNC} |
where SIGNATURE is non-empty and is only used for the hyperref target definition.
Note that the sixth argument is not used in contrast to the definition of ∖adinternalusename.
The command ∖adinternalusename has identical arguments to the command ∖adinternaldefinename.
\adinternalusename[type]%
{indexkey}{indextext}% {hyperlabelname}{hyperlabelsignature}% {latextext} |
We rely on the script tools/aldordoc2tex.pl.nw which translates ∖adname to ∖adinternalusename.
Inside the arguments of ∖adname every letter is taken literally. There is no need to escape % or even { and }. The only restriction is that braces must be balanced.
We do not do anything fancy. No link is generated. Only a nice output form is generated.
See also the description of the environment adparameters.
There is no aldordoc command corresponding to ∖adcode. Instead an ∖adcode command is translated into a ∖verb command by the script tools/aldordoc2tex.pl.nw. For more details read the corresponding Section 26.2.