<STATUS> stat: DP ppkg: GNU dejagnu 1.6.3 page: dejagnu-report-card.1 date: 2021/06/16 mail: michio_matsu****@yahoo***** name: Michio MATSUYAMA </STATUS> # 従前の man ページと比べて roff の記述体裁が # 大きく異なるため、下記の対訳表記は、読みにくい # かもしれません。 # .Nm は、冒頭において ".Nm dejagnu .Nd" として # 「dejagnu」という文字列に定義されていて、それ # 以降 ".Nm" だけでこの文字列を参照する形です。 # roff 文法を読みなれていないとわかりづらいかも # しれません。 # # わかりづらい場合は、 # git リポジトリ内の draft ファイルを参照ください。 # manual/GNU_dejagnu/draft/man1/dejagnu-report-card.1 [原文] .Sh NAME .Nm dejagnu\ report\ card .Nd summarize results from testing multiple tools [訳文] .Sh 名前 .Nm dejagnu\ report\ card .Nd 複数ツールに対するテスト結果の取りまとめ ---------------------------------------- [原文] .Sh SYNOPSIS .Nm dejagnu\ report\ card .Oo Ao Ar option Ac \*(Ba Ao Ar tool Ac \*(Ba Ao Ar file Ac Oc ... [訳文] .Sh 書式 .Nm dejagnu\ report\ card .Oo Ao Ar option Ac \*(Ba Ao Ar tool Ac \*(Ba Ao Ar file Ac Oc ... ---------------------------------------- [原文] .Sh DESCRIPTION The .Nm command displays results from testing multiple tools in a tabular format. The produced table lists, for each tool (and if multiple passes were run, each pass) the number of tests passed, failed, unsupported, unresolved, and untested. Tests that are expected to fail are counted in separate columns from tests expected to pass, but "known" failures and "expected" failures are summarized together. If a test generated warnings or errors, a tag .Ql !W! or .Ql !E! is appended at the end of the relevant line. [訳文] .Sh 説明 The .Nm コマンドは、 複数ツールによるテスト結果を表形式で表示します。 生成されるこの表においては、 以下の項目を一覧表示します。 各ツールごとに (そして複数パスが実行された場合には、 各パスごとに)、 テストの成功数 (passed)、 失敗数 (failed)、 未対応数 (unsupported)、 未解決数 (unresolved)、 未実施数 (untested) です。 失敗することが予想されるテストは、 成功することが予想されるテストとは、 別カラムに分けてカウントされます。 ただし失敗することが分かっている ("known") テストと、 失敗が予想される ("expected") テストは、 まとめられます。 テストが警告やエラーを生成した場合、 関連する行の終わりに .Ql !W! や .Ql !E! というタグがつきます。 ---------------------------------------- [原文] .Pp Aside from options, the argument list may include tool or file names. The .Nm command prefers to read DejaGnu summary files and will translate names accordingly: .Bl -tag -width ".Pa *.sum" [訳文] .Pp オプションでなく引数リストの場合には、 ツール名またはファイル名が含まれる場合があります。 .Nm コマンドは、 DejaGnu 概要ファイル (summary file) を読み込もうとします。 そして、 その場合には名称の翻訳を行います。 .Bl -tag -width ".Pa *.sum" ---------------------------------------- [原文] .It Pa *.sum Used as-is. [訳文] .It Pa *.sum そのまま用います。 ---------------------------------------- [原文] .It Pa *.log Rewritten to [訳文] .It Pa *.log 同じベース名を用いて ---------------------------------------- [原文] .Pa *.sum with the same stem. [訳文] .Pa *.sum に書き換えます。 ---------------------------------------- [原文] .It Pa *. The string [訳文] .It Pa *. 概要ファイルを用いるために、 文字列 ---------------------------------------- [原文] .Pa sum is appended to select a summary file. This processing is done for convenience when using Readline file name completion in a shell, which will complete to the dot. [訳文] .Pa sum が後ろにつけられます。 この処理は、 シェル上の Readline によって、 ファイル名補完を用いた場合の利便性のために行われるものであり 、 補完がドットまで行われるからです。 ---------------------------------------- [原文] .It Pa * Taken as a tool name; [訳文] .It Pa * ツール名として扱われます。 後ろに ---------------------------------------- [原文] .Pa .sum is appended. .El [訳文] .Pa .sum がつけられます。 .El ---------------------------------------- [原文] .Sh OPTIONS .Bl -tag -width ".Fl v , -verbose" [訳文] .Sh オプション .Bl -tag -width ".Fl v , -verbose" ---------------------------------------- [原文] .It Fl v , -verbose Emit additional output describing the operation of .Nm itself. .El [訳文] .It Fl v , -verbose .Nm の操作自体を説明する追加情報を出力します。 .El ---------------------------------------- [原文] .Sh FILES The .Nm command produces its output by reading the summary files produced by DejaGnu and counting "PASS", "FAIL", etc. [訳文] .Sh ファイル .Nm コマンドが出力を生成する際には、 DejaGnu によって作られた概要ファイルを読み込んで、 "PASS" や "FAIL" などの数をカウントします。 ---------------------------------------- [原文] .Pp If no names are given as arguments, all files matching [訳文] .Pp 引数に名前が指定されなかった場合、 カレントディレクトリ内の ---------------------------------------- [原文] .Pa *.sum in the current directory are read. [訳文] .Pa *.sum に一致するファイルすべてが読み込まれます。 ---------------------------------------- [原文] .Sh EXAMPLES .Ss A simple example from DejaGnu's own testsuite .Bd -literal $ dejagnu report card \ __________________________________________________ \ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST \ |-------------------------------------------------- \ launcher | 52 0 0 0 0 0 0 libdejagnu | 5 0 0 0 0 0 0 \ runtest | 135 0 0 0 0 0 0 \ |-------------------------------------------------- \ | 192 0 0 0 0 0 0 \ \\__________________________________________________ .Ed [訳文] .Sh 例 .Ss DejaGnu 自体のテストスイートから、単純な例を示します。 .Bd -literal $ dejagnu report card \ __________________________________________________ \ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST \ |-------------------------------------------------- \ launcher | 52 0 0 0 0 0 0 libdejagnu | 5 0 0 0 0 0 0 \ runtest | 135 0 0 0 0 0 0 \ |-------------------------------------------------- \ | 192 0 0 0 0 0 0 \ \e__________________________________________________ .Ed ---------------------------------------- [原文] .Pp Three tools were tested, with a total of 192 tests, all expected to pass. In this example, all tests did pass, so all other columns are zero. The .Ql ?PASS and .Ql ?FAIL columns count tests known or expected to fail that either unexpectedly passed or failed as expected. The remaining three columns count the exceptional results for unsupported tests, unresolved tests and stub tests that simply declare themselves untested. [訳文] .Pp 3 つのツールがテストされました。 そこでは全部で 192 個のテストがあり、 すべて成功することが予想されているものです。 この例において、 テストはすべて成功 (pass) しています。 したがってこれ以外のカラムは、 すべてゼロになっています。 .Ql ?PASS と .Ql ?FAIL のカラムは、 それぞれ失敗することが分かっている (known) ものと、 失敗が予想される (expected) ものであったもので、 実際には、 予想に反して成功したものと、 予想どおりに失敗したものを、 それぞれ示しています。 残りの 3 つのカラムは、 例外的な結果を示しているもので、 サポートされていない (unsupported) テスト、未解決 (unresolved) のテスト、 単純にテストしない (untested) ものとして宣言されているスタブテストをそれぞれ示しています。 ---------------------------------------- [原文] .Pp .ne 16v .Ss The same example after tests were added for dejagnu-report-card .Bd -literal $ dejagnu report-card \ __________________________________________________ \ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST \ |-------------------------------------------------- \ launcher | 52 0 0 0 0 0 0 \ libdejagnu | 5 0 0 0 0 0 0 report-card / awk | 36 0 0 0 0 0 0 report-card / sh | 36 0 0 0 0 0 0 report-card / tcl | 36 0 0 0 0 0 0 \ runtest | 135 0 0 0 0 0 0 \ |-------------------------------------------------- \ awk | 36 0 0 0 0 0 0 \ sh | 36 0 0 0 0 0 0 \ tcl | 36 0 0 0 0 0 0 \ |-------------------------------------------------- \ | 300 0 0 0 0 0 0 \ \\__________________________________________________ .Ed [訳文] .Pp .ne 16v .Ss dejagnu-report-card に対するテストが追加された後の同様の結果例 .Bd -literal $ dejagnu report-card \ __________________________________________________ \ / PASS FAIL ?PASS ?FAIL UNSUP UNRES UNTEST \ |-------------------------------------------------- \ launcher | 52 0 0 0 0 0 0 \ libdejagnu | 5 0 0 0 0 0 0 report-card / awk | 36 0 0 0 0 0 0 report-card / sh | 36 0 0 0 0 0 0 report-card / tcl | 36 0 0 0 0 0 0 \ runtest | 135 0 0 0 0 0 0 \ |-------------------------------------------------- \ awk | 36 0 0 0 0 0 0 \ sh | 36 0 0 0 0 0 0 \ tcl | 36 0 0 0 0 0 0 \ |-------------------------------------------------- \ | 300 0 0 0 0 0 0 \ \e__________________________________________________ .Ed ---------------------------------------- [原文] .Pp The .Ql report-card tool has been added, with three passes, one for each implementation. (The shell and Tcl implementations were later dropped to reduce future maintenance burden.) As before, all tests passed as expected. The interesting difference from the previous example is the use of DejaGnu's multipass testing feature and the additional per-pass summary lines added. For this example, only the .Ql report-card tool uses multipass testing, so each pass total is simply the count of tests for .Ql report-card instead of a distinct total. [訳文] .Pp .Ql report-card ツールに対して、 各実装ごとに 1 つ、合計で 3 つのパスが追加されています。 (この後に shell と Tcl による実装は、 将来のメンテナンス負荷を減らすために、 取り除かれます。) 前の例と同じく、 テストはすべて期待どおりに成功しています。 ただ前の例と違って興味深いのは、 DejaGnu によるマルチパスのテスト機能が利用されている点です。 これに従って、 パスごとの概要行が追加されています。 この例において、 マルチパスのテストを行っているのは .Ql report-card ツールだけです。 そこで各パスの合計値は、 他の合計値とは違って、 単に .Ql report-card のテスト数にすぎません。 ---------------------------------------- [原文] .Pp Also note that the command used to invoke .Nm is slightly different here. The .Xr dejagnu 1 launcher will also accept multiple words joined with dashes into a single argument. This allows individual words in a command name to be separated with either dashes or spaces on the command line interchangeably. [訳文] .Pp また、 .Nm の実行に用いたコマンドが、 ここでは多少異なっている点を確認してください。 .Xr dejagnu 1 の実行にあたっては、 複数単語をダッシュ文字でつなぎ合わせて 1 つの引数として受け渡すことができます。 こうすることによって、 1 つのコマンド名に含まれる複数単語を、 ダッシュや空白により交互に区切って、 コマンドライン上から指定することができます。 ---------------------------------------- [原文] .Sh SEE ALSO .Xr dejagnu 1 .Xr runtest 1 [訳文] .Sh 関連項目 .Xr dejagnu 1 .Xr runtest 1 ---------------------------------------- [原文] .Pp The full documentation for DejaGnu is maintained as a Texinfo manual. If the .Nm info program is properly installed at your site, the command .Li info dejagnu should give you access to the complete manual. [訳文] .Pp DejaGnu の完全なドキュメントは Texinfo マニュアルとしてメンテナンスされています。 .Nm info プログラムが適切にインストールされていれば、 コマンド .Li info dejagnu の実行によって、 完全なマニュアルを参照できます。 ---------------------------------------- [原文] .Sh AUTHORS .An Jacob Bachmeyer [訳文] .Sh 著者 .An Jacob Bachmeyer ----------------------------------------
Fork