home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / unixtex-6.1b-src.tgz / tar.out / contrib / unixtex / dvipsk / INSTALL < prev    next >
Encoding:
Text File  |  1996-09-28  |  5.5 KB  |  142 lines
  1. Contents:
  2.  
  3. Installation
  4.  
  5.  
  6. Installation
  7. ************
  8.  
  9.   To compile and install Dvipsk:
  10.  
  11.   1. Edit the file `make/paths.make' if you want to make changes to the
  12.      installation directories or paths that will have effect across
  13.      different runs of `configure'.  Alternatively, override the Make
  14.      variables on the command line when you run Make.
  15.  
  16.      Exception: to reliably change the top-level `prefix', you must give
  17.      `configure' the option `-prefix=PREFIX', instead of changing the
  18.      value in `paths.make'.
  19.  
  20.   2. Edit `kpathsea/texmf.cnf.in' to change the local paths to match
  21.      your local setup.  *Note Default paths: (kpathsea)Default paths,
  22.      for more details on changing the paths. A copy is in
  23.      `kpathsea/INSTALL'.  See `kpathsea/HIER' for an explanation of the
  24.      default setup.
  25.  
  26.      If the paths do not match where the files actually are, the
  27.      programs will probably start up Very, Very, Slowly, and/or not be
  28.      able to find the fonts or other input files.
  29.  
  30.   3. `sh configure' (in the top-level directory).  This makes
  31.      system-dependent `#define's' in `*/c-auto.h' (from the
  32.      corresponding `c-auto.h.in') and creates a `Makefile' (from the
  33.      corresponding `Makefile.in', by doing `@VAR@' and `ac_include'
  34.      substitutions).
  35.  
  36.      Perhaps the most common desire is to compile with optimization
  37.      instead of or as well as debugging.  You can change the options
  38.      passed to the compiler by changing `CFLAGS', either for
  39.      `configure' or `make'.  For example:
  40.  
  41.           prompt$ env CFLAGS="-g -O" configure
  42.           prompt$ make
  43.      or
  44.           prompt$ configure
  45.           prompt$ make CFLAGS="-g -O"
  46.  
  47.      *Note Running `configure' scripts: (autoconf)Invoking configure,
  48.      for detailed `configure' options.  (A copy is in
  49.      `kpathsea/CONFIGURE'.)
  50.  
  51.   4. `make' (still in the top-level directory). Barring configuration
  52.      and compiler bugs, this will compile all the programs.  *Note
  53.      Common problems: (kpathsea)Common problems, for system-dependent
  54.      problems (this section is also in `kpathsea/INSTALL').
  55.  
  56.      This also creates the `texmf.cnf' and `paths.h' files that define
  57.      the default search paths.
  58.  
  59.   5. Check the paths in `MakeTeXPK', unless you do not want automatic
  60.      font generation.  *Note Font Generation::.  The `MakeTeXPK' in the
  61.      distribution will overwrite the installed file only if the latter
  62.      contains the string `original MakeTeXPK --'.
  63.  
  64.      Dvipsk, unlike the original dvips, *requires* `MakeTeXPK' to echo
  65.      the generated filename (and nothing else) to standard output
  66.      (standard error can be used for commentary).  For more details, or
  67.      in general if `MakeTeXPK' fails, *note Unable to Generate Fonts::..
  68.  
  69.      By default, `MakeTeXPK' installs the new PK fonts under
  70.      `/usr/local/lib/texmf/fonts/tmp/pk'.  For the simplest
  71.      installation, create that directory and make it publically
  72.      writable.  *Note Font Generation::, for alternatives.
  73.  
  74.   6. Update the device parameters (available memory, resolution, etc.)
  75.      in `config.ps'.  This file is installed as the system-wide
  76.      configuration file.  *Note Config File Options::.  The `config.ps'
  77.      in the distribution will overwrite the installed file only if the
  78.      latter contains the string `original config.ps --'.
  79.  
  80.      If you need support for more than one device, create configuration
  81.      files for each and install them in the directory named by the Make
  82.      variable `configdir'. See the `-P' option in *Note Invoking
  83.      dvips::.
  84.  
  85.   7. Install the programs and supporting macros, fonts, and data files
  86.      with `make install'. If you want to install only the executables,
  87.      do `make install-exec'; for only the data files, `make
  88.      install-data'. And if you don't want to install the fonts (perhaps
  89.      because your directory structure is different from the default),
  90.      but do want everything else, set the Make variable
  91.      `install_fonts=false'.
  92.  
  93.   8. Install additional fonts, if you want to.
  94.  
  95.      A few Type 1 fonts (Utopia, Charter, Courier, Nimbus, Antiqua, ...)
  96.      have been contributed to the X Consortium, and thus are freely
  97.      available. You can get TeX distributions for them from
  98.      `ftp.cs.umb.edu' in `pub/tex', and from the CTAN hosts in
  99.      `tex-archive/fonts'.
  100.  
  101.      If you have a commercial Unix system, it may have come with
  102.      additional PostScript fonts.  If so, you can make them available
  103.      to Dvips by (1) copying or linking them with the appropriate
  104.      filenames; and (2) running `afm2tfm' (*note afm2tfm::.) to make
  105.      TFM and VF files so the fonts will be available in the same
  106.      encoding as the fonts distributed with Dvips. Also check
  107.      `psfonts.map' to be sure the fonts are listed there (*note
  108.      Non-resident Fonts::.).
  109.  
  110.      Here are the typical locations for vendor-supplied fonts:
  111.  
  112.     DEC Ultrix
  113.           `/usr/lib/DPS/outline/decwin'
  114.  
  115.     DEC OSF/1
  116.           `/usr/lib/X11/fonts/Type1Adobe'
  117.  
  118.     IBM AIX
  119.           `/usr/lpp/DPS/fonts/outlines'
  120.  
  121.     NeXT
  122.           `/NextLibrary/Fonts/outline'
  123.  
  124.     SGI IRIX
  125.           `/usr/lib/DPS/outline/base'
  126.  
  127.     Sun Solaris
  128.           `/usr/openwin/lib/X11/fonts/Type1/outline'
  129.  
  130.      The NeXT system supplies more fonts than the others, but the sets
  131.      are overlapping.  See the distributed `psfonts.map' for which
  132.      fonts each system supplies.
  133.  
  134.   9. `make distclean'.  This removes all files created by the build.
  135.  
  136.  
  137.   *Note Debug Options::, for runtime debugging options that may help
  138. track down problems.
  139.  
  140.   *Note Reporting bugs: (kpathsea)Reporting bugs, for the bug reporting
  141. address and information. (Also at the end of `kpathsea/INSTALL'.)
  142.