[RFA/Doco] Document new <data-dir>/system-gdbinit area

[RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

This documents the introduction of new scripts provided in
a GDB install.

Ref: http://www.sourceware.org/ml/gdb-patches/2013-05/msg00382.html

gdb/doc/ChangeLog:

        * gdb.texinfo (System-wide configuration): Add subsection
        describing the scripts now available under the data-dir's
        system-gdbbinit subdirectory.

OK to apply? Should I also add a NEWS entry for this?

Thank you,
-- 
Joel

---
 gdb/doc/gdb.texinfo |   26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 43b0104..111e352 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -36332,6 +36332,32 @@ initialization.  If the data-directory is changed after @value{GDBN} has
 started with the @code{set data-directory} command, the file will not be
 reread.
 
+@subsection System-wide configuration scripts provided by @value{GDBN}
+
+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
+automatically source those scripts at startup, @value{GDBN} should be
+configured with @option{-with-system-gdbinit}.  Otherwise, any user
+should be able to source them by hand as needed.
+
+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.
+
+@end itemize
+
 @node Maintenance Commands
 @appendix Maintenance Commands
 @cindex maintenance commands
-- 
1.7.10.4

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Pedro Alves]

On 05/21/2013 10:24 AM, Joel Brobecker wrote:

> Should I also add a NEWS entry for this?

IMO, yes.

-- 
Pedro Alves

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Eli Zaretskii]

> Date: Tue, 21 May 2013 16:34:28 +0100
> From: Pedro Alves <palves@redhat.com>
> CC: gdb-patches@sourceware.org
> 
> On 05/21/2013 10:24 AM, Joel Brobecker wrote:
> 
> > Should I also add a NEWS entry for this?
> 
> IMO, yes.

I agree.  This kind of changes will go unnoticed unless we announce
them where most people will look.

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Eli Zaretskii]

> From: Joel Brobecker <brobecker@adacore.com>
> 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.

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 979 bytes --]

> > 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.

I didn't know... I will gladly fix it.

First attached is a patch which provides the changes made on top
of the first submission, showing the changes I made based on your
feedback. It also includes a NEWS entry.

And second patch is the actual full patch.

gdb/doc/ChangeLog:

        * gdb.texinfo (Installed System-wide Configuration Scripts):
        Add subsection describing the scripts now available under
        the data-dir's system-gdbbinit subdirectory.
        * NEWS: Add entry announcing the availability of system-wide
        configuration scripts for ElinOS and Wind River Linux.

OK to commit?

Thank you,
-- 
Joel
-- 
Joel

