This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
[PATCH] texi2pod quote translation
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.
Attachment:
texi2pod-quotes.diff
Description: Binary data