Next: @anchor, Previous: @ref, Up: Cross References [Contents][Index]
@pxrefThe parenthetical reference command, @pxref, is nearly the
same as @xref, but it is best used at the end of a sentence or
before a closing parenthesis. The command differs from @xref
in that TeX typesets the reference for the printed manual with a
lowercase ‘see’ rather than an uppercase ‘See’.
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.
With two arguments, a parenthetical cross-reference has this template:
… (@pxref{node-name, cross-reference-name}) …
which produces
… (*note cross-reference-name: node-name.) …
in Info and
… (see Section nnn [node-name], page ppp) …
in a printed manual.
@pxref can be used with up to five arguments, just like
@xref (see @xref).
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, so now it can be used
(for example) at the end of a sentence, where a lowercase “see”
works best. For instance:
… For more information, @pxref{More}.
which outputs (in Info):
… For more information, *note More::.
As a matter of style, @pxref is best used at the ends of
sentences. Although it technically works in the middle of a sentence,
that location breaks up the flow of reading.
Next: @anchor, Previous: @ref, Up: Cross References [Contents][Index]