folio 0.1.0 → 0.2.0

data/CHANGES

@@ -0,0 +1,2 @@
+
+

data/MANIFEST

@@ -2,6 +2,7 @@ doc
 doc/rdoc
 doc/rdoc/fr_file_index.html
 doc/rdoc/classes
+doc/rdoc/classes/Enumerator.html
 doc/rdoc/classes/Folio
 doc/rdoc/classes/Folio/FileObject.html
 doc/rdoc/classes/Folio/BlockDevice.html
@@ -19,6 +20,7 @@ doc/rdoc/rdoc-style.css
 doc/rdoc/files
 doc/rdoc/files/README.html
 doc/rdoc/files/METADATA.html
+doc/rdoc/files/CHANGES.html
 doc/rdoc/files/lib
 doc/rdoc/files/lib/folio
 doc/rdoc/files/lib/folio/fileobject_rb.html
@@ -50,15 +52,16 @@ doc/ri/Folio/Prompt/mv-i.yaml
 doc/ri/Folio/Prompt/files-i.yaml
 doc/ri/Folio/Prompt/entries-i.yaml
 doc/ri/Folio/Prompt/rm_rf-i.yaml
-doc/ri/Folio/Prompt/paths-i.yaml
 doc/ri/Folio/Prompt/mkdir_p-i.yaml
-doc/ri/Folio/Prompt/pwd-i.yaml
+doc/ri/Folio/Prompt/documents-i.yaml
 doc/ri/Folio/Prompt/%2f-i.yaml
 doc/ri/Folio/Prompt/ln_sf-i.yaml
 doc/ri/Folio/Prompt/chown-i.yaml
 doc/ri/Folio/Prompt/ln_s-i.yaml
 doc/ri/Folio/Prompt/directories-i.yaml
+doc/ri/Folio/Prompt/directory_entries-i.yaml
 doc/ri/Folio/Prompt/cp-i.yaml
+doc/ri/Folio/Prompt/document_entries-i.yaml
 doc/ri/Folio/Prompt/rmdir-i.yaml
 doc/ri/Folio/Prompt/localize-i.yaml
 doc/ri/Folio/Prompt/chown_r-i.yaml
@@ -69,6 +72,7 @@ doc/ri/Folio/Prompt/rm_r-i.yaml
 doc/ri/Folio/Prompt/cdesc-Prompt.yaml
 doc/ri/Folio/Prompt/chmod_r-i.yaml
 doc/ri/Folio/Prompt/file-i.yaml
+doc/ri/Folio/Prompt/%5b%5d-i.yaml
 doc/ri/Folio/Prompt/to_s-i.yaml
 doc/ri/Folio/Prompt/%5b%5d-c.yaml
 doc/ri/Folio/Prompt/new-c.yaml
@@ -134,8 +138,8 @@ doc/ri/Folio/FileObject/basename-i.yaml
 doc/ri/Folio/FileObject/ctime-i.yaml
 doc/ri/Folio/FileObject/cdesc-FileObject.yaml
 doc/ri/Folio/FileObject/ln_f-i.yaml
-doc/ri/Folio/FileObject/file%3f-i.yaml
 doc/ri/Folio/FileObject/directory%3f-i.yaml
+doc/ri/Folio/FileObject/document%3f-i.yaml
 doc/ri/Folio/FileObject/stat-i.yaml
 doc/ri/Folio/FileObject/install-i.yaml
 doc/ri/Folio/FileObject/to_s-i.yaml
@@ -159,6 +163,8 @@ doc/ri/Folio/Socket
 doc/ri/Folio/Socket/cdesc-Socket.yaml
 doc/ri/Folio/Socket/new-c.yaml
 doc/ri/Folio/Document
+doc/ri/Folio/Document/write-i.yaml
+doc/ri/Folio/Document/%3c-i.yaml
 doc/ri/Folio/Document/open-i.yaml
 doc/ri/Folio/Document/read-i.yaml
 doc/ri/Folio/Document/cdesc-Document.yaml
@@ -166,9 +172,11 @@ doc/ri/Folio/Document/executable%3f-i.yaml
 doc/ri/Folio/Document/readlines-i.yaml
 doc/ri/Folio/Document/delete-i.yaml
 doc/ri/Folio/Document/intialize-i.yaml
