diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-17 21:41:51 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-17 21:41:51 +0000 |
commit | 487ca4806cc046076293cf6cc5fbba0db282bac7 (patch) | |
tree | 847b412ab5158dd7bdd7ed7e5a4cc3fbca94be32 /Build/source/texk/gsftopk/INSTALL | |
parent | a3d3111bfe26b8e5f5bc6049dfb2a4ca2edc7881 (diff) |
texk 1
git-svn-id: svn://tug.org/texlive/trunk@1485 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/gsftopk/INSTALL')
-rw-r--r-- | Build/source/texk/gsftopk/INSTALL | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/Build/source/texk/gsftopk/INSTALL b/Build/source/texk/gsftopk/INSTALL new file mode 100644 index 00000000000..389139227cf --- /dev/null +++ b/Build/source/texk/gsftopk/INSTALL @@ -0,0 +1,83 @@ + INSTALLATION INSTRUCTIONS + +gsftopk is primarily intended for sites using xdvi and dvips; it allows them +to use PostScript fonts with xdvi. While there is nothing to prevent this +program from being used in other contexts, doing so would be difficult for +non-expert users. + +To install gsftopk, use the following steps. + +1. You _must_ have ghostscript 2.5.2 (or higher) installed on your system. + +2. It is recommended that you also have dvips installed; however, expert + users can read the more detailed instructions at the end of this file + to find out how to run without dvips. + +3. Make sure that the gsftopk directory is installed in the kpathsea + tools hierarchy: we assume that there is a ../kpathsea directory (as is + distributed in the xdvi, dvips, or web2c distributions from Karl Berry). + (If this is the case, then you can modify the installation in the top-level + build directory to automatically build in the gsftopk directory when + building the tools.) + +4. Run ./configure in this directory. This will generate a Makefile. + You may want to set some options when calling this script; see the + file ../kpathsea/INSTALL for details. There are no options specific + to gsftopk. + +5. Type 'make install' to install the program, its manual page, and the + render.ps file. + +You should now be able to use PostScript fonts with xdvi. + +--Paul Vojta, vojta@math.berkeley.edu + + + NOTES FOR THE EXPERT + +With a little extra work it is possible to install gsftopk without having +installed dvips. All that is needed is to explain some of the makefile +variables and to describe the format of the file psfonts.map. + +The CONFIGPATH is the directory where psfonts.map is to be stored. It may +actually be a colon-separated list of paths, although only the first one +containing a file named ``psfonts.map'' is useful. + +The HEADERDIR is the directory where the ``render.ps'' driver file is to +be stored; also it is a component of the HEADERPATH. The HEADERPATH is a +colon-separated list of directories which are searched for files referenced +in the ``psfonts.map'' file. + +Finally, the file ``psfonts.map'' should provide a information on how to access +each and every file gsftopk is to be expected to create. Each line of that +file describes one font. Each line consists of one or more fields, separated +by one or more tabs or spaces. The first field is mandatory; it gives the +name by which TeX refers to the file. Other fields are optional and are +order independent. They are: + + o The PS-name of the font. If absent, it is the same as the TeX name. + + o The file where the font is located. This field is identified by + preceding the file name with the character `<'. If absent, it is + assumed that the font is built-in to ghostscript. + + o Special instructions for scaling the font. This field is identified + by enclosing it in quotes; it may therefore contains spaces. + The field consists of PostScript instructions for modifying the font. + Possibilities include "1.2 ExtendFont" to stretch the font horizontally + by 20%, and ".3 SlantFont" to cause the letters to be slanted at a + slope of .3. + +The file may also contain comment lines. These are blank lines, or lines +beginning with `;', `#', or `*'. + +The following is a very abbreviated sample psfonts.map: + +# Comment and blank lines are ignored. + +Times-Roman +rptmr Times-Roman +Optima <Optima.pfb +Optima-Slanted Optima <Optima.pfb ".1944 SlantFont" +Optima-Condensed Optima <Optima.pfb ".82 ExtendFont" +Optima-Extended Optima <Optima.pfb "1.2 ExtendFont" |