RubyGems - como - Versions diffs - 0.1.4 → 0.1.5 - Mend

como 0.1.4 → 0.1.5

Files changed (28) hide show

checksums.yaml +4 -4
data/CHANGELOG.rdoc +4 -0
data/doc/Como/ArgsParseState.html +53 -53
data/doc/Como/ComoCommon.html +4 -4
data/doc/Como/MainOpt.html +51 -51
data/doc/Como/Opt/ErrorWithData.html +4 -4
data/doc/Como/Opt/InvalidOption.html +4 -4
data/doc/Como/Opt/MissingArgument.html +4 -4
data/doc/Como/Opt.html +913 -511
data/doc/Como/RuleCheck.html +89 -89
data/doc/Como/RuleDisplay.html +84 -84
data/doc/Como/Spec.html +16 -16
data/doc/Como.html +129 -123
data/doc/_index.html +5 -5
data/doc/class_list.html +6 -1
data/doc/css/style.css +2 -1
data/doc/file.CHANGELOG.html +27 -23
data/doc/file.README.html +10 -10
data/doc/file_list.html +6 -1
data/doc/frames.html +5 -7
data/doc/index.html +10 -10
data/doc/js/app.js +7 -2
data/doc/js/full_list.js +9 -6
data/doc/method_list.html +167 -132
data/doc/top-level-namespace.html +4 -4
data/lib/como.rb +41 -11
data/lib/version.rb +1 -1
metadata +2 -2

data/doc/Como/Opt.html CHANGED Viewed

@@ -6,7 +6,7 @@
 <title>
   Class: Como::Opt
-    &mdash; Documentation by YARD 0.8.6.1
+    &mdash; Documentation by YARD 0.8.7.6
 </title>
@@ -17,7 +17,7 @@
 <script type="text/javascript" charset="utf-8">
   hasFrames = window.top.frames.main ? true : false;
   relpath = '../';
-  framesUrl = "../frames.html#!" + escape(window.location.href);
+  framesUrl = "../frames.html#!Como/Opt.html";
 </script>
@@ -105,9 +105,9 @@
   <div class="discussion">
 <p>Opt includes all options spec information and parsed options and their
-values. Option instance is accessed with "<a href="http://'name'">Opt</a>".
-The option status (Opt instance) can be queried with for example "given"
-and "value" methods.</p>
+values. Option instance is accessed with “<a href="'name'">Opt</a>”. The
+option status (Opt instance) can be queried with for example “given” and
+“value” methods.</p>
   </div>
@@ -277,7 +277,7 @@ and "value" methods.</p>
       <li class="public ">
   <span class="summary_signature">
-      <a href="#given-instance_method" title="#given (instance method)">- (Object) <strong>given</strong>(yieldOpt = false, &amp;prog) </a>
+      <a href="#given-instance_method" title="#given (instance method)">- (Object) <strong>given</strong>(optArg = false, &amp;prog) </a>
@@ -826,6 +826,30 @@ and "value" methods.</p>
 <p>Options iterator for given options.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#error-class_method" title="error (class method)">+ (Object) <strong>error</strong>(str, nl = false) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Issue non-fatal user error.</p>
+</div></span>
 </li>
@@ -848,7 +872,31 @@ and "value" methods.</p>
     <span class="summary_desc"><div class='inline'>
 <p>Return arguments (options) that are specified as command external (i.e.
-after '--').</p>
+after &#39;–&#39;).</p>
+</div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#fatal-class_method" title="fatal (class method)">+ (Object) <strong>fatal</strong>(str) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Issue fatal user error.</p>
 </div></span>
 </li>
@@ -968,7 +1016,7 @@ after '--').</p>
     <span class="summary_desc"><div class='inline'>
-<p>Reset "dynamic" class members.</p>
+<p>Reset “dynamic” class members.</p>
 </div></span>
 </li>
@@ -1043,6 +1091,30 @@ after '--').</p>
 <p>Create sub-command option spec.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#warn-class_method" title="warn (class method)">+ (Object) <strong>warn</strong>(str, nl = false) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Issue user warning.</p>
+</div></span>
 </li>
@@ -1485,6 +1557,30 @@ subcommands.</p>
 <p>Como error printout with pre-newline.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#evalCheck-instance_method" title="#evalCheck (instance method)">- (Object) <strong>evalCheck</strong>(&amp;check) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Custom check for the option.</p>
+</div></span>
 </li>
@@ -1748,7 +1844,7 @@ subcommands.</p>
     <span class="summary_desc"><div class='inline'>
-<p>Option's opt id.</p>
+<p>Option&#39;s opt id.</p>
 </div></span>
 </li>
@@ -1868,7 +1964,7 @@ subcommands.</p>
     <span class="summary_desc"><div class='inline'>
-<p>Set optional footer for "usage".</p>
+<p>Set optional footer for “usage”.</p>
 </div></span>
 </li>
@@ -1892,7 +1988,7 @@ subcommands.</p>
     <span class="summary_desc"><div class='inline'>
-<p>Set optional header for "usage".</p>
+<p>Set optional header for “usage”.</p>
 </div></span>
 </li>
@@ -2063,6 +2159,30 @@ subcommands.</p>
 <p>Usage info for Opt:s.</p>
 </div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#warn-instance_method" title="#warn (instance method)">- (Object) <strong>warn</strong>(str, nl = false) </a>