+doc/ri/Folio/Document/%3c%3c-i.yaml
 doc/ri/Folio/Document/unlink-i.yaml
 doc/ri/Folio/Document/truncate-i.yaml
-doc/ri/Folio/Document/file%3f-i.yaml
+doc/ri/Folio/Document/document%3f-i.yaml
+doc/ri/Folio/Document/append-i.yaml
 doc/ri/Folio/Document/executable_real%3f-i.yaml
 doc/ri/Folio/FileNotFound
 doc/ri/Folio/FileNotFound/cdesc-FileNotFound.yaml
@@ -183,15 +191,19 @@ doc/ri/Folio/CharacterDevice/chardev%3f-i.yaml
 doc/ri/Folio/CharacterDevice/cdesc-CharacterDevice.yaml
 doc/ri/Folio/Directory
 doc/ri/Folio/Directory/%2b-i.yaml
+doc/ri/Folio/Directory/files-i.yaml
 doc/ri/Folio/Directory/entries-i.yaml
 doc/ri/Folio/Directory/rm_rf-i.yaml
-doc/ri/Folio/Directory/paths-i.yaml
+doc/ri/Folio/Directory/documents-i.yaml
 doc/ri/Folio/Directory/delete-i.yaml
 doc/ri/Folio/Directory/chroot-i.yaml
 doc/ri/Folio/Directory/%2f-i.yaml
+doc/ri/Folio/Directory/directories-i.yaml
+doc/ri/Folio/Directory/directory_entries-i.yaml
 doc/ri/Folio/Directory/chdir-i.yaml
 doc/ri/Folio/Directory/foreach-i.yaml
 doc/ri/Folio/Directory/unlink-i.yaml
+doc/ri/Folio/Directory/document_entries-i.yaml
 doc/ri/Folio/Directory/rmdir-i.yaml
 doc/ri/Folio/Directory/cdesc-Directory.yaml
 doc/ri/Folio/Directory/chown_r-i.yaml
@@ -202,6 +214,8 @@ doc/ri/Folio/Directory/chmod_r-i.yaml
 doc/ri/Folio/Directory/new-c.yaml
 doc/ri/Folio/Directory/cd-i.yaml
 doc/ri/Folio/cdesc-Folio.yaml
+doc/ri/Enumerator
+doc/ri/Enumerator/cdesc-Enumerator.yaml
 doc/ri/created.rid
 test
 test/test_folio.rb
@@ -210,6 +224,7 @@ test/fixture
 test/fixture/foo.txt
 test/fixture/sub
 test/fixture/bar.txt
+CHANGES
 README
 METADATA
 demo

data/METADATA

@@ -1,8 +1,9 @@
 name      : folio
-version   : 0.1.0
+version   : 0.2.0
 status    : alpha
 homepage  : http://folio.rubyforge.org
-author    : trans <transfire@gmail.com>
+contact   : tigerops-community@rubyforge.org
+author    : 7rans <transfire@gmail.com>
 summary   : Folio is a better way to access the file system.
 abstract  : Folio is a better way to access the file system.
 

data/README

@@ -57,13 +57,18 @@ And you may know the Setup drill.*
 
 *requires <a href="http://setup.rubyforge.org">Ruby Setup</a>
 
+
+
 == Resources
 
 <a href="rio.rubyforge.org">Rio<a> is a similar too. It's very well documented, but has a different
 design philiosophy having it's own more unique DSL.
 
+
+
 == Copying
 
 Folio is Copyright (c)2008 Tiger Ops & Thomas Sawyer
 Folio is distributed under the terms of the GPLv3.
 
+

data/doc/rdoc/classes/Enumerator.html

@@ -0,0 +1,92 @@
+<?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: Enumerator</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 = "show source"
+          }
+          else
+          {
+            elem.style.display = "block"
+            link.innerHTML = "hide source"
+          }
+        }
+
+        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 />Enumerator</td>
+  <td align="right">
+    <table cellspacing="0" cellpadding="2">
+      <tr valign="top">
+        <td>In:</td>
+        <td>
+<a href="../files/lib/folio/fileobject_rb.html">lib/folio/fileobject.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>
+
+  </div>
+
+    </body>
+</html>

data/doc/rdoc/classes/Folio.html

@@ -79,6 +79,16 @@
       <div id="content">
 
   <div class="description"><h1><a href="Folio.html">Folio</a></h1>
