manual/e2fsprogs/draft/man1/compile_et.1

   1 .\" Copyright (c) 1988 Massachusetts Institute of Technology,
   2 .\" Student Information Processing Board.  All rights reserved.
   3 .\"
   4 .\" Japanese Version Copyright (c) 2000 NAKANO Takeo all rights reserved.
   5 .\" Translated Thu 13 2000 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
   6 .\"
   7 .\" $Header$
   8 .\"
   9 .TH COMPILE_ET 1 "30 Mar 1998" SIPB
  10 .\"O .SH NAME
  11 .\"O compile_et \- error table compiler
  12 .SH 名前
  13 compile_et \- エラー表のコンパイラー
  14 .\"O .SH SYNOPSIS
  15 .SH 書式
  16 .B compile_et
  17 file
  18 .\"O .SH DESCRIPTION
  19 .SH 説明
  20 .\"O .B Compile_et
  21 .\"O converts a table listing error-code names and associated messages into
  22 .\"O a C source file suitable for use with the
  23 .\"O .IR com_err (3)
  24 .\"O library.
  25 .B compile_et
  26 は、エラーコードの名前と対応するメッセージをリストした表を、
  27 .IR com_err (3)
  28 ライブラリで扱いやすい C ソース形式に変換する。
  29
  30 .\"O The source file name must end with a suffix of ``.et''; the file
  31 .\"O consists of a declaration supplying the name (up to four characters
  32 .\"O long) of the error-code table:
  33 ソースファイルの名前は ``.et'' という拡張子で終わっている必要がある。
  34 ファイルの先頭で、まずエラーコード表の名前
  35 (名前は 4 文字まで)。
  36 を与える宣言を行う。
  37 .RS
  38 .sp
  39 .B error_table
  40 .I name
  41 .sp
  42 .RE
  43 .\"O followed by up to 256 entries of the form:
  44 続いて、エントリを次の形式で与える (256 エントリまで)。
  45 .RS
  46 .sp
  47 .B error_code
  48 .I name,
  49 .\"O "
  50 .\"O .I string
  51 .\"O "
  52 .RI \" string \"
  53 .sp
  54 .RE
  55
  56 .\"O and a final
  57 そして最後に表の末尾を
  58 .RS
  59 .sp
  60 .B end
  61 .sp
  62 .RE
  63 .\"O to indicate the end of the table.
  64 によって示す。
  65
  66 .\"O The name of the table is used to construct the name of a subroutine
  67 .\"O .I initialize_XXXX_error_table
  68 .\"O which must be called in order for the
  69 .\"O .I com_err
  70 .\"O library to recognize the error table.
  71 表の名前は、サブルーチンの名前をつくるときに
  72 .I initialize_XXXX_error_table
  73 の様に用いられる。
  74 .I com_err
  75 ライブラリにこのエラー表を認識させるには、
  76 このサブルーチンを呼び出す必要がある。
  77
  78 .\"O The various error codes defined are assigned sequentially increasing
  79 .\"O numbers (starting with a large number computed as a hash function of
  80 .\"O the name of the table); thus for compatibility it is suggested that
  81 .\"O new codes be added only to the end of an existing table, and that no
  82 .\"O codes be removed from tables.
  83 各種エラーコードの定義は、ひとつずつ増える数値に割り当てられる
  84 (先頭の数値は、表の名前をハッシュ関数に与えて計算された値になる)。
  85 したがって互換性を保つためには、
  86 新しいコードの追加は既存の表の末尾に行い、
  87 表からコードの削除を行わないことである。
  88
  89 .\"O The names defined in the table are placed into a C header file with
  90 .\"O preprocessor directives defining them as integer constants of up to
  91 .\"O 32 bits in magnitude.
  92 表で定義されている名前は、 C のヘッダファイルにおいて、
  93 それらの名前を 32 ビットまでの整数定数として定義する
  94 プリプロセッサ指定になる。
  95
  96 .\"O A C source file is also generated which should be compiled and linked
  97 .\"O with the object files which reference these error codes; it contains
  98 .\"O the text of the messages and the initialization subroutine.  Both C
  99 .\"O files have names derived from that of the original source file, with
 100 .\"O the ``.et'' suffix replaced by ``.c'' and ``.h''.
 101 C ソースファイルも生成されるので、これをコンパイルして、
 102 エラーコードを参照するオブジェクトファイルにリンクする。
 103 C ソースファイルには、メッセージのテキストと初期化サブルーチンとが含まれる。
 104 C のヘッダファイル・ソースファイル両者の名前は、
 105 オリジナルのソースファイルの名前の ``.et'' 拡張子を、
 106 それぞれ ``.h'', ``.c'' に置き換えたものになる。
 107
 108 .\"O A ``#'' in the source file is treated as a comment character, and all
 109 .\"O remaining text to the end of the source line will be ignored.
 110 ソースファイル中の ``#'' はコメント文字として扱われ、
 111 その行の末尾までの残りのテキストは無視される。
 112 .\"O
 113 .\"O .SH BUGS
 114 .\"O
 115 .SH バグ
 116 .\"O Since the original
 117 .\"O .B compile_et
 118 .\"O uses a very simple parser based on
 119 .\"O .IR yacc (1),
 120 .\"O and this current version of
 121 .\"O .B compile_et
 122 .\"O uses an awk/sed combination of scripts,
 123 .\"O its error recovery leaves much to be desired.
 124 オリジナルの
 125 .B compile_et
 126 は
 127 .IR yacc (1)
 128 を用いた非常に簡単なパーサーを使っていたし、
 129 現在のバージョンの
 130 .B compile_et
 131 は awk と sed スクリプトを組み合わせて用いているので、
 132 エラーリカバリは望ましい水準からはほど遠い。
 133 .\"O
 134 .\" .IR for manual entries
 135 .\" .PP for paragraph breaks
 136 .\"O
 137 .\"O .SH "SEE ALSO"
 138 .SH 関連項目
 139 .\"O com_err (3).
 140 com_err (3)
 141
 142 Ken Raeburn, "A Common Error Description Library for UNIX".