From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3088 invoked by alias); 21 Jan 2002 08:35:34 -0000 Mailing-List: contact gdb-patches-help@sources.redhat.com; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sources.redhat.com Received: (qmail 3051 invoked from network); 21 Jan 2002 08:35:29 -0000 Received: from unknown (HELO localhost.cygnus.com) (24.114.42.213) by sources.redhat.com with SMTP; 21 Jan 2002 08:35:29 -0000 Received: from cygnus.com (localhost [127.0.0.1]) by localhost.cygnus.com (Postfix) with ESMTP id EB3B43F0E for ; Mon, 21 Jan 2002 03:35:24 -0500 (EST) Message-ID: <3C4BD2CA.10407@cygnus.com> Date: Mon, 21 Jan 2002 00:35:00 -0000 From: Andrew Cagney User-Agent: Mozilla/5.0 (X11; U; NetBSD macppc; en-US; rv:0.9.7) Gecko/20020103 X-Accept-Language: en-us MIME-Version: 1.0 To: gdb-patches@sources.redhat.com Subject: [rfa/doc] tex -> texindex -> tex -> texindex -> tex Content-Type: multipart/mixed; boundary="------------000302090409020908070407" X-SW-Source: 2002-01/txt/msg00630.txt.bz2 This is a multi-part message in MIME format. --------------000302090409020908070407 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Content-length: 950 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. --------------000302090409020908070407 Content-Type: text/plain; name="diffs" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="diffs" Content-length: 1754 2002-01-21 Andrew Cagney * 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 --------------000302090409020908070407--