Sun 22 May 2011 04:53:37 PM UTC, original submission:
http://bugs.debian.org/492210
<snip>
The texinfo manual says:
8.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 two ways:
1. TeX typesets the reference for the printed manual with a lower case `see' rather than an upper case `See'.
2. The Info formatting commands automatically end the reference with a closing colon or period, if necessary.
However if there's a period after a closing parenthesis, makeinfo adds a second one before. For instance, gmp.texi from GMP 4.2.2 contains:
Libtool is used to build the library and @samp{-version-info} is set appropriately, having started from @samp{3:0:0} in GMP 3.0 (@pxref{Versioning, Library interface versions, Library interface versions, libtool, GNU Libtool}).
and makeinfo generates:
Libtool is used to build the library and `-version-info' is set appropriately, having started from `3:0:0' in GMP 3.0 (*note Library interface versions: (libtool)Versioning.).
makeinfo should be able to handle this case to generate instead:
Libtool is used to build the library and `-version-info' is set
appropriately, having started from `3:0:0' in GMP 3.0 (*note Library interface versions: (libtool)Versioning).
Note that this is correct typography according to some manuals, such as the Chicago Manual Of Style, 14th Ed.
<snap>
I see this bug in the C implementation of makeinfo and texi2any.pl by Patrice Dumas, but not in the texi2any from texi2html.
http://ftp.gnu.org/gnu/gmp/gmp-4.2.2.tar.bz2
|