From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5051 invoked by alias); 21 May 2013 17:17:48 -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 5040 invoked by uid 89); 21 May 2013 17:17:47 -0000 X-Spam-SWARE-Status: No, score=-4.2 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RCVD_IN_DNSWL_NONE,RCVD_IN_HOSTKARMA_NO,SPF_SOFTFAIL,TW_DB autolearn=no version=3.3.1 Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Tue, 21 May 2013 17:17:46 +0000 Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MN500100RYSP800@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Tue, 21 May 2013 20:17:32 +0300 (IDT) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MN5001PCS1753B0@a-mtaout22.012.net.il>; Tue, 21 May 2013 20:17:32 +0300 (IDT) Date: Tue, 21 May 2013 17:17:00 -0000 From: Eli Zaretskii Subject: Re: [RFA/Doco] Document new /system-gdbinit area In-reply-to: <1369128288-3495-1-git-send-email-brobecker@adacore.com> To: Joel Brobecker Cc: gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83d2skuuai.fsf@gnu.org> References: <1369128288-3495-1-git-send-email-brobecker@adacore.com> X-SW-Source: 2013-05/txt/msg00777.txt.bz2 > From: Joel Brobecker > Date: Tue, 21 May 2013 13:24:48 +0400 > > This documents the introduction of new scripts provided in > a GDB install. Thanks. > gdb/doc/ChangeLog: > > * gdb.texinfo (System-wide configuration): Add subsection > describing the scripts now available under the data-dir's > system-gdbbinit subdirectory. Ugh, a subsection without a @node... Why people like them so much? They make navigation inside an Info reader harder. > +@subsection System-wide configuration scripts provided by @value{GDBN} Each subsection should have at least one @cindex entry about its main subject(s). > +The @file{system-gdbinit} directory, located inside the data-directory > +(as specified by @option{--with-gdb-datadir} at configure time) contains > +a number of scripts which can be used as system-wide init files. To ^^ Two spaces. > +automatically source those scripts at startup, @value{GDBN} should be > +configured with @option{-with-system-gdbinit}. Otherwise, any user ^ One more hyphen. > +The following scripts are currently available: > +@itemize @bullet > + > +@item @file{elinos.py} > +This script is useful when debugging a program on an ELinOS target. > +It takes advantage of the environment variables defined in a standard > +ELinOS environment in order to determine the location of the system > +shared libraries, and then sets the @samp{solib-absolute-prefix} > +and @samp{solib-search-path} variables appropriately. > + > +@item @file{wrs-linux.py} > +This script is useful when debugging a program on a target running > +Wind River Linux. It expects the @env{ENV_PREFIX} to be set to > +the host-side sysroot used by the target system. There should be a @cindex entry for each of these items, and possibly also a @pindex entry with the name of the script. Think about a reader who knows she read about these somewhere in this humongous manual, and just forgot where... OK with those changes. Btw, with all those scripts we distribute and install, perhaps we should start thinking about installing them into version-specific directories. It becomes harder and harder to have more than one operable GDB version on the same system, because new features cause older GDB to barf.