cgit.sxemacs.org Git - packages/blob - mule-packages/mule-base/texi/XFONT.texi

   1 \input texinfo  @c -*-texinfo-*-
   2 @setfilename ../info/XFONT
   3 @settitle X's FONT usage
   4
   5 @titlepage
   6 @sp 6
   7 @center @titlefont{X's FONT usage for novice users}
   8 @sp 4
   9 @center Version 2.0
  10 @sp 5
  11 @center Ken'ichi HANDA
  12 @center handa@@etl.go.jp
  13 @page
  14
  15 @end titlepage
  16
  17 @node Top, , , (mule)
  18 @section X's FONT usage
  19
  20 This document descrives X's FONT usage for novice users.
  21
  22 @menu
  23 * Font path::           How to set font path?
  24 * Building fonts::      How to build new fonts?
  25 * Getting fonts::       How to get fonts?
  26 * Font selection: (mule) FONT.      Mule's font selection mechanism
  27 @end menu
  28
  29 @node Font path, Building fonts, , Top
  30 @section Setting font path
  31
  32 To run Mule as a client of X, X's font is required for each
  33 character set (e.g. GB2312 [Chinese], JISX0208 [Japanese]).
  34 The fonts you can use on your X server are listed by the
  35 command @code{xlsfonts}.
  36 @quotation
  37 @code{% xlsfonts | egrep -i gb2312}
  38 @end quotation
  39 will show you fonts for Chinese (GB).
  40 @quotation
  41 @code{% xlsfonts | egrep -i jisx0208}
  42 @end quotation
  43 will show you fonts for Japanese.
  44 @quotation
  45 @code{% xlsfonts | egrep -i ksc5601}
  46 @end quotation
  47 will show you fonts for Korean.
  48 @quotation
  49 @code{% xlsfonts | egrep -i big5}
  50 @end quotation
  51 will show you fonts for Big5.
  52
  53 If you can't find necessary fonts, check your 'Font Path' by:
  54 @quotation
  55 @code{% xset q}
  56 @end quotation
  57
  58 Under the default setting of X.V11R5, fonts for Japanese and
  59 Korean are in the directory /usr/lib/X11/fonts/misc.  If
  60 these directories are not in your Font Path, put them in by:
  61 @quotation
  62 @code{% xset fp+ /usr/lib/X11/fonts/misc}
  63 @end quotation
  64 If there are no such directories, you must create X's font
  65 from BDF files by yourself @xref{Building fonts}.
  66
  67 Now, you can run Mule on X.  If you want to use different
  68 fonts than defaults, you can specify them by command line
  69 switch or your X's resource file (try `man mule' or look
  70 into the file `mule/etc/mule.1').
  71
  72 @node Building fonts, Getting fonts, Font path, Top
  73 @section Building fonts
  74
  75 X.V11R5 is distributed with many fonts (BDF format).  Those
  76 are under X.V11R5/mit/fonts/bdf/misc:
  77 @quotation
  78         jiskan16.bdf, jiskan24.bdf (Japanese)
  79         hanglm16.bdf, hanglm24.bdf (Korean)
  80 @end quotation
  81 and under X.V11R5/contrib/clients/cxterm/fonts:
  82 @quotation
  83         cclib16st.bdf, cclib24st.bdf (Chinese GB)
  84         hku-ch16.bdf (Chinese Big5)
  85 @end quotation
  86 To create fonts from these files, you'd better make a
  87 directory for them (say ${font}):
  88 @example
  89         % mkdir ${font}
  90         % cd ${font}
  91         % bdftopcf xxx/jiskan24.bdf >jiskan24.pcf
  92         % bdftopcf yyy/hanglm24.bdf >hanglm24.pcf
  93         ...
  94         % mkfontdir
  95         % xset fp+ `pwd`
  96 @end example
  97
  98 Now you can check if you are really able to use these fonts by
  99 'xlsfonts' command.  You must use 'bdftosnf' instead of
 100 'bdftopcf' if you are using X.V11R4.
 101
 102 @node Getting fonts, , Building fonts, Top
 103 @section How to get fonts?
 104
 105 Mule requires more fonts than in the distribution of
 106 X.V11R5.  For instance, in the case of using EGG with cWnn's
 107 cserver, font for SiSheng characters is necessary.  The
 108 directory `fonts' under the ftp directory of Mule contains
 109 those fonts.
 110
 111 @contents
 112 @bye