home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / octave-1.1.1p1-src.tgz / tar.out / fsf / octave / kpathsea / HIER < prev    next >
Text File  |  1996-09-28  |  6KB  |  167 lines
  1. Here is the installed TeX & Metafont hierarchy (as of 31dec93) that
  2. we have been working on.  Please send comments to mackay@cs.washington.edu,
  3. unixtex@u.washington.edu, and kb@cs.umb.edu.
  4. (Especially if you try to actually install TeX like this!)
  5.  
  6. First, pick a root directory for the library files:
  7. TEXMFROOT = /usr/local/lib/texmf
  8.  
  9. (Or, in make variable terms: $(datadir)/texmf.)
  10.  
  11. All the files are installed relative to $TEXMFROOT.  Top-level directories:
  12. bibtex        -- see below
  13. fonts            for these
  14. tex           three
  15. mf        -- utility MF sources
  16.                    ({plain, expr, null, io, slant, modes, ...}.mf)
  17. ini        -- .base, .fmt, .pool
  18. dvips        -- only if you have a PostScript printer, naturally
  19.  
  20. In general, where possible, the same setup as ctan is clearly a win.
  21.  
  22. Under bibtex:
  23. bib    (xampl.bib & some of Nelson's bib files)
  24. bst    (at least standard and semi-standard)
  25. doc    (btxbst.doc, btxdoc.*, btxhak.tex)
  26.  
  27. Under dvips, have the .pro/.ps/psfonts.map files.
  28.  
  29. Under tex, at least:
  30. plain    ({plain, manmac, null, plain, story, testfont, webmac}.tex,
  31.      perhaps also texinfo.tex, eplain.tex, other single-file sources)
  32. latex    (with subdirectories base/ for M&S's files, and contrib/ for
  33.      other people's styles)
  34. tugboat    (tugboat.cmn, tugboat.sty, etc.)
  35. mft    (*.mft)
  36.  
  37. Also under tex/ would go many other things:
  38. dvips    (rotate.tex, epsf.sty, etc.)
  39. texdraw
  40. musictex
  41. ...
  42.  
  43. Having a whole separate tree for the utility MF sources seems pointless,
  44. since there are so few of them. Most .mf files go under fonts/.
  45.  
  46. Under fonts:
  47. <source>/<typeface>/
  48.   for <source> in public, adobe, ams, bitstream, urw, ...
  49.   for public/<typeface> in cm, concrete, punk, ...
  50.   for ams/<typeface> in euler, msym, ...
  51.   for adobe/<typeface> in times, palatino, avantgarde, ...
  52.  
  53. Under .../<source>/<typeface>/
  54. src/*.mf
  55. tfm/*.tfm
  56. vf/*.vf
  57. afm/*.afm
  58. pk/$MAKETEX_MODE (including pseudo-modes for gsrenderfont, pstopk, gsftopk)
  59. type1/*.{pfa,pfb,gsf}
  60. truetype/whatever
  61.  
  62. For example:
  63. /usr/local/lib/texmf/fonts/public/cm/pk/cx/cmr10.300pk
  64. /usr/local/lib/texmf/fonts/public/sauter/src/b-cmbx.mf
  65. /usr/local/lib/texmf/fonts/adobe/utopia/type1/putr.pfa
  66.  
  67. All the names which can be matched by the paths you actually use need to
  68. be unique. If you have two 300dpi devices, say `cx' and `qms', you can
  69. set their PK paths for dvips in their printer-specific configuration
  70. file. Conceivably you could instead make the default path include
  71. `$MAKETEX_MODE' (kpathsea sets this as it runs), but I'm not quite sure
  72. what all the ramifications of that are.
  73.  
  74.  
  75. Here are default variable values that go with the above:
  76.  
  77. TEXMFROOT = /usr/local/lib/texmf
  78.  
  79. % Read all relevant configuration files along this path, not just the first.
  80. TEXCONFIG = .:~:$TEXMFROOT
  81.  
  82. % Although it's pointless to search the adobe, bitstream, etc. directories
  83. % for Metafont sources, we want at least ams/ and public/, and unknown others.
  84. MFINPUTS  = .:$TEXMFROOT/mf:$TEXMFROOT/fonts//src//
  85. TEXINPUTS = .:$TEXMFROOT/tex//
  86.  
  87. TEXFORMATS = .:$TEXMFROOT/ini
  88. MFBASES    = .:$TEXMFROOT/ini
  89. TEXPOOL = .:$TEXMFROOT/ini
  90. MFPOOL  = .:$TEXMFROOT/ini
  91.  
  92. % Fonts for everyone.
  93. TFMFONTS = .:$TEXMFROOT/fonts//tfm
  94. VFFONTS = .:$TEXMFROOT/fonts//vf
  95. PKFONTS = .:$TEXMFROOT/fonts//pk//
  96.  
  97. % .bib and .bst files.
  98. BIBINPUTS = .:$TEXMFROOT/bibtex/bib
  99. BSTINPUTS = .:$TEXMFROOT/bibtex/bst
  100.  
  101. % PostScript prologues and downloadable fonts.
  102. PSHEADERS = .:$TEXMFROOT/dvips:$TEXMFROOT/fonts//type1
  103.  
  104. From mackay@cs.washington.edu Wed Dec 29 16:27:02 1993
  105. Date: Wed, 29 Dec 1993 13:27:08 -0800
  106. From: mackay@cs.washington.edu (Pierre MacKay)
  107. Subject: Directory tree
  108.  
  109. # The write-black, bitmapped type1 and write-white choices at this site
  110. set WB=cx
  111. set WW=ricoh
  112. set BM=ps-to-pk
  113. #
  114. # use the ${} variable form throughout---it saves grief.
  115. #
  116. set USRLOCAL=/usr2/local
  117.  
  118. set TEXMFRT=${USRLOCAL}/lib/texmf
  119. setenv TEXROOT ${TEXMFRT}/tex
  120. setenv TEXFONTS .:${TEXROOT}/fonts//
  121. setenv TEXINPUTS .:${TEXROOT}/inputs//
  122. setenv TEXFORMATS .:${TEXROOT}/formats
  123. setenv TEXPOOL ${TEXFORMATS}
  124.  
  125. setenv MFROOT ${TEXMFRT}/mf
  126. setenv MFINPUTS .:${MFROOT}/inputs:${TEXROOT}/fonts/public//src
  127. setenv MFBASES ${MFROOT}/bases
  128. setenv MFPOOL ${MFBASES}/bases
  129.  
  130. # The 00[TFM.VF,XDVI] directories are "accelerators" where links
  131. # to files that are in extremely frequent use are placed.
  132. #
  133. # The 00PK directory is where MakeTeXPK stores its
  134. # output.  It must therefore be in both XDVI and DVIPS paths.
  135. # It can also be used as an "accelerator" directory for
  136. # links to frequently used PK files.  But don't store write-white
  137. # fonts there unless you are unlucky enough to have a write-white
  138. # printer.
  139. #
  140. # XDVIFONTS takes write-white fonts from the ricoh set
  141. # but since we don't have to worry about write-white printers
  142. # any more, the ricoh directories contain only resolutions
  143. # below 360 dpi.  Above that it doesn't really matter very much
  144. # when all you are concerned with is screen preview.
  145. # Don't leave out the ${BM} part of the XDVI path if type1
  146. # fonts are in use.
  147. # NOTE: Locally, if we decide to use MakeTeXPK at all with XDVI, 
  148. # we will set it to produce fonts for the hardcopy printer only
  149. setenv TFMFONTS .:${TEXROOT}/fonts/00TFM:${TEXROOT}/fonts//tfm
  150. setenv VFFONTS .:${TEXROOT}/fonts/00VF:${TEXROOT}/fonts//vf
  151. setenv XDVIFONTS .:${TEXROOT}/fonts/00XDVI:${TEXROOT}/fonts/00PK:${TEXROOT}/fonts//${WW}:${TEXROOT}/fonts//${BM}:${TEXROOT}//${WB}
  152. setenv DVIPSFONTS .:${TEXROOT}/fonts/00PK:${TEXROOT}//${WB}
  153. setenv PKFONTS $DVIPSFONTS
  154. setenv TEXPKS $DVIPSFONTS
  155.  
  156. This sets up the common root "texmf" for both TEXROOT and MFROOT,
  157. but puts both TEXROOT and MFROOT into the environment.  Saves
  158. much typing.  
  159.  
  160. [TEX,MF]POOL really don't need a separate path, since it is
  161. only in a run of ini[tex,mf] that they are ever likely to be
  162. needed.  So TEXFORMATS and MFBASES is the obvious place.  
  163.  
  164. For BM I have changed from the specific "ps2pk" to a more general
  165. "ps-to-pk" because I sometimes find that pfb2mf->METAFONT->pk works
  166. better than ps2pk for a screen image.
  167.