Update: The utf8 documentation to reflect recent changes in the program arguments.

diff --git a/documentation/utf8.html b/documentation/utf8.html
index 8e8cab33d8b64e5f0e4c9d0ed8732f586748ba45..27db54553a3139ec060776b289ca33b4d92ddc60 100644 (file)
--- a/documentation/utf8.html
+++ b/documentation/utf8.html
@@ -91,7 +91,7 @@
 
             <div class="section-content">
               <p>
-                The <strong>UTF8</strong> program is a tool for converting from a <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> byte code sequence to the Unicode code point. The byte code can also be referred to as the binary representation of the code even though the byte code is considered text. The term <em>"byte code"</em> here is used to refer to a sequence of bytes intended to represent something, which in this case is a Unicode character. The Unicode code point is the Unicode designation uniquely identifying that particular sequence. The Unicode code point persists across different Unicode encoding beyond <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr>, such as <abbr title="Unicode Transformation Format 16-bit">UTF-16</abbr>.
+                The <strong>UTF8</strong> program is a tool for converting from a <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> byte sequence to the Unicode code point. The byte sequence can also be referred to as the binary representation of the code even though the byte sequence is considered text. The term <em>"byte sequence"</em> here is used to refer to a sequence of bytes intended to represent something, which in this case is a Unicode character. The Unicode code point is the Unicode designation uniquely identifying that particular sequence. The Unicode code point is not specific to <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> and persists across different encodings, such as <abbr title="Unicode Transformation Format 16-bit">UTF-16</abbr>.
               </p>
               <p>
                 The idea behind the <strong>UTF8</strong> program is to provide the answer to the question of what some special <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> character is or to provide a way to create the <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> character given the Unicode code point.
@@ -100,7 +100,10 @@
                 This tool is intended to be scriptable, should handle both piped data and files, and can convert entire files.
               </p>
               <p>
-                In addition, this tool can be used to validate a given byte code or can be used to get the character width of some byte code or code point.
+                This tool can be used to validate a given byte sequence or can be used to get the character width of some byte sequence or code point.
+              </p>
+              <p>
+                This tool can be used to store binary data in a text-friendly format and then restore the binary data.
               </p>
             </div>
           </section>
@@ -171,7 +174,7 @@
                 </table>
               </div>
               <p>
-                The <code class="code">+q/++quiet</code> parameter silences all output that is not the intent and purpose of the program. For example, the purpose of the <strong>utf8</strong> program is to print the Unicode code point or the <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> byte code. The <code class="code">+q/++quiet</code> will not suppress this output. The new line printed at the end of the program, is however, not printed. The <code class="code">+q/++quiet</code> is ideal for using in scripting to help guarantee more consistent and controlled output.
+                The <code class="code">+q/++quiet</code> parameter silences all output that is not the intent and purpose of the program. For example, the purpose of the <strong>utf8</strong> program is to print the Unicode code point or the <abbr title="Unicode Transformation Format 8-bit">UTF-8</abbr> byte sequence. The <code class="code">+q/++quiet</code> will not suppress this output. The new line printed at the end of the program, is however, not printed. The <code class="code">+q/++quiet</code> is ideal for using in scripting to help guarantee more consistent and controlled output.
               </p>
               <p>
                 The <code class="code">+n/++no_color</code> simplifies the output to avoid the special color character codes. The special color character codes tend to take up a lot of extra space and may slow down printing performance.
@@ -198,8 +201,8 @@
                   <tbody class="body set">
                     <tr class="row">
                       <td class="column"><code class="code">-b</code></td>
-                      <td class="column"><code class="code">--from_bytecode</code></td>
-                      <td class="column">The expected input format is byte code (character data).</td>
+                      <td class="column"><code class="code">--from_bytesequence</code></td>
+                      <td class="column">The expected input format is byte sequence (character data).</td>
                     </tr>
                     <tr class="row">
                       <td class="column"><code class="code">-c</code></td>
@@ -213,8 +216,8 @@
                     </tr>
                     <tr class="row">
                       <td class="column"><code class="code">-B</code></td>
-                      <td class="column"><code class="code">--to_bytecode</code></td>
-                      <td class="column">The output format is bytecode (character data).</td>
+                      <td class="column"><code class="code">--to_bytesequence</code></td>
+                      <td class="column">The output format is bytesequence (character data).</td>
                     </tr>
                     <tr class="row">
                       <td class="column"><code class="code">-C</code></td>
@@ -263,7 +266,7 @@
                 This program establishes a pattern for some of the parameters. The parameters that represent a <em>"from"</em> use lower case short characters and the parameters that represent a <em>"to"</em> use upper case short characters. For short parameters that have both a <em>"from"</em> and a <em>"to"</em>, they use the same character with their case being different.
               </p>
               <p>
-                The default behavior is to assume the expected input is byte code from the command line to be output to the screen as codepoints.
+                The default behavior is to assume the expected input is byte sequence from the command line to be output to the screen as codepoints.
               </p>
               <p>
                 Multiple input sources are allowed but only a single output destination is allowed.