add doc for test.html

Author: gfx

doc/test.html

@@ -70,10 +70,10 @@ <h1>Unit Test</h1>
 <h2>Introduction</h2>
 
 <p>
-JSX has a built-in test runner invoked by <code>--test</code> option and has a unit test framework <code>test-case.jsx</code>. The unit test framework is an xUnit style, running <code>_Test#test*():void</code> of the main file.
+JSX has a built-in test runner invoked by <code>--test</code> option and has an unit test framework <code>test-case.jsx</code>. The unit test framework is an xUnit style, running <code>_Test#test*():void</code> of the given file.
 </p>
 <p>
-Here is a basic test file, which is typically placed in <code>t/</code> of a project.
+Here is a simple test file, which is typically placed in <code>t/</code> of a project.
 </p>
 
 <pre class="prettyprint"><code class="language-jsx">import &quot;test-case.jsx&quot;;
@@ -98,7 +98,6 @@ <h2>Introduction</h2>
 
 <p>NOTE: it is recommended to use prove(1) to run tests and parse TAP, which can run test files in parallel. See .proverc and and Makefile in the <a href="https://github.com/jsx/mizuki">mizuki</a> project.</p>
 
-
 <h2>Synchronous Test</h2>
 
 <p>Synchronous testing is really simple, where you just define test methods, which are invoked in serial.</p>
@@ -142,11 +141,15 @@ <h2>Asynchronous Test</h2>
 
         async.done(); // to tell this test is finished
       }, to);
-    }, 1000);
+    }, 1000 /* timeout in milliseconds */);
   }
 }
 </code></pre>
 
+<h2>Misc.</h2>
+
+<p>jsx --test can takes test method names to run specific tests in a file. When you use <a href="https://github.com/jsx/jsx.vim">jsx.vim</a> you can run the currently editing test method by <code>\t</code>.</p>
+
 <h2>See Also</h2>
 
 <ul>

gen/src/doc/test.mt

@@ -8,18 +8,18 @@
 <title>Unit Test - JSX</title>
 
 ?= $_mt->render_file("header.mt")
-?= $_mt->render_file("breadcrumb.mt", [ qw(Documents doc.html) ], [ 'Unit Test' ])
+?= $_mt->render_file("breadcrumb.mt", [ qw(Documents doc.html compilerref.html) ], [ 'Unit Test' ])
 <div id="main">
 
 <h1>Unit Test</h1>
 
 <h2>Introduction</h2>
 
 <p>
-JSX has a built-in test runner invoked by <code>--test</code> option and has a unit test framework <code>test-case.jsx</code>. The unit test framework is an xUnit style, running <code>_Test#test*():void</code> of the main file.
+JSX has a built-in test runner invoked by <code>--test</code> option and has an unit test framework <code>test-case.jsx</code>. The unit test framework is an xUnit style, running <code>_Test#test*():void</code> of the given file.
 </p>
 <p>
-Here is a basic test file, which is typically placed in <code>t/</code> of a project.
+Here is a simple test file, which is typically placed in <code>t/</code> of a project.
 </p>
 
 <?= $context->{prettify}->('jsx', <<'EOT')
@@ -46,7 +46,6 @@ ok 1 - testAdd
 
 <p>NOTE: it is recommended to use prove(1) to run tests and parse TAP, which can run test files in parallel. See .proverc and and Makefile in the <a href="https://github.com/jsx/mizuki">mizuki</a> project.</p>
 
-
 <h2>Synchronous Test</h2>
 
 <p>Synchronous testing is really simple, where you just define test methods, which are invoked in serial.</p>
@@ -99,6 +98,10 @@ class _Test extends TestCase {
 EOT
 ?>
 
+<h2>Misc.</h2>
+
+<p>jsx --test can takes test method names to run specific tests in a file. When you use <a href="https://github.com/jsx/jsx.vim">jsx.vim</a> you can run the currently editing test method by <code>\t</code>.</p>
+
 <h2>See Also</h2>
 
 <ul>

jsxdoc/lib/built-in.jsx.html

@@ -3562,7 +3562,7 @@ <h3>
 <div id="footer">
 <p>Copyright &copy; DeNA., Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:52.840Z.</p>
+at 2013-12-15T08:23:30.184Z.</p>
 
 </div>
 </div>

jsxdoc/lib/common/test-case.jsx.html

@@ -368,7 +368,7 @@ <h3>
 <p>This is <strong>lib/common/test-case.jsx version 1.0.0</strong>.</p>
 <p>Copyright &copy; DeNA., Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:53.213Z.</p>
+at 2013-12-15T08:23:30.553Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/console.jsx.html

@@ -111,7 +111,7 @@ <h3>
 <div id="footer">
 <p>Copyright &copy; DeNA, Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:53.494Z.</p>
+at 2013-12-15T08:23:30.832Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/js.jsx.html

@@ -84,7 +84,7 @@ <h3>
 <div id="footer">
 <p>Copyright &copy; DeNA., Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:55.588Z.</p>
+at 2013-12-15T08:23:32.861Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/js/nodejs.jsx.html

@@ -1319,7 +1319,7 @@ <h3>
 
 <div id="footer">
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:53.849Z.</p>
+at 2013-12-15T08:23:31.158Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/js/phantomjs.jsx.html

@@ -779,7 +779,7 @@ <h3>
 
 <div id="footer">
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:54.553Z.</p>
+at 2013-12-15T08:23:31.844Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/js/phantomjs/test-case.jsx.html

@@ -53,7 +53,7 @@ <h3>
 
 <div id="footer">
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:54.239Z.</p>
+at 2013-12-15T08:23:31.531Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/js/web.jsx.html

@@ -31642,7 +31642,7 @@ <h3>
 <div id="footer">
 <p>Copyright &copy; DeNA, Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:55.300Z.</p>
+at 2013-12-15T08:23:32.569Z.</p>
 
 </div>
 </div>

jsxdoc/lib/js/timer.jsx.html

@@ -104,7 +104,7 @@ <h2>final class <strong>TimerHandle</strong></h2>
 <div id="footer">
 <p>Copyright &copy; DeNA, Co., Ltd.</p>
 <p class="jsxdoc-notice">This document was automatically generated by <a href="http://jsx.github.io/">JSX</a> 0.9.71<br />
-at 2013-12-15T08:10:55.901Z.</p>
+at 2013-12-15T08:23:33.237Z.</p>
 
 </div>
 </div>