[-- Attachment #2: doco-fixes.diff --]
[-- Type: text/x-diff, Size: 2754 bytes --]

From 76d5c10e6a7baff4f88f2a77d51bb7234bb247b4 Mon Sep 17 00:00:00 2001
From: Joel Brobecker <brobecker@adacore.com>
Date: Wed, 22 May 2013 10:21:55 +0400
Subject: [PATCH] Adjustments to doco patch re: system-gdbinit scripts.

---
 gdb/NEWS            |    6 ++++++
 gdb/doc/gdb.texinfo |   12 +++++++++---
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/gdb/NEWS b/gdb/NEWS
index e09907c..458c5f1 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -72,6 +72,12 @@ show debug nios2
 
   ** The new command -dprintf-insert sets a dynamic printf breakpoint.
 
+* New system-wide configuration scripts
+  A GDB installation now provides scripts suitable as system-wide
+  configuration scripts for the following systems:
+    ** ElinOS
+    ** Wind River Linux
+
 *** Changes in GDB 7.6
 
 * Target record has been renamed to record-full.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 111e352..cb98135 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -36332,19 +36332,23 @@ initialization.  If the data-directory is changed after @value{GDBN} has
 started with the @code{set data-directory} command, the file will not be
 reread.
 
-@subsection System-wide configuration scripts provided by @value{GDBN}
+@node Installed System-wide Configuration Scripts
+@subsection Installed System-wide Configuration Scripts
+@cindex System-wide configuration scripts
 
 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
+a number of scripts which can be used as system-wide init files.  To
 automatically source those scripts at startup, @value{GDBN} should be
-configured with @option{-with-system-gdbinit}.  Otherwise, any user
+configured with @option{--with-system-gdbinit}.  Otherwise, any user
 should be able to source them by hand as needed.
 
 The following scripts are currently available:
 @itemize @bullet
 
 @item @file{elinos.py}
+@pindex elinos.py
+@cindex ELinOS system-wide configuration script
 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
@@ -36352,6 +36356,8 @@ shared libraries, and then sets the @samp{solib-absolute-prefix}
 and @samp{solib-search-path} variables appropriately.
 
 @item @file{wrs-linux.py}
+@pindex wrs-linux.py
+@cindex Wind River Linux system-wide configuration script
 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.
-- 
1.7.10.4


[-- Attachment #3: 0001-Document-new-data-dir-system-gdbinit-area.patch --]
[-- Type: text/x-diff, Size: 2970 bytes --]

From 1cecd9968f0f8c1a8ec7f5efba741a288026e71a Mon Sep 17 00:00:00 2001
From: Joel Brobecker <brobecker@adacore.com>
Date: Tue, 21 May 2013 13:18:54 +0400
Subject: [PATCH] Document new <data-dir>/system-gdbinit area

gdb/doc/ChangeLog:

        * gdb.texinfo (Installed System-wide Configuration Scripts):
        Add subsection describing the scripts now available under
        the data-dir's system-gdbbinit subdirectory.
        * NEWS: Add entry announcing the availability of system-wide
        configuration scripts for ElinOS and Wind River Linux.
---
 gdb/NEWS            |    6 ++++++
 gdb/doc/gdb.texinfo |   32 ++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/gdb/NEWS b/gdb/NEWS
index e09907c..c6a5e5d 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -72,6 +72,12 @@ show debug nios2
 
   ** The new command -dprintf-insert sets a dynamic printf breakpoint.
 
+* New system-wide configuration scripts
+  A GDB installation now provides scripts suitable for use as system-wide
+  configuration scripts for the following systems:
+    ** ElinOS
+    ** Wind River Linux
+
 *** Changes in GDB 7.6
 
 * Target record has been renamed to record-full.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 43b0104..cb98135 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -36332,6 +36332,38 @@ initialization.  If the data-directory is changed after @value{GDBN} has
 started with the @code{set data-directory} command, the file will not be
 reread.
 
+@node Installed System-wide Configuration Scripts
+@subsection Installed System-wide Configuration Scripts
+@cindex System-wide configuration scripts
+
+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
+automatically source those scripts at startup, @value{GDBN} should be
+configured with @option{--with-system-gdbinit}.  Otherwise, any user
+should be able to source them by hand as needed.
+
+The following scripts are currently available:
+@itemize @bullet
+
+@item @file{elinos.py}
+@pindex elinos.py
+@cindex ELinOS system-wide configuration script
+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}
+@pindex wrs-linux.py
+@cindex Wind River Linux system-wide configuration script
+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.
+
+@end itemize
+
 @node Maintenance Commands
 @appendix Maintenance Commands
 @cindex maintenance commands
-- 
1.7.10.4

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Eli Zaretskii]

> Date: Wed, 22 May 2013 10:28:15 +0400
> From: Joel Brobecker <brobecker@adacore.com>
> Cc: gdb-patches@sourceware.org
> 
> > Ugh, a subsection without a @node...  Why people like them so much?
> > They make navigation inside an Info reader harder.
> 
> I didn't know... I will gladly fix it.

Thanks.

> First attached is a patch which provides the changes made on top
> of the first submission, showing the changes I made based on your
> feedback. It also includes a NEWS entry.
> 
> And second patch is the actual full patch.
> 
> gdb/doc/ChangeLog:
> 
>         * gdb.texinfo (Installed System-wide Configuration Scripts):
>         Add subsection describing the scripts now available under
>         the data-dir's system-gdbbinit subdirectory.
>         * NEWS: Add entry announcing the availability of system-wide
>         configuration scripts for ElinOS and Wind River Linux.
> 
> OK to commit?

