rubu 0.0.1 → 0.0.2

data/doc/Rubu/Walk.html

@@ -73,14 +73,14 @@
   
     <dt class="r1">Inherits:</dt>
     <dd class="r1">
-      <span class="inheritName"><span class='object_link'><a href="Flow.html" title="Rubu::Flow (class)">Flow</a></span></span>
+      <span class="inheritName"><span class='object_link'><a href="Trail.html" title="Rubu::Trail (class)">Trail</a></span></span>
       
         <ul class="fullTree">
           <li>Object</li>
           
-            <li class="next"><span class='object_link'><a href="Action.html" title="Rubu::Action (class)">Action</a></span></li>
+            <li class="next"><span class='object_link'><a href="Move.html" title="Rubu::Move (class)">Move</a></span></li>
           
-            <li class="next"><span class='object_link'><a href="Flow.html" title="Rubu::Flow (class)">Flow</a></span></li>
+            <li class="next"><span class='object_link'><a href="Trail.html" title="Rubu::Trail (class)">Trail</a></span></li>
           
             <li class="next">Rubu::Walk</li>
           
@@ -106,7 +106,7 @@
 <h2>Overview</h2><div class="docstring">
   <div class="discussion">
     
-<p>Serial Flow.</p>
+<p>Serial Trail.</p>
 
 
   </div>
@@ -122,13 +122,13 @@
 
   <h2>Instance Attribute Summary</h2>
   
-  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="Flow.html" title="Rubu::Flow (class)">Flow</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Flow.html#name-instance_method" title="Rubu::Flow#name (method)">#name</a></span></p>
+  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="Trail.html" title="Rubu::Trail (class)">Trail</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Trail.html#name-instance_method" title="Rubu::Trail#name (method)">#name</a></span></p>
 
   
   
-  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="Action.html" title="Rubu::Action (class)">Action</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Action.html#errmsg-instance_method" title="Rubu::Action#errmsg (method)">#errmsg</a></span>, <span class='object_link'><a href="Action.html#output-instance_method" title="Rubu::Action#output (method)">#output</a></span>, <span class='object_link'><a href="Action.html#status-instance_method" title="Rubu::Action#status (method)">#status</a></span>, <span class='object_link'><a href="Action.html#subs-instance_method" title="Rubu::Action#subs (method)">#subs</a></span></p>
+  <h3 class="inherited">Attributes inherited from <span class='object_link'><a href="Move.html" title="Rubu::Move (class)">Move</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Move.html#errmsg-instance_method" title="Rubu::Move#errmsg (method)">#errmsg</a></span>, <span class='object_link'><a href="Move.html#output-instance_method" title="Rubu::Move#output (method)">#output</a></span>, <span class='object_link'><a href="Move.html#status-instance_method" title="Rubu::Move#status (method)">#status</a></span>, <span class='object_link'><a href="Move.html#subs-instance_method" title="Rubu::Move#subs (method)">#subs</a></span></p>
 
 
 
@@ -140,8 +140,8 @@
   
   <h2>Method Summary</h2>
   
-  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Flow.html" title="Rubu::Flow (class)">Flow</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Flow.html#%5B%5D-class_method" title="Rubu::Flow.[] (method)">[]</a></span>, <span class='object_link'><a href="Flow.html#form-class_method" title="Rubu::Flow.form (method)">form</a></span>, <span class='object_link'><a href="Flow.html#initialize-instance_method" title="Rubu::Flow#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Flow.html#load_setup-class_method" title="Rubu::Flow.load_setup (method)">load_setup</a></span>, <span class='object_link'><a href="Flow.html#run-instance_method" title="Rubu::Flow#run (method)">#run</a></span>, <span class='object_link'><a href="Flow.html#run-class_method" title="Rubu::Flow.run (method)">run</a></span>, <span class='object_link'><a href="Flow.html#setup-class_method" title="Rubu::Flow.setup (method)">setup</a></span></p>
+  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Trail.html" title="Rubu::Trail (class)">Trail</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Trail.html#%5B%5D-class_method" title="Rubu::Trail.[] (method)">[]</a></span>, <span class='object_link'><a href="Trail.html#form-class_method" title="Rubu::Trail.form (method)">form</a></span>, <span class='object_link'><a href="Trail.html#initialize-instance_method" title="Rubu::Trail#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Trail.html#load_setup-class_method" title="Rubu::Trail.load_setup (method)">load_setup</a></span>, <span class='object_link'><a href="Trail.html#pick-instance_method" title="Rubu::Trail#pick (method)">#pick</a></span>, <span class='object_link'><a href="Trail.html#run-instance_method" title="Rubu::Trail#run (method)">#run</a></span>, <span class='object_link'><a href="Trail.html#run-class_method" title="Rubu::Trail.run (method)">run</a></span>, <span class='object_link'><a href="Trail.html#setup-class_method" title="Rubu::Trail.setup (method)">setup</a></span></p>
 
   
   
