ドキュメントの更新

diff --git a/doc/autotest_mk.html b/doc/autotest_mk.html
index 76f6147..86e583e 100644 (file)
--- a/doc/autotest_mk.html
+++ b/doc/autotest_mk.html
@@ -237,7 +237,7 @@ dt {
 
 <h3 class="section">2.1 ダウンロード</h3>
 
-<p><a href="http://github.com/j8takagi/autotest_mk">GitHub/j8takagi/autotest_mk</a>の<a href="http://github.com/j8takagi/autotest_mk/downloads">ダウンロードページ</a>から最新版の<samp><span class="file">tar.gz</span></samp>ファイルをダウンロードします。
+<p><a href="https://github.com/j8takagi/Autotest.mk/">GitHub/j8takagi/Autotest.mk</a>の<a href="https://github.com/j8takagi/Autotest.mk/downloads">ダウンロードページ</a>から最新版の<samp><span class="file">tar.gz</span></samp>ファイルをダウンロードします。
 
  <p>続けて、対応する<samp><span class="file">md5sum</span></samp>ファイルをダウンロードします。
 
@@ -245,7 +245,9 @@ dt {
 
 <h3 class="section">2.2 ファイルの検証</h3>
 
-<p>ダウンロードが完了したら、<kbd>md5sum</kbd>と<kbd>diff</kbd>で正しくファイルがダウンロードができているかを検証します。
+<p>(準備中)
+
+ <p>ダウンロードが完了したら、<kbd>md5sum</kbd>と<kbd>diff</kbd>で正しくファイルがダウンロードができているかを検証します。
 
 <pre class="example">  $ <kbd>md5sum autotest_mk.tar.gz | diff -s autotest_mk.tar.gz.md5sum -</kbd>
   Files autotest_mk.tar.gz.md5sum and - are identical
@@ -348,6 +350,7 @@ dt {
  <p>三角形判定プログラムをビルドします。
 
 <pre class="example">  $ <kbd>make</kbd>
+  rm -f triangle
   gcc -o triangle triangle.c
 </pre>
  <p>テストもかねて、三角形判定プログラムを手動で実行します。
@@ -364,6 +367,7 @@ dt {
 <p>バグを含み一部のテストに失敗する三角形判定プログラムをビルドする場合は、次のコマンドを実行します。
 
 <pre class="example">  $ <kbd>make bug</kbd>
+  rm -f triangle
   gcc -o triangle triangle.c
 </pre>
  <p>テストもかねて、三角形判定プログラムを手動で実行します。
@@ -375,7 +379,7 @@ dt {
   $ <kbd>./triangle 2 4 4</kbd>
   isosceles triangle
 </pre>
- <p><kbd>./triangle 3 4 5</kbd>で、仕様では`scalene triangle'という結果になるべきところが、`futohen sankakukei'となっています。
+ <p><kbd>./triangle 3 4 5</kbd>で、仕様で`scalene triangle'となるべきところが、`futohen sankakukei'となっています。
 
 <p><a name="Create-Group"></a>
 
@@ -453,8 +457,11 @@ dt {
 <pre class="example">  $ <kbd>make set</kbd>
   scalene triangle
 </pre>
- <p>ã\81\93ã\81®æ\96¹æ³\95ã\81§<samp><span class="file">0.txt</span></samp>ã\82\92ä½\9cæ\88\90ã\81\97ã\81\9få ´å\90\88ã\81¯ã\80\81ä½\9cæ\88\90ã\81\95ã\82\8cã\81\9få\86\85容ã\81\8cã\83\86ã\82¹ã\83\88æ\83³å®\9aã\81¨ã\81\97ã\81¦æ\9c¬å½\93ã\81«æ­£ã\81\97ã\81\84ã\81\8bã\82\88ã\81\8fæ¤\9cè¨\8eã\81\99ã\82\8bå¿\85è¦\81ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99。
+ <p>ã\81\93ã\81®æ\96¹æ³\95ã\81§<samp><span class="file">0.txt</span></samp>ã\82\92ä½\9cæ\88\90ã\81\99ã\82\8bå ´å\90\88ã\81¯ã\80\81ä½\9cæ\88\90ã\81\95ã\82\8cã\81\9få\86\85容ã\81\8cã\83\86ã\82¹ã\83\88æ\83³å®\9aã\81¨ã\81\97ã\81¦æ\9c¬å½\93ã\81«æ­£ã\81\97ã\81\84ã\81\8bã\82\88ã\81\8fæ¤\9cè¨\8eã\81\99ã\82\8bå¿\85è¦\81ã\81\8cã\81\82ã\82\8aã\81¾ã\81\99ã\80\82ä¾\8bã\81\88ã\81°ã\80\81ã\83\90ã\82°ã\82\92å\90«ã\82\80ä¸\89è§\92å½¢å\88¤å®\9aã\83\97ã\83­ã\82°ã\83©ã\83 ã\82\92æº\96å\82\99ã\81\97ã\81¦<kbd>make set</kbd>ã\82\92å®\9fè¡\8cã\81\99ã\82\8bã\81¨ã\80\81ä»\95æ§\98ã\81¨ç\95°ã\81ªã\82\8bã\83\86ã\82¹ã\83\88æ\83³å®\9aã\83\95ã\82¡ã\82¤ã\83«ã\81\8cä½\9cæ\88\90ã\81\95ã\82\8cã\80\81ã\83\86ã\82¹ã\83\88ã\82\92æ­£ã\81\97ã\81\8få®\9fè¡\8cã\81§ã\81\8dã\81¾ã\81\9bã\82\93。
 
+<pre class="example">  $ <kbd>make set</kbd>
+  futohen sankakukei
+</pre>
  <p>また、<samp><span class="file">0.txt</span></samp>がすでに存在する場合は<kbd>make set</kbd>を実行するとエラーになり、<samp><span class="file">0.txt</span></samp>は更新されません。
 
 <h4 class="subsection">3.5.3 <kbd>make reset</kbd></h4>
@@ -648,7 +655,7 @@ dt {
 
 <p>バグを含む三角形判定プログラムを準備してテストグループを実行した場合、次のように表示されます。
 
-<pre class="example">  test: 10 / 13 tests passed. Detail in /home/foo/triangle/test/TEST.log
+<pre class="example">  test: 11 / 13 tests passed. Detail in /home/foo/triangle/test/TEST.log
 </pre>
  <p><a name="Check-Group-Log"></a>
 
@@ -816,12 +823,27 @@ dt {
 
 <h4 class="subsection">4.1.1 <kbd>make</kbd>または<kbd>make group</kbd> グループの作成</h4>
 
-<p>変数<code>GROUPDIR</code>で指定されたディレクトリーをテストグループディレクトリーとして作成し、必要な次のファイルをコピーします。
+<p>変数<code>GROUPDIR</code>で指定されたディレクトリーをテストグループディレクトリーとして作成し、必要なファイルを配置します。
 
 <p><a name="Template-Files"></a>
 
 <h4 class="subsection">4.1.2 テンプレートのファイル</h4>
 
+<p>テンプレートディレクトリーには、次のファイルが含まれます。
+     <dl>
+<dt><samp><span class="file">Makefile</span></samp><dd>テンプレートディレクトリーのMakefile
+
+     <br><dt><samp><span class="file">Group.mk</span></samp><dd>グループディレクトリーのMakefile。<kbd>make</kbd>または<kbd>make group</kbd>で、グループディレクトリーに<samp><span class="file">Makefile</span></samp>として配置されます。
+
+     <br><dt><samp><span class="file">Test.mk</span></samp><dd>テストディレクトリーから参照されるMakefile。<kbd>make</kbd>または<kbd>make group</kbd>で、グループディレクトリーに配置されます。
+
+     <br><dt><samp><span class="file">Define.mk</span></samp><dd>テストとテストグループに関する項目を定義したMakefile。<kbd>make</kbd>または<kbd>make group</kbd>で、グループディレクトリーに配置されます。
+
+     <br><dt><samp><span class="file">Define_group.mk</span></samp><dd>テストグループに関する項目を定義したMakefile。<kbd>make</kbd>または<kbd>make group</kbd>で、グループディレクトリーに配置されます。
+
+     <br><dt><samp><span class="file">Define.mk</span></samp><dd>テストに関する項目を定義したMakefile。<kbd>make</kbd>または<kbd>make group</kbd>で、グループディレクトリーに配置されます。
+</dl>
+
 <p><a name="Group-Dir"></a>
 
 <h3 class="section">4.2 グループディレクトリー</h3>
@@ -830,6 +852,8 @@ dt {
 
 <h4 class="subsection">4.2.1 <kbd>make create</kbd> テストの作成</h4>
 
+<p>変数<code>TEST</code>で指定されたディレクトリーをテストディレクトリーとして作成し、必要なファイルを配置します。
+
 <p><a name="Rename"></a>
 
 <h4 class="subsection">4.2.2 テスト名の変更</h4>

diff --git a/doc/autotest_mk.texi b/doc/autotest_mk.texi
index 095cc77..60d9005 100644 (file)
--- a/doc/autotest_mk.texi
+++ b/doc/autotest_mk.texi
@@ -155,12 +155,13 @@ Autotest.mkファイルの展開
 @node Download, Verify, Install, Install
 @section ダウンロード
 
-@uref{http://github.com/j8takagi/autotest_mk, GitHub/j8takagi/autotest_mk}の@uref{http://github.com/j8takagi/autotest_mk/downloads, ダウンロードページ}から最新版の@file{tar.gz}ファイルをダウンロードします。
+@uref{https://github.com/j8takagi/Autotest.mk/, GitHub/j8takagi/Autotest.mk}の@uref{https://github.com/j8takagi/Autotest.mk/downloads, ダウンロードページ}から最新版の@file{tar.gz}ファイルをダウンロードします。
 
 続けて、対応する@file{md5sum}ファイルをダウンロードします。
 
 @node Verify, Expand, Download, Install
 @section ファイルの検証
+(準備中)
 
 ダウンロードが完了したら、@kbd{md5sum}と@kbd{diff}で正しくファイルがダウンロードができているかを検証します。
 
@@ -306,6 +307,7 @@ Makefile  triangle.c  triangle_bug.c
 
 @example
 $ @kbd{make}
+rm -f triangle
 gcc -o triangle triangle.c
 @end example
 
@@ -326,6 +328,7 @@ isosceles triangle
 
 @example
 $ @kbd{make bug}
+rm -f triangle
 gcc -o triangle triangle.c
 @end example
 
@@ -340,7 +343,7 @@ $ @kbd{./triangle 2 4 4}
 isosceles triangle
 @end example
 
-@kbd{./triangle 3 4 5}で、仕様では`scalene triangle'という結果になるべきところが、`futohen sankakukei'となっています。
+@kbd{./triangle 3 4 5}で、仕様で`scalene triangle'となるべきところが、`futohen sankakukei'となっています。
 
 @node Create Group, Create Test, Prepare, Tutorial
 @section グループディレクトリーの作成
@@ -429,7 +432,12 @@ $ @kbd{make set}
 scalene triangle
 @end example
 
-この方法で@file{0.txt}を作成した場合は、作成された内容がテスト想定として本当に正しいかよく検討する必要があります。
+この方法で@file{0.txt}を作成する場合は、作成された内容がテスト想定として本当に正しいかよく検討する必要があります。例えば、バグを含む三角形判定プログラムを準備して@kbd{make set}を実行すると、仕様と異なるテスト想定ファイルが作成され、テストを正しく実行できません。
+
+@example
+$ @kbd{make set}
+futohen sankakukei
+@end example
 
 また、@file{0.txt}がすでに存在する場合は@kbd{make set}を実行するとエラーになり、@file{0.txt}は更新されません。
 
@@ -664,7 +672,7 @@ test: All tests are succeded.
 バグを含む三角形判定プログラムを準備してテストグループを実行した場合、次のように表示されます。
 
 @example
-test: 10 / 13 tests passed. Detail in /home/foo/triangle/test/TEST.log
+test: 11 / 13 tests passed. Detail in /home/foo/triangle/test/TEST.log
 @end example
 
 @node Check Group Log, , Group Execute, Tutorial
@@ -845,11 +853,32 @@ Detail in /home/foo/triangle/test/04_isosceles_c/detail.log
 @node make group, Template Files, Template Dir, Template Dir
 @subsection @kbd{make}または@kbd{make group} グループの作成
 
-変数@code{GROUPDIR}で指定されたディレクトリーをテストグループディレクトリーとして作成し、必要な次のファイルをコピーします。
+変数@code{GROUPDIR}で指定されたディレクトリーをテストグループディレクトリーとして作成し、必要なファイルを配置します。
 
 @node Template Files,  , make group, Template Dir
 @subsection テンプレートのファイル
 
+テンプレートディレクトリーには、次のファイルが含まれます。
+@table @file
+@item Makefile
+テンプレートディレクトリーのMakefile
+
+@item Group.mk
+グループディレクトリーのMakefile。@kbd{make}または@kbd{make group}で、グループディレクトリーに@file{Makefile}として配置されます。
+
+@item Test.mk
+テストディレクトリーから参照されるMakefile。@kbd{make}または@kbd{make group}で、グループディレクトリーに配置されます。
+
+@item Define.mk
+テストとテストグループに関する項目を定義したMakefile。@kbd{make}または@kbd{make group}で、グループディレクトリーに配置されます。
+
+@item Define_group.mk
+テストグループに関する項目を定義したMakefile。@kbd{make}または@kbd{make group}で、グループディレクトリーに配置されます。
+
+@item Define.mk
+テストに関する項目を定義したMakefile。@kbd{make}または@kbd{make group}で、グループディレクトリーに配置されます。
+@end table
+
 @node Group Dir, Test Dir, Template Dir, Manual
 @section グループディレクトリー
 
@@ -868,6 +897,8 @@ Detail in /home/foo/triangle/test/04_isosceles_c/detail.log
 @node make create, Rename, Group Dir, Group Dir
 @subsection @kbd{make create} テストの作成
 
+変数@code{TEST}で指定されたディレクトリーをテストディレクトリーとして作成し、必要なファイルを配置します。
+
 @node Rename, Delete, make create, Group Dir
 @subsection テスト名の変更