5.4 @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 shares constraints with node names. The potentially problematic character in this context is the colon. See Info Node Names Constraints.