+<p>
+In folio the term `<a href="Folio.html#M000001">file</a>` means a <a
+href="Folio.html#M000001">file</a> object. That is to say any type of <a
+href="Folio.html#M000001">file</a> system resource: document, directory,
+device, etc. We use the term `document` instead to mean &quot;regular
+files&quot;. This terminolgy was chosen for two reasons. Namely, (1) a
+differentiation in terms was required; and (2) a <a
+href="Folio.html#M000001">file</a> in the everyday sense is something in
+which one puts papars (eg. documents).
+</p>
 </div>
 
 
@@ -116,7 +126,7 @@ Class <a href="Folio/Socket.html" class="link">Folio::Socket</a><br />
   <p class="source-link">[ <a href="javascript:toggleSource('M000002_source')" id="l_M000002_source">show source</a> ]</p>
   <div id="M000002_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio.rb, line 24</span>
+<span class="ruby-comment cmt"># File lib/folio.rb, line 31</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-operator">[]</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">path</span>)
     <span class="ruby-constant">Prompt</span>.<span class="ruby-identifier">new</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">path</span>)
   <span class="ruby-keyword kw">end</span>
@@ -132,7 +142,7 @@ Class <a href="Folio/Socket.html" class="link">Folio::Socket</a><br />
   <p class="source-link">[ <a href="javascript:toggleSource('M000001_source')" id="l_M000001_source">show source</a> ]</p>
   <div id="M000001_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio.rb, line 20</span>
+<span class="ruby-comment cmt"># File lib/folio.rb, line 27</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">file</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">path</span>)
     <span class="ruby-constant">FileObject</span>[<span class="ruby-operator">*</span><span class="ruby-identifier">path</span>]
   <span class="ruby-keyword kw">end</span>

data/doc/rdoc/classes/Folio/BlockDevice.html

@@ -86,7 +86,7 @@ Block device
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000031">blockdev?</a></li>
+  <li><a href="#M000035">blockdev?</a></li>
   </ul>
 
 
@@ -97,11 +97,11 @@ Block device
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000031"></a><b>blockdev?</b>()
+    <a name="M000035"></a><b>blockdev?</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000031_source')" id="l_M000031_source">show source</a> ]</p>
-  <div id="M000031_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000035_source')" id="l_M000035_source">show source</a> ]</p>
+  <div id="M000035_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/folio/device.rb, line 24</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">blockdev?</span> ; <span class="ruby-keyword kw">true</span> ; <span class="ruby-keyword kw">end</span>

data/doc/rdoc/classes/Folio/CharacterDevice.html

@@ -86,7 +86,7 @@ Character device
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000139">chardev?</a></li>
+  <li><a href="#M000149">chardev?</a></li>
   </ul>
 
 
@@ -97,11 +97,11 @@ Character device
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000139"></a><b>chardev?</b>()
+    <a name="M000149"></a><b>chardev?</b>()
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000139_source')" id="l_M000139_source">show source</a> ]</p>
-  <div id="M000139_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000149_source')" id="l_M000149_source">show source</a> ]</p>
+  <div id="M000149_source" class="dyn-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/folio/device.rb, line 17</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chardev?</span> ; <span class="ruby-keyword kw">true</span> ; <span class="ruby-keyword kw">end</span>

data/doc/rdoc/classes/Folio/Directory.html

@@ -82,8 +82,8 @@ FileObject
 
   <div class="sectiontitle">Methods</div>
   <ul>
-  <li><a href="#M000030">+</a></li>
-  <li><a href="#M000029">/</a></li>
+  <li><a href="#M000034">+</a></li>
+  <li><a href="#M000033">/</a></li>
   <li><a href="#M000024">cd</a></li>
   <li><a href="#M000023">chdir</a></li>
   <li><a href="#M000021">chmod_r</a></li>
@@ -91,11 +91,15 @@ FileObject
   <li><a href="#M000025">chroot</a></li>
   <li><a href="#M000015">cp_r</a></li>
   <li><a href="#M000018">delete</a></li>
+  <li><a href="#M000032">directories</a></li>
   <li><a href="#M000014">directory?</a></li>
