Fix dirty conflict between archiver and emulate_keyboard
[texmacs.git] / src / TeXmacs / TEX_FONTS
blob84dd2cf9b3442058ed090441423ac6bfa29c4b62
2 -------------------------------------------------------------------------------
3 Using TeX fonts
4 -------------------------------------------------------------------------------
6 1. GNU TeXmacs has been designed in order to cooporate with
7    the TeTeX distribution. The TeTeX distribution comes with
8    the programs MakeTeXTFM and MakeTeXPK to generate
9    new fonts automatically using MetaFont.
10    Furthermore, it provides the utility kpsepath,
11    for finding the different directories where TeX fonts have been installed.
13 2. When starting GNU TeXmacs for the first time, the program examines
14    the way your TeX system has been installed. The result of this
15    examination is written the file $TEXMACS_HOME_PATH/system/TEX_PATHS.
16    By default, $TEXMACS_HOME_PATH contains ~/.TeXmacs.
17    Whenever you change your TeX system, or if you add new fonts,
18    it may be a good idea to remove this file in order to recreate it.
19    In the directory $TEXMACS_HOME_PATH/fonts/error, you also find
20    a trace of all fonts which GNU TeXmacs failed to create.
21    When adding new fonts, you should remove all files in this directory.
23 3. If the user did not install the TeTeX distribution or
24    no TeX distribution at all, we provide by default
25    a limited set of compiled fonts in $TEXMACS_PATH/data/tfm and
26    $TEXMACS_PATH/data/pk. The user may also specify his own paths
27    TEX_TFM_PATH and TEX_PK_PATH for .tfm and .pk files
28    respectively. GNU TeXmacs uses the following algorithm to find fonts:
30     - Look whether the font is in one of directories specified by
31       the user paths TEX_TFM_PATH or TEX_PK_PATH.
32     - Look whether the font is installed by default in
33       $TEXMACS_PATH/data/tfm or $TEXMACS_PATH/data/pk. 
34     - Look whether the font was already generated in
35       the TeTeX distribution (using kpsepath). 
36     - Automatically generate the font using
37       MakeTeXTFM and/or MakeTeXPK.
39 4. We also precompiled a larger set of 600 dpi fonts,
40    which can be added to the set of default fonts from 'TeXmacs'.
41    In order to do so, first download the fonts from
43         ftp://ftp.texmacs.org/pub/TeXmacs/targz/TeXmacs-600pk-fonts.tar.gz
45    Next unpack them in the installation directory using
47         tar -zxvf TeXmacs-600pk-fonts.tar.gz