pho 0.5 → 0.6

data/doc/rdoc/classes/Pho/FieldWeighting.html

@@ -93,8 +93,8 @@ href="QueryProfile.html">QueryProfile</a>
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000170">new</a>&nbsp;&nbsp;
-      <a href="#M000171">to_rdf</a>&nbsp;&nbsp;
+      <a href="#M000190">new</a>&nbsp;&nbsp;
+      <a href="#M000191">to_rdf</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -148,19 +148,19 @@ The weighting applied to the field
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000170" class="method-detail">
-        <a name="M000170"></a>
+      <div id="method-M000190" class="method-detail">
+        <a name="M000190"></a>
 
         <div class="method-heading">
-          <a href="#M000170" class="method-signature">
+          <a href="#M000190" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(uri, name, weight)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000170-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000170-source">
+            onclick="toggleCode('M000190-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000190-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/query_profile.rb, line 15</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">uri</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">weight</span>)
@@ -175,19 +175,19 @@ The weighting applied to the field
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000171" class="method-detail">
-        <a name="M000171"></a>
+      <div id="method-M000191" class="method-detail">
+        <a name="M000191"></a>
 
         <div class="method-heading">
-          <a href="#M000171" class="method-signature">
+          <a href="#M000191" class="method-signature">
           <span class="method-name">to_rdf</span><span class="method-args">(ns=true)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Convert this object into an RDF representation. Generates a simple
-rdf:Description, optionally including namespaces
+Convert this object into an <a href="RDF.html">RDF</a> representation.
+Generates a simple rdf:Description, optionally including namespaces
 </p>
 <table>
 <tr><td valign="top">ns:</td><td>include namespace declarations
@@ -195,8 +195,8 @@ rdf:Description, optionally including namespaces
 </td></tr>
 </table>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000171-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000171-source">
+            onclick="toggleCode('M000191-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000191-source">
 <pre>
 <span class="ruby-comment cmt"># File lib/pho/query_profile.rb, line 23</span>
     <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_rdf</span>(<span class="ruby-identifier">ns</span>=<span class="ruby-keyword kw">true</span>)

data/doc/rdoc/classes/Pho/FileManagement/AbstractFileManager.html

@@ -80,7 +80,7 @@
 
     <div id="description">
       <p>
-TODO: move files into hidden directory TODO: add directory traversal
+TODO: move files into hidden directory
 </p>
 
     </div>
@@ -92,15 +92,16 @@ TODO: move files into hidden directory TODO: add directory traversal
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000029">failures</a>&nbsp;&nbsp;
-      <a href="#M000032">get_fail_file_for</a>&nbsp;&nbsp;
-      <a href="#M000033">get_ok_file_for</a>&nbsp;&nbsp;
-      <a href="#M000025">new</a>&nbsp;&nbsp;
-      <a href="#M000028">reset</a>&nbsp;&nbsp;
-      <a href="#M000027">retry_failures</a>&nbsp;&nbsp;
-      <a href="#M000026">store</a>&nbsp;&nbsp;
-      <a href="#M000030">successes</a>&nbsp;&nbsp;
-      <a href="#M000031">summary</a>&nbsp;&nbsp;
+      <a href="#M000031">failures</a>&nbsp;&nbsp;
+      <a href="#M000034">get_fail_file_for</a>&nbsp;&nbsp;
+      <a href="#M000035">get_ok_file_for</a>&nbsp;&nbsp;
+      <a href="#M000026">new</a>&nbsp;&nbsp;
+      <a href="#M000030">new_files</a>&nbsp;&nbsp;
+      <a href="#M000029">reset</a>&nbsp;&nbsp;
+      <a href="#M000028">retry_failures</a>&nbsp;&nbsp;
+      <a href="#M000027">store</a>&nbsp;&nbsp;
+      <a href="#M000032">successes</a>&nbsp;&nbsp;
+      <a href="#M000033">summary</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -158,21 +159,21 @@ TODO: move files into hidden directory TODO: add directory traversal
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000025" class="method-detail">
-        <a name="M000025"></a>
+      <div id="method-M000026" class="method-detail">
+        <a name="M000026"></a>
 
         <div class="method-heading">