Yes, with one gotcha:

> +@node Installed System-wide Configuration Scripts
> +@subsection Installed System-wide Configuration Scripts
> +@cindex System-wide configuration scripts

@cindex entries should begin with a lower-case letter, unless it's a
proper name or acronym.  (This is because mixed-case sorts differently
in different locales.)

Thanks.

Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 802 bytes --]

> > First attached is a patch which provides the changes made on top
> > of the first submission, showing the changes I made based on your
> > feedback. It also includes a NEWS entry.
> > 
> > And second patch is the actual full patch.
> > 
> > gdb/doc/ChangeLog:
> > 
> >         * gdb.texinfo (Installed System-wide Configuration Scripts):
> >         Add subsection describing the scripts now available under
> >         the data-dir's system-gdbbinit subdirectory.
> >         * NEWS: Add entry announcing the availability of system-wide
> >         configuration scripts for ElinOS and Wind River Linux.
> > 
> > OK to commit?
> 
> Yes, with one gotcha:

Thanks, Eli. Checked in with the small correction you pointed out.
For the record, attached is the exact patch that got checked in.

-- 
Joel

[-- Attachment #2: 0001-Document-new-data-dir-system-gdbinit-area.patch --]
[-- Type: text/x-diff, Size: 3606 bytes --]

From 8f25b97456ed86e16ece4b9571585a07ed6a4485 Mon Sep 17 00:00:00 2001
From: Joel Brobecker <brobecker@adacore.com>
Date: Tue, 21 May 2013 13:18:54 +0400
Subject: [PATCH] Document new <data-dir>/system-gdbinit area

gdb/doc/ChangeLog:

        * gdb.texinfo (Installed System-wide Configuration Scripts):
        Add subsection describing the scripts now available under
        the data-dir's system-gdbbinit subdirectory.
        * NEWS: Add entry announcing the availability of system-wide
        configuration scripts for ElinOS and Wind River Linux.
---
 gdb/NEWS            |    6 ++++++
 gdb/doc/ChangeLog   |    8 ++++++++
 gdb/doc/gdb.texinfo |   32 ++++++++++++++++++++++++++++++++
 3 files changed, 46 insertions(+)

diff --git a/gdb/NEWS b/gdb/NEWS
index e09907c..c6a5e5d 100644
--- a/gdb/NEWS
+++ b/gdb/NEWS
@@ -72,6 +72,12 @@ show debug nios2
 
   ** The new command -dprintf-insert sets a dynamic printf breakpoint.
 
+* New system-wide configuration scripts
+  A GDB installation now provides scripts suitable for use as system-wide
+  configuration scripts for the following systems:
+    ** ElinOS
+    ** Wind River Linux
+
 *** Changes in GDB 7.6
 
 * Target record has been renamed to record-full.
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 41e08b8..ddc766a 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,11 @@
+2013-05-23  Joel Brobecker  <brobecker@adacore.com>
+
+	* gdb.texinfo (Installed System-wide Configuration Scripts):
+	Add subsection describing the scripts now available under
+	the data-dir's system-gdbbinit subdirectory.
+	* NEWS: Add entry announcing the availability of system-wide
+	configuration scripts for ElinOS and Wind River Linux.
+
 2013-05-21  Hui Zhu  <hui@codesourcery.com>
 
 	* gdb.texinfo (GDB/MI Breakpoint Commands): Describe the
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 43b0104..b68d2f8 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -36332,6 +36332,38 @@ initialization.  If the data-directory is changed after @value{GDBN} has
 started with the @code{set data-directory} command, the file will not be
 reread.
 
+@node Installed System-wide Configuration Scripts
+@subsection Installed System-wide Configuration Scripts
+@cindex system-wide configuration scripts
+
+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
+automatically source those scripts at startup, @value{GDBN} should be
+configured with @option{--with-system-gdbinit}.  Otherwise, any user
+should be able to source them by hand as needed.
+
+The following scripts are currently available:
+@itemize @bullet
+
+@item @file{elinos.py}
+@pindex elinos.py
+@cindex ELinOS system-wide configuration script
+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}
+@pindex wrs-linux.py
+@cindex Wind River Linux system-wide configuration script
+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.
+
+@end itemize
+
 @node Maintenance Commands
 @appendix Maintenance Commands
 @cindex maintenance commands
