Next: , Previous: , Up: Cross References   [Contents][Index]


6.7 @pxref

The 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: , Previous: , Up: Cross References   [Contents][Index]