@@ -151,8 +151,8 @@
   
   
   
-  <h3 class="inherited">Methods included from <span class='object_link'><a href="FlowRun.html" title="Rubu::FlowRun (module)">FlowRun</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="FlowRun.html#parallel_run-instance_method" title="Rubu::FlowRun#parallel_run (method)">#parallel_run</a></span>, <span class='object_link'><a href="FlowRun.html#serial_run-instance_method" title="Rubu::FlowRun#serial_run (method)">#serial_run</a></span></p>
+  <h3 class="inherited">Methods included from <span class='object_link'><a href="MoveStyles.html" title="Rubu::MoveStyles (module)">MoveStyles</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="MoveStyles.html#parallel_run-instance_method" title="Rubu::MoveStyles#parallel_run (method)">#parallel_run</a></span>, <span class='object_link'><a href="MoveStyles.html#serial_run-instance_method" title="Rubu::MoveStyles#serial_run (method)">#serial_run</a></span></p>
 
   
   
@@ -162,12 +162,12 @@
   
   
   
-  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Action.html" title="Rubu::Action (class)">Action</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Action.html#display-instance_method" title="Rubu::Action#display (method)">#display</a></span>, <span class='object_link'><a href="Action.html#error-instance_method" title="Rubu::Action#error (method)">#error</a></span>, <span class='object_link'><a href="Action.html#host-instance_method" title="Rubu::Action#host (method)">#host</a></span>, <span class='object_link'><a href="Action.html#host_in-instance_method" title="Rubu::Action#host_in (method)">#host_in</a></span>, <span class='object_link'><a href="Action.html#host_out-instance_method" title="Rubu::Action#host_out (method)">#host_out</a></span>, <span class='object_link'><a href="Action.html#initialize-instance_method" title="Rubu::Action#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Action.html#pick-instance_method" title="Rubu::Action#pick (method)">#pick</a></span>, <span class='object_link'><a href="Action.html#use-instance_method" title="Rubu::Action#use (method)">#use</a></span></p>
+  <h3 class="inherited">Methods inherited from <span class='object_link'><a href="Move.html" title="Rubu::Move (class)">Move</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Move.html#display-instance_method" title="Rubu::Move#display (method)">#display</a></span>, <span class='object_link'><a href="Move.html#error-instance_method" title="Rubu::Move#error (method)">#error</a></span>, <span class='object_link'><a href="Move.html#host-instance_method" title="Rubu::Move#host (method)">#host</a></span>, <span class='object_link'><a href="Move.html#host_in-instance_method" title="Rubu::Move#host_in (method)">#host_in</a></span>, <span class='object_link'><a href="Move.html#host_out-instance_method" title="Rubu::Move#host_out (method)">#host_out</a></span>, <span class='object_link'><a href="Move.html#initialize-instance_method" title="Rubu::Move#initialize (method)">#initialize</a></span>, <span class='object_link'><a href="Move.html#use-instance_method" title="Rubu::Move#use (method)">#use</a></span></p>
 <div id="constructor_details" class="method_details_list">
   <h2>Constructor Details</h2>
   
-    <p class="notice">This class inherits a constructor from <span class='object_link'><a href="Flow.html#initialize-instance_method" title="Rubu::Flow#initialize (method)">Rubu::Flow</a></span></p>
+    <p class="notice">This class inherits a constructor from <span class='object_link'><a href="Trail.html#initialize-instance_method" title="Rubu::Trail#initialize (method)">Rubu::Trail</a></span></p>
   
 </div>
 
@@ -175,7 +175,7 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Jun 29 10:04:07 2018 by
+  Generated on Sun Jul  1 17:48:17 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.3).
 </div>

data/doc/_index.html

@@ -87,20 +87,6 @@
           <li class="letter">A</li>
           <ul>
             
