[PATCH] texi2pod quote translation

Bob Wilson bwilson@tensilica.com
Thu Oct 6 03:49:00 GMT 2005


On Oct 5, 2005, at 5:26 PM, Joseph S. Myers wrote:
> This script is maintained in GCC, please submit changes to gcc- 
> patches.
> It looks like the src version is out of date with respect to the GCC
> version.

OK.  From the ChangeLog, it looked like they were maintained  
separately, but this is better.

Here is a revised description of the problem and a patch to GCC's  
version of texi2pod.  If the patch is approved for GCC, may I also  
import the latest version into binutils?

I noticed that some of the gcc and binutils man pages have strange  
quotes in them.  For some reason, every single quote or back quote  
character in the texinfo file appears with a space before it in the  
man page.  Worse, the texinfo convention of using two single quotes  
or two back quotes is not recognized and translated to use double  
quote characters.  For example, if the texinfo file has ``name'', the  
man page will show  ` `name ' ' instead of "name".  You can see  
examples of this in most of the binutils man pages, e.g., the  
reference to the FDL in the COPYRIGHT section, or in the reference to  
"overall options" in the first paragraph of GCC's DESCRIPTION section.

I took a quick look at the texi2pod.pl script and came up with this  
patch to fix the translation to double quotes.  I don't know what's  
causing the extra space characters before quotes.

Just for the record, there is a similar problem with dashes.  The  
texinfo conventions for en-dashes (two hyphens) and em-dashes (three  
hyphens) are not translated in the man pages as they are in the info  
files.  This is harder to fix because it's quite likely that double  
dashes will appear in sample input, code, examples, etc. and they  
should not be translated in those contexts.

Anyway, is this patch OK?

contrib/ChangeLog entry:

2005-10-04  Bob Wilson  <bob.wilson@acm.org>

         * texi2pod.pl: Convert two single quotes or two backquotes to
         double quotes.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: texi2pod-quotes.diff
Type: application/octet-stream
Size: 696 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/binutils/attachments/20051006/14ce378e/attachment.obj>


More information about the Binutils mailing list