-          <a href="#M000025" class="method-signature">
+          <a href="#M000026" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(store, dir, ok_suffix=OK, fail_suffix=FAIL, sleep=1)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000025-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000025-source">
+            onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000026-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 15</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 14</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">store</span>, <span class="ruby-identifier">dir</span>, <span class="ruby-identifier">ok_suffix</span>=<span class="ruby-constant">OK</span>, <span class="ruby-identifier">fail_suffix</span>=<span class="ruby-constant">FAIL</span>, <span class="ruby-identifier">sleep</span>=<span class="ruby-value">1</span>)
         <span class="ruby-ivar">@store</span> = <span class="ruby-identifier">store</span>
         <span class="ruby-ivar">@dir</span> = <span class="ruby-identifier">dir</span>
@@ -187,27 +188,27 @@ TODO: move files into hidden directory TODO: add directory traversal
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000029" class="method-detail">
-        <a name="M000029"></a>
+      <div id="method-M000031" class="method-detail">
+        <a name="M000031"></a>
 
         <div class="method-heading">
-          <a href="#M000029" class="method-signature">
-          <span class="method-name">failures</span><span class="method-args">()</span>
+          <a href="#M000031" class="method-signature">
+          <span class="method-name">failures</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List <a href="AbstractFileManager.html#M000029">failures</a>
+List <a href="AbstractFileManager.html#M000031">failures</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000029-source">
+            onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000031-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 55</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">failures</span>()
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 68</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">failures</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">fails</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
-        <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-ivar">@dir</span>, <span class="ruby-value str">&quot;*&quot;</span>) ).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
           <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">file</span>) <span class="ruby-operator">!=</span> <span class="ruby-node">&quot;.#{@fail_suffix}&quot;</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">file</span>) <span class="ruby-operator">!=</span> <span class="ruby-node">&quot;.#{@ok_suffix}&quot;</span>
             <span class="ruby-identifier">fails</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">file</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>( <span class="ruby-identifier">get_fail_file_for</span>(<span class="ruby-identifier">file</span>) )  
           <span class="ruby-keyword kw">end</span>          
@@ -219,76 +220,110 @@ List <a href="AbstractFileManager.html#M000029">failures</a>
         </div>
       </div>
 
-      <div id="method-M000032" class="method-detail">
-        <a name="M000032"></a>
+      <div id="method-M000034" class="method-detail">
+        <a name="M000034"></a>
 
         <div class="method-heading">
-          <a href="#M000032" class="method-signature">
+          <a href="#M000034" class="method-signature">
           <span class="method-name">get_fail_file_for</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000032-source">
+            onclick="toggleCode('M000034-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000034-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 87</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 100</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_fail_file_for</span>(<span class="ruby-identifier">filename</span>)
         <span class="ruby-identifier">ext</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">filename</span>)
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/#{ext}/</span>, <span class="ruby-node">&quot;.#{@fail_suffix}&quot;</span>)              
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/#{ext}$/</span>, <span class="ruby-node">&quot;.#{@fail_suffix}&quot;</span>)              
       <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000033" class="method-detail">
-        <a name="M000033"></a>
+      <div id="method-M000035" class="method-detail">
+        <a name="M000035"></a>
 
         <div class="method-heading">
-          <a href="#M000033" class="method-signature">
+          <a href="#M000035" class="method-signature">
           <span class="method-name">get_ok_file_for</span><span class="method-args">(filename)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000033-source">
+            onclick="toggleCode('M000035-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000035-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 92</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 105</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_ok_file_for</span>(<span class="ruby-identifier">filename</span>)
         <span class="ruby-identifier">ext</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">filename</span>)        
-        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/#{ext}/</span>, <span class="ruby-node">&quot;.#{@ok_suffix}&quot;</span>)
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">filename</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-node">/#{ext}$/</span>, <span class="ruby-node">&quot;.#{@ok_suffix}&quot;</span>)
       <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000028" class="method-detail">
-        <a name="M000028"></a>
+      <div id="method-M000030" class="method-detail">
+        <a name="M000030"></a>
 
         <div class="method-heading">
