(texinfo) Preparing for TeX

Info Catalog

(texinfo) Requirements Summary

(texinfo) Hardcopy

(texinfo) Overfull hboxes

 
 Preparing for TeX
 =================
 
   TeX needs to know where to find the `texinfo.tex' file that you have
 told it to input with the `\input texinfo' command at the beginning of
 the first line.  The `texinfo.tex' file tells TeX how to handle
 @-commands; it is included in all standard GNU distributions.
 
   Usually, the `texinfo.tex' file is put under the default directory
 that contains TeX macros
 (`/usr/local/share/texmf/tex/texinfo/texinfo.tex' by default) when GNU
 Emacs or other GNU software is installed.  In this case, TeX will find
 the file and you do not need to do anything special.  Alternatively,
 you can put `texinfo.tex' in the current directory when you run TeX,
 and TeX will find it there.
 
   Also, you should install `epsf.tex' in the same place as
 `texinfo.tex', if it is not already installed from another
 distribution.  This file is needed to support the `@image' command
 ( Images).
 
   Optionally, you may create an additional `texinfo.cnf', and install
 it as well.  This file is read by TeX when the `@setfilename' command
 is executed ( `@setfilename' setfilename.).  You can put any
 commands you like there, according to local site-wide conventions.  They
 will be read by TeX when processing any Texinfo document.  For example,
 if `texinfo.cnf' contains the line `@afourpaper' ( A4 Paper),
 then all Texinfo documents will be processed with that page size in
 effect.  If you have nothing to put in `texinfo.cnf', you do not need
 to create it.
 
   If neither of the above locations for these system files suffice for
 you, you can specify the directories explicitly.  For `texinfo.tex',
 you can do this by writing the complete path for the file after the
 `\input' command.  Another way, that works for both `texinfo.tex' and
 `texinfo.cnf' (and any other file TeX might read), is to set the
 `TEXINPUTS' environment variable in your `.cshrc' or `.profile' file.
 
   Which you use of `.cshrc' or `.profile' depends on whether you use a
 Bourne shell-compatible (`sh', `bash', `ksh', ...) or C
 shell-compatible (`csh', `tcsh') command interpreter.  The latter read
 the `.cshrc' file for initialization information, and the former read
 `.profile'.
 
   In a `.cshrc' file, you could use the following `csh' command
 sequence:
 
      setenv TEXINPUTS .:/home/me/mylib:/usr/lib/tex/macros
 
   In a `.profile' file, you could use the following `sh' command
 sequence:
 
      TEXINPUTS=.:/home/me/mylib:/usr/lib/tex/macros
      export TEXINPUTS
 
 for TeX-Footnote-1::):
 
      set TEXINPUTS=.;d:/home/me/mylib;c:/usr/lib/tex/macros
 
 It is customary for DOS/Windows users to put such commands in the
 `autoexec.bat' file, or in the Windows Registry.
 
 These settings would cause TeX to look for `\input' file first in the
 current directory, indicated by the `.', then in a hypothetical user's
 `me/mylib' directory, and finally in a system directory
 `/usr/lib/tex/macros'.
 
   Finally, you may wish to dump a `.fmt' file ( Memory dumps
 (web2c)Memory dumps.) so that TeX can load Texinfo faster.  (The
 disadvantage is that then updating `texinfo.tex' requires redumping.)
 You can do this by running this command, assuming `epsf.tex' is
 findable by TeX:
 
      initex texinfo @dump
 
   (`@dump' is a TeX primitive.)  You'll then need to move `texinfo.fmt'
 to wherever your `.fmt' files are found; typically this will be in the
 subdirectory `web2c' of your TeX installation, for example,
 `/usr/local/share/tex/web2c'.
 

Info Catalog

(texinfo) Requirements Summary

(texinfo) Hardcopy

(texinfo) Overfull hboxes