+  </span>
+    <span class="summary_desc"><div class='inline'>
+<p>Como warning printout.</p>
+</div></span>
 </li>
@@ -2238,38 +2358,38 @@ subcommands.</p>
       <pre class="lines">
-1100
-1101
-1102
-1103
-1104
-1105
-1106
-1107
-1108
-1109
-1110
-1111
-1112
-1113
-1114
-1115
-1116
 1117
 1118
 1119
 1120
 1121
-1122</pre>
+1122
+1123
+1124
+1125
+1126
+1127
+1128
+1129
+1130
+1131
+1132
+1133
+1134
+1135
+1136
+1137
+1138
+1139</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1100</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1117</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_type'>type</span><span class='comma'>,</span> <span class='id identifier rubyid_doc'>doc</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
     <span class='ivar'>@parent</span> <span class='op'>=</span> <span class='kw'>nil</span>
     <span class='ivar'>@name</span> <span class='op'>=</span> <span class='id identifier rubyid_name'>name</span>
     <span class='ivar'>@shortOpt</span> <span class='op'>=</span> <span class='id identifier rubyid_opt'>opt</span>
-    <span class='ivar'>@longOpt</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>--</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+    <span class='ivar'>@longOpt</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>--</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
     <span class='ivar'>@type</span> <span class='op'>=</span> <span class='id identifier rubyid_type'>type</span>
     <span class='ivar'>@value</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
@@ -2326,12 +2446,12 @@ subcommands.</p>
       <pre class="lines">
-1079
-1080
-1081</pre>
+1096
+1097
+1098</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1079</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1096</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_config'>config</span>
   <span class='ivar'>@config</span>
@@ -2369,12 +2489,12 @@ subcommands.</p>
       <pre class="lines">
-1067
-1068
-1069</pre>
+1084
+1085
+1086</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1067</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1084</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_doc'>doc</span>
   <span class='ivar'>@doc</span>
@@ -2389,7 +2509,7 @@ subcommands.</p>
       <div class="method_details ">
   <h3 class="signature " id="given-instance_method">
-    - (<tt>Object</tt>) <strong>given</strong>(yieldOpt = false, &amp;prog)
+    - (<tt>Object</tt>) <strong>given</strong>(optArg = false, &amp;prog)
@@ -2415,7 +2535,7 @@ given.</p>
     <li>
-        <span class='name'>yieldOpt</span>
+        <span class='name'>optArg</span>
         <span class='type'>(<tt>Boolean</tt>)</span>
@@ -2440,29 +2560,29 @@ given.</p>
       <pre class="lines">
-1526
-1527
-1528
-1529
-1530
-1531
-1532
-1533
-1534
-1535
-1536
-1537
-1538
-1539
-1540</pre>
+1543
+1544
+1545
+1546
+1547
+1548
+1549
+1550
+1551
+1552
+1553
+1554
+1555
+1556
+1557</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1526</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1543</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_given'>given</span><span class='lparen'>(</span> <span class='id identifier rubyid_yieldOpt'>yieldOpt</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_prog'>prog</span> <span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_given'>given</span><span class='lparen'>(</span> <span class='id identifier rubyid_optArg'>optArg</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_prog'>prog</span> <span class='rparen'>)</span>
     <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
         <span class='kw'>if</span> <span class='ivar'>@given</span>
-            <span class='kw'>if</span> <span class='id identifier rubyid_yieldOpt'>yieldOpt</span>
+            <span class='kw'>if</span> <span class='id identifier rubyid_optArg'>optArg</span>
                 <span class='kw'>yield</span><span class='lparen'>(</span> <span class='kw'>self</span> <span class='rparen'>)</span>
             <span class='kw'>else</span>
                 <span class='kw'>yield</span><span class='lparen'>(</span> <span class='ivar'>@value</span> <span class='rparen'>)</span>
@@ -2507,12 +2627,12 @@ given.</p>
       <pre class="lines">
-1058
-1059
-1060</pre>
+1075
+1076
+1077</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1058</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1075</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_longOpt'>longOpt</span>
   <span class='ivar'>@longOpt</span>
@@ -2550,12 +2670,12 @@ given.</p>
       <pre class="lines">
-1052
-1053
-1054</pre>
+1069
+1070
+1071</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1052</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1069</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_name'>name</span>
   <span class='ivar'>@name</span>
@@ -2593,12 +2713,12 @@ given.</p>
       <pre class="lines">
-1048
-1049
-1050</pre>
+1065
+1066
+1067</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1048</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1065</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_parent'>parent</span>
   <span class='ivar'>@parent</span>
@@ -2636,12 +2756,12 @@ given.</p>
       <pre class="lines">
-1082
-1083
-1084</pre>
+1099
+1100
+1101</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1082</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1099</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_rules'>rules</span>
   <span class='ivar'>@rules</span>
@@ -2679,12 +2799,12 @@ given.</p>
       <pre class="lines">
-1055
-1056
-1057</pre>
+1072
+1073
+1074</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1055</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1072</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_shortOpt'>shortOpt</span>
   <span class='ivar'>@shortOpt</span>
@@ -2722,12 +2842,12 @@ given.</p>
       <pre class="lines">
-1076
-1077
-1078</pre>
+1093
+1094
+1095</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1076</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1093</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_subcmd'>subcmd</span>
   <span class='ivar'>@subcmd</span>
