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

[Simon Marchi]

On 2019-09-16 9:40 p.m., Simon Marchi wrote:
> 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
> 

I have submitted the following patch to this effect:

https://sourceware.org/ml/gdb-patches/2019-09/msg00305.html

Simon