RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

Files changed (677) hide show

data/doc/rdoc/more/classes/BaseX.html DELETED

@@ -1,194 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: BaseX</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />BaseX</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/basex_rb.html">lib/more/facets/basex.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-Object
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000710">convert_base</a></span>
-  <span style="padding-right: 5px;"><a href="#M000709">decode</a></span>
-  <span style="padding-right: 5px;"><a href="#M000708">encode</a></span>
-  <span style="padding-right: 5px;"><a href="#M000707">new</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">BASE62</td>
-    <td>=</td>
-    <td class="attr-value">[&quot;0&quot;..&quot;9&quot;, &quot;a&quot;..&quot;z&quot;, &quot;A&quot;..&quot;Z&quot;].map { |r| r.to_a }.flatten</td>
-  </tr>
-  </table>
-  <div class="sectiontitle">Attributes</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class='attr-rw'>
-[RW]
-    </td>
-    <td class='attr-name'>chars</td>
-    <td class='attr-desc'></td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000707"></a><b>new</b>(chars=BASE62)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000707_source')" id="l_M000707_source">+</a> ]</p>
-  <div id="M000707_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 7</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">chars</span>=<span class="ruby-constant">BASE62</span>)
-    <span class="ruby-ivar">@chars</span>  = <span class="ruby-identifier">chars</span>
-    <span class="ruby-ivar">@base</span>   = <span class="ruby-ivar">@chars</span>.<span class="ruby-identifier">size</span>
-    <span class="ruby-ivar">@values</span> = <span class="ruby-constant">Hash</span>[<span class="ruby-operator">*</span>(<span class="ruby-value">0</span><span class="ruby-operator">...</span><span class="ruby-ivar">@base</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span> [ <span class="ruby-ivar">@chars</span>[<span class="ruby-identifier">i</span>], <span class="ruby-identifier">i</span> ] }.<span class="ruby-identifier">flatten</span>]
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000710"></a><b>convert_base</b>(digits, from_base, to_base)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000710_source')" id="l_M000710_source">+</a> ]</p>
-  <div id="M000710_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 25</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">digits</span>, <span class="ruby-identifier">from_base</span>, <span class="ruby-identifier">to_base</span>)
-    <span class="ruby-identifier">bignum</span> = <span class="ruby-value">0</span>
-    <span class="ruby-identifier">digits</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">digit</span><span class="ruby-operator">|</span> <span class="ruby-identifier">bignum</span> = <span class="ruby-identifier">bignum</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">from_base</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">digit</span> }
-    <span class="ruby-identifier">converted</span> = []
-    <span class="ruby-keyword kw">until</span> <span class="ruby-identifier">bignum</span>.<span class="ruby-identifier">zero?</span>
-      <span class="ruby-identifier">bignum</span>, <span class="ruby-identifier">digit</span> = <span class="ruby-identifier">bignum</span>.<span class="ruby-identifier">divmod</span> <span class="ruby-identifier">to_base</span>
-      <span class="ruby-identifier">converted</span>.<span class="ruby-identifier">push</span> <span class="ruby-identifier">digit</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">converted</span>.<span class="ruby-identifier">reverse</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000709"></a><b>decode</b>(encoded)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000709_source')" id="l_M000709_source">+</a> ]</p>
-  <div id="M000709_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 19</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decode</span>(<span class="ruby-identifier">encoded</span>)
-    <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">encoded</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
-      <span class="ruby-ivar">@values</span>[<span class="ruby-identifier">c</span>]
-    }, <span class="ruby-ivar">@base</span>, <span class="ruby-value">256</span>).<span class="ruby-identifier">pack</span>(<span class="ruby-value str">&quot;C*&quot;</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000708"></a><b>encode</b>(byte_string)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000708_source')" id="l_M000708_source">+</a> ]</p>
-  <div id="M000708_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/basex.rb, line 13</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encode</span>(<span class="ruby-identifier">byte_string</span>)
-    <span class="ruby-identifier">convert_base</span>(<span class="ruby-identifier">byte_string</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">&quot;C*&quot;</span>), <span class="ruby-value">256</span>, <span class="ruby-ivar">@base</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span>
-      <span class="ruby-ivar">@chars</span>[<span class="ruby-identifier">d</span>]
-    }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">''</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/more/classes/BiCrypt.html DELETED