@@ -2765,12 +2885,12 @@ given.</p>
       <pre class="lines">
-1073
-1074
-1075</pre>
+1090
+1091
+1092</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1073</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1090</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_subopt'>subopt</span>
   <span class='ivar'>@subopt</span>
@@ -2808,12 +2928,12 @@ given.</p>
       <pre class="lines">
-1061
-1062
-1063</pre>
+1078
+1079
+1080</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1061</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1078</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_type'>type</span>
   <span class='ivar'>@type</span>
@@ -2851,12 +2971,12 @@ given.</p>
       <pre class="lines">
-1064
-1065
-1066</pre>
+1081
+1082
+1083</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1064</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1081</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_value'>value</span>
   <span class='ivar'>@value</span>
@@ -2926,7 +3046,7 @@ list of all options.</p>
     <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
         <span class='id identifier rubyid_ret'>ret</span> <span class='op'>=</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
         <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
-            <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; does not exist...</span><span class='tstring_end'>&quot;</span></span>
+            <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot; does not exist...</span><span class='tstring_end'>&quot;</span></span>
         <span class='kw'>end</span>
     <span class='kw'>end</span>
@@ -3114,7 +3234,7 @@ list of all options.</p>
   <div class="discussion">
 <p>Set default config for Como options. User can manipulate the defaults with
-"preHook".</p>
+“preHook”.</p>
   </div>
@@ -3346,6 +3466,47 @@ list of all options.</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="error-class_method">
+    + (<tt>Object</tt>) <strong>error</strong>(str, nl = false)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Issue non-fatal user error. See <span class='object_link'><a href="#error-instance_method" title="Como::Opt#error (method)">#error</a></span>.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+1043
+1044
+1045</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1043</span>
+<span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='rparen'>)</span>
+    <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_main'>main</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -3361,7 +3522,7 @@ list of all options.</p>
   <div class="discussion">
 <p>Return arguments (options) that are specified as command external (i.e.
-after '--').</p>
+after &#39;–&#39;).</p>
   </div>
@@ -3388,6 +3549,47 @@ after '--').</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="fatal-class_method">
+    + (<tt>Object</tt>) <strong>fatal</strong>(str)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Issue fatal user error. See <span class='object_link'><a href="#fatal-instance_method" title="Como::Opt#fatal (method)">#fatal</a></span>.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+1049
+1050
+1051</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1049</span>
+<span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_fatal'>fatal</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
+    <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_main'>main</span><span class='period'>.</span><span class='id identifier rubyid_fatal'>fatal</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -3576,7 +3778,7 @@ after '--').</p>
 </h3><div class="docstring">
   <div class="discussion">
-<p>Reset "dynamic" class members.</p>
+<p>Reset “dynamic” class members.</p>
   </div>
@@ -3728,6 +3930,47 @@ after '--').</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="warn-class_method">
+    + (<tt>Object</tt>) <strong>warn</strong>(str, nl = false)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Issue user warning. See <span class='object_link'><a href="#warn-instance_method" title="Como::Opt#warn (method)">#warn</a></span>.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+1055
+1056
+1057</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1055</span>
+<span class='kw'>def</span> <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='rparen'>)</span>
+    <span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_main'>main</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -3803,21 +4046,21 @@ after '--').</p>
       <pre class="lines">
-1452
-1453
-1454
-1455
-1456
-1457
-1458</pre>
+1469
+1470
+1471
+1472
+1473
+1474
+1475</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1452</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1469</span>
 <span class='kw'>def</span> <span class='op'>[]</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_ret'>ret</span> <span class='op'>=</span> <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='kw'>unless</span> <span class='id identifier rubyid_ret'>ret</span>
-        <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subopt \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; does not exist for \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;!</span><span class='tstring_end'>&quot;</span></span>
+        <span class='id identifier rubyid_raise'>raise</span> <span class='const'>RuntimeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subopt \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot; does not exist for \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;!</span><span class='tstring_end'>&quot;</span></span>
     <span class='kw'>end</span>
     <span class='id identifier rubyid_ret'>ret</span>
 <span class='kw'>end</span></pre>
@@ -3872,13 +4115,13 @@ after '--').</p>
       <pre class="lines">
-1142
-1143
-1144
-1145</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1142</span>
+1159
+1160
+1161
+1162</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1159</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_addOption'>addOption</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_opt'>opt</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span> <span class='op'>=</span> <span class='kw'>self</span>
@@ -3935,13 +4178,13 @@ after '--').</p>
       <pre class="lines">
-1151
-1152
-1153
-1154</pre>
+1168
+1169
+1170
+1171</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1151</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1168</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_addSubcmd'>addSubcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_cmd'>cmd</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_cmd'>cmd</span><span class='period'>.</span><span class='id identifier rubyid_parent'>parent</span> <span class='op'>=</span> <span class='kw'>self</span>
@@ -3965,7 +4208,7 @@ after '--').</p>
   <div class="discussion">
 <p>Return option value if given otherwise the default. Example usage: fileName
-= <a href="http://"file"">Opt</a>.apply( "no_name.txt" )</p>
+= <a href=""file"">Opt</a>.apply( “no_name.txt” )</p>
   </div>
@@ -3979,20 +4222,20 @@ after '--').</p>
       <pre class="lines">
