From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id UfcBEwcFk2RW7gkAWB0awg (envelope-from ) for ; Wed, 21 Jun 2023 10:11:19 -0400 Authentication-Results: simark.ca; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.a=rsa-sha256 header.s=default header.b=dPCCIOiP; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id 3FA461E0BB; Wed, 21 Jun 2023 10:11:19 -0400 (EDT) Received: from sourceware.org (ip-8-43-85-97.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 307FF1E0AC for ; Wed, 21 Jun 2023 10:11:17 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id BFF1B3858000 for ; Wed, 21 Jun 2023 14:11:16 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org BFF1B3858000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1687356676; bh=ZkTF9rSTckAgp6tGqCz3lPl1jKE9tctMWlHxZbkEvHQ=; h=Date:To:Cc:In-Reply-To:Subject:References:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=dPCCIOiPvFg3pHNVAla+xEgv1Xr3eZeQDEf2JPIn1DHd4q/j0AUinWZQPJI175HNc +Dbu/nlogbT/XHn5OYbK0mgHlQWEGh+WFHtmfBN2Q59rZHzBcwm2VtPytM9z5nsoxg NhoYduUdZWlBJimgbLeEBJbWwtMdDykIr+vT0g/0= Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 04F6C3858D28 for ; Wed, 21 Jun 2023 14:10:57 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 04F6C3858D28 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qByXv-0001Ew-Qr; Wed, 21 Jun 2023 10:10:55 -0400 Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qByXv-0007dT-An; Wed, 21 Jun 2023 10:10:55 -0400 Date: Wed, 21 Jun 2023 17:11:04 +0300 Message-Id: <83o7l852iv.fsf@gnu.org> To: Bruno Larsen Cc: gdb-patches@sourceware.org In-Reply-To: <28ec469a-e3d4-d284-0785-02c93c21246e@redhat.com> (message from Bruno Larsen on Wed, 21 Jun 2023 14:55:25 +0200) Subject: Re: [PATCH v3 4/4] gdb/doc: document '+' argument for 'list' command References: <20230621104545.2530552-1-blarsen@redhat.com> <20230621104545.2530552-5-blarsen@redhat.com> <838rcd5arg.fsf@gnu.org> <83352l56jd.fsf@gnu.org> <28ec469a-e3d4-d284-0785-02c93c21246e@redhat.com> X-Spam-Status: No, score=1.7 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_BARRACUDACENTRAL, SPF_HELO_PASS, SPF_PASS, TXREP, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Level: * X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org 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: Eli Zaretskii via Gdb-patches Reply-To: Eli Zaretskii Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" > Date: Wed, 21 Jun 2023 14:55:25 +0200 > Cc: gdb-patches@sourceware.org > From: Bruno Larsen > > > "list +" lists the ten lines following a previous ten-line listing. > > > > vs > > > > @item list + > > Same as using with no arguments, but errors out if the line is > > past the end of the file. > > > > Or what am I missing? > > > Ah, I see what you mean. I thought that the help text should prioritize > being short over being complete, and I basically modeled it after the > no-arguments help text (With no argument, lists ten more lines after or > around previous listing) whereas the documentation I thought was > important outlining the difference. > > Would you prefer if I made the help text more verbose? You could say in the help text something like "list +" like with no arguments, but errors out if past end of the file