From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org 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 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=ZkTF9rSTckAgp6tGqCz3lPl1jKE9tctMWlHxZbkEvHQ=; b=ptk44gXnSdfK +hUIuqOejHBTLodJSC1yYcbTansw2zyUkkNt9MQ4UBDHoCJAxsO71ZsXgpNWaNJElWU3NgSZWXL7a davZYrVoxaO74A9VerGm4zYZFqpH0Y3NKupULp3H6lAA1pUJKQhKZaHyxru+h6o+0e0AmunLsUe8m +ZKSBdNitl3tpcKf+7voAlS3q+u3Bnkdl1AnQFy70As3gOr9A3zO8X1FMiXAGmzt3ozHSu8Q9Sy/+ buwzixTde4w4tPuNLh0RbCsU66uGqpXdLknzaVaZzMy8gI01A72F9xImyVH8cIkut5gB2Si34hkE2 80laiIPE3gFpxxEr9oEyuQ==; 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> From: Eli Zaretskii 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 List-Id: > 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