-1507
-1508
-1509
-1510
-1511
-1512
-1513
-1514
-1515
-1516
-1517</pre>
+1524
+1525
+1526
+1527
+1528
+1529
+1530
+1531
+1532
+1533
+1534</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1507</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1524</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_apply'>apply</span><span class='lparen'>(</span> <span class='id identifier rubyid_default'>default</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
     <span class='kw'>if</span> <span class='id identifier rubyid_given'>given</span>
@@ -4056,12 +4299,12 @@ after '--').</p>
       <pre class="lines">
-1160
-1161
-1162</pre>
+1177
+1178
+1179</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1160</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1177</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_applyConfig'>applyConfig</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
     <span class='ivar'>@config</span><span class='period'>.</span><span class='id identifier rubyid_merge!'>merge!</span><span class='lparen'>(</span> <span class='id identifier rubyid_config'>config</span> <span class='rparen'>)</span>
@@ -4097,26 +4340,26 @@ after '--').</p>
       <pre class="lines">
-1598
-1599
-1600
-1601
-1602
-1603
-1604
-1605
-1606
-1607
-1608
-1609
-1610
-1611
-1612
-1613
-1614</pre>
+1615
+1616
+1617
+1618
+1619
+1620
+1621
+1622
+1623
+1624
+1625
+1626
+1627
+1628
+1629
+1630
+1631</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1598</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1615</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_argById'>argById</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span> <span class='op'>||</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='symbol'>:default</span>
@@ -4166,26 +4409,26 @@ after '--').</p>
       <pre class="lines">
-1578
-1579
-1580
-1581
-1582
-1583
-1584
-1585
-1586
-1587
-1588
-1589
-1590
-1591
-1592
-1593
-1594</pre>
+1595
+1596
+1597
+1598
+1599
+1600
+1601
+1602
+1603
+1604
+1605
+1606
+1607
+1608
+1609
+1610
+1611</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1578</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1595</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span> <span class='op'>||</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='symbol'>:default</span>
@@ -4235,23 +4478,6 @@ after '--').</p>
       <pre class="lines">
-1177
-1178
-1179
-1180
-1181
-1182
-1183
-1184
-1185
-1186
-1187
-1188
-1189
-1190
-1191
-1192
-1193
 1194
 1195
 1196
@@ -4276,10 +4502,27 @@ after '--').</p>
 1215
 1216
 1217
-1218</pre>
+1218
+1219
+1220
+1221
+1222
+1223
+1224
+1225
+1226
+1227
+1228
+1229
+1230
+1231
+1232
+1233
+1234
+1235</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1177</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1194</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span> <span class='id identifier rubyid_argsState'>argsState</span> <span class='rparen'>)</span>
@@ -4424,21 +4667,21 @@ after '--').</p>
       <pre class="lines">
-1432
-1433
-1434
-1435
-1436
-1437
-1438
-1439
-1440
-1441
-1442
-1443</pre>
+1449
+1450
+1451
+1452
+1453
+1454
+1455
+1456
+1457
+1458
+1459
+1460</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1432</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1449</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_checkAlso'>checkAlso</span><span class='lparen'>(</span> <span class='id identifier rubyid_opt'>opt</span><span class='comma'>,</span> <span class='id identifier rubyid_error'>error</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
     <span class='kw'>begin</span>
@@ -4497,23 +4740,6 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1352
-1353
-1354
-1355
-1356
-1357
-1358
-1359
-1360
-1361
-1362
-1363
-1364
-1365
-1366
-1367
-1368
 1369
 1370
 1371
@@ -4548,17 +4774,34 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
 1400
 1401
 1402
-1403</pre>
+1403
+1404
+1405
+1406
+1407
+1408
+1409
+1410
+1411
+1412
+1413
+1414
+1415
+1416
+1417
+1418
+1419
+1420</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1352</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1369</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_checkMissing'>checkMissing</span>
     <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span> <span class='symbol'>:check_missing</span> <span class='rbracket'>]</span>
     <span class='comment'># Full cmd name.
-</span>    <span class='id identifier rubyid_cmd'>cmd</span> <span class='op'>=</span> <span class='lparen'>(</span> <span class='id identifier rubyid_getParents'>getParents</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'> </span><span class='tstring_end'>'</span></span> <span class='rparen'>)</span>
+</span>    <span class='id identifier rubyid_cmd'>cmd</span> <span class='op'>=</span> <span class='lparen'>(</span> <span class='id identifier rubyid_getParents'>getParents</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'> </span><span class='tstring_end'>&#39;</span></span> <span class='rparen'>)</span>
     <span class='comment'># Check for any exclusive args first.
 </span>    <span class='ivar'>@subopt</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
@@ -4574,7 +4817,7 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
         <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isRequired'>isRequired</span>
             <span class='kw'>unless</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
                 <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-                    <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; missing for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                    <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot; missing for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                     <span class='kw'>self</span> <span class='rparen'>)</span>
             <span class='kw'>end</span>
         <span class='kw'>end</span>
@@ -4601,7 +4844,7 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
     <span class='comment'># If no subcmds are given, issue error.
 </span>    <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subcommand required for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Subcommand required for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmd'>cmd</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
         <span class='kw'>self</span> <span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_subcmdMissing'>subcmdMissing</span>
 <span class='kw'>end</span></pre>
