Updated.

Author: sideshowbarker

README.md

@@ -19,7 +19,7 @@ of HTML documents by invoking it like this:
       java -jar ~/vnu.jar [--help] [--html] [--entities] [--schema URL]
         [--format gnu|xml|json|text] [--no-stream] [--verbose] [--version] FILES
 
-To validate one or more documents from the command line:
+To validate one or more HTML documents from the command line:
 
       java -jar ~/vnu.jar FILE.html FILE2.html FILE3.HTML FILE4.html...
 
@@ -46,7 +46,7 @@ executable provides the following options:
 
 #### --entities
 
-    Specifies that the XML parser must not load remote/external entities (such
+    Specifies that the XML parser should not load remote/external entities (such
     as DTDs) from the Internet.
 
     default: [unset; the XML parser will attempt to load external entities]
@@ -64,13 +64,25 @@ executable provides the following options:
 
    [2]: http://wiki.whatwg.org/wiki/Validator.nu_Common_Input_Parameters#out
 
+#### --help
+
+    Shows detailed usage information.
+
 #### --html
 
-    Specifies that all documents must be parsed by the HTML parser as text/html
-    (otherwise, *.xhtml documents are parsed by the XML parser).
+    Specifies that all documents should be parsed by the HTML parser as
+    text/html (otherwise, *.xhtml documents are parsed by the XML parser).
 
     default: [unset; *.xhtml documents are parsed by the XML parser]
 
+#### --no-stream
+
+    Specifies that all documents parsed by the HTML parser will be parsed in
+    buffered mode instead of streaming mode (causes some parse errors to be
+    treated as non-fatal document errors instead of as fatal document errors).
+
+    default: [unset; non-streamable parse errors cause fatal document errors]
+
 #### --schema _URL_
 
     Specifies a URL for a known http://s.validator.nu/* schema to use for
@@ -80,14 +92,14 @@ executable provides the following options:
 
 #### --verbose
 
-    Specifies that the validator output should be "verbose". Currently this just
-    means that the names of files being validated are written to stdout.
+    Specifies that the validator output should be "verbose". (Currently this
+    just means that the names of files being validated are written to stdout.)
 
     default: [unset; output is not verbose]
 
 #### --version
 
-    Shows validator version number.
+    Shows the vnu.jar version number.
 
 For details on using the `vnu.jar` validator to provide validation of HTML
 documents over the Web (in a Web browser, as an HTTP service), see [Using

index.html

@@ -29,7 +29,7 @@ <h2>Usage</h2>
     [--format gnu|xml|json|text] [--no-stream] [--verbose] [--version] FILES
 </pre>
 
-<p>To validate one or more documents from the command line:
+<p>To validate one or more HTML documents from the command line:
 <pre>
   java -jar ~/vnu.jar FILE.html FILE2.html FILE3.HTML FILE4.html...
 </pre>
@@ -59,7 +59,7 @@ <h3 id="options">Options</h3>
 
 <h4 id="entities">--entities</h4>
 <pre>
-Specifies that the XML parser must not load remote/external entities (such
+Specifies that the XML parser should not load remote/external entities (such
 as DTDs) from the Internet.
 
 default: [unset; the XML parser will attempt to load external entities]
@@ -76,14 +76,28 @@ <h4 id="format">--format <var>format</var></h4>
 see also: <a href="http://wiki.whatwg.org/wiki/Validator.nu_Common_Input_Parameters#out">http://wiki.whatwg.org/wiki/Validator.nu_Common_Input_Parameters#out</a>
 </pre>
 
+<h4 id="help">--help</h4>
+<pre>
+Shows detailed usage information.
+</pre>
+
 <h4 id="html">--html</h4>
 <pre>
-Specifies that all documents must be parsed by the HTML parser as text/html
+Specifies that all documents should be parsed by the HTML parser as text/html
 (otherwise, *.xhtml documents are parsed by the XML parser).
 
 default: [unset; *.xhtml documents are parsed by the XML parser]
 </pre>
 
+<h4 id="no-stream">--no-stream</h4>
+<pre>
+Specifies that all documents parsed by the HTML parser will be parsed in
+buffered mode instead of streaming mode (causes some parse errors to be
+treated as non-fatal document errors instead of as fatal document errors).
+
+default: [unset; non-streamable parse errors cause fatal document errors]
+</pre>
+
 <h4 id="schema-url">--schema <var>URL</var></h4>
 <pre>
 Specifies a URL for a known http://s.validator.nu/* schema to use for
@@ -94,15 +108,15 @@ <h4 id="schema-url">--schema <var>URL</var></h4>
 
 <h4 id="verbose">--verbose</h4>
 <pre>
-Specifies that the validator output should be "verbose". Currently this
-just means that the names of files being validated are written to stdout.
+Specifies that the validator output should be "verbose". (Currently this
+just means that the names of files being validated are written to stdout.)
 
 default: [unset; output is not verbose]
 </pre>
 
 <h4 id="version">--version</h4>
 <pre>
-Shows validator version number.
+Shows the <code>vnu.jar</code> version number.
 </pre>
 </section>
 </div>