doing 2.1.12 → 2.1.16

data/docs/doc/String.html

@@ -144,7 +144,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#add_at-instance_method" title="#add_at (instance method)">#<strong>add_at</strong>  &#x21d2; Object </a>
+      <a href="#add_at-instance_method" title="#add_at (instance method)">#<strong>add_at</strong>  &#x21d2; String </a>
     
 
     
@@ -158,7 +158,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Add @ prefix to string if needed, maintains +/- prefix.</p>
+</div></span>
   
 </li>
 
@@ -166,7 +167,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#add_tags-instance_method" title="#add_tags (instance method)">#<strong>add_tags</strong>(tags, remove: false)  &#x21d2; Object </a>
+      <a href="#add_tags-instance_method" title="#add_tags (instance method)">#<strong>add_tags</strong>(tags, remove: false)  &#x21d2; String </a>
     
 
     
@@ -180,7 +181,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>The tagged string.</p>
+</div></span>
   
 </li>
 
@@ -361,7 +363,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Remove duplicate tags, leaving only first occurrence.</p>
+</div></span>
   
 </li>
 
@@ -383,7 +386,29 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Remove duplicate tags, leaving only first occurrence.</p>
+    <span class="summary_desc"><div class='inline'></div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#expand_date_tags-instance_method" title="#expand_date_tags (instance method)">#<strong>expand_date_tags</strong>(additional_tags = nil)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Convert (chronify) natural language dates within configured date tags (tags whose value is expected to be a date).</p>
 </div></span>
   
 </li>
@@ -520,7 +545,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Turn raw urls into HTML links.</p>
+</div></span>
   
 </li>
 
@@ -542,8 +568,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Turn raw urls into HTML links.</p>
-</div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
   
 </li>
 
@@ -551,7 +576,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#normalize_age-instance_method" title="#normalize_age (instance method)">#<strong>normalize_age</strong>(default = :newest)  &#x21d2; Object </a>
+      <a href="#normalize_age-instance_method" title="#normalize_age (instance method)">#<strong>normalize_age</strong>(default = :newest)  &#x21d2; Symbol </a>
     
 
     
@@ -565,7 +590,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert an age string to a qualified type.</p>
+</div></span>
   
 </li>
 
@@ -573,7 +599,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#normalize_age!-instance_method" title="#normalize_age! (instance method)">#<strong>normalize_age!</strong>(default = :newest)  &#x21d2; Symbol </a>
+      <a href="#normalize_age!-instance_method" title="#normalize_age! (instance method)">#<strong>normalize_age!</strong>(default = :newest)  &#x21d2; Object </a>
     
 
     
@@ -587,8 +613,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Convert an age string to a qualified type.</p>
-</div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
   
 </li>
 
@@ -610,7 +635,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert a boolean string to a symbol.</p>
+</div></span>
   
 </li>
 
@@ -632,8 +658,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Convert a boolean string to a symbol.</p>
-</div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
   
 </li>
 
@@ -655,7 +680,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert a case sensitivity string to a symbol.</p>
+</div></span>
   
 </li>
 
@@ -677,8 +703,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Convert a case sensitivity string to a symbol.</p>
-</div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
   
 </li>
 
@@ -700,7 +725,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert a matching configuration string to a symbol.</p>
+</div></span>
   
 </li>
 
@@ -722,8 +748,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Convert a matching configuration string to a symbol.</p>
-</div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
   
 </li>
 
@@ -776,7 +801,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#normalize_trigger-instance_method" title="#normalize_trigger (instance method)">#<strong>normalize_trigger</strong>  &#x21d2; Object </a>
+      <a href="#normalize_trigger-instance_method" title="#normalize_trigger (instance method)">#<strong>normalize_trigger</strong>  &#x21d2; String </a>
     
 
     
@@ -790,7 +815,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Adds ?: to any parentheticals in a regular expression to avoid match groups.</p>
+</div></span>
   
 </li>
 
@@ -820,7 +846,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#pluralize-instance_method" title="#pluralize (instance method)">#<strong>pluralize</strong>(number)  &#x21d2; Object </a>
+      <a href="#remove_self_links-instance_method" title="#remove_self_links (instance method)">#<strong>remove_self_links</strong>  &#x21d2; Object </a>
     
 
     