@@ -4636,25 +4879,25 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1408
-1409
-1410
-1411
-1412
-1413
-1414
-1415
-1416
-1417
-1418
-1419
-1420
-1421
-1422
-1423</pre>
+1425
+1426
+1427
+1428
+1429
+1430
+1431
+1432
+1433
+1434
+1435
+1436
+1437
+1438
+1439
+1440</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1408</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1425</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_checkRule'>checkRule</span>
@@ -4703,23 +4946,6 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1753
-1754
-1755
-1756
-1757
-1758
-1759
-1760
-1761
-1762
-1763
-1764
-1765
-1766
-1767
-1768
-1769
 1770
 1771
 1772
@@ -4744,10 +4970,27 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
 1791
 1792
 1793
-1794</pre>
+1794
+1795
+1796
+1797
+1798
+1799
+1800
+1801
+1802
+1803
+1804
+1805
+1806
+1807
+1808
+1809
+1810
+1811</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1753</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1770</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_cmdline'>cmdline</span>
     <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
@@ -4765,7 +5008,7 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
         <span class='kw'>if</span> <span class='op'>!</span><span class='lparen'>(</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isSwitch'>isSwitch</span> <span class='rparen'>)</span>
-            <span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> &lt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>&gt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_prural'>prural</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+            <span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> &lt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>&gt;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_prural'>prural</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
         <span class='kw'>else</span>
             <span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
         <span class='kw'>end</span>
@@ -4777,9 +5020,9 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
         <span class='kw'>end</span>
         <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_isRequired'>isRequired</span>
-            <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+            <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
         <span class='kw'>else</span>
-            <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>]</span><span class='tstring_end'>&quot;</span></span>
+            <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_push'>push</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_opt'>opt</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>]</span><span class='tstring_end'>&quot;</span></span>
         <span class='kw'>end</span>
     <span class='kw'>end</span>
@@ -4822,12 +5065,12 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1572
-1573
-1574</pre>
+1589
+1590
+1591</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1572</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1589</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_default'>default</span>
     <span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
@@ -4863,14 +5106,14 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1474
-1475
-1476
-1477
-1478</pre>
+1491
+1492
+1493
+1494
+1495</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1474</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1491</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each'>each</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
@@ -4908,14 +5151,14 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1482
-1483
-1484
-1485
-1486</pre>
+1499
+1500
+1501
+1502
+1503</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1482</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1499</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_each_given'>each_given</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_blk'>blk</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_suball'>suball</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span>
@@ -4945,7 +5188,45 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
   </div>
 </div>
 <div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>str</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>Error message.</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>nl</span>
+        <span class='type'>(<tt>Boolean</tt>)</span>
+        <em class="default">(defaults to: <tt>false</tt>)</em>
+        &mdash;
+        <div class='inline'>
+<p>Prepend msg with newline.</p>
+</div>
+    </li>
+</ul>
 </div><table class="source_code">
   <tr>
@@ -4953,17 +5234,17 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1837
-1838
-1839
-1840</pre>
+1857
+1858
+1859
+1860</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1837</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1857</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
-    <span class='const'>STDERR</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_nl'>nl</span><span class='rbrace'>}</span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span><span class='rbrace'>}</span><span class='tstring_content'> error: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
+    <span class='const'>STDERR</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_nl'>nl</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span><span class='embexpr_end'>}</span><span class='tstring_content'> error: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -4996,12 +5277,12 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1844
-1845
-1846</pre>
+1864
+1865
+1866</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1844</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1864</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_errornl'>errornl</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='kw'>true</span> <span class='rparen'>)</span>
@@ -5009,6 +5290,47 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="evalCheck-instance_method">
+    - (<tt>Object</tt>) <strong>evalCheck</strong>(&amp;check)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Custom check for the option. User has to know some Como internals.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+1888
+1889
+1890</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1888</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_evalCheck'>evalCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span> <span class='rparen'>)</span>
+    <span class='id identifier rubyid_instance_eval'>instance_eval</span> <span class='op'>&amp;</span><span class='id identifier rubyid_check'>check</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -5037,13 +5359,13 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1850
-1851
-1852
-1853</pre>
+1870
+1871
+1872
+1873</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1850</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1870</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fatal'>fatal</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
@@ -5080,20 +5402,20 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1823
-1824
-1825
-1826
-1827
-1828
-1829
-1830
-1831
-1832
-1833</pre>
+1840
+1841
+1842
+1843
+1844
+1845
+1846
+1847
+1848
+1849
+1850</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1823</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1840</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='kw'>if</span> <span class='id identifier rubyid_str'>str</span> <span class='op'>==</span> <span class='kw'>nil</span>
@@ -5137,16 +5459,16 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1490
-1491
-1492
-1493
-1494
-1495
-1496</pre>
+1507
+1508
+1509
+1510
+1511
+1512
+1513</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1490</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1507</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_givenCount'>givenCount</span>
     <span class='id identifier rubyid_cnt'>cnt</span> <span class='op'>=</span> <span class='int'>0</span>
