doc/info/ja/Bugs.texi

   1 @menu
   2 * Functions and Variables for Bug Detection and Reporting::
   3 @end menu
   4
   5 @c -----------------------------------------------------------------------------
   6 @node Functions and Variables for Bug Detection and Reporting
   7 @section Functions and Variables for Bug Detection and Reporting
   8 @c -----------------------------------------------------------------------------
   9
  10 @c -----------------------------------------------------------------------------
  11 @anchor{run_testsuite}
  12 @deffn {関数} run_testsuite ([@var{options}])
  13
  14 Maximaのテストスイートを走らせます。
  15 望みの答えを生成したテストは「パス」とみなされます。
  16 望みの答えを生成しないテストも同様ですが、既知のバグとしてマークされています。
  17
  18 @code{run_testsuite}は、以下のオプションキーワード引数を取ります。
  19
  20 @table @code
  21 @item display_all
  22 テストすべてを表示します。
  23 通常は、テストが失敗しない限りテストを表示しません。
  24 （デフォルトでは @code{false}に設定されます。）
  25 @item display_known_bugs
  26 既知のバグとしてマークされているテストを表示します。
  27 （デフォルトでは @code{false}に設定されます。）
  28 @item tests
  29 これは、実行するテストのリストです。
  30 それぞれのテストは文字列かシンボルで指定することができます。
  31 デフォルトではテストすべてを実行します。
  32 テストの完全な組は @mref{testsuite_files}で指定されています。
  33 @item time
  34 時間情報を表示します。
  35 もし @code{true}ならそれぞれのテストファイルにかかった時間を表示します。
  36 もし @code{all}なら @code{display_all}が @code{true}の時、
  37 それぞれ個々のテストにかかった時間を示します。
  38 デフォルトは@code{false}で、時間情報を示しません。
  39 @end table
  40
  41 例えば、 @code{run_testsuite(display_known_bugs = true, tests=[rtest5])}は、
  42 テスト @code{rtest5}だけを走らせ、既知のバグとしてマークされているテストを表示します。
  43
  44 @code{run_testsuite(display_all = true, tests=["rtest1", rtest1a])}は、
  45 テスト @code{rtest1}と @code{rtest2}を走らせ、
  46 テストそれぞれを表示します。
  47
  48 @code{run_testsuite}は、Maxima環境を変更します。
  49 通常は、テストスクリプトは
  50 既知の環境（すなわちユーザー定義の関数や変数のない環境）を確立するために
  51 @mref{kill}を実行し、
  52 それからテストにふさわしい関数や変数を定義します。
  53
  54 @code{run_testsuite}は @code{done}を返します。
  55
  56 @opencatbox
  57 @category{Debugging}
  58 @closecatbox
  59 @end deffn
  60
  61 @c -----------------------------------------------------------------------------
  62 @anchor{testsuite_files}
  63 @defvr {オプション変数} testsuite_files
  64
  65 @code{testsuite_files}は @mref{run_testsuite}が実行するテスト一式です。
  66 それは実行するテストを含むファイル名のリストです。
  67 もしファイルの中のテストのいくつかが失敗することが既知なら、
  68 ファイル名をリストする代わりに、
  69 ファイル名と失敗するテスト番号を含むリストを使います。
  70
  71 例えば、以下はデフォルトのテスト一式の一部です:
  72
  73 @example
  74  ["rtest13s", ["rtest14", 57, 63]]
  75 @end example
  76
  77 これは、ファイル"rtest13s", "rtest14"から成るテストスイートを指定しますが、
  78 "rtest14" は失敗することが既知の２つのテスト57と63を含みます。
  79
  80 @opencatbox
  81 @category{Debugging} @category{Global variables}
  82 @closecatbox
  83 @end defvr
  84
  85 @c -----------------------------------------------------------------------------
  86 @anchor{bug_report}
  87 @deffn {関数} bug_report ()
  88
  89 MaximaとLispのバージョン番号を表示し、Maximaプロジェクトのバグレポートウェブサイトへのリンクを与えます。
  90 バージョン情報は@mref{build_info}がレポートするものと同じです。
  91
  92 バグをレポートする時、
  93 MaximaとLispのバージョン情報をバグレポートにコピーしてもらえると助かります。
  94
  95 @code{bug_report}は空の文字列 @code{""}を返します。
  96
  97 @opencatbox
  98 @category{Debugging}
  99 @closecatbox
 100 @end deffn
 101
 102 @c -----------------------------------------------------------------------------
 103 @anchor{build_info}
 104 @deffn {関数} build_info ()
 105
 106 Maximaビルドのパラメータのまとめを表示します。
 107
 108 @code{build_info}は空の文字列 @code{""}を返します。
 109 @mrefdot{bug_report}も参照してください。
 110
 111 @opencatbox
 112 @category{Debugging}
 113 @closecatbox
 114 @end deffn
 115