-- 
1.7.10.4

Re: Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[asmwarrior]

On 2013-5-23 14:08, Joel Brobecker wrote:
>>> First attached is a patch which provides the changes made on top
>>> of the first submission, showing the changes I made based on your
>>> feedback. It also includes a NEWS entry.
>>>
>>> And second patch is the actual full patch.
>>>
>>> gdb/doc/ChangeLog:
>>>
>>>         * gdb.texinfo (Installed System-wide Configuration Scripts):
>>>         Add subsection describing the scripts now available under
>>>         the data-dir's system-gdbbinit subdirectory.
>>>         * NEWS: Add entry announcing the availability of system-wide
>>>         configuration scripts for ElinOS and Wind River Linux.
>>>
>>> OK to commit?
>>
>> Yes, with one gotcha:
> 
> Thanks, Eli. Checked in with the small correction you pointed out.
> For the record, attached is the exact patch that got checked in.
> 

I see an error when I run the command below (in MSYS)
make install INSTALL_PROGRAM='install -s' -C gdb

make[2]: Entering directory `/f/build_gdb/abuild/gdb'
make[3]: Entering directory `/f/build_gdb/abuild/gdb/doc'
echo "@set GDBVN `sed q ../../../archer/gdb/doc/../version.in`" > ./GDBvn.new
if [ -n "(GDB) " ]; then \
          echo "@set VERSION_PACKAGE (GDB) " >> ./GDBvn.new; \
        fi
echo "@set BUGURL @uref{http://www.gnu.org/software/gdb/bugs/}" >> ./GDBvn.new
if [ "@uref{http://www.gnu.org/software/gdb/bugs/}" = "@uref{http://www.gnu.org/
software/gdb/bugs/}" ]; then \
          echo "@set BUGURL_DEFAULT" >> ./GDBvn.new; \
        fi
if test -z "-I ../../../archer/gdb/doc/../../readline/doc"; then \
          echo "@set SYSTEM_READLINE" >> ./GDBvn.new; \
        fi
if [ -n "" ]; then \
          echo "@set SYSTEM_GDBINIT " >> ./GDBvn.new; \
        fi
mv GDBvn.new GDBvn.texi
makeinfo --split-size=5000000  -DHAVE_MAKEINFO_CLICK -I ../../../archer/gdb/doc/
../../readline/doc -I ../../../archer/gdb/doc/../mi -I ../../../archer/gdb/doc \

                -o gdb.info ../../../archer/gdb/doc/gdb.texinfo
../../../archer/gdb/doc/gdb.texinfo:36367: `Installed System-wide Configuration
Scripts' has no Up field (perhaps incorrect sectioning?).
../../../archer/gdb/doc/gdb.texinfo:36367: warning: unreferenced node `Installed
 System-wide Configuration Scripts'.