-  <li><a href="#M000026">entries</a></li>
-  <li><a href="#M000027">foreach</a></li>
+  <li><a href="#M000029">directory_entries</a></li>
+  <li><a href="#M000028">document_entries</a></li>
+  <li><a href="#M000031">documents</a></li>
+  <li><a href="#M000027">entries</a></li>
+  <li><a href="#M000030">files</a></li>
+  <li><a href="#M000026">foreach</a></li>
   <li><a href="#M000013">new</a></li>
-  <li><a href="#M000028">paths</a></li>
   <li><a href="#M000019">rm_r</a></li>
   <li><a href="#M000020">rm_rf</a></li>
   <li><a href="#M000016">rmdir</a></li>
@@ -128,7 +132,7 @@ FileObject
 <div class="sectiontitle">Public Instance methods</div>
 <div class="method">
   <div class="title">
-    <a name="M000030"></a><b>+</b>(fname)
+    <a name="M000034"></a><b>+</b>(fname)
   </div>
   <div class="description">
   <p>
@@ -138,22 +142,22 @@ Alias for #/
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000029"></a><b>/</b>(fname)
+    <a name="M000033"></a><b>/</b>(fname)
   </div>
   <div class="description">
   <p>
-Join <a href="Directory.html#M000028">paths</a>.
+Join path and return <a href="Directory.html#M000013">new</a> file object.
 </p>
   </div>
 <div class="aka">
   This method is also aliased as
-  <a href="Directory.html#M000030">+</a>
+  <a href="Directory.html#M000034">+</a>
 </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000029_source')" id="l_M000029_source">show source</a> ]</p>
-  <div id="M000029_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000033_source')" id="l_M000033_source">show source</a> ]</p>
+  <div id="M000033_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 75</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 118</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-operator">/</span>(<span class="ruby-identifier">fname</span>)
       <span class="ruby-constant">FileObject</span>[<span class="ruby-identifier">path</span>, <span class="ruby-identifier">fname</span>]
     <span class="ruby-keyword kw">end</span>
@@ -175,6 +179,11 @@ Alias for <a href="Directory.html#M000023">chdir</a>
   <div class="title">
     <a name="M000023"></a><b>chdir</b>(&amp;block)
   </div>
+  <div class="description">
+  <p>
+Change into this directory.
+</p>
+  </div>
 <div class="aka">
   This method is also aliased as
   <a href="Directory.html#M000024">cd</a>
@@ -183,7 +192,7 @@ Alias for <a href="Directory.html#M000023">chdir</a>
   <p class="source-link">[ <a href="javascript:toggleSource('M000023_source')" id="l_M000023_source">show source</a> ]</p>
   <div id="M000023_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 51</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 69</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chdir</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
       <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chdir</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
     <span class="ruby-keyword kw">end</span>
@@ -195,11 +204,16 @@ Alias for <a href="Directory.html#M000023">chdir</a>
   <div class="title">
     <a name="M000021"></a><b>chmod_r</b>(mode)
   </div>
+  <div class="description">
+  <p>
+Change the mode of this directory and all it&#8216;s content recursively.
+</p>
+  </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000021_source')" id="l_M000021_source">show source</a> ]</p>
   <div id="M000021_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 37</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 52</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chmod_r</span>(<span class="ruby-identifier">mode</span>)
       <span class="ruby-identifier">util</span>.<span class="ruby-identifier">chmod_r</span>(<span class="ruby-identifier">mode</span>, <span class="ruby-identifier">path</span>)
     <span class="ruby-keyword kw">end</span>
@@ -213,14 +227,14 @@ Alias for <a href="Directory.html#M000023">chdir</a>
   </div>
   <div class="description">
   <p>
-alias_method :chmod_R, :<a href="Directory.html#M000021">chmod_r</a>
+Change the owner of this directory and all it&#8216;s content recursively.
 </p>
   </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000022_source')" id="l_M000022_source">show source</a> ]</p>
   <div id="M000022_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 42</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 59</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chown_r</span>(<span class="ruby-identifier">user</span>, <span class="ruby-identifier">group</span>)
       <span class="ruby-identifier">util</span>.<span class="ruby-identifier">chown_r</span>(<span class="ruby-identifier">user</span>, <span class="ruby-identifier">group</span>, <span class="ruby-identifier">path</span>)
     <span class="ruby-keyword kw">end</span>
