From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6178 invoked by alias); 17 Sep 2019 01:40:05 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 6161 invoked by uid 89); 17 Sep 2019 01:40:05 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-9.1 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_2,KAM_SHORT,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.1 spammy=UD:gcc.git, gcc.git, our, UD:pl X-HELO: simark.ca Received: from simark.ca (HELO simark.ca) (158.69.221.121) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 17 Sep 2019 01:40:04 +0000 Received: from [10.0.0.11] (unknown [192.222.164.54]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by simark.ca (Postfix) with ESMTPSA id 78C981E4C2; Mon, 16 Sep 2019 21:40:02 -0400 (EDT) Subject: Re: [PATCH 1/2] etc/texi2pod.pl: convert @t{} to C<> To: Carl Bordum Hansen , gdb-patches@sourceware.org References: From: Simon Marchi Cc: Binutils Message-ID: Date: Tue, 17 Sep 2019 01:40:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.0 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-SW-Source: 2019-09/txt/msg00298.txt.bz2 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