@@ -5186,12 +5508,12 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1548
-1549
-1550</pre>
+1565
+1566
+1567</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1548</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1565</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span>
     <span class='lparen'>(</span> <span class='ivar'>@subcmd</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span> <span class='kw'>end</span> <span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
@@ -5227,15 +5549,15 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1618
-1619
-1620
-1621
-1622
-1623</pre>
+1635
+1636
+1637
+1638
+1639
+1640</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1618</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1635</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_hasArg'>hasArg</span>
     <span class='kw'>case</span> <span class='ivar'>@type</span>
@@ -5274,15 +5596,15 @@ subcommands. MissingArgument Exception is generated if argument is missing.</p>
       <pre class="lines">
-1627
-1628
-1629
-1630
-1631
-1632</pre>
+1644
+1645
+1646
+1647
+1648
+1649</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1627</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1644</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_hasMany'>hasMany</span>
     <span class='kw'>case</span> <span class='ivar'>@type</span>
@@ -5322,15 +5644,15 @@ exclusive.</p>
       <pre class="lines">
-1652
-1653
-1654
-1655
-1656
-1657</pre>
+1669
+1670
+1671
+1672
+1673
+1674</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1652</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1669</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_isExclusive'>isExclusive</span>
     <span class='kw'>case</span> <span class='ivar'>@type</span>
@@ -5369,15 +5691,15 @@ exclusive.</p>
       <pre class="lines">
-1636
-1637
-1638
-1639
-1640
-1641</pre>
+1653
+1654
+1655
+1656
+1657
+1658</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1636</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1653</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_isRequired'>isRequired</span>
     <span class='kw'>case</span> <span class='ivar'>@type</span>
@@ -5416,15 +5738,15 @@ exclusive.</p>
       <pre class="lines">
-1661
-1662
-1663
-1664
-1665
-1666</pre>
+1678
+1679
+1680
+1681
+1682
+1683</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1661</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1678</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_isSwitch'>isSwitch</span>
     <span class='kw'>case</span> <span class='ivar'>@type</span>
@@ -5449,7 +5771,7 @@ exclusive.</p>
 </h3><div class="docstring">
   <div class="discussion">
-<p>Option's opt id. Short if exists otherwise long.</p>
+<p>Option&#39;s opt id. Short if exists otherwise long.</p>
   </div>
@@ -5463,12 +5785,12 @@ exclusive.</p>
       <pre class="lines">
-1462
-1463
-1464</pre>
+1479
+1480
+1481</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1462</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1479</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_opt'>opt</span>
     <span class='ivar'>@shortOpt</span> <span class='op'>?</span> <span class='ivar'>@shortOpt</span> <span class='op'>:</span> <span class='ivar'>@longOpt</span>
@@ -5528,23 +5850,23 @@ exclusive.</p>
       <pre class="lines">
-1560
-1561
-1562
-1563
-1564
-1565
-1566
-1567
-1568</pre>
+1577
+1578
+1579
+1580
+1581
+1582
+1583
+1584
+1585</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1560</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1577</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_params'>params</span>
     <span class='id identifier rubyid_map'>map</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
     <span class='ivar'>@value</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
-        <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>=</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
+        <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_i'>i</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>=</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
         <span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_str_to_num'>str_to_num</span><span class='lparen'>(</span> <span class='id identifier rubyid_value'>value</span> <span class='rparen'>)</span>
         <span class='id identifier rubyid_map'>map</span><span class='lbracket'>[</span> <span class='id identifier rubyid_name'>name</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
     <span class='kw'>end</span>
@@ -5581,23 +5903,6 @@ exclusive.</p>
       <pre class="lines">
-1223
-1224
-1225
-1226
-1227
-1228
-1229
-1230
-1231
-1232
-1233
-1234
-1235
-1236
-1237
-1238
-1239
 1240
 1241
 1242
@@ -5704,10 +6009,27 @@ exclusive.</p>
 1343
 1344
 1345
-1346</pre>
+1346
+1347
+1348
+1349
+1350
+1351
+1352
+1353
+1354
+1355
+1356
+1357
+1358
+1359
+1360
+1361
+1362
+1363</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1223</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1240</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span> <span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='id identifier rubyid_checkInvalids'>checkInvalids</span> <span class='op'>=</span> <span class='kw'>true</span> <span class='rparen'>)</span>
@@ -5729,14 +6051,14 @@ exclusive.</p>
             <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
                 <span class='kw'>if</span> <span class='id identifier rubyid_checkInvalids'>checkInvalids</span>
                     <span class='id identifier rubyid_raise'>raise</span> \
-                    <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                    <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown option \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                         <span class='kw'>self</span> <span class='rparen'>)</span>
                 <span class='kw'>else</span>
                     <span class='id identifier rubyid_o'>o</span> <span class='op'>=</span> <span class='id identifier rubyid_findOpt'>findOpt</span><span class='lparen'>(</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
                     <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
                         <span class='id identifier rubyid_raise'>raise</span> \
                         <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-                            <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified to allow \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                            <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified to allow \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                            <span class='kw'>self</span> <span class='rparen'>)</span>
                     <span class='kw'>else</span>
                         <span class='comment'># Default option.
@@ -5753,7 +6075,7 @@ exclusive.</p>
                         <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>!=</span> <span class='symbol'>:opt_any</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_type'>type</span> <span class='op'>!=</span> <span class='symbol'>:exclusive</span>
                     <span class='id identifier rubyid_raise'>raise</span> <span class='const'>MissingArgument</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-                        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No argument given for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No argument given for \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_opt'>opt</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                         <span class='kw'>self</span> <span class='rparen'>)</span>
                 <span class='kw'>else</span>
