contrib/texinfo/INSTALL

   1 $Id: INSTALL,v 1.5 2004/11/19 13:08:47 karl Exp $
   2
   3      Copying and distribution of this file, with or without modification,
   4      are permitted in any medium without royalty provided the copyright
   5      notice and this notice are preserved.
   6
   7 For generic installation instructions on compiling and installing this
   8 Automake-based distribution, please read the file `INSTALL.generic'.
   9
  10 Installation notes specific to Texinfo:
  11
  12 * texinfo.tex and the other *.tex files are not installed by `make
  13   install'.  This is because there is no reliable way to know where to
  14   install them.  Instead, you have to run an additional make command
  15   after the normal make install:
  16     make TEXMF=/your/texmf install-tex
  17   texinfo.tex is installed in ${TEXMF}/tex/texinfo/texinfo.tex, etc.
  18
  19 * On the other hand, if you're maintaining a TeX distribution, you don't
  20   want your users to see the installation warnings, because you already
  21   have the files installed.  (And you're keeping them up to date, right?)
  22   In this case, run configure --disable-install-warnings, or set
  23   enable_install_warnings=no in the environment.
  24
  25 * On MacOSX, if configure fails with the error:
  26         ac_cv_build='config.sub: invalid option -apple-darwin7.2.0
  27 this is probably because your uname -p is returning "unknown".  Use
  28 /usr/bin/uname instead.
  29
  30 * For instructions on compiling this distribution with DJGPP tools
  31   for MS-DOS and MS-Windows, see the file djgpp/README.
  32
  33 * The Info tree uses a file `dir' as its root node; the `dir-example'
  34   file in this distribution is included as a possible starting point.
  35   Use it, modify it, or ignore it just as you like.
  36
  37 * You can create a file texinfo.cnf to be read by TeX when
  38   processing Texinfo manuals.  For example, you might like to use
  39   @afourpaper by default.  See the `Preparing for TeX' node in
  40   texinfo.txi for more details.  You don't have to create the file if
  41   you have nothing to put in it.
  42
  43 * If your info files are not in $prefix/info, you may wish to add a line
  44 #define DEFAULT_INFOPATH "/mydir1:/mydir2:..."
  45   to config.h after running configure.