This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area
- From: Joel Brobecker <brobecker at adacore dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: gdb-patches at sourceware dot org
- Date: Thu, 23 May 2013 10:08:31 +0400
- Subject: Checked in: [RFA/Doco] Document new <data-dir>/system-gdbinit area
- References: <1369128288-3495-1-git-send-email-brobecker at adacore dot com> <83d2skuuai dot fsf at gnu dot org> <20130522062815 dot GZ4017 at adacore dot com> <83obc3t68n dot fsf at gnu dot org>
> > 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
>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