From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id ZjofHw6CaWGeVQAAWB0awg (envelope-from ) for ; Fri, 15 Oct 2021 09:28:46 -0400 Received: by simark.ca (Postfix, from userid 112) id 6CBBE1F0BB; Fri, 15 Oct 2021 09:28:46 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-2.0 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,NICE_REPLY_A,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.2 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 8CF211E79C for ; Fri, 15 Oct 2021 09:28:45 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 7EFAB3857C76 for ; Fri, 15 Oct 2021 13:28:44 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7EFAB3857C76 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1634304524; bh=C43QmR2A1j4RmoJK+j+SD+HDzxFpevdpLVKWsY7wOIY=; h=Date:Subject:To:References:In-Reply-To:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=v7f8HHnL80DDptWgfTCelLlkx5w5pn7WTcIP5GViBxlqIWe7yJq1IsAw+yVOac7A2 HlsJqucpTb1ZrBfDVrU2C+ckBZf24jwi73HAPlGbFzGlE0eLRIHhIGJ0jZzneLxq99 NBZ8WqToZlh9y+bg4rQ5c01vbdQ2lw4ona+3MA+A= Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by sourceware.org (Postfix) with ESMTP id 1A0EF3857C72 for ; Fri, 15 Oct 2021 13:28:08 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 1A0EF3857C72 Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-473-v3LqbtmeNkaTf1obqj41Zw-1; Fri, 15 Oct 2021 09:28:05 -0400 X-MC-Unique: v3LqbtmeNkaTf1obqj41Zw-1 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id A8AA3362F8; Fri, 15 Oct 2021 13:28:04 +0000 (UTC) Received: from [10.97.116.76] (ovpn-116-76.gru2.redhat.com [10.97.116.76]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C91927092D; Fri, 15 Oct 2021 13:28:02 +0000 (UTC) Message-ID: <68a1c4c5-e399-3f45-dee6-c1f239815354@redhat.com> Date: Fri, 15 Oct 2021 10:27:58 -0300 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.2.0 Subject: Re: [PATCH] [gdb/doc]: Updated manpages to be consistent with help To: Philippe Waroquiers , Sergio Durigan Junior , Bruno Larsen via Gdb-patches References: <20211013130409.10711-1-blarsen@redhat.com> <87czo96iyv.fsf@paluero> <8cd51cc0-3ca2-b1ae-e608-82a7cac10bcc@redhat.com> <97db0ebc9dedf0dd9a75ac32be57d1f689a21083.camel@skynet.be> In-Reply-To: <97db0ebc9dedf0dd9a75ac32be57d1f689a21083.camel@skynet.be> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Bruno Larsen via Gdb-patches Reply-To: Bruno Larsen Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" On 10/14/21 15:56, Philippe Waroquiers wrote: > Note that I started a patch to have the options consistently using -- > > But as GDB accepts various layout for options (such as -thisone or --thisone), > it was not very clear it that was a good thing to do. > Pedro e.g. commented that GDB does not use the concept of 'short' and 'long' options. > > Finally, as I understand, the decision was rather to use as cannnical form > -thisone > (in the doc and on line help) > and so the manual should then also be aligned. > > Sadly, I had no time to finalize the patch (i.e. to rather systematically use > the single dash convention). > But this patch seems then not to go into what I think is the last agreed direction. > > See the initial RFC in > https://sourceware.org/pipermail/gdb-patches/2021-June/179587.html > and RFA in > https://sourceware.org/pipermail/gdb-patches/2021-June/179834.html > > Thanks > Philippe > Hi! I didn't see this patch when writing my own, sorry. As for not going the agreed direction, it didn't sounds "agreed" to me, since Eli agreed with documenting '--' while Pedro preferred '-'. I agree with the argument that GDB doesn't accept short options, since you can't combine them, but the help page still shows the abbreviated versions with a single dash and longer versions with '--' and that causes confusion for users. What the patches are supposed to do is make those 2 pages consistent and avoid user confusion, keeping them as-is because the developers know it makes more sense doesn't fix confusion. My proposed solution is: Let's make them consistent with help, all longer options having '--', use your text explaining that GDB accepts all 8 versions of options despite how they are written, but change it to call "abbreviated" and "longer" options instead, to avoid the "short option" confusion that Pedro has brought up. Does that sound reasonable? -- Cheers! Bruno Larsen