22.4.3 HTML Cross-reference Command Expansion

In standard Texinfo, node names may not contain @-commands. makeinfo has an option ‘--commands-in-node-names’ which partially supports it (see section Running makeinfo from a Shell), 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 section @set and @value) and macro invocations (see section 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.

Quotation mark commands are likewise replaced by their Unicode values (see section Inserting Quotation Marks).

An @acronym or @abbr command is replaced by the first argument, followed by the second argument in parentheses, if present. See section @acronym{acronym[, meaning]}.

An @email command is replaced by the text argument if present, else the address. See section @email{email-address[, displayed-text]}.

An @image command is replaced by the filename (first) argument. See section Inserting Images.

A @verb command is replaced by its transformed argument. See section @verb{<char>text<char>}.

Any other command is an error, and the result is unspecified.