public inbox for
help / color / mirror / Atom feed
Subject: [SCM]  jankratochvil/man: Merge branch 'addindex' into jankratochvil/man
Date: Mon, 08 Apr 2013 11:26:00 -0000	[thread overview]
Message-ID: <> (raw)

The branch, jankratochvil/man has been updated
       via  bdbe622e9b047621e003095cbc840e839127aa15 (commit)
       via  15a3a62594cf4270f5f0bd425f9958e6af9277f1 (commit)
       via  59e76bc290e612e1f8cf858b11293740fe9ca7b1 (commit)
      from  da3218d9de387fa78680a3dacfb9ae053d38dca3 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email.

- Log -----------------------------------------------------------------
commit bdbe622e9b047621e003095cbc840e839127aa15
Merge: da3218d 15a3a62
Author: Jan Kratochvil <>
Date:   Mon Apr 8 13:26:41 2013 +0200

    Merge branch 'addindex' into jankratochvil/man

commit 15a3a62594cf4270f5f0bd425f9958e6af9277f1
Author: Jan Kratochvil <>
Date:   Mon Apr 8 13:25:26 2013 +0200


commit 59e76bc290e612e1f8cf858b11293740fe9ca7b1
Author: Jan Kratochvil <>
Date:   Sun Apr 7 21:29:15 2013 +0200



Summary of changes:
 gdb/doc/ |   13 ++++++++++++-
 gdb/doc/gdb.texinfo |   48 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+), 1 deletions(-)

First 500 lines of diff:
diff --git a/gdb/doc/ b/gdb/doc/
index 4ad31d9..effd665 100644
--- a/gdb/doc/
+++ b/gdb/doc/
@@ -177,7 +177,7 @@ POD2MAN5 = pod2man --center="GNU Development Tools" \
 		   --release="gdb-`sed q $(srcdir)/../`" --section=5
 # List of man pages generated from gdb.texi
-MAN1S = gdb.1 gdbserver.1 gcore.1
+MAN1S = gdb.1 gdbserver.1 gcore.1 gdb-add-index.1
 MAN5S = gdbinit.5
 MANS = $(MAN1S) $(MAN5S)
@@ -605,6 +605,7 @@ gdbserver.1: $(GDB_DOC_FILES)
 		mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1)
 	rm -f gdbserver.pod
+<<<<<<< HEAD
 gcore.1: $(GDB_DOC_FILES)
 	touch $@
 	-$(TEXI2POD) $(MANCONF) -Dgcore < $(srcdir)/gdb.texinfo > gcore.pod
@@ -612,6 +613,16 @@ gcore.1: $(GDB_DOC_FILES)
 		mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1)
 	rm -f gcore.pod
+||||||| merged common ancestors
+gdb-add-index.1: $(GDB_DOC_FILES)
+	touch $@
+	-$(TEXI2POD) $(MANCONF) -Dgdb-add-index < $(srcdir)/gdb.texinfo > gdb-add-index.pod
+	-($(POD2MAN1) gdb-add-index.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \
+		mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1)
+	rm -f gdb-add-index.pod
+>>>>>>> addindex
 gdbinit.5: $(GDB_DOC_FILES)
 	touch $@
 	-$(TEXI2POD) $(MANCONF) -Dgdbinit < $(srcdir)/gdb.texinfo > gdbinit.pod
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index fc2adc3..20306a5 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -41611,6 +41611,7 @@ switch (die->tag)
 * gdbserver man::               Remote Server for the GNU Debugger man page
 * gcore man::                   Generate a core file of a running program
 * gdbinit man::                 gdbinit scripts
+* gdb-add-index man::           Add index files to speed up GDB
 @end menu
 @node gdb man
@@ -42275,6 +42276,53 @@ Richard M. Stallman and Roland H. Pesch, July 1991.
 @end ifset
 @c man end
+@node gdb-add-index man
+@c man title gdb-add-index Add index files to speed up GDB
+@c man begin SYNOPSIS gdb-add-index
+gdb-add-index @var{filename}
+@c man end
+@c man begin DESCRIPTION gdb-add-index
+When GDB finds a symbol file, it scans the symbols in the file in order
+to construct an internal symbol table.  This lets most GDB operations
+work quickly--at the cost of a delay early on.  For large programs,
+this delay can be quite lengthy, so GDB provides a way to build an
+index, which speeds up startup.
+To determine whether a file contains such an index, use the command
+@command{readelf -S filename}: the index is stored in a section named
+@code{.gdb_index}.  Note that the index is never generated for files that do
+not contain DWARF debug information (sections named @code{.debug_*}).
+See more in
+@ifset man
+the @value{GDBN} manual in node @code{Index Files}
+-- shell command @code{info -f gdb -n 'Index Files'}.
+@end ifset
+@ifclear man
+@ref{Index Files}.
+@end ifclear
+@c man end
+@c man begin SEEALSO gdb-add-index
+@ifset man
+The full documentation for @value{GDBN} is maintained as a Texinfo manual.
+If the @code{info} and @code{gdb} programs and @value{GDBN}'s Texinfo
+documentation are properly installed at your site, the command
+info gdb
+@end smallexample
+should give you access to the complete manual.
+@cite{Using GDB: A Guide to the GNU Source-Level Debugger},
+Richard M. Stallman and Roland H. Pesch, July 1991.
+@end ifset
+@c man end
 @include gpl.texi
 @node GNU Free Documentation License

Repository for Project Archer.

             reply	other threads:[~2013-04-08 11:26 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-04-08 11:26 jkratoch [this message]
2013-04-10 19:02 jkratoch

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \ \ \ \

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).