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

facets 2.5.2 → 2.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (677) hide show

data/doc/rdoc/more/classes/Archive/Tar/Minitar/Reader.html DELETED

@@ -1,283 +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: Archive::Tar::Minitar::Reader</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 />Archive::Tar::Minitar::Reader</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../../files/lib/more/facets/minitar_rb.html">lib/more/facets/minitar.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"><p>
-The class that reads a tar format archive from a data stream. The data
-stream may be sequential or random access, but certain features only work
-with random access data streams.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000937">close</a></span>
-  <span style="padding-right: 5px;"><a href="#M000934">each</a></span>
-  <span style="padding-right: 5px;"><a href="#M000936">each_entry</a></span>
-  <span style="padding-right: 5px;"><a href="#M000933">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000932">open</a></span>
-  <span style="padding-right: 5px;"><a href="#M000935">rewind</a></span>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000933"></a><b>new</b>(anIO)
-  </div>
-  <div class="description">
-  <p>
-Creates and returns a <a href="Reader.html#M000933">new</a> <a
-href="Reader.html">Reader</a> object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000933_source')" id="l_M000933_source">+</a> ]</p>
-  <div id="M000933_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 662</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-ivar">@io</span>     = <span class="ruby-identifier">anIO</span>
-      <span class="ruby-ivar">@init_pos</span> = <span class="ruby-identifier">anIO</span>.<span class="ruby-identifier">pos</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000932"></a><b>open</b>(anIO) {|reader| ...}
-  </div>
-  <div class="description">
-  <p>
-With no associated block, +Reader::open+ is a synonym for +Reader::new+. If
-the optional code block is given, it will be passed the <a
-href="Reader.html#M000933">new</a> <em>writer</em> as an argument and the
-<a href="Reader.html">Reader</a> object will automatically be closed when
-the block terminates. In this instance, +Reader::open+ returns the value of
-the block.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000932_source')" id="l_M000932_source">+</a> ]</p>
-  <div id="M000932_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 647</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-identifier">reader</span> = <span class="ruby-constant">Reader</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">reader</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-keyword kw">begin</span>
-        <span class="ruby-identifier">res</span> = <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">reader</span>
-      <span class="ruby-keyword kw">ensure</span>
-        <span class="ruby-identifier">reader</span>.<span class="ruby-identifier">close</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">res</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="M000937"></a><b>close</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000937_source')" id="l_M000937_source">+</a> ]</p>
-  <div id="M000937_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 717</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000934"></a><b>each</b>(&amp;block)
-  </div>
-  <div class="description">
-  <p>
-Iterates through <a href="Reader.html#M000934">each</a> entry in the data
-stream.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000934_source')" id="l_M000934_source">+</a> ]</p>
-  <div id="M000934_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 668</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-identifier">each_entry</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000936"></a><b>each_entry</b>() {|entry| ...}
-  </div>
-  <div class="description">
-  <p>
-Iterates through <a href="Reader.html#M000934">each</a> entry in the data
-stream.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000936_source')" id="l_M000936_source">+</a> ]</p>
-  <div id="M000936_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 686</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">each_entry</span>
-      <span class="ruby-identifier">loop</span> <span class="ruby-keyword kw">do</span>
-        <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">eof?</span>
-        <span class="ruby-identifier">header</span> = <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">PosixHeader</span>.<span class="ruby-identifier">new_from_stream</span>(<span class="ruby-ivar">@io</span>)
-        <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">header</span>.<span class="ruby-identifier">empty?</span>
-        <span class="ruby-identifier">entry</span> = <span class="ruby-constant">EntryStream</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">header</span>, <span class="ruby-ivar">@io</span>)
-        <span class="ruby-identifier">size</span>  = <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">size</span>
-        <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">entry</span>
-        <span class="ruby-identifier">skip</span> = (<span class="ruby-value">512</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-value">512</span>)) <span class="ruby-operator">%</span> <span class="ruby-value">512</span>
-        <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:seek</span>)
-            <span class="ruby-comment cmt"># avoid reading...</span>
-          <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">seek</span>(<span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">bytes_read</span>, <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SEEK_CUR</span>)
-        <span class="ruby-keyword kw">else</span>
-          <span class="ruby-identifier">pending</span> = <span class="ruby-identifier">size</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">bytes_read</span>
-          <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">pending</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
-            <span class="ruby-identifier">bread</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>([<span class="ruby-identifier">pending</span>, <span class="ruby-value">4096</span>].<span class="ruby-identifier">min</span>).<span class="ruby-identifier">size</span>
-            <span class="ruby-identifier">raise</span> <span class="ruby-constant">UnexpectedEOF</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">eof?</span>
-            <span class="ruby-identifier">pending</span> <span class="ruby-operator">-=</span> <span class="ruby-identifier">bread</span>
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span>
-        <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">skip</span>) <span class="ruby-comment cmt"># discard trailing zeros</span>
-          <span class="ruby-comment cmt"># make sure nobody can use #read, #getc or #rewind anymore</span>
-        <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">close</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000935"></a><b>rewind</b>()
-  </div>
-  <div class="description">
-  <p>
-Resets the read pointer to the beginning of data stream. Do not call this
-during a <a href="Reader.html#M000934">each</a> or <a
-href="Reader.html#M000936">each_entry</a> iteration. This only works with
-random access data streams that respond to <a
-href="Reader.html#M000935">rewind</a> and pos.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000935_source')" id="l_M000935_source">+</a> ]</p>
-  <div id="M000935_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 675</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rewind</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@init_pos</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
-        <span class="ruby-identifier">raise</span> <span class="ruby-constant">NonSeekableStream</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:rewind</span>)
-        <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">rewind</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">raise</span> <span class="ruby-constant">NonSeekableStream</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:pos=</span>)
-        <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span> = <span class="ruby-ivar">@init_pos</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>

