@pxref
The parenthetical reference command, @pxref
, is nearly the
same as @xref
, but it is best used within parentheses.
The command differs from @xref
in that the reference is
typeset with a lowercase ‘see’ rather than an uppercase ‘See’.
In Info, ‘*note’ is output.
With one argument, a parenthetical cross-reference looks like this:
… storms cause flooding (@pxref{Hurricanes}) …
which produces
… storms cause flooding (*note Hurricanes::) …
in Info and
… storms cause flooding (see Section 6.7 [Hurricanes], page 72) …
in a printed manual.
In past versions of Texinfo, it was not allowed to write punctuation
after a @pxref
, so it could be used only before a
right parenthesis. This is no longer the case.
The effect of ‘@pxref{node-name}’ is similar to that of
‘see @ref{node-name}’. However, in many circumstances the
latter is preferable, as this makes it clear in the Info output that
the word “see” should be present.