dvitomp fix from Akira
[mplib] / src / texk / kpathsea / HIER
1 TeX directory structure
2 =======================
3
4   This section describes the default installation hierarchy of the
5 distribution.  It conforms to both the GNU coding standards and the TeX
6 directory structure (TDS) standard.  For rationale and further
7 explanation, please see those documents.  The GNU standard is available
8 as `ftp://prep.ai.mit.edu/pub/gnu/standards/standards.texi' and
9 mirrors.  The TDS document is available from `CTAN:/tex-archive/tds'
10 (*note unixtex.ftp::.).
11
12   You can change the default paths in many ways (*note Changing search
13 paths::.).  One common desire is to put everything (binaries and all)
14 under a single top-level directory such as `/usr/local/texmf' or
15 `/opt/texmf'--in the terms used below, make PREFIX and TEXMF the same.
16 For specific instructions on doing that, see *Note configure
17 scenarios::.
18
19   Here is a skeleton of the default directory structure, extracted from
20 the TDS document:
21
22      PREFIX/      installation root (`/usr/local' by default)
23       bin/         executables
24       man/         man pages
25       include/     C header files
26       info/        GNU info files
27       lib/         libraries (`libkpathsea.*')
28       share/       architecture-independent files
29        texmf/      TDS root
30         bibtex/     BibTeX input files
31          bib/        BibTeX databases
32           base/       base distribution (e.g., `xampl.bib')
33           misc/       single-file databases
34           PKG/       name of a package
35          bst/        BibTeX style files
36           base/       base distribution (e.g., `plain.bst', `acm.bst')
37           misc/       single-file styles
38           PKG/       name of a package
39         doc/         additional documentation
40         dvips/       `.pro', `.ps', `psfonts.map'
41         fonts/       font-related files
42          TYPE/         file type (e.g., `tfm', `pk')
43           MODE/          type of output device (types `pk' and `gf' only)
44            SUPPLIER/       name of a font supplier (e.g., `public')
45             TYPEFACE/        name of a typeface (e.g., `cm')
46              dpiNNN/           font resolution (types `pk' and `gf' only)
47         metafont/    Metafont (non-font) input files
48          base/        base distribution (e.g., `plain.mf')
49          misc/        single-file packages (e.g., `modes.mf')
50          PKG/           name of a package (e.g., `mfpic')
51         metapost/    MetaPost input files
52          base/        base distribution (e.g., `plain.mp')
53          misc/        single-file packages
54          PKG/           name of a package
55          support/     support files for MetaPost-related utilities (e.g., `trfonts.map')
56         mft/         `MFT' inputs (e.g., `plain.mft')
57         tex/         TeX input files
58          FORMAT/         name of a format (e.g., `plain')
59           base/        base distribution for FORMAT (e.g., `plain.tex')
60           misc/        single-file packages (e.g., `webmac.tex')
61           local/       local additions to or local configuration files for FORMAT
62           PKG/           name of a package (e.g., `graphics', `mfnfss')
63          generic/     format-independent packages
64           hyphen/      hyphenation patterns (e.g., `hyphen.tex')
65           images/      image input files (e.g., Encapsulated PostScript)
66           misc/        single-file format-independent packages (e.g., `null.tex').
67           PKG/           name of a package (e.g., `babel')
68         web2c/        implementation-dependent files (`.pool', `.fmt', `texmf.cnf', etc.)
69
70   Some concrete examples for most file types:
71
72      /usr/local/bin/tex
73      /usr/local/man/man1/xdvi.1
74      /usr/local/info/kpathsea.info
75      /usr/local/lib/libkpathsea.a
76      /usr/local/share/texmf/bibtex/bst/base/plain.bst
77      /usr/local/share/texmf/fonts/pk/ljfour/public/cm/cmr10.600pk
78      /usr/local/share/texmf/fonts/source/public/pandora/pnr10.mf
79      /usr/local/share/texmf/fonts/tfm/public/cm/cmr10.tfm
80      /usr/local/share/texmf/fonts/type1/adobe/utopia/putr.pfa
81      /usr/local/share/texmf/metafont/base/plain.mf
82      /usr/local/share/texmf/metapost/base/plain.mp
83      /usr/local/share/texmf/tex/plain/base/plain.tex
84      /usr/local/share/texmf/tex/generic/hyphen/hyphen.tex
85      /usr/local/share/texmf/web2c/tex.pool
86      /usr/local/share/texmf/web2c/tex.fmt
87      /usr/local/share/texmf/web2c/texmf.cnf
88