@@ -1,541 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: BiCrypt</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />BiCrypt</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/bicrypt_rb.html">lib/more/facets/bicrypt.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-Object
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><h1><a href="BiCrypt.html">BiCrypt</a></h1>
-<p>
-A simple two-way encryption class.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000548">block_size</a></span>
-  <span style="padding-right: 5px;"><a href="#M000559">carefully_open_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000555">decrypt_block</a></span>
-  <span style="padding-right: 5px;"><a href="#M000561">decrypt_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000553">decrypt_pair</a></span>
-  <span style="padding-right: 5px;"><a href="#M000558">decrypt_stream</a></span>
-  <span style="padding-right: 5px;"><a href="#M000563">decrypt_string</a></span>
-  <span style="padding-right: 5px;"><a href="#M000554">encrypt_block</a></span>
-  <span style="padding-right: 5px;"><a href="#M000560">encrypt_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000552">encrypt_pair</a></span>
-  <span style="padding-right: 5px;"><a href="#M000557">encrypt_stream</a></span>
-  <span style="padding-right: 5px;"><a href="#M000562">encrypt_string</a></span>
-  <span style="padding-right: 5px;"><a href="#M000551">f</a></span>
-  <span style="padding-right: 5px;"><a href="#M000556">generate_initialization_vector</a></span>
-  <span style="padding-right: 5px;"><a href="#M000549">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000550">precalculate_S_table</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">ULONG</td>
-    <td>=</td>
-    <td class="attr-value">0x100000000</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000549"></a><b>new</b>(userKey)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000549_source')" id="l_M000549_source">+</a> ]</p>
-  <div id="M000549_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 37</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">userKey</span>)
-    <span class="ruby-comment cmt"># These are the S-boxes given in Applied Cryptography 2nd Ed., p. 333</span>
-    <span class="ruby-ivar">@sBox</span> = [
-      [<span class="ruby-value">4</span>, <span class="ruby-value">10</span>, <span class="ruby-value">9</span>, <span class="ruby-value">2</span>, <span class="ruby-value">13</span>, <span class="ruby-value">8</span>, <span class="ruby-value">0</span>, <span class="ruby-value">14</span>, <span class="ruby-value">6</span>, <span class="ruby-value">11</span>, <span class="ruby-value">1</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">15</span>, <span class="ruby-value">5</span>, <span class="ruby-value">3</span>],
-      [<span class="ruby-value">14</span>, <span class="ruby-value">11</span>, <span class="ruby-value">4</span>, <span class="ruby-value">12</span>, <span class="ruby-value">6</span>, <span class="ruby-value">13</span>, <span class="ruby-value">15</span>, <span class="ruby-value">10</span>, <span class="ruby-value">2</span>, <span class="ruby-value">3</span>, <span class="ruby-value">8</span>, <span class="ruby-value">1</span>, <span class="ruby-value">0</span>, <span class="ruby-value">7</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>],
-      [<span class="ruby-value">5</span>, <span class="ruby-value">8</span>, <span class="ruby-value">1</span>, <span class="ruby-value">13</span>, <span class="ruby-value">10</span>, <span class="ruby-value">3</span>, <span class="ruby-value">4</span>, <span class="ruby-value">2</span>, <span class="ruby-value">14</span>, <span class="ruby-value">15</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">6</span>, <span class="ruby-value">0</span>, <span class="ruby-value">9</span>, <span class="ruby-value">11</span>],
-      [<span class="ruby-value">7</span>, <span class="ruby-value">13</span>, <span class="ruby-value">10</span>, <span class="ruby-value">1</span>, <span class="ruby-value">0</span>, <span class="ruby-value">8</span>, <span class="ruby-value">9</span>, <span class="ruby-value">15</span>, <span class="ruby-value">14</span>, <span class="ruby-value">4</span>, <span class="ruby-value">6</span>, <span class="ruby-value">12</span>, <span class="ruby-value">11</span>, <span class="ruby-value">2</span>, <span class="ruby-value">5</span>, <span class="ruby-value">3</span>],
-      [<span class="ruby-value">6</span>, <span class="ruby-value">12</span>, <span class="ruby-value">7</span>, <span class="ruby-value">1</span>, <span class="ruby-value">5</span>, <span class="ruby-value">15</span>, <span class="ruby-value">13</span>, <span class="ruby-value">8</span>, <span class="ruby-value">4</span>, <span class="ruby-value">10</span>, <span class="ruby-value">9</span>, <span class="ruby-value">14</span>, <span class="ruby-value">0</span>, <span class="ruby-value">3</span>, <span class="ruby-value">11</span>, <span class="ruby-value">2</span>],
-      [<span class="ruby-value">4</span>, <span class="ruby-value">11</span>, <span class="ruby-value">10</span>, <span class="ruby-value">0</span>, <span class="ruby-value">7</span>, <span class="ruby-value">2</span>, <span class="ruby-value">1</span>, <span class="ruby-value">13</span>, <span class="ruby-value">3</span>, <span class="ruby-value">6</span>, <span class="ruby-value">8</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>, <span class="ruby-value">12</span>, <span class="ruby-value">15</span>, <span class="ruby-value">14</span>],
-      [<span class="ruby-value">13</span>, <span class="ruby-value">11</span>, <span class="ruby-value">4</span>, <span class="ruby-value">1</span>, <span class="ruby-value">3</span>, <span class="ruby-value">15</span>, <span class="ruby-value">5</span>, <span class="ruby-value">9</span>, <span class="ruby-value">0</span>, <span class="ruby-value">10</span>, <span class="ruby-value">14</span>, <span class="ruby-value">7</span>, <span class="ruby-value">6</span>, <span class="ruby-value">8</span>, <span class="ruby-value">2</span>, <span class="ruby-value">12</span>],
-      [<span class="ruby-value">1</span>, <span class="ruby-value">15</span>, <span class="ruby-value">13</span>, <span class="ruby-value">0</span>, <span class="ruby-value">5</span>, <span class="ruby-value">7</span>, <span class="ruby-value">10</span>, <span class="ruby-value">4</span>, <span class="ruby-value">9</span>, <span class="ruby-value">2</span>, <span class="ruby-value">3</span>, <span class="ruby-value">14</span>, <span class="ruby-value">6</span>, <span class="ruby-value">11</span>, <span class="ruby-value">8</span>, <span class="ruby-value">12</span>]
-    ]
-    <span class="ruby-comment cmt"># These are the S-boxes given in the GOST source code listing in Applied</span>
-    <span class="ruby-comment cmt"># Cryptography 2nd Ed., p. 644.  They appear to be from the DES S-boxes</span>
-    <span class="ruby-comment cmt"># [13,  2,  8,  4,  6, 15, 11,  1, 10,  9,  3, 14,  5,  0, 12,  7 ],</span>
-    <span class="ruby-comment cmt"># [ 4, 11,  2, 14, 15,  0,  8, 13,  3, 12,  9,  7,  5, 10,  6,  1 ],</span>
-    <span class="ruby-comment cmt"># [12,  1, 10, 15,  9,  2,  6,  8,  0, 13,  3,  4, 14,  7,  5, 11 ],</span>
-    <span class="ruby-comment cmt"># [ 2, 12,  4,  1,  7, 10, 11,  6,  8,  5,  3, 15, 13,  0, 14,  9 ],</span>
-    <span class="ruby-comment cmt"># [ 7, 13, 14,  3,  0,  6,  9, 10,  1,  2,  8,  5, 11, 12,  4, 15 ],</span>
-    <span class="ruby-comment cmt"># [10,  0,  9, 14,  6,  3, 15,  5,  1, 13, 12,  7, 11,  4,  2,  8 ],</span>
-    <span class="ruby-comment cmt"># [15,  1,  8, 14,  6, 11,  3,  4,  9,  7,  2, 13, 12,  0,  5, 10 ],</span>
-    <span class="ruby-comment cmt"># [14,  4, 13,  1,  2, 15, 11,  8,  3, 10,  6, 12,  5,  9,  0,  7 ]</span>
-    <span class="ruby-comment cmt"># precalculate the S table</span>
-    <span class="ruby-ivar">@sTable</span> = <span class="ruby-identifier">precalculate_S_table</span>()
-    <span class="ruby-comment cmt"># derive the 32-byte key from the user-supplied key</span>
-    <span class="ruby-identifier">userKeyLength</span> = <span class="ruby-identifier">userKey</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-ivar">@key</span> = <span class="ruby-identifier">userKey</span>[<span class="ruby-value">0</span><span class="ruby-operator">..</span><span class="ruby-value">31</span>].<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span><span class="ruby-operator">*</span><span class="ruby-value">32</span>)
-    <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">userKeyLength</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">32</span>)
-      <span class="ruby-identifier">userKeyLength</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">31</span>) { <span class="ruby-ivar">@key</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">0</span> }
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000548"></a><b>block_size</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000548_source')" id="l_M000548_source">+</a> ]</p>
-  <div id="M000548_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 33</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">block_size</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-value">8</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000559"></a><b>carefully_open_file</b>(filename, mode)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000559_source')" id="l_M000559_source">+</a> ]</p>
-  <div id="M000559_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 217</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mode</span>)
-    <span class="ruby-keyword kw">begin</span>
-      <span class="ruby-identifier">aFile</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">filename</span>, <span class="ruby-identifier">mode</span>)
-    <span class="ruby-keyword kw">rescue</span>
-      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Sorry. There was a problem opening the file &lt;#{filename}&gt;.&quot;</span>
-      <span class="ruby-identifier">aFile</span>.<span class="ruby-identifier">close</span>() <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">aFile</span>.<span class="ruby-identifier">nil?</span>
-      <span class="ruby-identifier">raise</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">aFile</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000555"></a><b>decrypt_block</b>(block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000555_source')" id="l_M000555_source">+</a> ]</p>
-  <div id="M000555_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 147</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">decrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">decrypted</span> = [<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">decrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000561"></a><b>decrypt_file</b>(cryptFilename, plainFilename)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000561_source')" id="l_M000561_source">+</a> ]</p>
-  <div id="M000561_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 238</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-identifier">plainFilename</span>)
-    <span class="ruby-identifier">cryptFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-value str">'rb'</span>)
-    <span class="ruby-identifier">plainFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-value str">'wb+'</span>)
-    <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptFile</span>, <span class="ruby-identifier">plainFile</span>)
-    <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">closed?</span>
-    <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">closed?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000553"></a><b>decrypt_pair</b>(xl, xr)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000553_source')" id="l_M000553_source">+</a> ]</p>
-  <div id="M000553_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 117</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    <span class="ruby-value">3</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    }
-    <span class="ruby-keyword kw">return</span>([<span class="ruby-identifier">xr</span>, <span class="ruby-identifier">xl</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000558"></a><b>decrypt_stream</b>(cryptStream, plainStream)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000558_source')" id="l_M000558_source">+</a> ]</p>
-  <div id="M000558_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 199</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptStream</span>, <span class="ruby-identifier">plainStream</span>)
-    <span class="ruby-comment cmt"># Cypher-block-chain mode</span>
-    <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>())
-    <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">block</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>()))
-      <span class="ruby-identifier">decrypted</span> = <span class="ruby-identifier">decrypt_block</span>(<span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">plainText</span> = <span class="ruby-identifier">decrypted</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-      <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">plainText</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">eof?</span>
-      <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">block</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># write the final block, omitting the padding</span>
-    <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">plainText</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">remainingMessageBytes</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'C'</span>).<span class="ruby-identifier">first</span>
-    <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">times</span> { <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">shift</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000563"></a><b>decrypt_string</b>(cryptText)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000563_source')" id="l_M000563_source">+</a> ]</p>
-  <div id="M000563_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 256</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">decrypt_string</span>(<span class="ruby-identifier">cryptText</span>)
-    <span class="ruby-identifier">cryptStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">cryptText</span>)
-    <span class="ruby-identifier">plainStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">decrypt_stream</span>(<span class="ruby-identifier">cryptStream</span>, <span class="ruby-identifier">plainStream</span>)
-    <span class="ruby-identifier">plainText</span> = <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">string</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">plainText</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000554"></a><b>encrypt_block</b>(block)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000554_source')" id="l_M000554_source">+</a> ]</p>
-  <div id="M000554_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 139</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span> = <span class="ruby-identifier">encrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-identifier">encrypted</span> = [<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'NN'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">encrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000560"></a><b>encrypt_file</b>(plainFilename, cryptFilename)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000560_source')" id="l_M000560_source">+</a> ]</p>
-  <div id="M000560_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 229</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-identifier">cryptFilename</span>)
-    <span class="ruby-identifier">plainFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">plainFilename</span>, <span class="ruby-value str">'rb'</span>)
-    <span class="ruby-identifier">cryptFile</span> = <span class="ruby-identifier">carefully_open_file</span>(<span class="ruby-identifier">cryptFilename</span>, <span class="ruby-value str">'wb+'</span>)
-    <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainFile</span>, <span class="ruby-identifier">cryptFile</span>)
-    <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">plainFile</span>.<span class="ruby-identifier">closed?</span>
-    <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">close</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">cryptFile</span>.<span class="ruby-identifier">closed?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000552"></a><b>encrypt_pair</b>(xl, xr)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000552_source')" id="l_M000552_source">+</a> ]</p>
-  <div id="M000552_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 94</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_pair</span>(<span class="ruby-identifier">xl</span>, <span class="ruby-identifier">xr</span>)
-    <span class="ruby-value">3</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-      <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-      <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    }
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">7</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">6</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">5</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">4</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">3</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">2</span>])
-    <span class="ruby-identifier">xr</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xl</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">1</span>])
-    <span class="ruby-identifier">xl</span> <span class="ruby-operator">^=</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">xr</span><span class="ruby-operator">+</span><span class="ruby-ivar">@key</span>[<span class="ruby-value">0</span>])
-    <span class="ruby-keyword kw">return</span>([<span class="ruby-identifier">xr</span>, <span class="ruby-identifier">xl</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000557"></a><b>encrypt_stream</b>(plainStream, cryptStream)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000557_source')" id="l_M000557_source">+</a> ]</p>
-  <div id="M000557_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 168</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainStream</span>, <span class="ruby-identifier">cryptStream</span>)
-    <span class="ruby-comment cmt"># Cypher-block-chain mode</span>
-    <span class="ruby-identifier">initVector</span> = <span class="ruby-identifier">generate_initialization_vector</span>(<span class="ruby-identifier">block_size</span>() <span class="ruby-operator">/</span> <span class="ruby-value">4</span>)
-    <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">initVector</span>)
-    <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">chain</span>)
-    <span class="ruby-keyword kw">while</span> ((<span class="ruby-identifier">block</span> = <span class="ruby-identifier">plainStream</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">block_size</span>())) <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">block</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">block_size</span>()))
-      <span class="ruby-identifier">block</span> = <span class="ruby-identifier">block</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-      <span class="ruby-identifier">encrypted</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">encrypted</span>)
-      <span class="ruby-identifier">chain</span> = <span class="ruby-identifier">encrypted</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-comment cmt"># write the final block</span>
-    <span class="ruby-comment cmt"># At most block_size()-1 bytes can be part of the message.</span>
-    <span class="ruby-comment cmt"># That means the final byte can be used to store the number of meaningful</span>
-    <span class="ruby-comment cmt"># bytes in the final block</span>
-    <span class="ruby-identifier">block</span> = <span class="ruby-value str">''</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block</span>.<span class="ruby-identifier">nil?</span>
-    <span class="ruby-identifier">buffer</span> = <span class="ruby-identifier">block</span>.<span class="ruby-identifier">split</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">remainingMessageBytes</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">length</span>
-    <span class="ruby-comment cmt"># we use 7-bit characters to avoid possible strange behavior on the Mac</span>
-    <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-identifier">block_size</span>()<span class="ruby-operator">-</span><span class="ruby-value">2</span>) { <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">rand</span>(<span class="ruby-value">128</span>).<span class="ruby-identifier">chr</span> }
-    <span class="ruby-identifier">buffer</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">remainingMessageBytes</span>.<span class="ruby-identifier">chr</span>
-    <span class="ruby-identifier">block</span> = <span class="ruby-identifier">buffer</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">block</span> = <span class="ruby-identifier">block</span> <span class="ruby-operator">^</span> <span class="ruby-identifier">chain</span>
-    <span class="ruby-identifier">encrypted</span> = <span class="ruby-identifier">encrypt_block</span>(<span class="ruby-identifier">block</span>)
-    <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">encrypted</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000562"></a><b>encrypt_string</b>(plainText)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000562_source')" id="l_M000562_source">+</a> ]</p>
-  <div id="M000562_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 247</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">encrypt_string</span>(<span class="ruby-identifier">plainText</span>)
-    <span class="ruby-identifier">plainStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">plainText</span>)
-    <span class="ruby-identifier">cryptStream</span> = <span class="ruby-constant">StringIO</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">encrypt_stream</span>(<span class="ruby-identifier">plainStream</span>, <span class="ruby-identifier">cryptStream</span>)
-    <span class="ruby-identifier">cryptText</span> = <span class="ruby-identifier">cryptStream</span>.<span class="ruby-identifier">string</span>
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">cryptText</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000551"></a><b>f</b>(longWord)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000551_source')" id="l_M000551_source">+</a> ]</p>
-  <div id="M000551_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 88</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">f</span>(<span class="ruby-identifier">longWord</span>)
-    <span class="ruby-identifier">longWord</span> = <span class="ruby-identifier">longWord</span> <span class="ruby-operator">%</span> <span class="ruby-constant">ULONG</span>
-    <span class="ruby-identifier">a</span>, <span class="ruby-identifier">b</span>, <span class="ruby-identifier">c</span>, <span class="ruby-identifier">d</span> = [<span class="ruby-identifier">longWord</span>].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'L'</span>).<span class="ruby-identifier">unpack</span>(<span class="ruby-value str">'CCCC'</span>)
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-ivar">@sTable</span>[<span class="ruby-value">3</span>][<span class="ruby-identifier">d</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">2</span>][<span class="ruby-identifier">c</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">1</span>][<span class="ruby-identifier">b</span>] <span class="ruby-operator">^</span> <span class="ruby-ivar">@sTable</span>[<span class="ruby-value">0</span>][<span class="ruby-identifier">a</span>])
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000556"></a><b>generate_initialization_vector</b>(words)
-  </div>
-  <div class="description">
-  <p>
-When this module is mixed in with an encryption class, the class must
-provide three methods: <a
-href="BiCrypt.html#M000554">encrypt_block</a>(block) and <a
-href="BiCrypt.html#M000555">decrypt_block</a>(block) and <a
-href="BiCrypt.html#M000548">block_size</a>()
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000556_source')" id="l_M000556_source">+</a> ]</p>
-  <div id="M000556_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 158</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">generate_initialization_vector</span>(<span class="ruby-identifier">words</span>)
-    <span class="ruby-identifier">srand</span>(<span class="ruby-constant">Time</span>.<span class="ruby-identifier">now</span>.<span class="ruby-identifier">to_i</span>)
-    <span class="ruby-identifier">vector</span> = <span class="ruby-value str">&quot;&quot;</span>
-    <span class="ruby-identifier">words</span>.<span class="ruby-identifier">times</span> {
-      <span class="ruby-identifier">vector</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">rand</span>(<span class="ruby-constant">ULONG</span>)].<span class="ruby-identifier">pack</span>(<span class="ruby-value str">'N'</span>)
-    }
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">vector</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000550"></a><b>precalculate_S_table</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000550_source')" id="l_M000550_source">+</a> ]</p>
-  <div id="M000550_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/bicrypt.rb, line 74</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">precalculate_S_table</span>()
-    <span class="ruby-identifier">sTable</span> = [[], [], [], []]
-    <span class="ruby-value">0</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">3</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
-      <span class="ruby-value">0</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-value">255</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">j</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">t</span> = <span class="ruby-ivar">@sBox</span>[<span class="ruby-value">2</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span>][<span class="ruby-identifier">j</span> <span class="ruby-operator">%</span> <span class="ruby-value">16</span>] <span class="ruby-operator">|</span> (<span class="ruby-ivar">@sBox</span>[<span class="ruby-value">2</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span><span class="ruby-operator">+</span><span class="ruby-value">1</span>][<span class="ruby-identifier">j</span><span class="ruby-operator">/</span><span class="ruby-value">16</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">4</span>)
-        <span class="ruby-identifier">u</span> = (<span class="ruby-value">8</span><span class="ruby-operator">*</span><span class="ruby-identifier">i</span> <span class="ruby-operator">+</span> <span class="ruby-value">11</span>) <span class="ruby-operator">%</span> <span class="ruby-value">32</span>
-        <span class="ruby-identifier">v</span> = (<span class="ruby-identifier">t</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">u</span>) <span class="ruby-operator">|</span> (<span class="ruby-identifier">t</span> <span class="ruby-operator">&gt;&gt;</span> (<span class="ruby-value">32</span><span class="ruby-operator">-</span><span class="ruby-identifier">u</span>))
-        <span class="ruby-identifier">sTable</span>[<span class="ruby-identifier">i</span>][<span class="ruby-identifier">j</span>] = (<span class="ruby-identifier">v</span> <span class="ruby-operator">%</span> <span class="ruby-constant">ULONG</span>)
-      }
-    }
-    <span class="ruby-keyword kw">return</span>(<span class="ruby-identifier">sTable</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>