-              <li>
-                <span class='object_link'><a href="Rubu/Action.html" title="Rubu::Action (class)">Action</a></span>
-                
-                  <small>(Rubu)</small>
-                
-              </li>
-            
-              <li>
-                <span class='object_link'><a href="Rubu/AlwaysBuild.html" title="Rubu::AlwaysBuild (class)">AlwaysBuild</a></span>
-                
-                  <small>(Rubu)</small>
-                
-              </li>
-            
               <li>
                 <span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span>
                 
@@ -110,12 +96,12 @@
         </ul>
       
         
-        <ul id="alpha_B" class="alpha">
-          <li class="letter">B</li>
+        <ul id="alpha_F" class="alpha">
+          <li class="letter">F</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/Build.html" title="Rubu::Build (class)">Build</a></span>
+                <span class='object_link'><a href="Rubu/Fork.html" title="Rubu::Fork (class)">Fork</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -125,12 +111,12 @@
         </ul>
       
         
-        <ul id="alpha_D" class="alpha">
-          <li class="letter">D</li>
+        <ul id="alpha_I" class="alpha">
+          <li class="letter">I</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/DateBuild.html" title="Rubu::DateBuild (class)">DateBuild</a></span>
+                <span class='object_link'><a href="Rubu/Info.html" title="Rubu::Info (class)">Info</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -140,26 +126,26 @@
         </ul>
       
         
-        <ul id="alpha_F" class="alpha">
-          <li class="letter">F</li>
+        <ul id="alpha_M" class="alpha">
+          <li class="letter">M</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/Flow.html" title="Rubu::Flow (class)">Flow</a></span>
+                <span class='object_link'><a href="Rubu/Mark.html" title="Rubu::Mark (class)">Mark</a></span>
                 
                   <small>(Rubu)</small>
                 
               </li>
             
               <li>
-                <span class='object_link'><a href="Rubu/FlowRun.html" title="Rubu::FlowRun (module)">FlowRun</a></span>
+                <span class='object_link'><a href="Rubu/Move.html" title="Rubu::Move (class)">Move</a></span>
                 
                   <small>(Rubu)</small>
                 
               </li>
             
               <li>
-                <span class='object_link'><a href="Rubu/Fork.html" title="Rubu::Fork (class)">Fork</a></span>
+                <span class='object_link'><a href="Rubu/MoveStyles.html" title="Rubu::MoveStyles (module)">MoveStyles</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -169,12 +155,12 @@
         </ul>
       
         
-        <ul id="alpha_I" class="alpha">
-          <li class="letter">I</li>
+        <ul id="alpha_O" class="alpha">
+          <li class="letter">O</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/Info.html" title="Rubu::Info (class)">Info</a></span>
+                <span class='object_link'><a href="Rubu/Order.html" title="Rubu::Order (class)">Order</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -184,19 +170,17 @@
         </ul>
       
         
-        <ul id="alpha_M" class="alpha">
-          <li class="letter">M</li>
+        <ul id="alpha_R" class="alpha">
+          <li class="letter">R</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/Mark.html" title="Rubu::Mark (class)">Mark</a></span>
-                
-                  <small>(Rubu)</small>
+                <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span>
                 
               </li>
             
               <li>
-                <span class='object_link'><a href="Rubu/MarkBuild.html" title="Rubu::MarkBuild (class)">MarkBuild</a></span>
+                <span class='object_link'><a href="Rubu/RubyCommand.html" title="Rubu::RubyCommand (class)">RubyCommand</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -206,57 +190,65 @@
         </ul>
       
         
-        <ul id="alpha_O" class="alpha">
-          <li class="letter">O</li>
+        <ul id="alpha_S" class="alpha">
+          <li class="letter">S</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Rubu/Order.html" title="Rubu::Order (class)">Order</a></span>
+                <span class='object_link'><a href="Rubu/ShellCommand.html" title="Rubu::ShellCommand (class)">ShellCommand</a></span>
                 
                   <small>(Rubu)</small>
                 
               </li>
             
-          </ul>
-        </ul>
-      
-        
-          </td><td valign='top' width="33%">
-          
-        
-        <ul id="alpha_R" class="alpha">
-          <li class="letter">R</li>
-          <ul>
+              <li>
+                <span class='object_link'><a href="Rubu/State.html" title="Rubu::State (class)">State</a></span>
+                
+                  <small>(Rubu)</small>
+                
+              </li>
             
               <li>