-          <a href="#M000028" class="method-signature">
-          <span class="method-name">reset</span><span class="method-args">(reset_store=false)</span>
+          <a href="#M000030" class="method-signature">
+          <span class="method-name">new_files</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Reset the directory to clear out any previous statuses <a
-href="../Store.html">Store</a> can also be <a
-href="AbstractFileManager.html#M000028">reset</a> at the same time: use
-with care!
+List any <a href="AbstractFileManager.html#M000026">new</a> files in the
+directory
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000028-source">
+            onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000030-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 53</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">new_files</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
+        <span class="ruby-identifier">newfiles</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
+        <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
+          
+          <span class="ruby-identifier">ok_file</span> = <span class="ruby-identifier">get_ok_file_for</span>(<span class="ruby-identifier">file</span>)
+          <span class="ruby-identifier">fail_file</span> = <span class="ruby-identifier">get_fail_file_for</span>(<span class="ruby-identifier">file</span>)
+          <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">ok_file</span>) <span class="ruby-keyword kw">or</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">fail_file</span>) )
+            <span class="ruby-identifier">newfiles</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">file</span>          
+          <span class="ruby-keyword kw">end</span>
+            
+        <span class="ruby-keyword kw">end</span>
+        <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">newfiles</span>
+      <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000029" class="method-detail">
+        <a name="M000029"></a>
+
+        <div class="method-heading">
+          <a href="#M000029" class="method-signature">
+          <span class="method-name">reset</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Reset the directory to clear out any previous statuses
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000029-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000029-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 45</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reset</span>(<span class="ruby-identifier">reset_store</span>=<span class="ruby-keyword kw">false</span>)
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 43</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">reset</span>()
         <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-ivar">@dir</span>, <span class="ruby-node">&quot;*.#{@fail_suffix}&quot;</span>) ).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
           <span class="ruby-constant">File</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">file</span>)
         <span class="ruby-keyword kw">end</span>
@@ -301,11 +336,11 @@ with care!
         </div>
       </div>
 
-      <div id="method-M000027" class="method-detail">
-        <a name="M000027"></a>
+      <div id="method-M000028" class="method-detail">
+        <a name="M000028"></a>
 
         <div class="method-heading">
-          <a href="#M000027" class="method-signature">
+          <a href="#M000028" class="method-signature">
           <span class="method-name">retry_failures</span><span class="method-args">()</span>
           </a>
         </div>
@@ -315,10 +350,10 @@ with care!
 Retry anything known to have failed
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000027-source">
+            onclick="toggleCode('M000028-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000028-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 33</span>
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 32</span>
       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">retry_failures</span>()
         <span class="ruby-identifier">retries</span> = <span class="ruby-identifier">failures</span>()
         <span class="ruby-identifier">retries</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
@@ -333,12 +368,12 @@ Retry anything known to have failed
         </div>
       </div>
 
-      <div id="method-M000026" class="method-detail">
-        <a name="M000026"></a>
+      <div id="method-M000027" class="method-detail">
+        <a name="M000027"></a>
 
         <div class="method-heading">
-          <a href="#M000026" class="method-signature">
-          <span class="method-name">store</span><span class="method-args">()</span>
+          <a href="#M000027" class="method-signature">
+          <span class="method-name">store</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
@@ -348,43 +383,43 @@ Retry anything known to have failed
 directory
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000026-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000026-source">
+            onclick="toggleCode('M000027-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000027-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 24</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store</span>()
-        <span class="ruby-identifier">files_to_store</span> = <span class="ruby-identifier">new_files</span>()
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 23</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">store</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
+        <span class="ruby-identifier">files_to_store</span> = <span class="ruby-identifier">new_files</span>(<span class="ruby-identifier">recursive</span>)
         <span class="ruby-identifier">files_to_store</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">filename</span><span class="ruby-operator">|</span>
           <span class="ruby-identifier">file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">filename</span>)
           <span class="ruby-identifier">store_file</span>(<span class="ruby-identifier">file</span>, <span class="ruby-identifier">filename</span>)
-        <span class="ruby-keyword kw">end</span>    
+        <span class="ruby-keyword kw">end</span>
       <span class="ruby-keyword kw">end</span>
 </pre>
           </div>
         </div>
       </div>
 
