bugtexinfo - GNU documentation system - Bugs: bug #33373, makeinfo adds a spurious period...

 
 

You are not allowed to post comments on this tracker with your current authentication level.

bug #33373: makeinfo adds a spurious period for @pxref before closing parenthesis

Submitted by:  Hilmar Preusse <hpreusse>
Submitted on:  Sun 22 May 2011 04:53:37 PM UTC  
 
Category: makeinfoRelease: 4.13a
Priority: 3 - LowSeverity: 3 - Normal
Item Group: bugPrivacy: Public
Open/Closed: ClosedAssigned to: None
Status: Fixed

Sun 18 Sep 2011 08:15:18 AM UTC, comment #1:

As discussed on the list, the Info reader requires a punctuation mark to end a node, and it would be a bad idea to parse parenthesis in node for another purpose than detecting a manual name embedded in the node name, like
(manual)node name.
So adding the dot before the parenthesis should stay.

Patrice Dumas <pertusus>
Project Member
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

Hilmar Preusse <hpreusse>

 

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -unavailable- added by pertusus (Posted a comment)
  • -unavailable- added by hpreusse (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

    Please enter the title of George Orwell's famous dystopian book (it's a date):

     

     

    Follow 2 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Sun 18 Sep 2011 08:15:18 AM UTCpertususOpen/ClosedOpen=>Closed
      StatusNone=>Fixed

    Back to the top


    Powered by Savane 3.1-cleanup1