diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:40:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:40:28 +0000 |
commit | fd423d0bb64fe29a2be1fbae5baaf4bc386cc274 (patch) | |
tree | 6bf20bbdf3d9741134f6ea40b30c1b3722fa0cd1 /Master/texmf-dist/doc/fontinst/base/README | |
parent | 0afd1aaf73fc909c6604939dcaf4ccc983b7277e (diff) |
doc 1
git-svn-id: svn://tug.org/texlive/trunk@77 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/fontinst/base/README')
-rw-r--r-- | Master/texmf-dist/doc/fontinst/base/README | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/fontinst/base/README b/Master/texmf-dist/doc/fontinst/base/README new file mode 100644 index 00000000000..6c5acf8fc52 --- /dev/null +++ b/Master/texmf-dist/doc/fontinst/base/README @@ -0,0 +1,113 @@ +README for fontinst + +* What is it? + +Fontinst is a program that helps with installing fonts +for (La)TeX. Since it is written entirely in TeX macros, +it is completely portable. + +More precisely, fontinst helps mainly with the number +crunching and shoveling parts of font installation. This +means in practice that it creates a number of files which +give the TeX metrics (and related information) for a font +family that (La)TeX needs to do any typesetting in these +fonts. Fontinst furthermore makes it easy to create fonts +containing glyphs from more than one base font, taking +advantage of e.g. "expert" font sets. + +Fontinst cannot examine files to see if they contain any +useful information, nor automatically search for files +or work with binary file formats; those tasks must +normally be done manually or with the help of some other +tool, such as the pltotf and vptovf programs. + + +* Documentation + +The doc directory contains pure documentation; in +particular the doc/manual directory should be of +interest, as it contains the fontinst manual. For all +questions about how one uses fontinst, see this manual. + +Sadly, the manual has been neglected for some time, and +although it was recently revised, much remains to do. +In particular, many commands still lack description and +explanations (although at least the manual now lists +all the syntaxes). Some alternative sources of information +that you may find useful are: + + * Philipp Lehman's "The Font Installation Guide" + Available on CTAN, at info/Type1fonts/fontinstallationguide/ + + * intro98.tex - parts of the 1998 fontinst v1.8 manual + that were split off during the recent revision. + + * The fontinst mailing list and its archives + (See below for relevant addresses.) + + * The fontinst Literate Programming sources (see + source/fisource.dvi). If a command isn't documented + anywhere else, there is probably a discussion of it + in the sources. They're thoroughly indexed. + +The examples directory contains some examples (with +comments) of using fontinst to install a font family. + + +* Installation + +To use fontinst, you only need to make sure the inputs +directory and its subdirectories are on TeX's input path. +Usually you do this by moving it to a suitable location. +In a TDS texmf tree, the inputs directory is usually +made the ${TEXMF}/tex/fontinst directory. + +You will probably also want to move the file fontdoc.sty +in the latex directory to some location where TeX will +find it. Many of the .mtx and .etx files in the inputs +hierarchy are simultaneously fontinst input files and +LaTeX documents; the fontdoc package is needed to typeset +them as the latter. In a TDS texmf tree, the normal place +for fontdoc.sty is in the tex/latex/misc directory. + +Also recall that some TeX implementations maintain a +database over files that have been installed. If you've +placed fontinst in a suitable place but TeX complains it +cannot find the file fontinst.sty then the problem may +be that you need to update this database of files. That +is however nothing that is particular for fontinst. + + +* Latin and other scripts + +The fontinst distribution includes the necessary encoding +definition (.etx) files for the latin script as used in +European languages, but there is nothing in fontinst as +a program that restricts it to these languages. In the T2 +bundle (CTAN:macros/latex/contrib/t2) there are +corresponding fontinst files for the cyrillic scripts +(and in the future it might become part of the main +fontinst distribution). + + +* The test directory + +This is mainly of interest for advanced fontinst users. +It collects some files that were written to test the new +features in various versions of fontinst. + + +* Mailing list + +Questions and bug reports should be sent to the fontinst +mailing list + + fontinst@tug.org + +General information about the mailing list is at: + + http://tug.org/mailman/listinfo/fontinst + + +7 August 2004, +Lars Hellstr\"om |