[PATCH 1/2] etc/texi2pod.pl: convert @t{} to C<>

[Simon Marchi]

On 2019-09-16 6:04 p.m., Carl Bordum Hansen wrote:
> Both are intended to be stylized in a typewriter font.
> ---
> 
> I noticed that this was missing when I was looking into the man page
> rendering issue.

[adding binutils, since it's concerns shared files]

Hi Carl,

With this patch applied, the result in the man page is:

  ...programs written in C, C"++"...

There are two ways I can see to get rid of those quotes:

1. Substitute @t{...} with the content as-is, not C<...>
2. Use the option "--quotes none" of pod2man

This file happens to be present in the gcc repo as well [1], and the gcc version should
probably be considered the upstream.  If you diff the binutils-gdb version with
the gcc version, you'll see that the gcc version seems to have received additional
fixes compared to the binutils-gdb version.  And there's one fix [2] that happens to be
for the @t{...} issue, that's same as solution #1.

Since it's preferable to stay as close as possible to the gcc version, I suggest we
instead sync our version with the gcc one.

Simon

[1] https://gcc.gnu.org/git/?p=gcc.git;a=blob;f=contrib/texi2pod.pl;h=91bdbb5cea933d0381f2924ab94490fca31d5800;hb=HEAD
[2] https://gcc.gnu.org/git/?p=gcc.git;a=commit;h=6be49d577254ca021cf0904f920d9785d5fc74c8