-                <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span>
+                <span class='object_link'><a href="Rubu/Step.html" title="Rubu::Step (class)">Step</a></span>
+                
+                  <small>(Rubu)</small>
                 
               </li>
             
               <li>
-                <span class='object_link'><a href="Rubu/RubyCommand.html" title="Rubu::RubyCommand (class)">RubyCommand</a></span>
+                <span class='object_link'><a href="Rubu/StepAged.html" title="Rubu::StepAged (class)">StepAged</a></span>
                 
                   <small>(Rubu)</small>
                 
               </li>
             
-          </ul>
-        </ul>
-      
-        
-        <ul id="alpha_S" class="alpha">
-          <li class="letter">S</li>
-          <ul>
+              <li>
+                <span class='object_link'><a href="Rubu/StepAlways.html" title="Rubu::StepAlways (class)">StepAlways</a></span>
+                
+                  <small>(Rubu)</small>
+                
+              </li>
             
               <li>
-                <span class='object_link'><a href="Rubu/ShellCommand.html" title="Rubu::ShellCommand (class)">ShellCommand</a></span>
+                <span class='object_link'><a href="Rubu/StepMark.html" title="Rubu::StepMark (class)">StepMark</a></span>
                 
                   <small>(Rubu)</small>
                 
               </li>
             
+          </ul>
+        </ul>
+      
+        
+          </td><td valign='top' width="33%">
+          
+        
+        <ul id="alpha_T" class="alpha">
+          <li class="letter">T</li>
+          <ul>
+            
               <li>
-                <span class='object_link'><a href="Rubu/State.html" title="Rubu::State (class)">State</a></span>
+                <span class='object_link'><a href="Rubu/Trail.html" title="Rubu::Trail (class)">Trail</a></span>
                 
                   <small>(Rubu)</small>
                 
@@ -304,7 +296,7 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Jun 29 10:04:07 2018 by
+  Generated on Sun Jul  1 17:48:17 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.3).
 </div>

data/doc/class_list.html

@@ -50,7 +50,7 @@
 
       <ul id="full_list" class="class">
         <li><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></li>
-<li><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span> &lt; Object<small class='search_info'>Top Level Namespace</small></li><li><a class='toggle'></a> <span class='object_link'><a href="Rubu.html" title="Rubu (module)">Rubu</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="Rubu/Action.html" title="Rubu::Action (class)">Action</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/AlwaysBuild.html" title="Rubu::AlwaysBuild (class)">AlwaysBuild</a></span> &lt; Build<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Build.html" title="Rubu::Build (class)">Build</a></span> &lt; Action<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/DateBuild.html" title="Rubu::DateBuild (class)">DateBuild</a></span> &lt; Build<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Flow.html" title="Rubu::Flow (class)">Flow</a></span> &lt; Action<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/FlowRun.html" title="Rubu::FlowRun (module)">FlowRun</a></span><small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Fork.html" title="Rubu::Fork (class)">Fork</a></span> &lt; Flow<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Info.html" title="Rubu::Info (class)">Info</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Mark.html" title="Rubu::Mark (class)">Mark</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/MarkBuild.html" title="Rubu::MarkBuild (class)">MarkBuild</a></span> &lt; Build<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Order.html" title="Rubu::Order (class)">Order</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/RubyCommand.html" title="Rubu::RubyCommand (class)">RubyCommand</a></span> &lt; Action<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/ShellCommand.html" title="Rubu::ShellCommand (class)">ShellCommand</a></span> &lt; Action<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/State.html" title="Rubu::State (class)">State</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Var.html" title="Rubu::Var (class)">Var</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Walk.html" title="Rubu::Walk (class)">Walk</a></span> &lt; Flow<small class='search_info'>Rubu</small></li></ul>
+<li><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span> &lt; Object<small class='search_info'>Top Level Namespace</small></li><li><a class='toggle'></a> <span class='object_link'><a href="Rubu.html" title="Rubu (module)">Rubu</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="Rubu/Fork.html" title="Rubu::Fork (class)">Fork</a></span> &lt; Trail<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Info.html" title="Rubu::Info (class)">Info</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Mark.html" title="Rubu::Mark (class)">Mark</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Move.html" title="Rubu::Move (class)">Move</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/MoveStyles.html" title="Rubu::MoveStyles (module)">MoveStyles</a></span><small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Order.html" title="Rubu::Order (class)">Order</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/RubyCommand.html" title="Rubu::RubyCommand (class)">RubyCommand</a></span> &lt; Move<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/ShellCommand.html" title="Rubu::ShellCommand (class)">ShellCommand</a></span> &lt; Move<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/State.html" title="Rubu::State (class)">State</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Step.html" title="Rubu::Step (class)">Step</a></span> &lt; Move<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/StepAged.html" title="Rubu::StepAged (class)">StepAged</a></span> &lt; Step<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/StepAlways.html" title="Rubu::StepAlways (class)">StepAlways</a></span> &lt; Step<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/StepMark.html" title="Rubu::StepMark (class)">StepMark</a></span> &lt; Step<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Trail.html" title="Rubu::Trail (class)">Trail</a></span> &lt; Move<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Var.html" title="Rubu::Var (class)">Var</a></span> &lt; Object<small class='search_info'>Rubu</small></li><li><span class='object_link'><a href="Rubu/Walk.html" title="Rubu::Walk (class)">Walk</a></span> &lt; Trail<small class='search_info'>Rubu</small></li></ul>
 
       </ul>
     </div>