@@ -5774,7 +6096,7 @@ exclusive.</p>
                         <span class='kw'>if</span> <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
                             <span class='id identifier rubyid_raise'>raise</span> \
                             <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-                                <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Too many arguments for option (\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;)...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                                <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Too many arguments for option (\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;)...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                                 <span class='kw'>self</span> <span class='rparen'>)</span>
                         <span class='kw'>else</span>
                             <span class='id identifier rubyid_o'>o</span><span class='period'>.</span><span class='id identifier rubyid_value'>value</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_toValue'>toValue</span>
@@ -5810,7 +6132,7 @@ exclusive.</p>
                 <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_o'>o</span>
                     <span class='id identifier rubyid_raise'>raise</span> \
                     <span class='const'>InvalidOption</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span>
-                        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified to allow \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
+                        <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>No default option specified to allow \&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_args'>args</span><span class='period'>.</span><span class='id identifier rubyid_get'>get</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot;...</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span>
                         <span class='kw'>self</span> <span class='rparen'>)</span>
                 <span class='kw'>else</span>
                     <span class='comment'># Default option.
@@ -5879,18 +6201,18 @@ exclusive.</p>
       <pre class="lines">
-1128
-1129
-1130
-1131
-1132
-1133
-1134
-1135
-1136</pre>
+1145
+1146
+1147
+1148
+1149
+1150
+1151
+1152
+1153</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1128</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1145</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_setOptionSubcmd'>setOptionSubcmd</span><span class='lparen'>(</span> <span class='id identifier rubyid_opts'>opts</span><span class='comma'>,</span> <span class='id identifier rubyid_subs'>subs</span> <span class='rparen'>)</span>
     <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_i'>i</span><span class='op'>|</span>
@@ -5952,12 +6274,12 @@ exclusive.</p>
       <pre class="lines">
-1168
-1169
-1170</pre>
+1185
+1186
+1187</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1168</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1185</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_setRuleCheck'>setRuleCheck</span><span class='lparen'>(</span> <span class='op'>&amp;</span><span class='id identifier rubyid_rule'>rule</span> <span class='rparen'>)</span>
     <span class='ivar'>@rules</span> <span class='op'>=</span> <span class='id identifier rubyid_rule'>rule</span>
@@ -5979,7 +6301,7 @@ exclusive.</p>
 </h3><div class="docstring">
   <div class="discussion">
-<p>Set optional footer for "usage".</p>
+<p>Set optional footer for “usage”.</p>
   </div>
@@ -5993,12 +6315,12 @@ exclusive.</p>
       <pre class="lines">
-1679
-1680
-1681</pre>
+1696
+1697
+1698</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1679</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1696</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_setUsageFooter'>setUsageFooter</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:footer</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_str'>str</span>
@@ -6020,7 +6342,7 @@ exclusive.</p>
 </h3><div class="docstring">
   <div class="discussion">
-<p>Set optional header for "usage".</p>
+<p>Set optional header for “usage”.</p>
   </div>
@@ -6034,12 +6356,12 @@ exclusive.</p>
       <pre class="lines">
-1673
-1674
-1675</pre>
+1690
+1691
+1692</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1673</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1690</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_setUsageHeader'>setUsageHeader</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span> <span class='rparen'>)</span>
     <span class='ivar'>@config</span><span class='lbracket'>[</span> <span class='symbol'>:header</span> <span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_str'>str</span>
@@ -6088,12 +6410,12 @@ exclusive.</p>
       <pre class="lines">
-1645
-1646
-1647</pre>
+1662
+1663
+1664</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1645</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1662</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_silent?'>silent?</span>
     <span class='ivar'>@type</span> <span class='op'>==</span> <span class='symbol'>:silent</span>
@@ -6129,12 +6451,12 @@ exclusive.</p>
       <pre class="lines">
-1468
-1469
-1470</pre>
+1485
+1486
+1487</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1468</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1485</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_suball'>suball</span>
     <span class='ivar'>@subopt</span> <span class='op'>+</span> <span class='ivar'>@subcmd</span>
@@ -6170,31 +6492,31 @@ exclusive.</p>
       <pre class="lines">
-1798
-1799
-1800
-1801
-1802
-1803
-1804
-1805
-1806
-1807
-1808
-1809
-1810
-1811
-1812
-1813
-1814
 1815
 1816
 1817
 1818
-1819</pre>
+1819
+1820
+1821
+1822
+1823
+1824
+1825
+1826
+1827
+1828
+1829
+1830
+1831
+1832
+1833
+1834
+1835
+1836</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1798</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1815</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_suboptDoc'>suboptDoc</span>
@@ -6289,23 +6611,23 @@ exclusive.</p>
       <pre class="lines">
-1692
-1693
-1694
-1695
-1696
-1697
-1698
-1699
-1700
-1701
-1702
-1703
-1704
-1705</pre>
+1709
+1710
+1711
+1712
+1713
+1714
+1715
+1716
+1717
+1718
+1719
+1720
+1721
+1722</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1692</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1709</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_usage'>usage</span><span class='lparen'>(</span> <span class='id identifier rubyid_doExit'>doExit</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_ruleHelp'>ruleHelp</span> <span class='op'>=</span> <span class='kw'>nil</span> <span class='rparen'>)</span>
@@ -6352,25 +6674,25 @@ exclusive.</p>
       <pre class="lines">