-      <div id="method-M000030" class="method-detail">
-        <a name="M000030"></a>
+      <div id="method-M000032" class="method-detail">
+        <a name="M000032"></a>
 
         <div class="method-heading">
-          <a href="#M000030" class="method-signature">
-          <span class="method-name">successes</span><span class="method-args">()</span>
+          <a href="#M000032" class="method-signature">
+          <span class="method-name">successes</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-List <a href="AbstractFileManager.html#M000030">successes</a>
+List <a href="AbstractFileManager.html#M000032">successes</a>
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000030-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000030-source">
+            onclick="toggleCode('M000032-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000032-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 66</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">successes</span>()
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 79</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">successes</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
         <span class="ruby-identifier">successes</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>
-        <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">glob</span>( <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-ivar">@dir</span>, <span class="ruby-value str">&quot;*&quot;</span>) ).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
+        <span class="ruby-identifier">list</span>(<span class="ruby-identifier">recursive</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
           <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">file</span>) <span class="ruby-operator">!=</span> <span class="ruby-node">&quot;.#{@fail_suffix}&quot;</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">extname</span>(<span class="ruby-identifier">file</span>) <span class="ruby-operator">!=</span> <span class="ruby-node">&quot;.#{@ok_suffix}&quot;</span>
              <span class="ruby-identifier">successes</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">file</span> <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>( <span class="ruby-identifier">get_ok_file_for</span>(<span class="ruby-identifier">file</span>) )
           <span class="ruby-keyword kw">end</span>
@@ -396,31 +431,31 @@ List <a href="AbstractFileManager.html#M000030">successes</a>
         </div>
       </div>
 
-      <div id="method-M000031" class="method-detail">
-        <a name="M000031"></a>
+      <div id="method-M000033" class="method-detail">
+        <a name="M000033"></a>
 
         <div class="method-heading">
-          <a href="#M000031" class="method-signature">
-          <span class="method-name">summary</span><span class="method-args">()</span>
+          <a href="#M000033" class="method-signature">
+          <span class="method-name">summary</span><span class="method-args">(recursive=false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Summarize the state of the collection to the provied IO object Creates a
+Summarize the state of the collection to the provided IO object Creates a
 simple report
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000031-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000031-source">
+            onclick="toggleCode('M000033-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000033-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 78</span>
-      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">summary</span>()
-         <span class="ruby-identifier">failures</span> = <span class="ruby-identifier">failures</span>()
-         <span class="ruby-identifier">successes</span> = <span class="ruby-identifier">successes</span>()
-         <span class="ruby-identifier">newfiles</span> = <span class="ruby-identifier">new_files</span>()
+<span class="ruby-comment cmt"># File lib/pho/file_management.rb, line 91</span>
+      <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">summary</span>(<span class="ruby-identifier">recursive</span>=<span class="ruby-keyword kw">false</span>)
+         <span class="ruby-identifier">failures</span> = <span class="ruby-identifier">failures</span>(<span class="ruby-identifier">recursive</span>)
+         <span class="ruby-identifier">successes</span> = <span class="ruby-identifier">successes</span>(<span class="ruby-identifier">recursive</span>)
+         <span class="ruby-identifier">newfiles</span> = <span class="ruby-identifier">new_files</span>(<span class="ruby-identifier">recursive</span>)
          <span class="ruby-identifier">total</span> = <span class="ruby-identifier">failures</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">successes</span>.<span class="ruby-identifier">size</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">newfiles</span>.<span class="ruby-identifier">size</span>
-         <span class="ruby-identifier">summary</span> = <span class="ruby-node">&quot;#{@dir} contains #{total} files: #{successes.size} stored, #{failures.size} failed, #{newfiles.size} new&quot;</span>
+         <span class="ruby-identifier">summary</span> = <span class="ruby-node">&quot;#{@dir} #{recursive ? &quot; and sub-directories&quot; : &quot;&quot;} contains #{total} files: #{successes.size} stored, #{failures.size} failed, #{newfiles.size} new&quot;</span>
          <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">summary</span>     
       <span class="ruby-keyword kw">end</span>
 </pre>