data/doc/file.CHANGELOG.html

@@ -63,14 +63,17 @@
 
     <div id="content"><div id='filecontents'>
 <h1 id="label-Version+history">Version history</h1>
-<dl class="rdoc-list label-list"><dt>0.0.1
+<dl class="rdoc-list label-list"><dt>0.0.2
+<dd>
+<p>Documentation updates. Some name changes to Rubu classes.</p>
+</dd><dt>0.0.1
 <dd>
 <p>Initial version.</p>
 </dd></dl>
 </div></div>
 
     <div id="footer">
-  Generated on Fri Jun 29 10:04:07 2018 by
+  Generated on Sun Jul  1 17:48:17 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.3).
 </div>

data/doc/file.README.html

@@ -69,7 +69,7 @@ is in practice a replacement for Make and Rake type of tools. <span class='objec
 targeted to provide means for creating flexible build environments.</p>
 
 <p>Make and Rake are rule and recipe based, and they are very effective when
-the build process can be captured to these rules and are fairly fixed.
+the build process can be captured to these rules and is fairly fixed.
 <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> includes declarations which correspond to rules, but the
 declarations are lower level and provide more control over the behavior.
 <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> also provides direct control over when the rules are executed.</p>
@@ -77,16 +77,16 @@ declarations are lower level and provide more control over the behavior.
 <p>Make and Rake are more compact for the simplest build environments, but
 there is a break-even point where <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> becomes more convenient. This is
 likely to happen when the user needs many exceptions to basic rules, also
-when other tasks than just build task are needed.</p>
+when other tasks than just build tasks are needed.</p>
 
 <p><span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> library can be used from any Ruby program, since it is just a
 library. It can also be part of a larger program as less significant part
 of the overall functionality. From maintenance point of view this can be a
 win in many cases.</p>
 
-<h2 id="label-Concepts">Concepts</h2>
-
-<p>TBD</p>
+<p>The easiest way to get started with <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> is to study examples (See:
+“Example” chapter below). However for longer term the main concepts are
+important as well (See: “Concepts” chapter below).</p>
 
 <h2 id="label-Example">Example</h2>
 
@@ -99,7 +99,7 @@ win in many cases.</p>
 files. The main file is hand written and the other file is generated with a
 script. File generation is part of the build program.</p>
 
-<p>Various executions of the build is captured in:</p>
+<p>Different execution variations of the build program is captured in:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_example'>example</span><span class='op'>/</span><span class='id identifier rubyid_runme'>runme</span>
 </code></pre>
@@ -111,20 +111,267 @@ script. File generation is part of the build program.</p>
 <span class='id identifier rubyid_runme'>runme</span>
 </code></pre>
 
-<p>Also take a look into the build program:</p>
+<p>Also take a look into the build program itself:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_cat'>cat</span> <span class='id identifier rubyid_example'>example</span><span class='op'>/</span><span class='id identifier rubyid_bin'>bin</span><span class='op'>/</span><span class='id identifier rubyid_rubu_example'>rubu_example</span>
 </code></pre>
 
 <p>There are comments which highlight purpose of the build program content.</p>
 
