5.4.2 @xref with Two Arguments

With two arguments, the second is used as a label for the online output.

The template is like this:

@xref{node-name, online-label}.

For example,

@xref{Electrical Effects, Lightning}.

produces:

*Note Lightning: Electrical Effects.

in Info and

See Section 5.2 [Electrical Effects], page 57.

in a printed manual, where the node name is printed.

The second argument to cross-references must observe some of the restrictions for node names (see @node Line Requirements). The most common issue is that colons cannot be used, since that interferes with the parsing of the Info file.