"Fossies" - the Fresh Open Source Software Archive

Member "texinfo-6.5/INSTALL" (3 Jan 2016, 2722 Bytes) of package /linux/misc/texinfo-6.5.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 $Id: INSTALL 6918 2016-01-03 21:27:43Z gavin $
    2 INSTALL file for texinfo.
    3 
    4      Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
    5      2001, 2002, 2003, 2004, 2005, 2006, 2007, 2010, 2011, 2013, 2014,
    6      2015, 2016
    7      Free Software Foundation, Inc.
    8 
    9      Copying and distribution of this file, with or without modification,
   10      are permitted in any medium without royalty provided the copyright
   11      notice and this notice are preserved.
   12 
   13 For generic installation instructions on compiling and installing this
   14 Automake-based distribution, please read the file `INSTALL.generic'.
   15 
   16 Installation notes specific to Texinfo:
   17 
   18 * texinfo.tex and the other *.tex files are not installed by
   19   `make install', because there is no reliable way to know where to
   20   install them.  Instead, you have to run an additional make command
   21   after the normal make install:
   22     make TEXMF=/your/texmf install-tex
   23   texinfo.tex is installed in ${TEXMF}/tex/texinfo/texinfo.tex, etc.
   24 
   25 * On the other hand, if you're maintaining a TeX distribution and
   26   keeping the files up to date yourself, you may not want to see the
   27   installation warnings.
   28   For that, run configure --disable-install-warnings, or set
   29   enable_install_warnings=no in the environment.
   30 
   31 * The `makeinfo' program is a Perl program that can use extension
   32   modules, known as XS modules.  The configure script will attempt to
   33   detect whether such modules can be built and loaded on your
   34   installation.  If you want to disable the use of XS modules, you can
   35   give the --disable-perl-xs flag to `configure'; likewise, to use them
   36   without checking, give the --enable-perl-xs flag.  Some of the
   37   environment variables listed in the output of `./configure --help' may
   38   be of use for building the XS modules.
   39       After building the program, the use of XS modules can be
   40   controlled with the `TEXINFO_XS' environment variable, which may be
   41   useful for troubleshooting.  Set TEXINFO_XS=debug to print some
   42   information as the modules are looked for and loaded, TEXINFO=omit to
   43   disable their use, and TEXINFO_XS=required to force their use.
   44 
   45 * For instructions on compiling this distribution with DJGPP tools
   46   for MS-DOS and MS-Windows, see the file djgpp/README.
   47 
   48 * The Info tree uses a file `dir' as its root node; the `dir-example'
   49   file in this distribution is included as a possible starting point.
   50   Use it, modify it, or ignore it just as you like.
   51 
   52 * You can create a file texinfo.cnf to be read by TeX when
   53   processing Texinfo manuals.  For example, you might like to use
   54   @afourpaper by default.  See the `Preparing for TeX' node in
   55   the Texinfo manual for more details.  You don't have to create the
   56   file if you have nothing to put in it.