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 51937386F47A for ; Thu, 8 Oct 2020 06:44:49 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 51937386F47A Received: from fencepost.gnu.org ([2001:470:142:3::e]:59423) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kQPfU-0000Sj-8X; Thu, 08 Oct 2020 02:44:48 -0400 Received: from [176.228.60.248] (port=2790 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kQPfS-0005Tb-H8; Thu, 08 Oct 2020 02:44:47 -0400 Date: Thu, 08 Oct 2020 09:44:54 +0300 Message-Id: <83ft6p8bdl.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org, tom@tromey.com In-Reply-To: (message from Andrew Burgess on Wed, 7 Oct 2020 21:05:11 +0100) Subject: Re: [PATCH 7/7] Add "set startup-quietly" References: X-Spam-Status: No, score=-3.8 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, RCVD_IN_DNSWL_LOW, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) 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: , X-List-Received-Date: Thu, 08 Oct 2020 06:44:50 -0000 > From: Andrew Burgess > Date: Wed, 7 Oct 2020 21:05:11 +0100 > Cc: Tom Tromey > > +set startup-quietly on|off > +show startup-quietly > + When enabled, this causes GDB to act as if "-silent" were always > + passed on the command line. This saves the setting into a special > + configuration file, so that it can be read during startup and > + applied. As I wrote earlier, the second sentence is inaccurate/incomplete. > +@kindex set startup-quietly > +@kindex show startup-quietly > +This can also be enabled using @code{set startup-quietly on}. The > +default is @code{off}. Use @code{show startup-quietly} to see the > +current setting. Changing this setting will cause it to automatically > +be saved in a special configuration file, which is read by > +@value{GDBN} early in its startup. Likewise. Also, the text should say explicitly that the setting will not affect any aspect of GDB behavior during the current session. > +The directory in which this file appears depends on the host platform. > +On most systems, the file is in the @file{gdb} subdirectory of the > +directory pointed to by the @env{XDG_CONFIG_HOME} environment > +variable, if it is defined, else in the @file{.config/gdb} > +subdirectory of your home directory. However, on some systems, the > +default may differ according to local convention. Once again, this has been already documented elsewhere in the manual, and in more detail. Please leave here just the cross-reference to that place, and please call that file "startup file", for consistency with the terminology there. > + c = add_setshow_boolean_cmd ("startup-quietly", class_support, > + &startup_quiet, _("\ > +Set whether GDB should start up quietly."), _(" \ > +Show whether GDB should start up quietly."), NULL, I think the doc string should mention that the setting has no effect in this session.