URL:
<http://savannah.gnu.org/bugs/?33373>
Summary: makeinfo adds a spurious period for @pxref before
closing parenthesis
Project: texinfo - GNU documentation system
Submitted by: hpreusse
Submitted on: Sun 22 May 2011 04:53:37 PM GMT
Category: makeinfo
Release: 4.13a
Priority: 3 - Low
Severity: 3 - Normal
Item Group: bug
Privacy: Public
Open/Closed: Open
Assigned to: None
Discussion Lock: Any
Status: None
_______________________________________________________
Details:
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
_______________________________________________________
Reply to this item at:
<http://savannah.gnu.org/bugs/?33373>
_______________________________________________
Message sent via/by Savannah
http://savannah.gnu.org/
