From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id OcO6Nr7+NmgbyjcAWB0awg (envelope-from ) for ; Wed, 28 May 2025 08:17:02 -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=TOjnpnDn; dkim-atps=neutral Received: by simark.ca (Postfix, from userid 112) id D13BB1E11C; Wed, 28 May 2025 08:17:02 -0400 (EDT) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-25) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=ARC_SIGNED,ARC_VALID,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,RCVD_IN_SBL_CSS,RCVD_IN_VALIDITY_CERTIFIED, RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE autolearn=ham autolearn_force=no version=4.0.1 Received: from server2.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 ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 17ABB1E102 for ; Wed, 28 May 2025 08:17:02 -0400 (EDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 9D56E3851408 for ; Wed, 28 May 2025 12:17:01 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9D56E3851408 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1748434621; bh=sE5EoRE9miEjs9hMC/z3IR1uTsv/AOmg0dEdWwovUu0=; h=Date:Subject:To:Cc:References:In-Reply-To:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=TOjnpnDnCcL5O+5T983e+huqcC41pyKea3be/e+r3QpFTuD6VoJDDyOy06DELvLKF c+CoVMGAFu/oe8L9B5IfwyDPDMprgl0dboiMJrjjYyr5Rj2ZlCuEuxVVfakRCNhhYL Gjn3i2VGi1QLc8XBWiPytC6tvX3jyxKC1RsssNsc= Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTP id 9227C3858D32 for ; Wed, 28 May 2025 12:16:05 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 9227C3858D32 ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 9227C3858D32 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1748434565; cv=none; b=I7lPoOlCMBaKUFJDEHzMjp3n/+FTWz4gjKTU9RJKhacPbvwsxtMrVwd7hUyF5wL9JZfYedFIhGWevYuXR8iDMDZHUjntvJltCegpoIo/SLNooZYl9Q34G7DMZvktuib5ZB0oa35ct4imxNqc6J167l8rxLaVo3BUgjGFSTGYjbY= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1748434565; c=relaxed/simple; bh=QbIOTI5ZmchldjUtpHKK+FBxVZJfe+0NOyCoir/nhWU=; h=DKIM-Signature:Message-ID:Date:MIME-Version:Subject:To:From; b=II+5lvfnUWi+k42ilQcbAes3rkjgDWjNKtboHPqx5wWa0JpUow/2PtGQ/31iaJF8XvG8Ncgrca2AvxOIO9Qh4mJb7MTu1bGmiiVoBVuM64aVfflIJoRdpQO1e224KN8WP5LjF9tiGxoBxSsTITh8zFOuFE3L2kXGmyq6vXn+mQI= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9227C3858D32 Received: from mail-vk1-f198.google.com (mail-vk1-f198.google.com [209.85.221.198]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-136-QM21SdZwNM6D3TC0cfOgmw-1; Wed, 28 May 2025 08:16:03 -0400 X-MC-Unique: QM21SdZwNM6D3TC0cfOgmw-1 X-Mimecast-MFC-AGG-ID: QM21SdZwNM6D3TC0cfOgmw_1748434563 Received: by mail-vk1-f198.google.com with SMTP id 71dfb90a1353d-52f46430010so2099390e0c.0 for ; Wed, 28 May 2025 05:16:03 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1748434563; x=1749039363; h=in-reply-to:from:content-language:references:cc:to:subject :user-agent:mime-version:date:message-id:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=+HDyJH7FVmeb8bnN+lwpFEW5zaFpCyBsQQGqqezrN3Q=; b=JwEYk2z+eVquS9pJX5h9+F/Uzzoeq/a057VQ8ZJK3Xuteiqw4rWnIDrk962ZSs+ti0 cHrIST2DTlOaLZo3VfWcLaAu2Rfs28qI7Aj1k0674mt+dgotW1icTFnt9sZgJLjimvRo voSLYBLvxh9e23cF0aT8QKa3AztI8PyKUwkPIScA/a8lrrvu5zxCZ+TB/lX49x6KGgQZ w2n1wGEZ3Qh5ubGh0hWnFYSnCtw2iIINwhOVwgnDKw3fO6huzaLhyvYIRScT0CxFsvqK IdfJpclyEYUISeuu0bnfDUbwGoEXc/SlnfkWAoIkJycGXTIEmisqQHEsf12kOA5fgEPs 84LA== X-Gm-Message-State: AOJu0Yx0ZVTgsJOkgU5IbmS0JtFbdtOkVxyvTnULWbBgfyQ1S06QJDfp TiETEdslNKSNT3baUYzl5EeBQaTovOZY1DbUf92BEsSQ3N4UlRCNjM+VDCTXnHZ0IK367fSxHMT nRwpH64dfb1Nq6trAHAcwyN1WDhfVBTPupJ9jUISD0JIs5o/a+LH28JwXG7Jd X-Gm-Gg: ASbGncsxkR4mBUHQoHqmnJS0MiQncijBpIvr1vNSWnXC1PgDmcDgS15MYpmIBVZ3huy MBevtWo5PaJJUCpNsy+obFlDUHmRMraRep6DaSj/vHXvTvU5G496TNbq4h2RRDgJrvCDNQ5P1VV mOu4tMla7afF8VDNGH0V+ulRfu5KYDjOn1uvmkeKLQvm4OXGcgVGXR/OyMHKZzxPEW1cF5JsUOp a3eb7WAPcuKG86g+OH+q6f9gzBC1QOYd19/6DDjL8g8IK/wkVI/pAvlWzK3g7nLDhDeHBF3/TSm dQn/xi3FjlnGMXyiYb3BsqA= X-Received: by 2002:a05:6122:848e:b0:530:5308:42ec with SMTP id 71dfb90a1353d-530530845a1mr3945551e0c.8.1748434562774; Wed, 28 May 2025 05:16:02 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHSLGOujXsKLh09eO9T4qj8ciaStxFoF0vYis1ugpDNkNZpZOw0PQEGuCTbPhdHehKAfE6lhw== X-Received: by 2002:a05:6122:848e:b0:530:5308:42ec with SMTP id 71dfb90a1353d-530530845a1mr3945513e0c.8.1748434562289; Wed, 28 May 2025 05:16:02 -0700 (PDT) Received: from ?IPV6:2804:14d:8084:9a69::1001? ([2804:14d:8084:9a69::1001]) by smtp.gmail.com with ESMTPSA id 71dfb90a1353d-530669749c4sm856940e0c.45.2025.05.28.05.16.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 28 May 2025 05:16:01 -0700 (PDT) Message-ID: <7bf8f6cc-2017-4cd4-9b74-bddaa4f1a4d3@redhat.com> Date: Wed, 28 May 2025 09:15:59 -0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: Improve GDB's first user experience by reducing "print_gdb_version" output To: Eli Zaretskii Cc: gdb@sourceware.org References: <0bfd51f7-2246-475c-b171-8dde8474227a@redhat.com> <86plftvuaz.fsf@gnu.org> In-Reply-To: <86plftvuaz.fsf@gnu.org> X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: XtD_BP_-4oumduNfo28pQsSM4hllu4ZOXMBJFlXJEyk_1748434563 X-Mimecast-Originator: redhat.com Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Content-Filtered-By: Mailman/MimeDel 2.1.30 X-BeenThere: gdb@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Guinevere Larsen via Gdb Reply-To: Guinevere Larsen Errors-To: gdb-bounces~public-inbox=simark.ca@sourceware.org Sender: "Gdb" On 5/28/25 8:39 AM, Eli Zaretskii wrote: >> Date: Tue, 27 May 2025 17:43:18 -0300 >> From: Guinevere Larsen via Gdb >> >> GNU gdb (GDB) 17.0.50.20250526-git >> Copyright (C) 2024 Free Software Foundation, Inc. >> License GPLv3+: GNU GPL version 3 or later >> >> This is free software: you are free to change and redistribute it. >> There is NO WARRANTY, to the extent permitted by law. >> Type "show copying" and "show warranty" for details. >> This GDB was configured as "x86_64-pc-linux-gnu". >> Type "show configuration" for configuration details. >> For bug reporting instructions, please see: >> . >> Find the GDB manual and other documentation resources online at: >> . >> >> For help, type "help". >> Type "apropos word" to search for commands related to "word". >> (gdb) >> >> For the *vast* majority of our users, only 4 of those lines are useful >> at all: the GDB version (to ask for help), where to find the >> documentation, the "help" command, and the "apropos" command. Arguably, >> where to report bugs could be useful, but the worst ones already print >> it and otherwise users are incredibly unlikely to report them >> (especially given the email requirements to create an account). Worthy >> of note, the important lines are the last ones, so even if a new user >> was eager enough to start reading everything, they'd likely gloss over >> everything assuming this entire thing is just copyright. >> >> I propose that the text be updated to something similar to this: >> >> GNU gdb (GDB) 17.0.50.20250526-git >> For a list of commands, use "help" >> For all commands related to a certain word, use "apropos word" >> For a thorough explanation of what GDB can do, check the manual at: >> >> For information on GDB's copyright, warranty or configuration, use >>     "show copying/warranty/configuration" >> (gdb) > This line is NOT redundant, and conveys important information: > > This GDB was configured as "x86_64-pc-linux-gnu". Strictly speaking, none of the lines in the introduction are fully redundant, they will all be useful in niche situations. My claim is that for most users, and especially new users, this reads as visual noise that obscures the helpful commands to start using GDB. And worse in this specific situation, I would expect that many cases where that knowledge would be important, the information would have scrolled off the screen and a refresher would be needed either way. Further thinking about the end goal, it would be good to have an even more descriptive message if GDB thinks that this can be an entirely new user, which explains more things and would be disabled by adding something to a gdbinit, something like "set existing-user 1", and explaining what the gdbinit even is. With that, if a user ends up finding that knowing the configuration is important, they will be aware that they can add "show configuration". > Also, why did you decide to change the wording of this line: > > Type "apropos word" to search for commands related to "word". > > I think the original wording was good. > The wording here isn't meant to be taken literally, it was chosen quickly to illustrate what kind of changes I had in mind. The quick change was just to standardize the suggestions as "for , use ", but that detail side of the discussion can be left for when a patch making these changes -- Cheers, Guinevere Larsen She/Her/Hers