1### International Fonts Ver.1.2.1 ###
2
30. Introduction
4
5This directory contains free X11 fonts (BDF format) for all characters
6that Emacs 20 can handle. They are classified into several categories
7(e.g Asian, European), with one sub-directory for each category.
8
9This directory also contains the following files:
10 README this file
11 NEWS describe what is new in the latest version
12 ChangeLog log of changes to intlfonts package
13 configure configure script (made from configure.in below)
14 Makefile.in template of Makefile for configure
15 configure.in source for autoconf to make configure
16 rmoldfnt.sh shell script to be used by the make script.
17 It deletes font files installed by the previous
18 version of intlfonts.
19 install-sh BSD compatible install program
20 Emacs.ap sample X resource setting to define fontsets for Emacs
21 TrueType directory containing TrueType fonts
22 Type1 directory containing Type1 fonts
23
24
251. How to install fonts
26
271.0 Suppose that you extracted font archives in $WORKDIR. This
28directory should contain `configure' scritp as well as this README
29file and archive files.
30
311.1 Run commands to install
32
33% cd $WORKDIR
34% ./configure
35% make install
36
37Note: You don't have to do `make' before `make install'.
38
39Then all fonts are installed to this directory:
40 /usr/local/share/emacs/fonts
41while being converted to PCF format.
42In addition, BDF font files are installed as is to this directory:
43 /usr/local/share/emacs/fonts/bdf
44
45If you want to install fonts in the different directory (say
46$INSTDIR), run `configure' as below:
47
48% ./configure --with-fontdir=$INSTDIR
49
50Then, PCF fonts are installed in $INSTDIR, and BDF fonts are installed
51in $INSTDIR/bdf.
52
53Here's a list of the other `configure' optioins:
54 --enable-compress[=ARG] whether to compress PCF fonts or not [ARG=gzip]
55 --with-pcf[=ARG] install PCF fonts
56 [ARG=yes] on Unix, [ARG=no] on DOS
57 --with-bdf[=ARG] install BDF fonts [ARG=yes]
58 --with-type1[=ARG] install Type1 fonts [ARG=no]
59 --with-truetype[=ARG] install TrueType fonts [ARG=no]
60
61
621.2 Inform your X server about the new fonts
63
64The step 1.1 converts fonts to a format that X server can read (PCF
65format) and put them in proper directory. But, you still have to
66inform your X server about the new fonts.
67
68If $INSTDIR is already in your font path (please check it by the
69command `xset q'), you can tell X server to update font hash table by:
70 $ xset fp rehash
71
72If $INSTDIR is not yet in your font path, you can tell one X session
73to use the installed fonts with:
74 % xset +fp $INSTDIR
75On some systems, you may have to give absolute pathname to the command
76`xset'.
77
78To make the effect permanent for future X sessions, you probably have
79to edit certain files in your X installation, for instance, include
80the following line in your ~/.xinitrc or ~/.xsession.
81 xset +fp $INSTDIR
82
831.3 X resource
84
85The file Emacs.ap contains X resource setting of fontsets for various
86size fonts (14, 16, 18, and 24 dots). If you want to utilze this
87setting, install it appropriately. There are many ways to set X
88resource. For instance, one way for XFree86 users is to merge
89Emacs.ap into /usr/X11R6/lib/X11/app-defaults/Emacs.
90
91Once you set this X resource, Emacs uses fontset-16 by default. You
92can specify the other fontsets by `-fn' command line argument as below:
93 % emacs -fn fontset-14
94You can change the fontset while running Emacs by, for instance:
95 Shift-Mouse-1 -> Fontset -> 14.
96
972. List of font sub-directories
98
992.1 Classification
100
1012.1.2 X's font (BDF format)
102
103X's Fonts are classified by the following regions:
104 European, Asian, Chinese, Japanese, Korean, Ethiopic, Misc
105This directory contains the following kinds of sub-directories.
106
107o REGION (ex: European, Asian)
108
109The fonts in these sub-directories are the fonts of normal size (less
110than or equal to 24dots) not included in the standard distribution of
111X window system. You surely need all of them to correctly display all
112characters supported by Emacs 20.
113
114o REGION.X (ex: Chinese.X, Japanese.X)
115
116The fonts in these sub-directories are fonts of normal size included
117in the standard distribution of X window system. You may not need
118them if you have already installed X's fonts.
119
120o REGION.BIG (ex: Chinese.BIG, Japanese.BIG)
121
122The fonts in these sub-directories are fonts of big size (greater than
12324dots). None of them are included in the standard distribution of X
124window system. You need them only when you surely want to see big
125characters. But, they do not cover all character sets.
126
1272.1.3 Vector fonts (TrueType and Type1)
128
129We greatly appreciate the contribution of Yannis Haralambous and
130Tereza Tranaka <yannis@fluxus-virus.com>. They made free TrueType and
131Type1 fonts for Latin-X series, Thai, and Vietnamese. They will
132eventually make fonts for more character sets.
133
134If you want to install them, run `configure' script with the arguments
135`--with-type1' and/or `--with-truetyep'.
136
1372.2 Contents of each directory
138
139European -- European normal size fonts (suitable with the other fonts)
140 lt1-{1[468],24}-etl.bdf ISO8859-1 (Latin-1)
141 lt1-16{b,i,bi}-etl.bdf ISO8859-1 bold, italic, bold-italic
142 lt1-18{b,i,bi}-etl.bdf ISO8859-1 bold, italic, bold-italic
143 lt1-24{b,i,bi}-etl.bdf ISO8859-1 bold, italic, bold-italic
144 lt2-{14,16,24}-etl.bdf ISO8859-2 (Latin-2)
145 lt3-{14,16,24}-etl.bdf ISO8859-3 (Latin-3)
146 lt4-{14,16,24}-etl.bdf ISO8859-4 (Latin-4)
147 cyl{14,16,24}-etl.bdf ISO8859-5 (Cyrillic)
148 grk{14,16,24}-etl.bdf ISO8859-7 (Greek)
149 lt5-{14,16,24}-etl.bdf ISO8859-9 (Latin-5)
150 koi{14,16,24}-etl.bdf KOI8 (Cyrillic)
151
152European.BIG -- European big fonts
153 lt1-40-etl.bdf ISO8859-1 (Latin-1)
154
155Asian -- Asian (non-CJK) fonts
156 ind1c{16,24}-mule.bdf Indian script single column width
157 ind{16,24}-mule.bdf Indian script double column width
158 ind{16,24}-uni.bdf Indian script of Unicode encoding.
159 isci{16,24}-mule.bdf Indian script
160 lao{1[468],24}-mule.bdf Lao
161 lao18{b,i}-mule.bdf Bold, italic of lao18-mul.bdf
162 tib1c{16,24}-mule.bdf Tibetan single column width
163 tib{16,24}-mule.bdf Tibetan double column width
164 thai{14,18,16,24}.bdf Thai (TIS620)
165 thai18{b,i,bi}.bdf Bold, italic, bold-italic of thai18.bdf
166 xtis{18,24}.bdf Thai XTIS encoding (not used by Emacs)
167 visc{16,18,24}-etl.bdf Vietnamese (VISCII)
168 visc18{b,i,bi}-etl.bdf Bold, italic, bold-italic of visc18-etl.bdf
169
170Chinese -- Chinese normal size fonts excluding what distributed with X
171 guob16.bdf 16 dots GB2312 + GB8565-88
172 cns[1234567]-16.bdf 16 dots CNS Plane 1..7
173 cns[1234567]-24.bdf 24 dots CNS Plane 1..7
174 taipei{16,24}.bdf 16 and 24 dots BIG5 (ETen)
175 sish{14,16,24}-etl.bdf 14, 16, 24 dots SiSheng
176
177Chinese.BIG -- Chinese big fonts
178 cc{40,48}s.bdf 40 and 48 dots GB2312
179 cns[1234567]-40.bdf 40 dots CNS Plane 1..7
180
181Chinese.X -- Chinese fonts distributed with X
182 gb16{fs,st}.bdf 16 dots GB2312 (gb16fs.bdf & gb16st.bdf)
183 gb24st.bdf 24 dots GB2312 (gb24st.bdf)
184
185Japanese -- Japanese normal size fonts excluding what distributed with X
186 j90-16.bdf 16 dots JISX0208.1990
187 j78-16.bdf 16 dots JISX0208.1978
188 jksp16.bdf 16 dots JISX0212.1990 (HojoKanji)
189 j83-18.bdf 18 dots JISX0208.1983
190 j83-18{b,i,bi}.bdf Bold, italic, bold-italic of j83-18.bdf
191 a18rk.bdf 9x18 dots JISX0201 (Roman & Kana)
192 a18rk{b,i,bi}.bdf Bold, italic, bold-italic of a18rk.bdf
193
194Japanese.BIG -- Japanese big fonts
195 jiskan32.bdf 32 dots JISX0208.1983
196 jiskan48.bdf 48 dots JISX0208.1983
197 jksp40.bdf 40 dots JISX0212.1990 (HojoKanji)
198
199Japanese.X -- Japanese fonts distributed with X
200 k14.bdf 14 dots JISX0208.1983
201 jiskan{16,24}.bdf 16 and 24 dots JISX0208.1983
202 8x16rk.bdf 8x16 dots JISX0201 (Roman & Kana)
203 12x24rk.bdf 12x24 dots JISX0201 (Roman & Kana)
204
205Korean.X -- Korean fonts distributed with X
206 hangl[mg]16.bdf 16 dots KSC5601.1987
207 hanglm24.bdf 24 dots KSC5601.1987
208
209Ethiopic -- Ethiopic fonts
210 ethio16f-uni.bdf 16 dots Ethiopic (Unicode)
211 ethio24f-uni.bdf 24 dots Ethiopic (Unicode)
212
213Misc -- fonts for the other regions/scripts
214 ipa{14,16,24}-etl.bdf International Phonetic Alphabet
215 heb{14,16,24}-etl.bdf ISO8859-8 (Hebrew)
216 arab{16,24}-0-etl.bdf Arabic digits
217 arab{16,24}-1-etl.bdf Arabic single column
218 arab{16,24}-2-etl.bdf Arabic double column
219 bmp16-etl.bdf bitmap element glyphs used by bitmap.el
220
221TrueType -- Truetype fonts
222 lt[12345]-{r,b,i,bi}-omega-serif.ttf
223 Latin-X fonts roman, bold, italic, and bold-italic
224 viscii-omega-serif.ttf
225 Vietnamese (VISCII roman)
226
227Type1 -- Postscript Type1 fonts
228 lt[12345]-{r,b,i,bi}-omega-serif.{pfa,pfb,afm}
229 Latin-X fonts roman, bold, italic, and bold-italic
230 tis620-r-omega-serif.{pfa,pfb,afm}
231 Thai (TIS620)
232 nf{3,3i}.{pfa,pfb,afm}
233 Thai National Font (TIS620 roman and italic)
234 viscii-r-omega-serif.{pfa,pfb,afm}
235 Vietnamese (VISCII roman)
236