This directory contains TeX-related programs that use the kpathsea
library for configuration and path searching (and the library itself).

For the simplest possible installation, see the beginning of
kpathsea/INSTALL.

If you want to override the defaults, read both <program>/INSTALL (e.g.,
web2c/INSTALL) and kpathsea/INSTALL.

Other files are not necessary reading for basic installation, but may
prove helpful:
- etc/unixtex.ftp describes how to obtain a TeX system by ftp or on
  physical media, and some alternative TeX distributions.
- README in each subdirectory briefly summarizes that directory.
- NEWS in each subdirectory has noteworthy changes by release.
- kpathsea/BUGS has bug reporting information.
- kpathsea/CONFIGURE has generic instructions on running configure scripts.

Please send bug reports and suggestions for either the programs or the
documentation, no matter how small, to tex-k@mail.tug.org.  But please
read kpathsea/BUGS first.  (That file also tells you how to join the
mailing list yourself, and how to receive announcements only.)

For general documentation on the coding and usage standards this
distribution follows, see the GNU standards document
ftp://prep.ai.mit.edu/pub/gnu/standards/standards.text, especially the
`Makefile Conventions', `Configuration', and `User Interfaces' sections.

The files in the etc/ directory are present for informational purposes.
They are not used or installed by the programs.  For example, a copy of
texinfo.tex is there in case you want to produce DVI files from the
Texinfo manuals.

If you know enough about TeX to be reading this, then you (or your
institution) should consider joining the TeX Users Group.  (If you're
already a member, thanks!)  TUG produces the periodical TUGboat, sponsors
an annual meeting and publishes the proceedings, and arranges TeX
courses for all levels of TeX users, throughout the world.  Contact:
    TeX Users Group
    870 Market St. #801
    San Francisco, CA 94102  USA
    phone: +1-415-982-8449
    fax:   +1-415-982-8559
    email: tug@tug.org
    url:   http://www.tug.org

This is free software.  See the files COPYING* for copying permissions.

kb@mail.tug.org
Member of the League for Programming Freedom -- write lpf@uunet.uu.net.
