Info file: XFONT,    -*-Text-*-
produced by texinfo-format-buffer
from file: XFONT.texi




File: XFONT  Node: Top, Up: (mule)

X's FONT usage
==============

This document descrives X's FONT usage for novice users.

* Menu:

* Font path::           How to set font path?
* Building fonts::      How to build new fonts?
* Getting fonts::       How to get fonts?
* Font selection: (mule) FONT.      Mule's font selection mechanism


File: XFONT  Node: Font path, Up: Top, Next: Building fonts

Setting font path
=================

To run Mule as a client of X, X's font is required for each
character set (e.g. GB2312 [Chinese], JISX0208 [Japanese]).
The fonts you can use on your X server are listed by the
command `xlsfonts'.
     `% xlsfonts | egrep -i gb2312'
will show you fonts for Chinese (GB).
     `% xlsfonts | egrep -i jisx0208'
will show you fonts for Japanese.
     `% xlsfonts | egrep -i ksc5601'
will show you fonts for Korean.
     `% xlsfonts | egrep -i big5'
will show you fonts for Big5.

If you can't find necessary fonts, check your 'Font Path' by:
     `% xset q'

Under the default setting of X.V11R5, fonts for Japanese and
Korean are in the directory /usr/lib/X11/fonts/misc.  If
these directories are not in your Font Path, put them in by:
     `% xset fp+ /usr/lib/X11/fonts/misc'
If there are no such directories, you must create X's font
from BDF files by yourself *Note Building fonts::.

Now, you can run Mule on X.  If you want to use different
fonts than defaults, you can specify them by command line
switch or your X's resource file (try `man mule' or look
into the file `mule/etc/mule.1').


File: XFONT  Node: Building fonts, Prev: Font path, Up: Top, Next: Getting fonts

Building fonts
==============

X.V11R5 is distributed with many fonts (BDF format).  Those
are under X.V11R5/mit/fonts/bdf/misc:
     	jiskan16.bdf, jiskan24.bdf (Japanese)
     	hanglm16.bdf, hanglm24.bdf (Korean)
and under X.V11R5/contrib/clients/cxterm/fonts:
     	cclib16st.bdf, cclib24st.bdf (Chinese GB)
     	hku-ch16.bdf (Chinese Big5)
To create fonts from these files, you'd better make a
directory for them (say ${font}):
     	% mkdir ${font}
     	% cd ${font}
     	% bdftopcf xxx/jiskan24.bdf >jiskan24.pcf
     	% bdftopcf yyy/hanglm24.bdf >hanglm24.pcf
     	...
     	% mkfontdir
     	% xset fp+ `pwd`

Now you can check if you are really able to use these fonts by
'xlsfonts' command.  You must use 'bdftosnf' instead of
'bdftopcf' if you are using X.V11R4.


File: XFONT  Node: Getting fonts, Prev: Building fonts, Up: Top

How to get fonts?
=================

Mule requires more fonts than in the distribution of
X.V11R5.  For instance, in the case of using EGG with cWnn's
cserver, font for SiSheng characters is necessary.  The
directory `fonts' under the ftp directory of Mule contains
those fonts.