From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id 0FvqHFS7amGJdgAAWB0awg (envelope-from ) for ; Sat, 16 Oct 2021 07:45:24 -0400 Received: by simark.ca (Postfix, from userid 112) id 5ECC31F0BB; Sat, 16 Oct 2021 07:45:24 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-1.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,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 EFFFF1EDDB for ; Sat, 16 Oct 2021 07:45:22 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id ED7F13857824 for ; Sat, 16 Oct 2021 11:45:21 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org ED7F13857824 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1634384722; bh=ZNaRrNpZwP2+A2NONQW2x0w4cwYzaEZmsXo8SH76/aM=; h=Subject:To:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=lzkVZdibuiPB52dLpDeag2L7YYeXvg3UjvqeUF8i8zUqMHDE796G5nbbD0goOhcW+ zrVqanl5jVviEj5RRpQ9a9WsMd77sh/DevorZNJ8ZRFAbAc9WZ0/VadqOcbJVNOLvJ vaTQwxDfjtwHtctmFi9J9rponLxR5auI4TvhPIaw= Received: from mailsec213.isp.belgacom.be (mailsec213.isp.belgacom.be [195.238.22.109]) by sourceware.org (Postfix) with ESMTPS id 6E6743858418 for ; Sat, 16 Oct 2021 11:45:02 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6E6743858418 IronPort-SDR: 0zqGfUcGiimtPvq5hr/MtG2yD3PEV4Syc3ziJbnjPuFBhI1q99YhGmsft/HYGOF/8SH6vh7zmj 1Mpiu4b53qdNangU+OpUWRrLBbhum649Y+H/girh7ptSGH5eiMcwj/0htg1rVvdB1kxTk6COZy zqctlOjXn/tOkgXvUZmhVSnvdM1QjLKDryhETrPMdUAxplmvUVHET1xVTpVwGya9lNOqC1kOys xXY7JVJQq+up9C1SdKkCari0YL8m5CwZ51x4InyiyYzG+oYyZe7tb2F128VFI9EZ7S1by/hUYx KHI= X-IPAS-Result: =?us-ascii?q?A2BSAQBlumph/yFRiNkNTYEJCYRwgUKER5EQA54cCwEBA?= =?us-ascii?q?QEBAQEBAQk1DAQBAYUAAoJNJjgTAQIEAQEBAQMCAwEBAQEFAQEGAQEBAQEBB?= =?us-ascii?q?QQBgSOFLzmCQikBg2QBAQEDIw8BVgsOCgICJgICVwYBLYJXgxarYnqBMYEBg?= =?us-ascii?q?04BgRuDK4FdBoEQKocagneDfTeBVUSEDzA+gmMDhHeCQyIEjAlhgRoRDgKCS?= =?us-ascii?q?AKRXaw7MweDNIEzBguJBpQqMacZlgsfjFCZKoF4gX1tYAQKgk5RKJcmhUxyO?= =?us-ascii?q?AIGAQoBAQMJkyABAQ?= IronPort-PHdr: A9a23:oYGzqBPmB+TuLNtb0Dcl6nbTChdPi9zP1u491JMrhvp0f7i5+Ny6Z QqDv60r1gaXFtmCo9t/yMPu+5j6XmIB5ZvT+FsjS7drEyE/tMMNggY7C9SEA0CoZNTjbig9A dgQHAQ9pyLzPkdaAtvxaEPPqXOu8zESBg//NQ1oLejpB4Lelcu62/6u95HJfQlEmTuwbbx9I RmrsA7cqtQYjYx+J6gr1xDHuGFIe+NYxWNpIVKcgRPx7dqu8ZBg7ipdpesv+9ZPXqvmcas4S 6dYDCk9PGAu+MLrrxjDQhCR6XYaT24bjwBHAwnB7BH9Q5fxri73vfdz1SWGIcH7S60/VC+85 Kl3VhDnlCYHNyY48G7JjMxwkLlbqw+lqxBm3oLYfJ2ZOP94c6jAf90VWHBBU95SWSJcAo2yc YUBAOgPPelEoYbyqFQAoACiBQSvHu7j1iNEi2X00KA8zu8vERvG3AslH98WqnrUrNT1NKMTU eCt1KnH0yjIYPNM1jfn74jIaw0hofCSUrJqasra1E4iFxvFjlWRrYzlPiuV1vwTvGSB4etvT /ivi2k+qwFsozig2N0sipLSi4IOyVDF9SN5z5gpJdGiU0F0f8epHZ1NvC6VK4V4WNktQ310u Ckk0L0Gv4a2cSwExZg6yBDSdfOKfoqI7x/gVuucLjh2inx5dL+xiBi//1asx/D9W8SpzFpHo ChIn9bQun4N1BHe7tWKR/ty80qnxD2B2QfT6uReLkA1k6rWM4UhwrktlpoJrUvMACH3l1/sj KCIbEkk/fKo6+vhb777pZGcL5d5hh/jPqksgMCzHOo1PwkUU2WY5OiwzrPu8EP/Tb5XlPM5i LPZv4rfJckDo665BBJa3Zg75hakCjemzMwYnX4aLFJZYB6Hj5bmO1XJIP3gCfiznlChnClxy /zbP7DsAY/BImXZnLv8f7ty7VZQyAs1zd9B+5JZEq8NLO/xV0PrqdDVAB40Pxa3zur6Etlw2 I0TVXqKAqCDMaPStVGI5vgoI+mJfIIVoDb9K/kh5/7vlX85gUEScbOn3JQNcnC4Ge1mI1iYY XXymNcBCnwHvhE9TO3qjl2NTyJTa2ypUK0i/j07Ep6pDZ/fRoCxh7yMxDy0HplMaWBcEVCDD 3Hoep6eW/gSdS2SItVukiAeWbe9TI8h0AmktBXmxLp/MurU5ioYuIr41Ndr/e3TmhAy9TtpA MSfyGyNVH97nnkHRz8326BwvE59xk2F0admn/xSDcZT6O9RUgcmKZ7cyPR3C9/vVQ3aZ9uJU EypQsm6DjExUN0x2MQDY116G9W/lBDMwzSlArEPmLyRGpM46KXc32L+J5U193GT/rM8iV5uZ sJVLmCgzvp18wHJHIPPu1+Um6ajaeIX2yubsC+4wHCBvUYQfBNqUKrMWzg9e03Xqs6xsljPV bCvDrglGhBM08GDLadILNvkkQMCDN35JdLZK0a4gXy9A16Wx7rEQ4bgPn0UwC7dBVNMxw8f9 zOePBQ1Biq6i3nZESZlGE3meU6q9vNx/iCVVEgxmjmKbklgz6K4siEcn/uFVvIexKlM7D8hq jF1BE6wmc3fEd2ZugtsZr50etAs5lpbk2jU4V8udqe8Jrxv0wZNOz98uFnjglAuUt0orA== IronPort-Data: A9a23:sKxmC6jInTY491a7sOIJHTKKX161NBEKZh0ujC45NGQN5FlHY01je htvWW7UPPiJNzT8Ld0lbdnl9BlSsMLcnN5kTwA6qC9mFH5jpJueD7x1DKtQ0wB+jyHnZBg6h ynLQoCYdKjYdpJfz/uUGuCJQUNUjMlkfZKhTr6ZUsxNbVU8En540Us9w7RRbrNA2LBVPSvc4 bsenOWCYDdJ6xYsWo7Dw/vewP/HlK2aVAIw5jTSV9gS1LPtvyV94KYkGE2EByCQrr+4sQKNb 72rILmRpgs19vq2Yz+vuu6TnkYiGtY+MeUS45Zbc/DKv/RMmsA9+qcVLt0ZUWBLsQXKsexe+ thMqpq5cS58a8UgmMxFO/VZOxInbPcAoeGXZyH56JOmp6HEWyG1nLM3Vx9wbdReob0f7WJmr JT0LBgVbhGHhvquzfSkQ/Nrn9kiIdPwFJgcq3dt0XfTAJ7KRLiaH/qXtIUHh1/cgOgVMOr9O 8pDLgEsVxn7ThJDC1UUKL4XybLAan7XNmcwREiujaAz6nLIwQpZyrXhMNPJPNeNQK19hUuCq WPB82bRGRwAO92YxTjD9H+w7sfAkSm+QIsOH7217dZxh0CJzWEMAQcbE1yhrpGEZlWWAIkZe xVRo3Fw6PJrqwqiQsL5GhGppjiFpQZaUddUHOQx7wTLwKe8DxulO1XohwVpMLQO3PLajxRzv rNVt7sFzgCDfFFYpbxxO1tUQf6P1fApEFI/ IronPort-HdrOrdr: A9a23:gHGub6+6iLhjcerk5VRuk+DVI+orL9Y04lQ7vn2ZKCYlFvBw8v rEoB1173HJYVoqNU3I4OrhBEDiewK4yXcW2+Ms1N6ZNWHbUQ2TTb2KhrGM/9SPIUHDHug079 YDT0B7YOeAbmRHsQ== X-IronPort-Anti-Spam-Filtered: true Received: from 33.81-136-217.adsl-dyn.isp.belgacom.be (HELO [192.168.1.17]) ([217.136.81.33]) by relay.proximus.be with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 16 Oct 2021 13:44:58 +0200 Message-ID: Subject: Re: [PATCH] [gdb/doc]: Updated manpages to be consistent with help To: Bruno Larsen , Sergio Durigan Junior , Bruno Larsen via Gdb-patches Date: Sat, 16 Oct 2021 13:44:53 +0200 In-Reply-To: <68a1c4c5-e399-3f45-dee6-c1f239815354@redhat.com> References: <20211013130409.10711-1-blarsen@redhat.com> <87czo96iyv.fsf@paluero> <8cd51cc0-3ca2-b1ae-e608-82a7cac10bcc@redhat.com> <97db0ebc9dedf0dd9a75ac32be57d1f689a21083.camel@skynet.be> <68a1c4c5-e399-3f45-dee6-c1f239815354@redhat.com> Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.38.3-1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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: Philippe Waroquiers via Gdb-patches Reply-To: Philippe Waroquiers Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" On Fri, 2021-10-15 at 10:27 -0300, Bruno Larsen wrote: > 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? > See also the feedback of Joel. https://sourceware.org/pipermail/gdb-patches/2021-August/181294.html Philippe