In standard Texinfo, node names may not contain @-commands. makeinfo has an option --commands-in-node-names which partially supports it (see Invoking makeinfo), but it is not robust and not recommended.
Thus, makeinfo does not fully implement this part of the HTML cross-reference algorithm, but it is documented here for the sake of completeness.
First, comments are removed.
Next, any @value
commands (see set value) and macro invocations
(see Invoking Macros) are fully expanded.
Then, for the following commands, the command name and braces are removed, the text of the argument is recursively transformed:
@asis @b @cite @code @command @dfn @dmn @dotless @emph @env @file @indicateurl @kbd @key @samp @sc @slanted @strong @t @var @w
For @sc
, any letters are capitalized.
The following commands are replaced by constant text, as shown. If
any of these commands have non-empty arguments, as in
@TeX{bad}
, it is an error, and the result is unspecified.
`(space)' means a space character, `(nothing)' means the empty string,
etc. The notation `U+xxxx' means Unicode code point xxxx
(in hex, as usual). There are further transformations of many of
these expansions for the final file or target name, such as space
characters to ‘-’, etc., according to the other rules.
@(newline) | (space)
|
@(space) | (space)
|
@(tab) | (space)
|
@! | ‘!’
|
@* | (space)
|
@- | (nothing)
|
@. | ‘.’
|
@: | (nothing)
|
@? | ‘?’
|
@@ | ‘@’
|
@{ | ‘{’
|
@} | ‘}’
|
@LaTeX | ‘LaTeX’
|
@TeX | ‘TeX’
|
@arrow | U+2192
|
@bullet | U+2022
|
@comma | ‘,’
|
@copyright | U+00A9
|
@dots | U+2026
|
@enddots | ‘...’
|
@equiv | U+2261
|
@error | ‘error-->’
|
@euro | U+20AC
|
@exclamdown | U+00A1
|
@expansion | U+2192
|
@geq | U+2265
|
@leq | U+2264
|
@minus | U+2212
|
@ordf | U+00AA
|
@ordm | U+00BA
|
@point | U+2605
|
@pounds | U+00A3
|
@print | U+22A3
|
@questiondown | U+00BF
|
@registeredsymbol | U+00AE
|
@result | U+21D2
|
@textdegree | U+00B0
|
@tie | (space)
|
Quotation mark commands are likewise replaced by their Unicode values (see Inserting Quotation Marks).
An @acronym
or @abbr
command is replaced by the first
argument, followed by the second argument in parentheses, if present.
See acronym.
An @email
command is replaced by the text argument if
present, else the address. See email.
An @image
command is replaced by the filename (first)
argument. See Images.
A @verb
command is replaced by its transformed argument.
See verb.
Any other command is an error, and the result is unspecified.