From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6132 invoked by alias); 21 Jun 2013 09:53:55 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 6117 invoked by uid 89); 21 Jun 2013 09:53:54 -0000 X-Spam-SWARE-Status: No, score=-7.6 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_HOSTKARMA_W,RCVD_IN_HOSTKARMA_WL,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.1 Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Fri, 21 Jun 2013 09:53:54 +0000 Received: from int-mx11.intmail.prod.int.phx2.redhat.com (int-mx11.intmail.prod.int.phx2.redhat.com [10.5.11.24]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id r5L9rqIj032134 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 21 Jun 2013 05:53:52 -0400 Received: from localhost.localdomain (ovpn-112-47.ams2.redhat.com [10.36.112.47]) by int-mx11.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id r5L9rp6m008015; Fri, 21 Jun 2013 05:53:51 -0400 Message-ID: <51C422AE.7000507@redhat.com> Date: Fri, 21 Jun 2013 10:50:00 -0000 From: Phil Muldoon MIME-Version: 1.0 To: Pedro Alves CC: "gdb-patches@sourceware.org" Subject: Re: [rfc] Add help text to start-up text References: <51B8D10E.5030409@redhat.com> <51B98CEE.3080006@redhat.com> In-Reply-To: <51B98CEE.3080006@redhat.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-SW-Source: 2013-06/txt/msg00580.txt.bz2 On 13/06/13 10:12, Pedro Alves wrote: > On 06/12/2013 08:50 PM, Phil Muldoon wrote: >> This patch proposes to add a few items to the GDB start-up text to >> provide some indication on where the user can find help. > I think at least the help and apropos bits are going to be super useful. > I like that a lot. > >> + fprintf_filtered (stream, _("The GDB manual can be found online at:\n\ >> +\n")); >> + fprintf_filtered (stream, _("The GDB wiki can be found online at:\n\ >> +\n\n")); I've updated the patch with yours and other reviewers' suggestions. The start-up text now reads: GNU gdb (GDB) 7.6.50.20130612-cvs Copyright (C) 2013 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-unknown-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". What do you think? Cheers Phil 2013-06-21 Phil Muldoon * top.c (print_gdb_version): Add help, apropos description and url to online documentation. -- diff --git a/gdb/top.c b/gdb/top.c index 8ac756f..529a784 100644 --- a/gdb/top.c +++ b/gdb/top.c @@ -1156,8 +1156,14 @@ Type \"show configuration\" for configuration details."); { fprintf_filtered (stream, _("\nFor bug reporting instructions, please see:\n")); - fprintf_filtered (stream, "%s.", REPORT_BUGS_TO); + fprintf_filtered (stream, "%s.\n", REPORT_BUGS_TO); } + fprintf_filtered (stream, + _("Find the GDB manual and other documentation \ +resources online at:\n.\n")); + fprintf_filtered (stream, _("For help, type \"help\".\n")); + fprintf_filtered (stream, _("Type \"apropos word\" to search for \ +commands related to \"word\".\n")); } /* Print the details of GDB build-time configuration. */