@@ -232,11 +246,16 @@ alias_method :chmod_R, :<a href="Directory.html#M000021">chmod_r</a>
   <div class="title">
     <a name="M000025"></a><b>chroot</b>(&amp;block)
   </div>
+  <div class="description">
+  <p>
+Make this directory the file system root.
+</p>
+  </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000025_source')" id="l_M000025_source">show source</a> ]</p>
   <div id="M000025_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 56</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 75</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chroot</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
       <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">chroot</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
     <span class="ruby-keyword kw">end</span>
@@ -250,7 +269,7 @@ alias_method :chmod_R, :<a href="Directory.html#M000021">chmod_r</a>
   </div>
   <div class="description">
   <p>
-Copy recursively.
+Copy this directory recursively to destination.
 </p>
   </div>
 <div class="sourcecode">
@@ -275,6 +294,28 @@ Alias for <a href="Directory.html#M000016">rmdir</a>
 </p>
   </div>
 </div>
+<div class="method">
+  <div class="title">
+    <a name="M000032"></a><b>directories</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns an <a href="../Enumerator.html">Enumerator</a> over all <a
+href="Directory.html#M000032">directories</a> in the directory.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000032_source')" id="l_M000032_source">show source</a> ]</p>
+  <div id="M000032_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 113</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">directories</span>
+      <span class="ruby-identifier">directory_entries</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-identifier">:each</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">FileObject</span>[<span class="ruby-identifier">path</span>, <span class="ruby-identifier">f</span>] }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
 <div class="method">
   <div class="title">
     <a name="M000014"></a><b>directory?</b>()
@@ -291,22 +332,65 @@ Alias for <a href="Directory.html#M000016">rmdir</a>
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000026"></a><b>entries</b>()
+    <a name="M000029"></a><b>directory_entries</b>()
   </div>
   <div class="description">
   <p>
-<a href="Directory.html">Directory</a> <a
-href="Directory.html#M000026">entries</a>. This returns a list of file
-names.
+Returns a list of directory names. This does not include &#8217;.&#8217; or
+&#8217;..&#8217;.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000026_source')" id="l_M000026_source">show source</a> ]</p>
-  <div id="M000026_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000029_source')" id="l_M000029_source">show source</a> ]</p>
+  <div id="M000029_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 61</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">entries</span>
-      <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">path</span>)
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 97</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">directory_entries</span>
+      <span class="ruby-identifier">dirs</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>(<span class="ruby-node">&quot;#{path}/&quot;</span>)
+      <span class="ruby-identifier">dirs</span>.<span class="ruby-identifier">collect</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">chomp</span>(<span class="ruby-value str">'/'</span>) }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000028"></a><b>document_entries</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns a list of document names.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000028_source')" id="l_M000028_source">show source</a> ]</p>
+  <div id="M000028_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 91</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">document_entries</span>
+      <span class="ruby-identifier">entries</span>.<span class="ruby-identifier">select</span>{<span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">file?</span>(<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">path</span>,<span class="ruby-identifier">f</span>)) }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000031"></a><b>documents</b>()
+  </div>
+  <div class="description">
+  <p>
+Returns an <a href="../Enumerator.html">Enumerator</a> over all <a
+href="Directory.html#M000031">documents</a> in the directory.
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000031_source')" id="l_M000031_source">show source</a> ]</p>
+  <div id="M000031_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 108</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">documents</span>
+      <span class="ruby-identifier">document_entries</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-identifier">:each</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">FileObject</span>[<span class="ruby-identifier">path</span>, <span class="ruby-identifier">f</span>] }
     <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -314,15 +398,21 @@ names.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000027"></a><b>foreach</b>(&amp;block)
+    <a name="M000027"></a><b>entries</b>()
+  </div>
+  <div class="description">
+  <p>
+This returns a list of file names. Unlike traditional Dir.entries method,
+this does not include &#8217;.&#8217; or &#8217;..&#8217;.
+</p>
   </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000027_source')" id="l_M000027_source">show source</a> ]</p>
   <div id="M000027_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 65</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">foreach</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
-      <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 86</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">entries</span>
+      <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">path</span>) <span class="ruby-operator">-</span> [<span class="ruby-value str">'.'</span>, <span class="ruby-value str">'..'</span>]
     <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -330,20 +420,43 @@ names.
 </div>
 <div class="method">
   <div class="title">