+<h2 id="label-Concepts">Concepts</h2>
+
+<p><span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> Build Program, RBP, is a Ruby program that uses the <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> library.
+Typically command line options are accepted to give options for the build
+process.</p>
+
+<p>Build programs are about collecting source files and transforming them into
+targets. This process is explicit in <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span>. Each file, whether it&#39;s
+source or target, is collected within the <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> build program. The files
+are converted into <strong>Mark</strong> objects. Basically
+<strong>Mark</strong> corresponds to a file, but it includes methods that
+make the build process convenient.</p>
+
+<p><strong>Step</strong> is build action that transforms source file(s) to
+target file(s). For example, a C source file compilation is a
+<strong>Step</strong> where one source file is converted to a corresponding
+object file. <strong>Step</strong> is given source <strong>Mark</strong>
+and target <strong>Mark</strong> as arguments. Hence this type of
+<strong>Step</strong> a is one-to-one mapping.</p>
+
+<p>Linking multiple objects to an executable is a many-to-one mapping. This is
+performed by a <strong>Step</strong> where there are multiple sources and
+one target, i.e. objects and the executable respectively.</p>
+
+<p><strong>Step</strong> class (or object) has “step” method which includes
+the <strong>Move</strong> that is needed to create the target.
+<strong>Move</strong> is either a Shell or a Ruby command.
+<strong>Move</strong> is executed only if necessary. Typically the
+<strong>Step</strong> is sensitive to source being newer that the target,
+just as with Make and Rake. However, it is possible to have a
+<strong>Step</strong> that is sensitive to file content, for example.
+Timestamp might change, but if the content is the same as previously, no
+<strong>Move</strong> is made.</p>
+
+<p><strong>Step</strong> is typically a simple command. In some cases
+<strong>Step</strong> can include multiple <strong>Moves</strong>. These
+can be performed in sequence or in parallel, with a multicore CPU.</p>
+
+<p><strong>Trail</strong> is a collection of <strong>Steps</strong>.
+<strong>Trail</strong> has a name, and it can be references by another
+<strong>Trail</strong>. <strong>Trail</strong> can be sequential or
+parallel. For example, C source to object compilation can be done in
+parallel, but linking of objects to executable must occur after all objects
+have been created.</p>
+
+<p><span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> Build Program includes all of the above, and the last step is to
+select which <strong>Trail</strong> is executed. There should be at least
+“default” <strong>Trail</strong>, and typically there is also a “clean”
+<strong>Trail</strong>.</p>
+
+<p><span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> supports the configuration spaces: <strong>Order</strong>,
+<strong>Var</strong>, and <strong>Info</strong>. <strong>Order</strong> is
+meant to be used for controlling <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> itself. For example if user wants
+to see all executed command, then “verbose” option should be selected.</p>
+
+<p><strong>Var</strong> is used to control how <strong>Steps</strong> behave
+and also details of <strong>Move</strong> internals. <strong>Info</strong>
+is meant for runtime generated information. The division is semantic and
+user might choose to combine everything to <strong>Var</strong> space, for
+example.</p>
+
+<p>To summarize and highlight the relationships between concepts, see the
+diagram below:</p>
+
+<pre class="code ruby"><code class="ruby">RBP =&gt; Trial+ =&gt; Step+ [s/p] =&gt; Move+ [s/p] =&gt; Source*, Target*
+    =&gt; Order+
+    =&gt; Var*
+    =&gt; Info*
+
+* = Zero or more
++ = One or more
+s = Serial
+p = Parallel</code></pre>
+
+<p>RBP includes <strong>Trials</strong>, <strong>Orders</strong>, and possibly
+<strong>Vars</strong> and <strong>Infos</strong>. <strong>Trial</strong>
+includes one or more <strong>Steps</strong>, which can be executed in
+sequence or in parallel.</p>
+
+<p><strong>Step</strong> includes one or more <strong>Moves</strong>, and they
+can also be sequential or parallel. <strong>Move</strong> has typically at
+least one <strong>Source</strong> and at least one <strong>Target</strong>.
+However, there are exceptions as well.</p>
+
+<p>The suggested ordering within <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> Build Program is:</p>
+<dl class="rdoc-list label-list"><dt>configuration
+<dd>
+<p>Process command line arguments and assign options that are used to control
+the build process.</p>
+</dd><dt>file collection
+<dd>
+<p>Collect source and target files either using Ruby with glob pattern, direct
+references, or through manifest files. Convert file names to
+<strong>Mark</strong> objects.</p>
+</dd><dt>step definition
+<dd>
+<p>Define <strong>Steps</strong>. Inherit one of the <strong>Step</strong>
+types (classes) and define at least the “step” method.</p>
+</dd><dt>trail definition
+<dd>
+<p>Define <strong>Trails</strong>. Create all possible flows that user wants
+to execute. Use hierarchy for your benefit in order to make RBP maintenance
+as light as possible.</p>
+</dd><dt>trail selection
+<dd>
+<p>Find the selected <strong>Trail</strong> or <strong>Trails</strong> and
+execute.</p>
+</dd></dl>
+
+<h2 id="label-Configuration">Configuration</h2>
+
+<p><strong>Order</strong> space default are set by the <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> library and user
+can override the default based on command line parameters if needed.</p>
+
+<p>Set default values for <strong>Var</strong> space. After default setting,
+override the defaults with possible control from command line arguments.</p>
+
+<p>Finally setup <strong>Trails</strong> by calling:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='const'>Trail</span><span class='period'>.</span><span class='id identifier rubyid_setup'>setup</span>
+</code></pre>
+
+<h2 id="label-File+collection">File collection</h2>
+
+<p>If the build environment has clear and clean directory structure, it is
+typically easiest to collect files programmatically. For example, to get
+all C source files:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_cee_files'>cee_files</span> <span class='op'>=</span> <span class='const'>Mark</span><span class='period'>.</span><span class='id identifier rubyid_glob'>glob</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='const'>Var</span><span class='lbracket'>[</span><span class='symbol'>:source_dir</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'>/*.c</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
+</code></pre>
+
+<p>This creates a list of <strong>Mark</strong> objects which are source
+files. The corresponding object files can be created with “peer” method:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_obj_files'>obj_files</span> <span class='op'>=</span> <span class='id identifier rubyid_cee_files'>cee_files</span><span class='period'>.</span><span class='id identifier rubyid_peer'>peer</span><span class='lparen'>(</span> <span class='const'>Var</span><span class='lbracket'>[</span> <span class='symbol'>:build_dir</span> <span class='rbracket'>]</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.o</span><span class='tstring_end'>&#39;</span></span> <span class='rparen'>)</span>
+</code></pre>
+
+<p>This method invocation takes an Array of <strong>Mark</strong> objects and
+calls “peer” method for them. “peer” method changes the directory and
+extension, and returns a new <strong>Mark</strong> object. In some cases
+also the “basename” of the file is changed. This is achieved by giving the
+“peer” method a third argument specifying the new “basename”.</p>
+
+<h2 id="label-Step+definition">Step definition</h2>
+
+<p><strong>Step</strong> is defined by inheriting of the <span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span>
+<strong>Step</strong> classes and defining the custom “step” method. If a
+specific setup for the <strong>Step</strong> is required, then an
+additional “setup” method can be defined as well.</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>CleanUp</span> <span class='op'>&lt;</span> <span class='const'>StepAlways</span>
+    <span class='kw'>def</span> <span class='id identifier rubyid_step'>step</span>
+        <span class='id identifier rubyid_shrun'>shrun</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>rm -f </span><span class='embexpr_beg'>#{</span><span class='const'>Var</span><span class='lbracket'>[</span> <span class='symbol'>:build_dir</span> <span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'>/*.o</span><span class='tstring_end'>&quot;</span></span>
+    <span class='kw'>end</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>“setup” method is typically used to change the command according to user
+configuration. “step” method is the action for <strong>Step</strong>.
+<span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> executes it, if necessary. For example, if <strong>Step</strong> is
+a <strong>StepAged</strong> class, then the “step” method is only called if
+the source <strong>Mark</strong> is newer than the target
+<strong>Mark</strong>.</p>
+
+<p>“step” method may include only one command or a set of commands. If one
+command is needed, it can be simply executed:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_step'>step</span>
+    <span class='id identifier rubyid_shrun'>shrun</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>rm -f </span><span class='embexpr_beg'>#{</span><span class='const'>Var</span><span class='lbracket'>[</span> <span class='symbol'>:build_dir</span> <span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'>/*.o</span><span class='tstring_end'>&quot;</span></span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>If there are multiple commands, then the commands can be grouped for
+sequential (“walk”) or parallel execution (“fork”).</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>def</span> <span class='id identifier rubyid_step'>step</span>
+    <span class='id identifier rubyid_fork'>fork</span> <span class='kw'>do</span>
+        <span class='id identifier rubyid_shuse'>shuse</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>rm -f </span><span class='embexpr_beg'>#{</span><span class='const'>Info</span><span class='lbracket'>[</span> <span class='symbol'>:gen_files</span> <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_rpath'>rpath</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
+        <span class='id identifier rubyid_shuse'>shuse</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>rm -f </span><span class='embexpr_beg'>#{</span><span class='const'>Var</span><span class='lbracket'>[</span> <span class='symbol'>:build_dir</span> <span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'>/*.o</span><span class='tstring_end'>&quot;</span></span>
+    <span class='kw'>end</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>Note that the commands are defined with “shuse”. The logic is that we
+don&#39;t execute the commands right away as in “shrun”. Instead we just
+register the commands to the group. When the group definition is closed
+(“end” keyword), it is complete, and we execute it either sequentially or
+in parallel.</p>
+
+<h2 id="label-Trail+definition">Trail definition</h2>
+
+<p><strong>Trail</strong> is a collection of <strong>Steps</strong> or other
+<strong>Trails</strong>, or a mix of both. For example, in order to compile
+a set of C source files to object files, we might define:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='const'>Fork</span><span class='period'>.</span><span class='id identifier rubyid_form'>form</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>compile-cee</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>do</span>
+    <span class='const'>GccCompileFile</span><span class='period'>.</span><span class='id identifier rubyid_usezip'>usezip</span><span class='lparen'>(</span> <span class='id identifier rubyid_cee_files'>cee_files</span><span class='comma'>,</span> <span class='id identifier rubyid_obj_files'>obj_files</span> <span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>This creates a parallel (“Fork”) <strong>Trail</strong> called
+“compile-cee”. Collection of <strong>Steps</strong> is created with
+“usezip” method. “usezip” performs two operations: it creates a zip type
+mix of “cee_files” and “obj_files”. The “zip” method of Ruby Array is used.
+“zip” creates an Array of <strong>Mark</strong> pairs. Each pair is passed
+to a “GccCompileFile” <strong>Step</strong> object. Finally we have a
+collection of <strong>Steps</strong> which are executed in parallel when
+“compile-cee” is invoked.</p>
+
+<p>Here the defined <strong>Trail</strong> from above is referenced in order
+to create a <strong>Trail</strong> for the complete compile flow:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='const'>Walk</span><span class='period'>.</span><span class='id identifier rubyid_form'>form</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>default</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>do</span>
+    <span class='id identifier rubyid_pick'>pick</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>compile-cee</span><span class='tstring_end'>&#39;</span></span>
+    <span class='const'>GccLinkExe</span><span class='period'>.</span><span class='id identifier rubyid_use'>use</span><span class='lparen'>(</span> <span class='id identifier rubyid_obj_files'>obj_files</span><span class='comma'>,</span> <span class='id identifier rubyid_exe_file'>exe_file</span> <span class='rparen'>)</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>This <strong>Trail</strong> definition defines that we want to first
+execute “compile-cee” and then a <strong>Step</strong> which will create an
+executable from object file collection. “GccLinkExe” <strong>Step</strong>
+is called with “use” method, which will register the <strong>Step</strong>
+to the enclosing <strong>Trail</strong>, “default”.</p>
+
+<h2 id="label-Trail+selection">Trail selection</h2>
+
+<p>The final stage in RBP execution is to use command line control for
+selecting the executed <strong>Trails</strong> and then execute them. The
+above definition (from previous section) is executed with:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='const'>Trail</span><span class='period'>.</span><span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>default</span><span class='tstring_end'>&#39;</span></span> <span class='rparen'>)</span>
+</code></pre>
+
+<h2 id="label-Final+notes">Final notes</h2>
+
+<p><span class='object_link'><a href="Rubu.html" title="Rubu (class)">Rubu</a></span> treats single <strong>Mark</strong> objects and Array of
+<strong>Mark</strong> objects the “same” way. In practice this means that
+the most common methods for <strong>Mark</strong> objects are implemented
+for Array as well. Hence, you can call a <strong>Mark</strong> method for
+an Array, and they will actually be applied for each individual
+<strong>Mark</strong> in the collection.</p>
+
+<p><strong>Step</strong> has sources and targets. Even if a step has only one
+source and one target, the actual container is an Array. If you want to
+refer to the source, i.e. the only existing source, you can use the
+“source” method. Same applies to targets (i.e. use the “target” method).</p>
+
 <h2 id="label-Testing">Testing</h2>
 
 <p>For this version, example is the testcase.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Fri Jun 29 10:04:07 2018 by
+  Generated on Sun Jul  1 17:48:17 2018 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.3).
 </div>