@@ -834,7 +860,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Remove <self-linked> formatting.</p>
+</div></span>
   
 </li>
 
@@ -842,7 +869,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#remove_self_links-instance_method" title="#remove_self_links (instance method)">#<strong>remove_self_links</strong>  &#x21d2; Object </a>
+      <a href="#replace_qualified_urls-instance_method" title="#replace_qualified_urls (instance method)">#<strong>replace_qualified_urls</strong>(**options)  &#x21d2; Object </a>
     
 
     
@@ -856,7 +883,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Remove <self-linked> formatting.</p>
+    <span class="summary_desc"><div class='inline'><p>Replace qualified urls.</p>
 </div></span>
   
 </li>
@@ -865,7 +892,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#replace_qualified_urls-instance_method" title="#replace_qualified_urls (instance method)">#<strong>replace_qualified_urls</strong>(**options)  &#x21d2; Object </a>
+      <a href="#set_type-instance_method" title="#set_type (instance method)">#<strong>set_type</strong>(kind = nil)  &#x21d2; Object </a>
     
 
     
@@ -879,7 +906,7 @@
   
 
   
-    <span class="summary_desc"><div class='inline'><p>Replace qualified urls.</p>
+    <span class="summary_desc"><div class='inline'><p>Convert a string value to an appropriate type.</p>
 </div></span>
   
 </li>
@@ -888,7 +915,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#set_type-instance_method" title="#set_type (instance method)">#<strong>set_type</strong>(kind = nil)  &#x21d2; Object </a>
+      <a href="#simple_wrap-instance_method" title="#simple_wrap (instance method)">#<strong>simple_wrap</strong>(width)  &#x21d2; Object </a>
     
 
     
@@ -910,7 +937,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#simple_wrap-instance_method" title="#simple_wrap (instance method)">#<strong>simple_wrap</strong>(width)  &#x21d2; Object </a>
+      <a href="#split_date_range-instance_method" title="#split_date_range (instance method)">#<strong>split_date_range</strong>  &#x21d2; Array&lt;DateTime&gt; </a>
     
 
     
@@ -924,7 +951,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Splits a range string and returns an array of DateTime objects as [start, end].</p>
+</div></span>
   
 </li>
 
@@ -972,6 +1000,52 @@
     <span class="summary_desc"><div class='inline'><p>Add, rename, or remove a tag in place.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#time_string-instance_method" title="#time_string (instance method)">#<strong>time_string</strong>(format: :dhm)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Convert DD:HH:MM to a natural language string.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#to_p-instance_method" title="#to_p (instance method)">#<strong>to_p</strong>(number)  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Pluralize a string based on quantity.</p>
+</div></span>
+  
 </li>
 
       
@@ -1001,7 +1075,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#to_tags-instance_method" title="#to_tags (instance method)">#<strong>to_tags</strong>  &#x21d2; Object </a>
+      <a href="#to_seconds-instance_method" title="#to_seconds (instance method)">#<strong>to_seconds</strong>  &#x21d2; Integer </a>
     
 
     
@@ -1015,7 +1089,31 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert DD:HH:MM to seconds.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#to_tags-instance_method" title="#to_tags (instance method)">#<strong>to_tags</strong>  &#x21d2; Array </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'><p>Convert a list of tags to an array.</p>
+</div></span>
   
 </li>
 
@@ -1204,7 +1302,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#wildcard_to_rx-instance_method" title="#wildcard_to_rx (instance method)">#<strong>wildcard_to_rx</strong>  &#x21d2; Object </a>
+      <a href="#wildcard_to_rx-instance_method" title="#wildcard_to_rx (instance method)">#<strong>wildcard_to_rx</strong>  &#x21d2; String </a>
     
 
     
@@ -1218,7 +1316,8 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'><p>Convert ? and * wildcards to regular expressions.</p>
+</div></span>
   
 </li>
 
@@ -1269,25 +1368,115 @@
       <div class="method_details first">
   <h3 class="signature first" id="add_at-instance_method">
   
-    #<strong>add_at</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>add_at</strong>  &#x21d2; <tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Add @ prefix to string if needed, maintains +/- prefix</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>@string</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
   <h3 class="signature " id="add_tags-instance_method">
   
