🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: gnu.misc.discuss
Article #75691

Re: How do you build the docs?

#75691
From: Arnold Robbins
Date: Wed, 16 May 1990 16:54
38 lines
2418 bytes
In article <BOB.90May15174636@volitans.MorningStar.Com> bob@MorningStar.Com (Bob Sutterfield) writes:
>In article <1094@manta.NOSC.MIL> psm@manta.NOSC.MIL (Scot Mcintosh) writes:
>   I've just gotten gnu make and am at a loss as to how to create the
>   doc files from the ones supplied. Is there some other utility
>   program I need to run them through?
>
>Install TeX and a dvi-to-whatever translator appropriate for your
>printer.  Copy texinfo.tex from some other GNU software distribution
>(gcc seems to have the most recent version, 2.1).  Then just say `tex
>make.texinfo' to create a make.dvi.  Use dvi2whatever to turn it into
>your printer's format, ...

While this will work, it is suboptimal.  The steps really are

	-1. Install TeX and a dvi-to-whatever translater.
	 0. Copy texinfo.tex from....
	 1. Compile texindex.c from the gnu emacs distribution and
	    put it into your path somewhere.
	 2. tex make.texinfo
	 3. texindex make.??
	 4. tex make.texinfo
	 [ Optional:
	    texindex make.??
	    tex make.texinfo
	 ]
	 5. dvi-to-whatever make.dvi and print

The texindex program fixes up all the cross references in the documentation.
You want to do it several times since the fixed text formats differently
than the unfixed text, so page numbers can change between the first and
subsequent runs of TeX.  This can be painful on large documents on slow
machines, but is worthwhile if you really want the cross references
to be right.
-- 
Arnold Robbins				AudioFAX, Inc. | Laundry increases
2000 Powers Ferry Road, #220 / Marietta, GA. 30067     | exponentially in the
INTERNET: arnold@audiofax.com	Phone: +1 404 933 7600 | number of children.
UUCP:	  emory!audfax!arnold	Fax:   +1 404 933 7606 |   -- Miriam Robbins
Technical Details
Message-ID: <230@audfax.audiofax.com>
Path: arc1-ca.pugleaf.net!gmdzi!unido!mcsun!uunet!tut.cis.ohio-state.edu!zaphod.mps.ohio-state.edu!swrinde!emory!audfax!arnold
References: <1094@manta.NOSC.MIL> <BOB.90May15174636@volitans.MorningStar.Com>

Show Full Headers
Complete Article Headers
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 1025b4,2dfc4712acb07965
X-Google-Attributes: gid1025b4,public
X-Google-ArrivalTime: 1990-05-16 10:53:09 PST
Path: arc1-ca.pugleaf.net!gmdzi!unido!mcsun!uunet!tut.cis.ohio-state.edu!zaphod.mps.ohio-state.edu!swrinde!emory!audfax!arnold
From: arnold@audiofax.com (Arnold Robbins)
Newsgroups: gnu.misc.discuss
Subject: Re: How do you build the docs?
Message-ID: <230@audfax.audiofax.com>
Date: 16 May 90 16:54:13 GMT
References: <1094@manta.NOSC.MIL> <BOB.90May15174636@volitans.MorningStar.Com>
Distribution: gnu
Organization: AudioFAX Inc., Atlanta
Lines: 38
Posted: Wed May 16 17:54:13 1990