data/doc/rdoc/more/classes/Archive/Tar/Minitar/Writer.html DELETED

@@ -1,378 +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: Archive::Tar::Minitar::Writer</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 />Archive::Tar::Minitar::Writer</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../../../../files/lib/more/facets/minitar_rb.html">lib/more/facets/minitar.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"><p>
-The class that writes a tar format archive to a data stream.
-</p>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000941">add_file</a></span>
-  <span style="padding-right: 5px;"><a href="#M000940">add_file_simple</a></span>
-  <span style="padding-right: 5px;"><a href="#M000944">close</a></span>
-  <span style="padding-right: 5px;"><a href="#M000943">flush</a></span>
-  <span style="padding-right: 5px;"><a href="#M000942">mkdir</a></span>
-  <span style="padding-right: 5px;"><a href="#M000939">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000938">open</a></span>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000939"></a><b>new</b>(anIO)
-  </div>
-  <div class="description">
-  <p>
-Creates and returns a <a href="Writer.html#M000939">new</a> <a
-href="Writer.html">Writer</a> object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000939_source')" id="l_M000939_source">+</a> ]</p>
-  <div id="M000939_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 388</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-ivar">@io</span>     = <span class="ruby-identifier">anIO</span>
-      <span class="ruby-ivar">@closed</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000938"></a><b>open</b>(anIO) {|writer| ...}
-  </div>
-  <div class="description">
-  <p>
-With no associated block, +Writer::open+ is a synonym for +Writer::new+. If
-the optional code block is given, it will be passed the <a
-href="Writer.html#M000939">new</a> <em>writer</em> as an argument and the
-<a href="Writer.html">Writer</a> object will automatically be closed when
-the block terminates. In this instance, +Writer::open+ returns the value of
-the block.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000938_source')" id="l_M000938_source">+</a> ]</p>
-  <div id="M000938_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 373</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">open</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-identifier">writer</span> = <span class="ruby-constant">Writer</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">anIO</span>)
-      <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">writer</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-keyword kw">begin</span>
-        <span class="ruby-identifier">res</span> = <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">writer</span>
-      <span class="ruby-keyword kw">ensure</span>
-        <span class="ruby-identifier">writer</span>.<span class="ruby-identifier">close</span>
-      <span class="ruby-keyword kw">end</span>
-      <span class="ruby-identifier">res</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="M000941"></a><b>add_file</b>(name, opts = {}) {|RestrictedStream.new(@io), opts| ...}
-  </div>
-  <div class="description">
-  <p>
-Adds a file to the archive as <tt>name</tt>. <tt>opts</tt> must contain the
-following value:
-</p>
-<table>
-<tr><td valign="top"><tt>:mode</tt>:</td><td>The Unix file permissions mode value.
-</td></tr>
-</table>
-<p>
-<tt>opts</tt> may contain the following values:
-</p>
-<p>
-<tt>:uid</tt>: The Unix file owner user ID number. <tt>:gid</tt>: The Unix
-file owner group ID number.
-</p>
-<table>
-<tr><td valign="top"><tt>:mtime</tt>:</td><td>The <b>integer</b> modification time value.
-</td></tr>
-</table>
-<p>
-The file&#8216;s size will be determined from the amount of data written to
-the stream.
-</p>
-<p>
-For <a href="Writer.html#M000941">add_file</a> to be used, the <a
-href="Writer.html">Archive::Tar::Minitar::Writer</a> must be wrapping a
-stream object that is seekable (e.g., it responds to pos=). Otherwise, <a
-href="Writer.html#M000940">add_file_simple</a> must be used.
-</p>
-<p>
-<tt>opts</tt> may be modified during the writing to the stream.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000941_source')" id="l_M000941_source">+</a> ]</p>
-  <div id="M000941_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 448</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_file</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">opts</span> = {}) <span class="ruby-comment cmt"># :yields RestrictedStream, +opts+:</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">Minitar</span><span class="ruby-operator">::</span><span class="ruby-constant">BlockRequired</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">Minitar</span><span class="ruby-operator">::</span><span class="ruby-constant">ClosedStream</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@closed</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">Minitar</span><span class="ruby-operator">::</span><span class="ruby-constant">NonSeekableStream</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:pos=</span>)
-      <span class="ruby-identifier">name</span>, <span class="ruby-identifier">prefix</span> = <span class="ruby-identifier">split_name</span>(<span class="ruby-identifier">name</span>)
-      <span class="ruby-identifier">init_pos</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\0&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-value">512</span>) <span class="ruby-comment cmt"># placeholder for the header</span>
-      <span class="ruby-keyword kw">yield</span> <span class="ruby-constant">RestrictedStream</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@io</span>), <span class="ruby-identifier">opts</span>
-        <span class="ruby-comment cmt"># FIXME: what if an exception is raised in the block?</span>
-      <span class="ruby-identifier">size</span>      = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">init_pos</span> <span class="ruby-operator">+</span> <span class="ruby-value">512</span>)
-      <span class="ruby-identifier">remainder</span> = (<span class="ruby-value">512</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">size</span> <span class="ruby-operator">%</span> <span class="ruby-value">512</span>)) <span class="ruby-operator">%</span> <span class="ruby-value">512</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\0&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">remainder</span>)
-      <span class="ruby-identifier">final_pos</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span>   = <span class="ruby-identifier">init_pos</span>
-      <span class="ruby-identifier">header</span> = { <span class="ruby-identifier">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">:mode</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mode</span>], <span class="ruby-identifier">:mtime</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mtime</span>],
-                 <span class="ruby-identifier">:size</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">size</span>, <span class="ruby-identifier">:gid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:gid</span>], <span class="ruby-identifier">:uid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:uid</span>],
-                 <span class="ruby-identifier">:prefix</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">prefix</span> }
-      <span class="ruby-identifier">header</span> = <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">PosixHeader</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">header</span>).<span class="ruby-identifier">to_s</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">header</span>)
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">pos</span> = <span class="ruby-identifier">final_pos</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000940"></a><b>add_file_simple</b>(name, opts = {}) {|os| ...}
-  </div>
-  <div class="description">
-  <p>
-Adds a file to the archive as <tt>name</tt>. <tt>opts</tt> must contain the
-following values:
-</p>
-<table>
-<tr><td valign="top"><tt>:mode</tt>:</td><td>The Unix file permissions mode value.
-</td></tr>
-<tr><td valign="top"><tt>:size</tt>:</td><td>The size, in bytes.
-</td></tr>
-</table>
-<p>
-<tt>opts</tt> may contain the following values:
-</p>
-<p>
-<tt>:uid</tt>: The Unix file owner user ID number. <tt>:gid</tt>: The Unix
-file owner group ID number.
-</p>
-<table>
-<tr><td valign="top"><tt>:mtime</tt>:</td><td>The <b>integer</b> modification time value.
-</td></tr>
-</table>
-<p>
-<a href="../../../It.html">It</a> will not be possible to add more than
-<tt>opts[:size]</tt> bytes to the file.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000940_source')" id="l_M000940_source">+</a> ]</p>
-  <div id="M000940_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 407</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">add_file_simple</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">opts</span> = {}) <span class="ruby-comment cmt"># :yields BoundedStream:</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">Minitar</span><span class="ruby-operator">::</span><span class="ruby-constant">BlockRequired</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">block_given?</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">ClosedStream</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@closed</span>
-      <span class="ruby-identifier">name</span>, <span class="ruby-identifier">prefix</span> = <span class="ruby-identifier">split_name</span>(<span class="ruby-identifier">name</span>)
-      <span class="ruby-identifier">header</span> = { <span class="ruby-identifier">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">:mode</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mode</span>], <span class="ruby-identifier">:mtime</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mtime</span>],
-        <span class="ruby-identifier">:size</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:size</span>], <span class="ruby-identifier">:gid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:gid</span>], <span class="ruby-identifier">:uid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:uid</span>],
-        <span class="ruby-identifier">:prefix</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">prefix</span> }
-      <span class="ruby-identifier">header</span> = <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">PosixHeader</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">header</span>).<span class="ruby-identifier">to_s</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">header</span>)
-      <span class="ruby-identifier">os</span> = <span class="ruby-constant">BoundedStream</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@io</span>, <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:size</span>])
-      <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">os</span>
-        <span class="ruby-comment cmt"># FIXME: what if an exception is raised in the block?</span>
-      <span class="ruby-identifier">min_padding</span> = <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:size</span>] <span class="ruby-operator">-</span> <span class="ruby-identifier">os</span>.<span class="ruby-identifier">written</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\0&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">min_padding</span>)
-      <span class="ruby-identifier">remainder</span> = (<span class="ruby-value">512</span> <span class="ruby-operator">-</span> (<span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:size</span>] <span class="ruby-operator">%</span> <span class="ruby-value">512</span>)) <span class="ruby-operator">%</span> <span class="ruby-value">512</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\0&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">remainder</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000944"></a><b>close</b>()
-  </div>
-  <div class="description">
-  <p>
-Closes the <a href="Writer.html">Writer</a>.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000944_source')" id="l_M000944_source">+</a> ]</p>
-  <div id="M000944_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 495</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">close</span>
-      <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@closed</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-value str">&quot;\0&quot;</span> <span class="ruby-operator">*</span> <span class="ruby-value">1024</span>)
-      <span class="ruby-ivar">@closed</span> = <span class="ruby-keyword kw">true</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000943"></a><b>flush</b>()
-  </div>
-  <div class="description">
-  <p>
-Passes the <a href="Writer.html#M000943">flush</a> method to the wrapped
-stream, used for buffered streams.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000943_source')" id="l_M000943_source">+</a> ]</p>
-  <div id="M000943_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 489</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">flush</span>
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">ClosedStream</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@closed</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">flush</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-identifier">:flush</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000942"></a><b>mkdir</b>(name, opts = {})
-  </div>
-  <div class="description">
-  <p>
-Creates a directory in the tar.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000942_source')" id="l_M000942_source">+</a> ]</p>
-  <div id="M000942_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/minitar.rb, line 476</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">mkdir</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">opts</span> = {})
-      <span class="ruby-identifier">raise</span> <span class="ruby-constant">ClosedStream</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@closed</span>
-      <span class="ruby-identifier">name</span>, <span class="ruby-identifier">prefix</span> = <span class="ruby-identifier">split_name</span>(<span class="ruby-identifier">name</span>)
-      <span class="ruby-identifier">header</span> = { <span class="ruby-identifier">:name</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">name</span>, <span class="ruby-identifier">:mode</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mode</span>], <span class="ruby-identifier">:typeflag</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value str">&quot;5&quot;</span>,
-                 <span class="ruby-identifier">:size</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>, <span class="ruby-identifier">:gid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:gid</span>], <span class="ruby-identifier">:uid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:uid</span>],
-                 <span class="ruby-identifier">:mtime</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">opts</span>[<span class="ruby-identifier">:mtime</span>], <span class="ruby-identifier">:prefix</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">prefix</span> }
-      <span class="ruby-identifier">header</span> = <span class="ruby-constant">Archive</span><span class="ruby-operator">::</span><span class="ruby-constant">Tar</span><span class="ruby-operator">::</span><span class="ruby-constant">PosixHeader</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">header</span>).<span class="ruby-identifier">to_s</span>
-      <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">write</span>(<span class="ruby-identifier">header</span>)
-      <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>