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

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

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 see 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').

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.

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.