-    <a name="M000028"></a><b>paths</b>()
+    <a name="M000030"></a><b>files</b>()
   </div>
   <div class="description">
   <p>
-TODO: use enumerator (?)
+Returns an <a href="../Enumerator.html">Enumerator</a> over all file
+objects in the directory.
 </p>
   </div>
 <div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000028_source')" id="l_M000028_source">show source</a> ]</p>
-  <div id="M000028_source" class="dyn-source">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000030_source')" id="l_M000030_source">show source</a> ]</p>
+  <div id="M000030_source" class="dyn-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 103</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">files</span>
+      <span class="ruby-identifier">entries</span>.<span class="ruby-identifier">to_enum</span>(<span class="ruby-identifier">:each</span>){ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">FileObject</span>[<span class="ruby-identifier">path</span>, <span class="ruby-identifier">f</span>] }
+    <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+</div>
+<div class="method">
+  <div class="title">
+    <a name="M000026"></a><b>foreach</b>(&amp;block)
+  </div>
+  <div class="description">
+  <p>
+Loop over the <a href="Directory.html#M000027">entries</a> (this does
+includes &#8217;.&#8217; and &#8217;..&#8217;).
+</p>
+  </div>
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000026_source')" id="l_M000026_source">show source</a> ]</p>
+  <div id="M000026_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 70</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">paths</span>
-      (<span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">path</span>) <span class="ruby-operator">-</span> [<span class="ruby-value str">'.'</span>, <span class="ruby-value str">'..'</span>]).<span class="ruby-identifier">collect</span>{ <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-constant">FileObject</span>[<span class="ruby-identifier">path</span>, <span class="ruby-identifier">f</span>] }
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 80</span>
+    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">foreach</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
+      <span class="ruby-operator">::</span><span class="ruby-constant">Dir</span>.<span class="ruby-identifier">foreach</span>(<span class="ruby-identifier">path</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
     <span class="ruby-keyword kw">end</span>
 </pre>
   </div>
@@ -353,11 +466,16 @@ TODO: use enumerator (?)
   <div class="title">
     <a name="M000019"></a><b>rm_r</b>()
   </div>
+  <div class="description">
+  <p>
+Remove this directory and all it&#8216;s content.
+</p>
+  </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000019_source')" id="l_M000019_source">show source</a> ]</p>
   <div id="M000019_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 29</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 31</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rm_r</span>
       <span class="ruby-identifier">util</span>.<span class="ruby-identifier">rm_r</span>(<span class="ruby-identifier">path</span>)
     <span class="ruby-keyword kw">end</span>
@@ -369,11 +487,16 @@ TODO: use enumerator (?)
   <div class="title">
     <a name="M000020"></a><b>rm_rf</b>(list)
   </div>
+  <div class="description">
+  <p>
+Remove this directory and all it&#8216;s content forcefully.
+</p>
+  </div>
 <div class="sourcecode">
   <p class="source-link">[ <a href="javascript:toggleSource('M000020_source')" id="l_M000020_source">show source</a> ]</p>
   <div id="M000020_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 33</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 36</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rm_rf</span>(<span class="ruby-identifier">list</span>)
       <span class="ruby-identifier">util</span>.<span class="ruby-identifier">rm_rf</span>(<span class="ruby-identifier">path</span>)
     <span class="ruby-keyword kw">end</span>
@@ -385,6 +508,11 @@ TODO: use enumerator (?)
   <div class="title">
     <a name="M000016"></a><b>rmdir</b>()
   </div>
+  <div class="description">
+  <p>
+Remove this directory. Fails if not empty.
+</p>
+  </div>
 <div class="aka">
   This method is also aliased as
   <a href="Directory.html#M000017">unlink</a>
@@ -394,7 +522,7 @@ TODO: use enumerator (?)
   <p class="source-link">[ <a href="javascript:toggleSource('M000016_source')" id="l_M000016_source">show source</a> ]</p>
   <div id="M000016_source" class="dyn-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 22</span>
+<span class="ruby-comment cmt"># File lib/folio/directory.rb, line 23</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">rmdir</span>
       <span class="ruby-identifier">util</span>.<span class="ruby-identifier">rmdir</span>(<span class="ruby-identifier">path</span>)
     <span class="ruby-keyword kw">end</span>