.\" $Xorg: mkfontdir.man,v 1.3 2000/08/17 19:53:59 cpqbld Exp $
.\" Copyright 1993, 1994, 1998  The Open Group
.\" 
.\" All Rights Reserved.
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\" $XFree86: xc/programs/mkfontdir/mkfontdir.man,v 1.12 2001/01/27 18:21:04 dawes Exp $
.\"
.\"
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Tue Oct 27 22:33:37 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Mon Jan  8 21:41:42 JST 2001 for XFree86 4.0.2
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 14 22:01:32 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.TH MKFONTDIR 1 "Release 6.5" "X Version 11"
.SH 名前
.\"0 mkfontdir, fonts.dir, fonts.scale, fonts.alias, encodings.dir \- create an index of X font files in a directory
mkfontdir, fonts.dir, fonts.scale, fonts.alias, encodings.dir \- あるディレクトリ内の X フォントファイルのインデックスを生成する
.SH 書式
.B "mkfontdir"
.RB [ \-x
.IR suffix ]
.RB [ \-r ]
.RB [ \-p
.IR prefix ]
.RB [ \-e
.IR encoding-directory-name ]
\|.\|.\|.
.RB [ \-\- ]
.RI [ directory-name
\|.\|.\|. ]
.SH 説明
.\"0 For each directory argument, 
.\"0 .I mkfontdir
.\"0 reads all of the font files in the
.\"0 directory searching for properties named "FONT", or (failing that) the name
.\"0 of the file stripped of its suffix.  These are converted to lower case and
.\"0 used as font names, and,
.\"0 along with the name of the font file, are
.\"0 written out to the file "fonts.dir" in the directory.
引き数で指定したディレクトリのそれぞれに対し、
.I mkfontdir
は "FONT"
という名前のプロパティを探すか、(それに失敗した場合)拡張子を取り除いた
名前を探すことにより、そのディレクトリ内の全てのフォントファイルを読む。
これらの名前は小文字に変換されてフォント名として使われ、ディレクトリ内
の "fonts.dir" ファイルに出力される。
.\"0 The X server and font server use "fonts.dir" to find font files.
X サーバとフォントサーバは "fonts.dir" を使ってフォントファイルを見つ
ける。
.PP
.\"0 The kinds of font files read by 
.\"0 .I mkfontdir
.\"0 depend on configuration
.\"0 parameters, but typically include PCF (suffix ".pcf"), SNF (suffix ".snf")
.\"0 and BDF (suffix ".bdf").  If a font exists in multiple formats,
.\"0 .I mkfontdir
.\"0 will first choose PCF, then SNF and finally BDF.
.I mkfontdir
が読む込むフォントの種類は設定パラメータによって決まる
が、通常は PCF(拡張子 ".pcf"), SNF(拡張子 ".snf"), BDF(拡張子 ".bdf")
等である。
1 つのフォントに対して複数フォーマットのファイルがある場合の優先順位は、
PCF, SNF, BDF である。
.PP
.\"0 The first line of fonts.dir gives the number of fonts in the file.
fonts.dir の最初の行にはファイル中のフォント数が書かれる。
.\"0 The remaining lines list the fonts themselves, one per line, in two
.\"0 fields.  First is the name of the font file, followed by a space and
.\"0 the name of the font.
残りの行においては、1行につき1つのフォントが記述される。これは2つの項
目を含む。最初の項目はフォントのファイル名であり、空白を挟んだ次の項目
はフォント名である。
.\"0 .SH "SCALABLE FONTS"
.SH "スケーラブルフォント"
.\"0 Because scalable font files do not usually include the X font name, the
.\"0 file "fonts.scale" can be used to name the scalable fonts in the
.\"0 directory.
通常、スケーラブルフォントのファイルは X のフォント名を含まないため、
ディレクトリ内のスケーラブルフォントを指定するためには "fonts.scale"
ファイルを使う。
.\"0 The fonts listed in it are copied to fonts.dir by 
.\"0 .IR mkfontdir .
.IR \fImkfontdir\fP
は、このファイルに列挙されたフォントを fonts.dir にコピーする。
.\"0 "fonts.scale" has the same format as the "fonts.dir" file.
"fonts.scale" のフォーマットは "fonts.dir" と同じである。
.\"0 .SH "FONT NAME ALIASES"
.SH "フォント名エイリアス"
.\"0 The file "fonts.alias", which can be put in any directory of the font-path, is
.\"0 used to map new names to existing fonts, and should be edited by hand.  The
.\"0 format is two white-space separated columns, the
.\"0 first containing aliases and the second containing font-name patterns.
"fonts.alias" ファイルは既にあるフォントに新しい名前を対応づけるために
使われる。このファイルはフォントパス内の任意のディレクトリに置くことが
できるが、内容は手で編集しなければならない。このファイルの形式は、
2つの項目を空白で区切ったものである。最初の項目はエイリアスであり、次
の項目はフォント名のパターンである。
.\"0 Lines beginning with "!" are comment lines and are ignored.
"!" で始まる行はコメント行であり、無視される。
.PP
.\"0 If neither the alias nor the value specifies the size fields of the
.\"0 font name, this is a scalable alias.  A font name of any size that
.\"0 matches this alias will be mapped to the same size of the font that
.\"0 the alias resolves to.
エイリアスと値のいずれでもフォント名の size 項目が指定されていない場合、
これは
スケーラブルなエイリアスである。このエイリアスにマッチする任意のサイズ
のフォント名は、エイリアスを解決して得られる同じサイズのフォントに対応
づけられる。
.PP
.\"0 When a font alias is used, the name it references is searched for in the normal
.\"0 manner, looking through each font directory in turn.  This means that the
.\"0 aliases need not mention fonts in the same directory as the alias file.
フォント名エイリアスを使った場合、エイリアスが名前を参照する際の
検索方法は通常と同じである。
つまり、各フォントディレクトリが順番に検索される。
これは、エイリアスはエイリアスファイルと同じディレクトリにある
フォントを記述する必要はないということである。
.PP
.\"0 To embed white space in either name, simply enclose it in double-quote
.\"0 marks; to embed double-quote marks (or any other character), precede them
.\"0 with back-slash:
名前の途中に空白を含めるためには、単に二重引用符(")で囲む。二重引用符
(または他の任意の文字)を含めるためには、バックスラッシュで囲む。以下に
その例を挙げる。
.PP
.nf
"magic-alias with spaces"	"\\"font name\\" with quotes"
regular-alias			fixed
.fi
.PP
.\"0 If the string "FILE_NAMES_ALIASES" stands alone on a line, each file-name
.\"0 in the directory (stripped of its suffix) will be used as an alias for
.\"0 that font.
文字列 "FILE_NAMES_ALIASES" が単独で行に現れた場合、そのフォントに対す
るエイリアスとしてはディレクトリ内のファイル名(の拡張子を取り除いたも
の)が使われる。
.\"0 .SH ENCODING FILES
.SH エンコーディングファイル
.\"0 The option 
.\"0 .B -e
.\"0 can be used to specify a directory with encoding files.  Every such
.\"0 directory is scanned for encoding files, the list of which is then
.\"0 written to an "encodings.dir" file in every font directory.  The
.\"0 "encodings.dir" file is used by the server to find encoding
.\"0 information.
オプション
.B -e
を使うと、ディレクトリをエンコーディングファイル付きで指定できる。
このように指定された全てのディレクトリからエンコーディングファイルが
検索され、そのリストが各フォントディレクトリに "encodings.dir" という
名前で書き出される。
"encodings.dir" ファイルは、サーバがエンコーディング情報を調べるために
使う。
.PP
.\"0 The "encodings.dir" file has the same format as "fonts.dir".
"encodings.dir" ファイルの書式は "fonts.dir" と同じである。
.\"0 It maps encoding names (strings of the form
.\"0 .BI CHARSET_REGISTRY \- CHARSET_ENCODING 
.\"0 ) to encoding file names.
このファイルはエンコーディング名(「
.BI 文字集合のレジストリ \- 文字集合のエンコーディング
」の形式の文字列)
をエンコーディングファイル名にマッピングする。
.SH オプション
.\"0 The following options are supported:
対応しているオプションは以下の通りである:
.TP
.B \-e
.\"0 Specify a directory containing encoding files.  The
.\"0 .B \-e
.\"0 option may be specified multiple times, and all the specified
.\"0 directories will be read.  The order of the entries is significant, as
.\"0 encodings found in earlier directories override those in later ones;
.\"0 encoding files in the same directory are discriminated by preferring
.\"0 compressed versions.
エンコーディングファイルが置かれているディレクトリを指定する。
.B \-e
オプションは複数回指定でき、指定された全てのディレクトリが読み込まれる。
項目の順序には意味がある。つまり、前のディレクトリで見つかった
エンコーディングは後のディレクトリのものより優先されるからである。
また、同じディレクトリに置かれているエンコーディングファイルは
圧縮されている方が優先される。
.TP
.B \-p
.\"0 Specify a prefix that is prepended to the encoding file path names
.\"0 when they are written to the "encodings.dir" file.  The prefix is
.\"0 prepended as-is.  If a `/' is required between the prefix and the path
.\"0 names, it must be supplied explicitly as part of the prefix.
"encodings.dir" ファイルに出力する際、
エンコーディングファイルのパス名に付けるプレフィックスを指定する。
このプレフィックスは指定された文字列がそのまま使われる。
したがって、プレフィックスとパス名の間に `/' が必要ならば、
`/' をプレフィックス部分として明示的に指定しなければならない。
.TP
.B \-r
.\"0 Keep non-absolute encoding directories in their relative form when
.\"0 writing the "encodings.dir" file.  The default is to convert relative
.\"0 encoding directories to absolute directories by prepending the current
.\"0 directory.  The positioning of this options is significant, as this
.\"0 option only applies to subsequent
.\"0 .B \-e
.\"0 options.
"encodings.dir" ファイルを出力する際、相対パス指定のディレクトリを
相対パス指定のまま残す。
デフォルトの動作では、相対パス指定のエンコーディングディレクトリは
カレントディレクトリを先頭に追加することにより、絶対パス指定に
変換される。このオプションを指定する位置には意味がある。つまり、
このオプションが適用されるのは、このオプションより後の
.B \-e
に対してだけである。
.TP
.BI "\-x " suffix
.\"0 Ignore fonts files of type
.\"0 .IR suffix .
.IR suffix
型のフォントファイルを無視する。
.TP
.B \-\-
.\"0 End options.
オプション指定の終わりを示す。
.SH ファイル
.TP 15
.B fonts.dir
.\"0 List of fonts in the directory and the files they are stored in.
.\"0 Created by \fImkfontdir\fP.  Read by the X server and font server each
.\"0 time the font path is set (see xset(1)).
ディレクトリ内のフォントとフォントを格納しているファイルのリスト。
\fImkfontdir\fP が生成する。X サーバとフォントサーバは、フォントパスを
設定するときには必ずこのファイルを読む(xset(1) を参照)。
.TP 15
.B fonts.scale
.\"0 List of scalable fonts in the directory.  Contents are copied to
.\"0 fonts.dir by \fImkfontdir\fP.
ディレクトリ内のスケーラブルフォントのリスト。\fImkfontdir\fP はこのファ
イルの内容を fonts.dir にコピーする。
.TP 15
.B fonts.alias
.\"0 List of font name aliases.
フォント名エイリアスのリスト。
.\"0 Read by the X server and font server each
.\"0 time the font path is set (see xset(1)).
X サーバとフォントサーバは、フォントパスを設定するときには必ずこの
ファイルを読む。
.TP 15
.B encodings.dir
.\"0 List of known encodings and the files they are stored in.
既知のエンコーディングと、それが格納されているファイルのリスト。
.\"0 Created by \fImkfontdir\fP.  Read by the X server and font server each
.\"0 time a font with an unknown charset is opened.
\fImkfontdir\fP が生成する。
X サーバは、文字集合がわからないフォントを開くたびに
このファイルを読み込む。
.SH 関連項目
X(7), Xserver(1), xfs(1), xset(1)