-1719
-1720
-1721
-1722
-1723
-1724
-1725
-1726
-1727
-1728</pre>
+1736
+1737
+1738
+1739
+1740
+1741
+1742
+1743
+1744
+1745</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1719</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1736</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_usageCommand'>usageCommand</span>
     <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
     <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\
-  Subcommand \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot; usage:
-    </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fullCommand'>fullCommand</span><span class='rbrace'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmdline'>cmdline</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>
+  Subcommand \&quot;</span><span class='embexpr_beg'>#{</span><span class='ivar'>@name</span><span class='embexpr_end'>}</span><span class='tstring_content'>\&quot; usage:
+    </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_fullCommand'>fullCommand</span><span class='embexpr_end'>}</span><span class='tstring_content'> </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_cmdline'>cmdline</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> </span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='embexpr_end'>}</span><span class='tstring_content'>
 </span><span class='tstring_end'>&quot;</span></span>
     <span class='id identifier rubyid_str'>str</span> <span class='op'>+=</span> <span class='id identifier rubyid_suboptDoc'>suboptDoc</span>
@@ -6407,19 +6729,19 @@ exclusive.</p>
       <pre class="lines">
-1709
-1710
-1711
-1712
-1713
-1714
-1715</pre>
+1726
+1727
+1728
+1729
+1730
+1731
+1732</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1709</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1726</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_usageIfHelp'>usageIfHelp</span>
-    <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>help</span><span class='tstring_end'>'</span></span> <span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>help</span><span class='tstring_end'>'</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
+    <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_argByName'>argByName</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>help</span><span class='tstring_end'>&#39;</span></span> <span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='kw'>self</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>help</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_given'>given</span>
         <span class='id identifier rubyid_usage'>usage</span>
     <span class='kw'>elsif</span> <span class='id identifier rubyid_hasSubcmd'>hasSubcmd</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span>
         <span class='id identifier rubyid_givenSubcmd'>givenSubcmd</span><span class='period'>.</span><span class='id identifier rubyid_usageIfHelp'>usageIfHelp</span>
@@ -6456,28 +6778,28 @@ exclusive.</p>
       <pre class="lines">
-1731
-1732
-1733
-1734
-1735
-1736
-1737
-1738
-1739
-1740
-1741
-1742
-1743
-1744
-1745
-1746
-1747
 1748
-1749</pre>
+1749
+1750
+1751
+1752
+1753
+1754
+1755
+1756
+1757
+1758
+1759
+1760
+1761
+1762
+1763
+1764
+1765
+1766</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1731</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1748</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_usageNormal'>usageNormal</span>
     <span class='id identifier rubyid_str'>str</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
@@ -6501,6 +6823,87 @@ exclusive.</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="warn-instance_method">
+    - (<tt>Object</tt>) <strong>warn</strong>(str, nl = false)
+</h3><div class="docstring">
+  <div class="discussion">
+<p>Como warning printout.</p>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>str</span>
+        <span class='type'>(<tt>String</tt>)</span>
+        &mdash;
+        <div class='inline'>
+<p>Warning message.</p>
+</div>
+    </li>
+    <li>
+        <span class='name'>nl</span>
+        <span class='type'>(<tt>Boolean</tt>)</span>
+        <em class="default">(defaults to: <tt>false</tt>)</em>
+        &mdash;
+        <div class='inline'>
+<p>Prepend msg with newline.</p>
+</div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+1880
+1881
+1882
+1883</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1880</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span> <span class='id identifier rubyid_str'>str</span><span class='comma'>,</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='kw'>false</span> <span class='rparen'>)</span>
+    <span class='id identifier rubyid_nl'>nl</span> <span class='op'>=</span> <span class='id identifier rubyid_nl'>nl</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
+    <span class='const'>STDERR</span><span class='period'>.</span><span class='id identifier rubyid_puts'>puts</span><span class='lparen'>(</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_nl'>nl</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='const'>Opt</span><span class='period'>.</span><span class='id identifier rubyid_progname'>progname</span><span class='embexpr_end'>}</span><span class='tstring_content'> warning: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_str'>str</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -6515,8 +6918,7 @@ exclusive.</p>
 </h3><div class="docstring">
   <div class="discussion">
-<p>Short syntax for value reference. Example: "~<a
-href="http://'file'">Opt</a>".</p>
+<p>Short syntax for value reference. Example: “~<a href="'file'">Opt</a>”.</p>
   </div>
@@ -6530,12 +6932,12 @@ href="http://'file'">Opt</a>".</p>
       <pre class="lines">
-1500
-1501
-1502</pre>
+1517
+1518
+1519</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1500</span>
+      <pre class="code"><span class="info file"># File 'lib/como.rb', line 1517</span>
 <span class='kw'>def</span> <span class='op'>~</span><span class='lparen'>(</span><span class='rparen'>)</span>
     <span class='ivar'>@value</span>
@@ -6550,9 +6952,9 @@ href="http://'file'">Opt</a>".</p>
 </div>
     <div id="footer">
-  Generated on Sat Nov 22 10:05:15 2014 by
+  Generated on Mon Apr 20 18:44:03 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.6.1 (ruby-1.9.3).
+  0.8.7.6 (ruby-2.1.2).
 </div>
   </body>