makeinfo: Removing output file `gdb.info' due to errors; use --force to preserve
.
make[3]: *** [gdb.info] Error 1
make[3]: Leaving directory `/f/build_gdb/abuild/gdb/doc'
make[2]: *** [subdir_do] Error 1
make[2]: Leaving directory `/f/build_gdb/abuild/gdb'
make[1]: *** [install-only] Error 2
make[1]: Leaving directory `/f/build_gdb/abuild/gdb'
make: *** [install] Error 2
make: Leaving directory `/f/build_gdb/abuild/gdb'


Any ideas?

Yuanhui Zhang

Re: Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

> I see an error when I run the command below (in MSYS)
[...]
> ../../../archer/gdb/doc/gdb.texinfo:36367: `Installed System-wide Configuration
> Scripts' has no Up field (perhaps incorrect sectioning?).
> ../../../archer/gdb/doc/gdb.texinfo:36367: warning: unreferenced node `Installed
>  System-wide Configuration Scripts'.

My apologies. I normally rebuild all formats when I make a change,
but I must have forgotten about the info format after I added the
@node to the @subection. Fixed thusly.

gdb/doc/ChangeLog:

        * gdb.texinfo (System-wide Configuration Scripts): Renames
        "Installed System-wide Configuration Scripts". Add associated
        @menu block.

Eli,

I installed this as an emergency fix, but I am ready to make any
further adjustment you might require. For this patch, I shortened
the node name a bit, but I think it'd be nice to shorten it further
to make it fit in 80 columns, if we have some good suggestions.

Thanks,
-- 
Joel

Re: Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 218 bytes --]

> gdb/doc/ChangeLog:
> 
>         * gdb.texinfo (System-wide Configuration Scripts): Renames
>         "Installed System-wide Configuration Scripts". Add associated
>         @menu block.

ENOPATCH (sigh...)

-- 
Joel

[-- Attachment #2: 0001-Fix-gdb.info-build-failure.patch --]
[-- Type: text/x-diff, Size: 1777 bytes --]

From d1a7eb5c7c80dd296d4a1aed91b577b555ce650e Mon Sep 17 00:00:00 2001
From: Joel Brobecker <brobecker@adacore.com>
Date: Fri, 24 May 2013 08:39:24 +0400
Subject: [PATCH] Fix gdb.info build failure

    gdb.texinfo:36367: `Installed System-wide Configuration Scripts' has no Up field (perhaps incorrect sectioning?).
    gdb.texinfo:36367: warning: unreferenced node `Installed System-wide Configuration Scripts'.

gdb/doc/ChangeLog:

        * gdb.texinfo (System-wide Configuration Scripts): Renames
        "Installed System-wide Configuration Scripts". Add associated
        @menu block.
---
 gdb/doc/ChangeLog   |    6 ++++++
 gdb/doc/gdb.texinfo |    6 +++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 7330f29..bb290ca 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2013-05-23  Joel Brobecker  <brobecker@adacore.com>
+
+	* gdb.texinfo (System-wide Configuration Scripts): Renames
+	"Installed System-wide Configuration Scripts". Add associated
+	@menu block.
+
 2013-05-23  Yao Qi  <yao@codesourcery.com>
 	    Pedro Alves  <palves@redhat.com>
 
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 721e96a..ead00b4 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -36364,7 +36364,11 @@ initialization.  If the data-directory is changed after @value{GDBN} has
 started with the @code{set data-directory} command, the file will not be
 reread.
 
-@node Installed System-wide Configuration Scripts
+@menu
+* System-wide Configuration Scripts::  Installed System-wide Configuration Scripts
+@end menu
+
+@node System-wide Configuration Scripts
 @subsection Installed System-wide Configuration Scripts
 @cindex system-wide configuration scripts
 
-- 
1.7.10.4

Re: Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Eli Zaretskii]

> Date: Fri, 24 May 2013 08:53:43 +0400
> From: Joel Brobecker <brobecker@adacore.com>
> Cc: Eli Zaretskii <eliz@gnu.org>, gdb-patches@sourceware.org
> 
> gdb/doc/ChangeLog:
> 
>         * gdb.texinfo (System-wide Configuration Scripts): Renames
>         "Installed System-wide Configuration Scripts". Add associated
>         @menu block.
> 
> Eli,
> 
> I installed this as an emergency fix, but I am ready to make any
> further adjustment you might require.

None needed, thanks.

> For this patch, I shortened the node name a bit, but I think it'd be
> nice to shorten it further to make it fit in 80 columns, if we have
> some good suggestions.

Maybe "System Configuration Scripts".  It's not too long already.

Re: [RFA/Doco] Document new <data-dir>/system-gdbinit area

[Joel Brobecker]

> 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.

I forgot to answer this part of the message, even though I meant to:
I agree with the suggestion. This is actually something we have been
doing at AdaCore for the past few years already, by configuring
the data-directory manually.

-- 
Joel