From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 20108 invoked by alias); 8 Apr 2013 11:26:58 -0000 Mailing-List: contact archer-commits-help@sourceware.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Subscribe: Received: (qmail 20083 invoked by uid 9674); 8 Apr 2013 11:26:57 -0000 Date: Mon, 08 Apr 2013 11:26:00 -0000 Message-ID: <20130408112657.20052.qmail@sourceware.org> From: jkratoch@sourceware.org To: archer-commits@sourceware.org Subject: [SCM] jankratochvil/man: Merge branch 'addindex' into jankratochvil/man X-Git-Refname: refs/heads/jankratochvil/man X-Git-Reftype: branch X-Git-Oldrev: da3218d9de387fa78680a3dacfb9ae053d38dca3 X-Git-Newrev: bdbe622e9b047621e003095cbc840e839127aa15 X-SW-Source: 2013-q2/txt/msg00009.txt.bz2 List-Id: 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 Conflicts: gdb/doc/Makefile.in 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/Makefile.in | 13 ++++++++++++- gdb/doc/gdb.texinfo | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 60 insertions(+), 1 deletions(-) First 500 lines of diff: diff --git a/gdb/doc/Makefile.in b/gdb/doc/Makefile.in index 4ad31d9..effd665 100644 --- a/gdb/doc/Makefile.in +++ b/gdb/doc/Makefile.in @@ -177,7 +177,7 @@ POD2MAN5 = pod2man --center="GNU Development Tools" \ --release="gdb-`sed q $(srcdir)/../version.in`" --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 + +@smallexample +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 hooks/post-receive -- Repository for Project Archer.