-    #<strong>add_tags</strong>(tags, remove: false)  &#x21d2; <tt>Object</tt> 
+    #<strong>add_tags</strong>(tags, remove: false)  &#x21d2; <tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Returns the tagged string.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>tags</span>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span> or <span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>List of tags to add. @ symbol optional</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>remove</span>
+      
+      
+        <span class='type'>(<tt>Boolean</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>false</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>remove tags instead of adding</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>the tagged string</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
@@ -1299,7 +1488,23 @@
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#add_tags-instance_method" title="String#add_tags (method)">#add_tags</a></span></li>
+    
+  </ul>
+
+</div>
 </div>
     
       <div class="method_details ">
@@ -1562,10 +1767,37 @@ added to a Time object</p>
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Remove duplicate tags, leaving only first occurrence</p>
+
+
+  </div>
 </div>
-    
-      <div class="method_details ">
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        
+        <div class='inline'><p>Deduplicated string</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
+</div>
+    
+      <div class="method_details ">
   <h3 class="signature " id="dedup_tags!-instance_method">
   
     #<strong>dedup_tags!</strong>  &#x21d2; <tt>Object</tt> 
@@ -1576,31 +1808,67 @@ added to a Time object</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Remove duplicate tags, leaving only first occurrence</p>
-
+    
 
   </div>
 </div>
 <div class="tags">
   
-<p class="tag_title">Returns:</p>
-<ul class="return">
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#dedup_tags-instance_method" title="String#dedup_tags (method)">#dedup_tags</a></span></li>
+    
+  </ul>
+
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="expand_date_tags-instance_method">
+  
+    #<strong>expand_date_tags</strong>(additional_tags = nil)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert (chronify) natural language dates
+within configured date tags (tags whose value is
+expected to be a date). Modifies string in place.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
   
     <li>
       
+        <span class='name'>additional_tags</span>
       
-        <span class='type'></span>
       
+        <span class='type'>(<tt><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span></tt>)</span>
       
       
-        
-        <div class='inline'><p>Deduplicated string</p>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>An array of
+additional tags to
+consider date_tags</p>
 </div>
       
     </li>
   
 </ul>
 
+
 </div>
 </div>
     
@@ -1839,22 +2107,12 @@ may not render the same style.</p>
   
 
   
-</h3>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="link_urls!-instance_method">
-  
-    #<strong>link_urls!</strong>(**opt)  &#x21d2; <tt>Object</tt> 
-  
-
-  
-
-  
 </h3><div class="docstring">
   <div class="discussion">
     <p>Turn raw urls into HTML links</p>
 
+<p>:html (default)</p>
+
 
   </div>
 </div>
@@ -1879,26 +2137,63 @@ may not render the same style.</p>
   
 </ul>
 
+  
+    
+    
+    <p class="tag_title">Options Hash (<tt>**opt</tt>):</p>
+    <ul class="option">
+      
+        <li>
+          <span class="name">:format</span>
+          <span class="type">(<tt><span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+          <span class="default">
+            
+          </span>
+          
+            &mdash; <div class='inline'><p>can be :markdown or</p>
+</div>
+          
+        </li>
+      
+    </ul>
+  
+
 
 </div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_age-instance_method">
+  <h3 class="signature " id="link_urls!-instance_method">
   
-    #<strong>normalize_age</strong>(default = :newest)  &#x21d2; <tt>Object</tt> 
+    #<strong>link_urls!</strong>(**opt)  &#x21d2; <tt>Object</tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#link_urls-instance_method" title="String#link_urls (method)">#link_urls</a></span></li>
+    
+  </ul>
+
+</div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_age!-instance_method">
+  <h3 class="signature " id="normalize_age-instance_method">
   
-    #<strong>normalize_age!</strong>(default = :newest)  &#x21d2; <tt><span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span></tt> 
+    #<strong>normalize_age</strong>(default = :newest)  &#x21d2; <tt><span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span></tt> 
   
 
   
@@ -1935,21 +2230,37 @@ may not render the same style.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_bool-instance_method">
+  <h3 class="signature " id="normalize_age!-instance_method">
   
-    #<strong>normalize_bool</strong>(default = :and)  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_age!</strong>(default = :newest)  &#x21d2; <tt>Object</tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#normalize_age-instance_method" title="String#normalize_age (method)">#normalize_age</a></span></li>
+    
+  </ul>
+
+</div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_bool!-instance_method">
+  <h3 class="signature " id="normalize_bool-instance_method">
   
-    #<strong>normalize_bool!</strong>(default = :and)  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_bool</strong>(default = :and)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -1986,21 +2297,37 @@ may not render the same style.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_case-instance_method">
+  <h3 class="signature " id="normalize_bool!-instance_method">
   
-    #<strong>normalize_case</strong>(default = :smart)  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_bool!</strong>(default = :and)  &#x21d2; <tt>Object</tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#normalize_bool-instance_method" title="String#normalize_bool (method)">#normalize_bool</a></span></li>
+    
+  </ul>
+
+</div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_case!-instance_method">
+  <h3 class="signature " id="normalize_case-instance_method">
   
-    #<strong>normalize_case!</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_case</strong>(default = :smart)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -2037,21 +2364,37 @@ may not render the same style.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_matching-instance_method">
+  <h3 class="signature " id="normalize_case!-instance_method">
   
-    #<strong>normalize_matching</strong>(default = :pattern)  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_case!</strong>  &#x21d2; <tt>Object</tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#normalize_case-instance_method" title="String#normalize_case (method)">#normalize_case</a></span></li>
+    
+  </ul>
+
+</div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="normalize_matching!-instance_method">
+  <h3 class="signature " id="normalize_matching-instance_method">
   
-    #<strong>normalize_matching!</strong>(default = :pattern)  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_matching</strong>(default = :pattern)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -2065,7 +2408,30 @@ may not render the same style.</p>
   </div>
 </div>
 <div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>default</span>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>:pattern</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>the default matching
+type to return if the string
+doesn&#39;t match a known symbol</p>
+</div>
+      
+    </li>
   
+</ul>
+
 <p class="tag_title">Returns:</p>
 <ul class="return">
   
@@ -2084,6 +2450,34 @@ may not render the same style.</p>
   
 </ul>
 
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="normalize_matching!-instance_method">
+  
+    #<strong>normalize_matching!</strong>(default = :pattern)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#normalize_matching-instance_method" title="String#normalize_matching (method)">#normalize_matching</a></span></li>
+    
+  </ul>
+
 </div>
 </div>
     
@@ -2141,13 +2535,41 @@ may not render the same style.</p>
       <div class="method_details ">
   <h3 class="signature " id="normalize_trigger-instance_method">
   
-    #<strong>normalize_trigger</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>normalize_trigger</strong>  &#x21d2; <tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Adds ?: to any parentheticals in a regular expression
+to avoid match groups</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>modified regular expression</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
@@ -2158,14 +2580,141 @@ may not render the same style.</p>
 
   
 
-  
-</h3>
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+
+  </div>
+</div>
+<div class="tags">
+  
+
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li><span class='object_link'><a href="#normalize_trigger-instance_method" title="String#normalize_trigger (method)">#normalize_trigger</a></span></li>
+    
+  </ul>
+
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="remove_self_links-instance_method">
+  
+    #<strong>remove_self_links</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Remove <self-linked> formatting</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="replace_qualified_urls-instance_method">
+  
+    #<strong>replace_qualified_urls</strong>(**options)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Replace qualified urls</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="set_type-instance_method">
+  
+    #<strong>set_type</strong>(kind = nil)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert a string value to an appropriate type. If
+kind is not specified, &#39;[one, two]&#39; becomes an Array,
+&#39;1&#39; becomes Integer, &#39;1.5&#39; becomes Float, &#39;true&#39; or
+&#39;yes&#39; becomes TrueClass, &#39;false&#39; or &#39;no&#39; becomes
+FalseClass.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>kind</span>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>specify string, array,
+integer, float, symbol, or boolean
+(falls back to string if value is
+not recognized)</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        
+        <div class='inline'><p>Converted object type</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="pluralize-instance_method">
+  <h3 class="signature " id="simple_wrap-instance_method">
   
-    #<strong>pluralize</strong>(number)  &#x21d2; <tt>Object</tt> 
+    #<strong>simple_wrap</strong>(width)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -2175,9 +2724,9 @@ may not render the same style.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="remove_self_links-instance_method">
+  <h3 class="signature " id="split_date_range-instance_method">
   
-    #<strong>remove_self_links</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>split_date_range</strong>  &#x21d2; <tt><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span>&lt;DateTime&gt;</tt> 
   
 
   
@@ -2185,61 +2734,61 @@ may not render the same style.</p>
   
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Remove <self-linked> formatting</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="replace_qualified_urls-instance_method">
-  
-    #<strong>replace_qualified_urls</strong>(**options)  &#x21d2; <tt>Object</tt> 
-  
-
-  
+    <p>Splits a range string and returns an array of
+DateTime objects as [start, end]. If only one date is
+given, end time is nil.</p>
 
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Replace qualified urls</p>
+<p>&quot;mon 3pm to mon 5pm&quot;.split_date_range</p>
 
 
   </div>
 </div>
 <div class="tags">
   
-
-</div>
-</div>
+  <div class="examples">
+    <p class="tag_title">Examples:</p>
     
-      <div class="method_details ">
-  <h3 class="signature " id="set_type-instance_method">
-  
-    #<strong>set_type</strong>(kind = nil)  &#x21d2; <tt>Object</tt> 
-  
-
-  
+      
+        <p class="example_title"><div class='inline'><p>Process a natural language date range</p>
+</div></p>
+      
+      <pre class="example code"><code></code></pre>
+    
+  </div>
 
+<p class="tag_title">Returns:</p>
+<ul class="return">
   
-</h3>
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span>&lt;DateTime&gt;</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>Start and end dates as
+array</p>
 </div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="simple_wrap-instance_method">
+      
+    </li>
   
-    #<strong>simple_wrap</strong>(width)  &#x21d2; <tt>Object</tt> 
+</ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
   
-
+    <li>
+      
+      
+        <span class='type'>(<tt>InvalidTimeExpression</tt>)</span>
+      
+      
+      
+    </li>
   
+</ul>
 
-  
-</h3>
+</div>
 </div>
     
       <div class="method_details ">
@@ -2428,6 +2977,91 @@ may not render the same style.</p>
     
   </ul>
 
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="time_string-instance_method">
+  
+    #<strong>time_string</strong>(format: :dhm)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert DD:HH:MM to a natural language string</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>format</span>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>:dhm</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'><p>The format to output (:dhm, :hm, :m, :clock, :natural)</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="to_p-instance_method">
+  
+    #<strong>to_p</strong>(number)  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Pluralize a string based on quantity</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>number</span>
+      
+      
+        <span class='type'>(<tt>Integer</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>the quantity of the
+object the string represents</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+
 </div>
 </div>
     
@@ -2519,19 +3153,100 @@ between characters</p>
   
 </ul>
 
+</div>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="to_seconds-instance_method">
+  
+    #<strong>to_seconds</strong>  &#x21d2; <tt>Integer</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert DD:HH:MM to seconds</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Integer</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>rounded number of seconds</p>
+</div>
+      
+    </li>
+  
+</ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Errors::DoingRuntimeError</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+
 </div>
 </div>
     
       <div class="method_details ">
   <h3 class="signature " id="to_tags-instance_method">
   
-    #<strong>to_tags</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>to_tags</strong>  &#x21d2; <tt><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span></tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert a list of tags to an array. Tags can be with
+or without @ symbols, separated by any character, and
+can include parenthetical values (with spaces)</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>array of tags including @ symbols</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
@@ -2797,13 +3512,41 @@ be recognized, e.g. %greensomething still finds
       <div class="method_details ">
   <h3 class="signature " id="wildcard_to_rx-instance_method">
   
-    #<strong>wildcard_to_rx</strong>  &#x21d2; <tt>Object</tt> 
+    #<strong>wildcard_to_rx</strong>  &#x21d2; <tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt> 
   
 
   
 
   
-</h3>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Convert ? and * wildcards to regular expressions.
+Uses \S (non-whitespace) instead of . (any character)</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt><span class='object_link'><a href="" title="String (class)">String</a></span></tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>Regular expression string</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div>
 </div>
     
       <div class="method_details ">
@@ -2886,7 +3629,7 @@ be recognized, e.g. %greensomething still finds
 </div>
 
       <div id="footer">
-  Generated on Tue Dec 21 14:44:17 2021 by
+  Generated on Tue Jan 18 02:48:58 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.26 (ruby-3.0.1).
 </div>