This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
[rfa/doc] tex -> texindex -> tex -> texindex -> tex
- From: Andrew Cagney <ac131313 at cygnus dot com>
- To: gdb-patches at sources dot redhat dot com
- Date: Mon, 21 Jan 2002 03:35:22 -0500
- Subject: [rfa/doc] tex -> texindex -> tex -> texindex -> tex
Hello,
Noticed that the texinfo 4.0 doco mentions that, when building
documentation, the sequence:
tex
texindex
tex
texindex
tex
should be used. The attached does this.
Ok?
Andrew
--
To summarize, this is a five step process:
1. Run `tex' on your Texinfo file. This generates a DVI file (with
undefined cross-references and no indices), and the raw index files
(with two letter extensions).
2. Run `texindex' on the raw index files. This creates the
corresponding sorted index files (with three letter extensions).
3. Run `tex' again on your Texinfo file. This regenerates the DVI
file, this time with indices and defined cross-references, but
with page numbers for the cross-references from last time,
generally incorrect.
4. Sort the indices again, with `texindex'.
5. Run `tex' one last time. This time the correct page numbers are
written for the cross-references.
2002-01-21 Andrew Cagney <ac131313@redhat.com>
* Makefile.in: Update copyright.
(gdb.dvi, gdb.pdf, gdbint.dvi, gdbint.pdf): Use the sequence tex,
texindex, tex, texindex, tex, when generating documents.
Index: Makefile.in
===================================================================
RCS file: /cvs/src/src/gdb/doc/Makefile.in,v
retrieving revision 1.17
diff -u -r1.17 Makefile.in
--- Makefile.in 2002/01/17 08:54:12 1.17
+++ Makefile.in 2002/01/21 08:28:53
@@ -1,4 +1,4 @@
-##Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1999, 2000
+##Copyright 1991, 1992, 1993, 1994, 1995, 1996, 1999, 2000, 2002
##Free Software Foundation, Inc.
# Makefile for GDB documentation.
@@ -247,6 +247,7 @@
ln $(srcdir)/GDBvn.texi . || \
cp $(srcdir)/GDBvn.texi . ; else true; fi
$(SET_TEXINPUTS) $(TEX) gdb.texinfo
+ $(TEXINDEX) gdb.??
$(SET_TEXINPUTS) $(TEX) gdb.texinfo
$(TEXINDEX) gdb.??
$(SET_TEXINPUTS) $(TEX) gdb.texinfo
@@ -262,6 +263,7 @@
ln $(srcdir)/GDBvn.texi . || \
cp $(srcdir)/GDBvn.texi . ; else true; fi
$(SET_TEXINPUTS) $(PDFTEX) gdb.texinfo
+ $(TEXINDEX) gdb.??
$(SET_TEXINPUTS) $(PDFTEX) gdb.texinfo
$(TEXINDEX) gdb.??
$(SET_TEXINPUTS) $(PDFTEX) gdb.texinfo
@@ -375,6 +377,8 @@
$(SET_TEXINPUTS) $(TEX) gdbint.texinfo
$(TEXINDEX) gdbint.??
$(SET_TEXINPUTS) $(TEX) gdbint.texinfo
+ $(TEXINDEX) gdbint.??
+ $(SET_TEXINPUTS) $(TEX) gdbint.texinfo
rm -f gdbint.aux gdbint.cp* gdbint.fn* gdbint.ky* \
gdbint.log gdbint.pg* gdbint.toc gdbint.tp* gdbint.vr*
@@ -382,6 +386,8 @@
$(DVIPS) -o $@ $?
gdbint.pdf: gdbint.dvi
+ $(SET_TEXINPUTS) $(PDFTEX) gdbint.texinfo
+ $(TEXINDEX) gdbint.??
$(SET_TEXINPUTS) $(PDFTEX) gdbint.texinfo
$(TEXINDEX) gdbint.??
$(SET_TEXINPUTS) $(PDFTEX) gdbint.texinfo