[latexrefman] Layout of sectional units

Karl Berry karl at freefriends.org
Sat Sep 5 23:11:52 CEST 2020


      Use @ref{verbatim} instead.

This is not correct.  I repeat, since apparently you didn't believe me,
all @*ref commands should be followed by punctuation. In all
languages. That's the way Texinfo is designed (unfortunately, but it
can't be changed now).

If you look at the Texinfo manual, you'll see why. In TeX, the output of
  @xref{foo} bar.
is (for whatever page number)
  See foo, p.100 bar.

which is not correct. There has to be a comma after "p.100":

  @xref{foo}, bar.
is
  See foo, p.100, bar.

It is the same story for @pxref (which outputs a lowercase "see") and
@ref (which does not output any "see"). The Texinfo manual has examples
of all the cases. -k


More information about the latexrefman mailing list.