This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
Re: [PATCH 1/2] etc/texi2pod.pl: convert @t{} to C<>
- From: Simon Marchi <simark at simark dot ca>
- To: Carl Bordum Hansen <carl at bordum dot dk>, gdb-patches at sourceware dot org
- Cc: Binutils <binutils at sourceware dot org>
- Date: Mon, 16 Sep 2019 23:22:32 -0400
- Subject: Re: [PATCH 1/2] etc/texi2pod.pl: convert @t{} to C<>
- References: <BX1RMFNHD09K.2UR7RI8XL51IC@carl-T440p> <f4311436-b021-970c-0c64-01f156e39912@simark.ca>
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