RubyGems - doing - Versions diffs - 2.1.37 → 2.1.40 - Mend

doing 2.1.37 → 2.1.40

Files changed (121) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +61 -0
data/Gemfile.lock +1 -1
data/README.md +1 -1
data/Rakefile +7 -1
data/bin/commands/config.rb +43 -34
data/bin/commands/done.rb +1 -18
data/bin/commands/finish.rb +30 -25
data/bin/commands/grep.rb +3 -14
data/bin/commands/last.rb +2 -8
data/bin/commands/meanwhile.rb +13 -6
data/bin/commands/now.rb +2 -4
data/bin/commands/on.rb +4 -15
data/bin/commands/recent.rb +2 -8
data/bin/commands/reset.rb +24 -1
data/bin/commands/select.rb +1 -1
data/bin/commands/show.rb +8 -16
data/bin/commands/since.rb +1 -12
data/bin/commands/today.rb +2 -13
data/bin/commands/view.rb +1 -1
data/bin/commands/yesterday.rb +2 -13
data/bin/doing +41 -36
data/docs/doc/Array.html +1 -1
data/docs/doc/BooleanTermParser/Clause.html +1 -1
data/docs/doc/BooleanTermParser/Operator.html +1 -1
data/docs/doc/BooleanTermParser/Query.html +1 -1
data/docs/doc/BooleanTermParser/QueryParser.html +1 -1
data/docs/doc/BooleanTermParser/QueryTransformer.html +1 -1
data/docs/doc/BooleanTermParser.html +1 -1
data/docs/doc/Doing/Color.html +166 -20
data/docs/doc/Doing/Completion.html +1 -1
data/docs/doc/Doing/Configuration.html +1 -1
data/docs/doc/Doing/Errors/DoingNoTraceError.html +7 -3
data/docs/doc/Doing/Errors/DoingRuntimeError.html +7 -3
data/docs/doc/Doing/Errors/DoingStandardError.html +1 -1
data/docs/doc/Doing/Errors/EmptyInput.html +10 -2
data/docs/doc/Doing/Errors/HistoryLimitError.html +194 -0
data/docs/doc/Doing/Errors/InvalidPlugin.html +194 -0
data/docs/doc/Doing/Errors/MissingBackupFile.html +194 -0
data/docs/doc/Doing/Errors/NoResults.html +10 -2
data/docs/doc/Doing/Errors/PluginException.html +1 -1
data/docs/doc/Doing/Errors/UserCancelled.html +10 -2
data/docs/doc/Doing/Errors/WrongCommand.html +10 -2
data/docs/doc/Doing/Errors.html +9 -9
data/docs/doc/Doing/Hooks.html +1 -1
data/docs/doc/Doing/Item.html +114 -1576
data/docs/doc/Doing/Items.html +121 -5
data/docs/doc/Doing/Logger.html +1 -1
data/docs/doc/Doing/Note.html +1 -1
data/docs/doc/Doing/Pager.html +1 -1
data/docs/doc/Doing/Plugins.html +1 -1
data/docs/doc/Doing/Prompt.html +2 -2
data/docs/doc/Doing/Section.html +1 -1
data/docs/doc/Doing/TemplateString.html +2 -2
data/docs/doc/Doing/Types.html +1 -1
data/docs/doc/Doing/Util/Backup.html +5 -5
data/docs/doc/Doing/Util.html +1 -1
data/docs/doc/Doing/WWID.html +197 -4033
data/docs/doc/Doing.html +2 -2
data/docs/doc/FalseClass.html +1 -1
data/docs/doc/GLI/Commands/Help.html +1 -1
data/docs/doc/GLI/Commands/MarkdownDocumentListener.html +1 -1
data/docs/doc/GLI/Commands.html +1 -1
data/docs/doc/GLI.html +1 -1
data/docs/doc/Hash.html +1 -1
data/docs/doc/Object.html +1 -1
data/docs/doc/PhraseParser/Operator.html +1 -1
data/docs/doc/PhraseParser/PhraseClause.html +1 -1
data/docs/doc/PhraseParser/Query.html +1 -1
data/docs/doc/PhraseParser/QueryParser.html +1 -1
data/docs/doc/PhraseParser/QueryTransformer.html +1 -1
data/docs/doc/PhraseParser/TermClause.html +1 -1
data/docs/doc/PhraseParser.html +1 -1
data/docs/doc/Status.html +1 -1
data/docs/doc/String.html +1 -1
data/docs/doc/Symbol.html +1 -1
data/docs/doc/Time.html +1 -1
data/docs/doc/TrueClass.html +1 -1
data/docs/doc/_index.html +26 -5
data/docs/doc/class_list.html +1 -1
data/docs/doc/file.README.html +2 -2
data/docs/doc/index.html +2 -2
data/docs/doc/method_list.html +237 -709
data/docs/doc/top-level-namespace.html +3 -3
data/docs/index.md +1 -1
data/doing.rdoc +54 -7
data/lib/completion/_doing.zsh +6 -6
data/lib/completion/doing.bash +10 -10
data/lib/completion/doing.fish +8 -2
data/lib/doing/add_options.rb +31 -1
data/lib/doing/chronify/array.rb +68 -18
data/lib/doing/chronify/string.rb +3 -1
data/lib/doing/colors.rb +77 -30
data/lib/doing/completion.rb +4 -5
data/lib/doing/errors.rb +51 -35
data/lib/doing/hooks.rb +3 -3
data/lib/doing/item/dates.rb +112 -0
data/lib/doing/item/query.rb +433 -0
data/lib/doing/item/state.rb +59 -0
data/lib/doing/item/tags.rb +87 -0
data/lib/doing/item.rb +6 -537
data/lib/doing/items.rb +39 -14
data/lib/doing/plugin_manager.rb +3 -3
data/lib/doing/plugins/export/template_export.rb +4 -4
data/lib/doing/plugins/import/cal_to_json.scpt +0 -0
data/lib/doing/prompt.rb +6 -8
data/lib/doing/string/tags.rb +8 -2
data/lib/doing/util_backup.rb +6 -8
data/lib/doing/version.rb +1 -1
data/lib/doing/wwid/display.rb +399 -0
data/lib/doing/wwid/editor.rb +214 -0
data/lib/doing/wwid/filetools.rb +186 -0
data/lib/doing/wwid/filter.rb +218 -0
data/lib/doing/wwid/guess.rb +87 -0
data/lib/doing/wwid/interactive.rb +385 -0
data/lib/doing/wwid/modify.rb +618 -0
data/lib/doing/wwid/tags.rb +54 -0
data/lib/doing/wwid/timers.rb +345 -0
data/lib/doing/wwid/wwidutil.rb +104 -0
data/lib/doing/wwid.rb +31 -2308
metadata +19 -2

data/docs/doc/Doing/Item.html CHANGED Viewed

@@ -247,28 +247,6 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#calculate_end_date-instance_method" title="#calculate_end_date (instance method)">#<strong>calculate_end_date</strong>(opt)  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
       <a href="#clone-instance_method" title="#clone (instance method)">#<strong>clone</strong>  &#x21d2; Object </a>
@@ -285,52 +263,6 @@
     <span class="summary_desc"><div class='inline'></div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#duration-instance_method" title="#duration (instance method)">#<strong>duration</strong>  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>If the entry doesn&#39;t have a @done date, return the elapsed time.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#end_date-instance_method" title="#end_date (instance method)">#<strong>end_date</strong>  &#x21d2; Time </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Get the value of the item&#39;s @done tag.</p>
-</div></span>
 </li>
@@ -354,74 +286,6 @@
     <span class="summary_desc"><div class='inline'><p>Test for equality between items.</p>
 </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>Updates the title of the Item by expanding natural language dates within configured date tags (tags whose value is expected to be a date).</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#finished%3F-instance_method" title="#finished? (instance method)">#<strong>finished?</strong>  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item has a @done tag.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#highlight_search-instance_method" title="#highlight_search (instance method)">#<strong>highlight_search</strong>(search, distance: nil, negate: false, case_type: nil)  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'></div></span>
 </li>
@@ -445,29 +309,6 @@
     <span class="summary_desc"><div class='inline'><p>Generate a hash that represents the entry.</p>
 </div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#ignore_case-instance_method" title="#ignore_case (instance method)">#<strong>ignore_case</strong>(search, case_type)  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Determine if case should be ignored for searches.</p>
-</div></span>
 </li>
@@ -493,29 +334,6 @@
     <span class="summary_desc"><div class='inline'><p>Initialize an item with date, title, section, and optional note.</p>
 </div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#interval-instance_method" title="#interval (instance method)">#<strong>interval</strong>  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Get the difference between the item&#39;s start date and the value of its @done tag (if present).</p>
-</div></span>
 </li>
@@ -545,7 +363,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#overlapping_time%3F-instance_method" title="#overlapping_time? (instance method)">#<strong>overlapping_time?</strong>(item_b)  &#x21d2; Boolean </a>
+      <a href="#to_pretty-instance_method" title="#to_pretty (instance method)">#<strong>to_pretty</strong>(elements: %i[date title section])  &#x21d2; Object </a>
@@ -559,7 +377,7 @@
-    <span class="summary_desc"><div class='inline'><p>Test if the interval between start date and @done value overlaps with another item&#39;s.</p>
+    <span class="summary_desc"><div class='inline'><p>outputs a colored string with relative date and highlighted tags.</p>
 </div></span>
 </li>
@@ -568,7 +386,7 @@
         <li class="public ">
   <span class="summary_signature">
-      <a href="#same_time%3F-instance_method" title="#same_time? (instance method)">#<strong>same_time?</strong>(item_b)  &#x21d2; Boolean </a>
+      <a href="#to_s-instance_method" title="#to_s (instance method)">#<strong>to_s</strong>  &#x21d2; Object </a>
@@ -582,304 +400,51 @@
-    <span class="summary_desc"><div class='inline'><p>Test if two items occur at the same time (same start date and equal duration).</p>
+    <span class="summary_desc"><div class='inline'><p>outputs item in Doing file format, including leading tab.</p>
 </div></span>
 </li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#search-instance_method" title="#search (instance method)">#<strong>search</strong>(search, distance: nil, negate: false, case_type: nil)  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item matches search string.</p>
-</div></span>
+    </ul>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#should_finish%3F-instance_method" title="#should_finish? (instance method)">#<strong>should_finish?</strong>  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item is included in never_finish config and thus should not receive a @done tag.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#should_time%3F-instance_method" title="#should_time? (instance method)">#<strong>should_time?</strong>  &#x21d2; Boolean </a>
-  </span>
+  <h3 class="inherited">Methods included from <span class='object_link'><a href="Color.html" title="Doing::Color (module)">Color</a></span></h3>
+  <p class="inherited"><span class='object_link'><a href="Color.html#attributes-instance_method" title="Doing::Color#attributes (method)">#attributes</a></span>, <span class='object_link'><a href="Color.html#coloring%3F-class_method" title="Doing::Color.coloring? (method)">coloring?</a></span>, <span class='object_link'><a href="Color.html#support%3F-instance_method" title="Doing::Color#support? (method)">#support?</a></span>, <span class='object_link'><a href="Color.html#template-class_method" title="Doing::Color.template (method)">template</a></span>, <span class='object_link'><a href="Color.html#uncolor-instance_method" title="Doing::Color#uncolor (method)">#uncolor</a></span></p>
+<div id="constructor_details" class="method_details_list">
+  <h2>Constructor Details</h2>
+    <div class="method_details first">
+  <h3 class="signature first" id="initialize-instance_method">
+    #<strong>initialize</strong>(date, title, section, note = nil)  &#x21d2; <tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>
-    <span class="summary_desc"><div class='inline'><p>Test if item is included in never_time config and thus should not receive a date on the @done tag.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#tag-instance_method" title="#tag (instance method)">#<strong>tag</strong>(tags, **options)  &#x21d2; Object </a>
-  </span>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Initialize an item with date, title, section, and
+optional note</p>
-    <span class="summary_desc"><div class='inline'><p>Add (or remove) tags from the title of the item.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#tag_array-instance_method" title="#tag_array (instance method)">#<strong>tag_array</strong>  &#x21d2; Array </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>convert tags on item to an array with @ symbols removed.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#tag_values%3F-instance_method" title="#tag_values? (instance method)">#<strong>tag_values?</strong>(queries, bool = :and, negate: false)  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item matches tag values.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#tags-instance_method" title="#tags (instance method)">#<strong>tags</strong>  &#x21d2; Array </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Get a list of tags on the item.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#tags%3F-instance_method" title="#tags? (instance method)">#<strong>tags?</strong>(tags, bool = :and, negate: false)  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item contains tag(s).</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#to_pretty-instance_method" title="#to_pretty (instance method)">#<strong>to_pretty</strong>(elements: %i[date title section])  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>outputs a colored string with relative date and highlighted tags.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#to_s-instance_method" title="#to_s (instance method)">#<strong>to_s</strong>  &#x21d2; Object </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>outputs item in Doing file format, including leading tab.</p>
-</div></span>
-</li>
-        <li class="public ">
-  <span class="summary_signature">
-      <a href="#unfinished%3F-instance_method" title="#unfinished? (instance method)">#<strong>unfinished?</strong>  &#x21d2; Boolean </a>
-  </span>
-    <span class="summary_desc"><div class='inline'><p>Test if item does not contain @done tag.</p>
-</div></span>
-</li>
-    </ul>
-  <h3 class="inherited">Methods included from <span class='object_link'><a href="Color.html" title="Doing::Color (module)">Color</a></span></h3>
-  <p class="inherited"><span class='object_link'><a href="Color.html#attributes-class_method" title="Doing::Color.attributes (method)">attributes</a></span>, <span class='object_link'><a href="Color.html#coloring%3F-class_method" title="Doing::Color.coloring? (method)">coloring?</a></span>, <span class='object_link'><a href="Color.html#support%3F-instance_method" title="Doing::Color#support? (method)">#support?</a></span>, <span class='object_link'><a href="Color.html#uncolor-instance_method" title="Doing::Color#uncolor (method)">#uncolor</a></span></p>
-<div id="constructor_details" class="method_details_list">
-  <h2>Constructor Details</h2>
-    <div class="method_details first">
-  <h3 class="signature first" id="initialize-instance_method">
-    #<strong>initialize</strong>(date, title, section, note = nil)  &#x21d2; <tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Initialize an item with date, title, section, and
-optional note</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
+  </div>
+</div>
+<div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
         <span class='name'>date</span>
@@ -899,883 +464,67 @@ optional note</p>
         <span class='name'>title</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The title</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>section</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The section to which
-the item belongs</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>note</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span> or <span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'><p>The note
-(optional)</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-</div>
-  <div id="instance_attr_details" class="attr_details">
-    <h2>Instance Attribute Details</h2>
-      <span id="date=-instance_method"></span>
-      <div class="method_details first">
-  <h3 class="signature first" id="date-instance_method">
-    #<strong>date</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute date.</p>
-  </div>
-</div>
-<div class="tags">
-</div>
-</div>
-      <span id="note=-instance_method"></span>
-      <div class="method_details ">
-  <h3 class="signature " id="note-instance_method">
-    #<strong>note</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute note.</p>
-  </div>
-</div>
-<div class="tags">
-</div>
-</div>
-      <span id="section=-instance_method"></span>
-      <div class="method_details ">
-  <h3 class="signature " id="section-instance_method">
-    #<strong>section</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute section.</p>
-  </div>
-</div>
-<div class="tags">
-</div>
-</div>
-      <span id="title=-instance_method"></span>
-      <div class="method_details ">
-  <h3 class="signature " id="title-instance_method">
-    #<strong>title</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Returns the value of attribute title.</p>
-  </div>
-</div>
-<div class="tags">
-</div>
-</div>
-  </div>
-  <div id="instance_method_details" class="method_details_list">
-    <h2>Instance Method Details</h2>
-      <div class="method_details first">
-  <h3 class="signature first" id="calculate_end_date-instance_method">
-    #<strong>calculate_end_date</strong>(opt)  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="clone-instance_method">
-    #<strong>clone</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="duration-instance_method">
-    #<strong>duration</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>If the entry doesn&#39;t have a @done date, return the elapsed time</p>
-  </div>
-</div>
-<div class="tags">
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="end_date-instance_method">
-    #<strong>end_date</strong>  &#x21d2; <tt><span class='object_link'><a href="../Time.html" title="Time (class)">Time</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Get the value of the item&#39;s @done tag</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="../Time.html" title="Time (class)">Time</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>@done value</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="equal?-instance_method">
-    #<strong>equal?</strong>(other, match_section: false)  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test for equality between items</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>other</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The other item</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>match_section</span>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        <em class="default">(defaults to: <tt>false</tt>)</em>
-        &mdash;
-        <div class='inline'><p>If true, require item sections to match</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>is equal?</p>
-</div>
-    </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><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Updates the title of the Item by expanding natural
-language dates within configured date tags (tags
-whose value is expected to be a date)</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>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'><p>An array of additional
-tag names to consider
-dates</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="finished?-instance_method">
-    #<strong>finished?</strong>  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test if item has a @done tag</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>true item has @done tag</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="highlight_search-instance_method">
-    #<strong>highlight_search</strong>(search, distance: nil, negate: false, case_type: nil)  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="id-instance_method">
-    #<strong>id</strong>  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Generate a hash that represents the entry</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="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>entry hash</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="ignore_case-instance_method">
-    #<strong>ignore_case</strong>(search, case_type)  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Determine if case should be ignored for searches</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>search</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The search string</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>case_type</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The case type</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>case should be ignored</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="interval-instance_method">
-    #<strong>interval</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Get the difference between the item&#39;s start date and
-the value of its @done tag (if present)</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'></span>
-        <div class='inline'><p>Interval in seconds</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="move_to-instance_method">
-    #<strong>move_to</strong>(new_section, label: true, log: true)  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Move item from current section to destination section</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>new_section</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The destination
-section</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>label</span>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        <em class="default">(defaults to: <tt>true</tt>)</em>
-        &mdash;
-        <div class='inline'><p>add @from(original
-section) tag</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>log</span>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        <em class="default">(defaults to: <tt>true</tt>)</em>
-        &mdash;
-        <div class='inline'><p>log this action</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'></span>
-        <div class='inline'><p>nothing</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="overlapping_time?-instance_method">
-    #<strong>overlapping_time?</strong>(item_b)  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test if the interval between start date and @done
-value overlaps with another item&#39;s</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>item_b</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The item to compare</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>overlaps?</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="same_time?-instance_method">
-    #<strong>same_time?</strong>(item_b)  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test if two items occur at the same time (same start date and equal duration)</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>item_b</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The item to compare</p>
-</div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>is equal?</p>
-</div>
-    </li>
-</ul>
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="search-instance_method">
-    #<strong>search</strong>(search, distance: nil, negate: false, case_type: nil)  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test if item matches search string</p>
-  </div>
-</div>
-<div class="tags">
-  <p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>search</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The search string</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>negate</span>
-        <span class='type'>(<tt>Boolean</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        <em class="default">(defaults to: <tt>false</tt>)</em>
         &mdash;
-        <div class='inline'><p>negate results</p>
+        <div class='inline'><p>The title</p>
 </div>
     </li>
     <li>
-        <span class='name'>case_type</span>
+        <span class='name'>section</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
         &mdash;
-        <div class='inline'><p>The case-sensitivity
-type (:sensitive,
-:ignore, :smart)</p>
+        <div class='inline'><p>The section to which
+the item belongs</p>
 </div>
     </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
     <li>
+        <span class='name'>note</span>
-        <span class='type'>(<tt>Boolean</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span> or <span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
         &mdash;
-        <div class='inline'><p>matches search criteria</p>
+        <div class='inline'><p>The note
+(optional)</p>
 </div>
     </li>
 </ul>
+</div>
 </div>
 </div>
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
-      <div class="method_details ">
-  <h3 class="signature " id="should_finish?-instance_method">
+      <span id="date=-instance_method"></span>
+      <div class="method_details first">
+  <h3 class="signature first" id="date-instance_method">
-    #<strong>should_finish?</strong>  &#x21d2; <tt>Boolean</tt>
+    #<strong>date</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
@@ -1783,39 +532,23 @@ type (:sensitive,
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Test if item is included in never_finish config and
-thus should not receive a @done tag</p>
+    <p>Returns the value of attribute date.</p>
   </div>
 </div>
 <div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>item should receive @done tag</p>
-</div>
-    </li>
-</ul>
 </div>
 </div>
+      <span id="note=-instance_method"></span>
       <div class="method_details ">
-  <h3 class="signature " id="should_time?-instance_method">
+  <h3 class="signature " id="note-instance_method">
-    #<strong>should_time?</strong>  &#x21d2; <tt>Boolean</tt>
+    #<strong>note</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
@@ -1823,39 +556,23 @@ thus should not receive a @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Test if item is included in never_time config and
-thus should not receive a date on the @done tag</p>
+    <p>Returns the value of attribute note.</p>
   </div>
 </div>
 <div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>item should receive @done date</p>
-</div>
-    </li>
-</ul>
 </div>
 </div>
+      <span id="section=-instance_method"></span>
       <div class="method_details ">
-  <h3 class="signature " id="tag-instance_method">
+  <h3 class="signature " id="section-instance_method">
-    #<strong>tag</strong>(tags, **options)  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
+    #<strong>section</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
@@ -1863,150 +580,23 @@ thus should not receive a date on the @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Add (or remove) tags from the title of the item</p>
+    <p>Returns the value of attribute section.</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="../Array.html" title="Array (class)">Array</a></span></tt>)</span>
-        &mdash;
-        <div class='inline'><p>The tags to apply</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>options</span>
-        <span class='type'></span>
-        &mdash;
-        <div class='inline'><p>Additional options</p>
-</div>
-    </li>
-</ul>
-    <p class="tag_title">Options Hash (<tt>**options</tt>):</p>
-    <ul class="option">
-        <li>
-          <span class="name">:date</span>
-          <span class="type">(<tt>Boolean</tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>Include timestamp?</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:single</span>
-          <span class="type">(<tt>Boolean</tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>Log as a single change?</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:value</span>
-          <span class="type">(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>A value to include as @tag(value)</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:remove</span>
-          <span class="type">(<tt>Boolean</tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>if true remove instead of adding</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:rename_to</span>
-          <span class="type">(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>if not nil, rename target tag to this tag name</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:regex</span>
-          <span class="type">(<tt>Boolean</tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>treat target tag string as regex pattern</p>
-</div>
-        </li>
-        <li>
-          <span class="name">:force</span>
-          <span class="type">(<tt>Boolean</tt>)</span>
-          <span class="default">
-          </span>
-            &mdash; <div class='inline'><p>with rename_to, add tag if it doesn&#39;t exist</p>
-</div>
-        </li>
-    </ul>
 </div>
 </div>
+      <span id="title=-instance_method"></span>
       <div class="method_details ">
-  <h3 class="signature " id="tag_array-instance_method">
+  <h3 class="signature " id="title-instance_method">
-    #<strong>tag_array</strong>  &#x21d2; <tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span></tt>
+    #<strong>title</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
@@ -2014,38 +604,40 @@ thus should not receive a date on the @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>convert tags on item to an array with @ symbols removed</p>
+    <p>Returns the value of attribute title.</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</p>
 </div>
-    </li>
+</div>
+  </div>
+  <div id="instance_method_details" class="method_details_list">
+    <h2>Instance Method Details</h2>
+      <div class="method_details first">
+  <h3 class="signature first" id="clone-instance_method">
+    #<strong>clone</strong>  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
-</ul>
-</div>
+</h3>
 </div>
       <div class="method_details ">
-  <h3 class="signature " id="tag_values?-instance_method">
+  <h3 class="signature " id="equal?-instance_method">
-    #<strong>tag_values?</strong>(queries, bool = :and, negate: false)  &#x21d2; <tt>Boolean</tt>
+    #<strong>equal?</strong>(other, match_section: false)  &#x21d2; <tt>Boolean</tt>
@@ -2053,7 +645,7 @@ thus should not receive a date on the @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Test if item matches tag values</p>
+    <p>Test for equality between items</p>
   </div>
@@ -2064,39 +656,22 @@ thus should not receive a date on the @done tag</p>
     <li>
-        <span class='name'>queries</span>
-        <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>The tag value queries to test</p>
-</div>
-    </li>
-    <li>
-        <span class='name'>bool</span>
+        <span class='name'>other</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Doing::Item (class)">Item</a></span></tt>)</span>
-        <em class="default">(defaults to: <tt>:and</tt>)</em>
         &mdash;
-        <div class='inline'><p>The boolean to use for multiple tags (:and, :or, :not)</p>
+        <div class='inline'><p>The other item</p>
 </div>
     </li>
     <li>
-        <span class='name'>negate</span>
+        <span class='name'>match_section</span>
         <span class='type'>(<tt>Boolean</tt>)</span>
@@ -2106,7 +681,7 @@ thus should not receive a date on the @done tag</p>
         &mdash;
-        <div class='inline'><p>negate the result?</p>
+        <div class='inline'><p>If true, require item sections to match</p>
 </div>
     </li>
@@ -2124,7 +699,7 @@ thus should not receive a date on the @done tag</p>
         &mdash;
-        <div class='inline'><p>true if tag/bool combination passes</p>
+        <div class='inline'><p>is equal?</p>
 </div>
     </li>
@@ -2135,9 +710,9 @@ thus should not receive a date on the @done tag</p>
 </div>
       <div class="method_details ">
-  <h3 class="signature " id="tags-instance_method">
+  <h3 class="signature " id="id-instance_method">
-    #<strong>tags</strong>  &#x21d2; <tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span></tt>
+    #<strong>id</strong>  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
@@ -2145,7 +720,7 @@ thus should not receive a date on the @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Get a list of tags on the item</p>
+    <p>Generate a hash that represents the entry</p>
   </div>
@@ -2158,12 +733,12 @@ thus should not receive a date on the @done tag</p>
     <li>
-        <span class='type'>(<tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
         &mdash;
-        <div class='inline'><p>array of tags (no values)</p>
+        <div class='inline'><p>entry hash</p>
 </div>
     </li>
@@ -2174,9 +749,9 @@ thus should not receive a date on the @done tag</p>
 </div>
       <div class="method_details ">
-  <h3 class="signature " id="tags?-instance_method">
+  <h3 class="signature " id="move_to-instance_method">
-    #<strong>tags?</strong>(tags, bool = :and, negate: false)  &#x21d2; <tt>Boolean</tt>
+    #<strong>move_to</strong>(new_section, label: true, log: true)  &#x21d2; <tt><span class='object_link'><a href="../Object.html" title="Object (class)">Object</a></span></tt>
@@ -2184,7 +759,7 @@ thus should not receive a date on the @done tag</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Test if item contains tag(s)</p>
+    <p>Move item from current section to destination section</p>
   </div>
@@ -2195,49 +770,51 @@ thus should not receive a date on the @done tag</p>
     <li>
-        <span class='name'>tags</span>
+        <span class='name'>new_section</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Array.html" title="Array (class)">Array</a></span> or <span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
         &mdash;
-        <div class='inline'><p>The tags to test. Can be an array or a comma-separated string.</p>
+        <div class='inline'><p>The destination
+section</p>
 </div>
     </li>
     <li>
-        <span class='name'>bool</span>
+        <span class='name'>label</span>
-        <span class='type'>(<tt><span class='object_link'><a href="../Symbol.html" title="Symbol (class)">Symbol</a></span></tt>)</span>
+        <span class='type'>(<tt>Boolean</tt>)</span>
-        <em class="default">(defaults to: <tt>:and</tt>)</em>
+        <em class="default">(defaults to: <tt>true</tt>)</em>
         &mdash;
-        <div class='inline'><p>The boolean to use for multiple tags (:and, :or, :not)</p>
+        <div class='inline'><p>add @from(original
+section) tag</p>
 </div>
     </li>
     <li>
-        <span class='name'>negate</span>
+        <span class='name'>log</span>
         <span class='type'>(<tt>Boolean</tt>)</span>
-        <em class="default">(defaults to: <tt>false</tt>)</em>
+        <em class="default">(defaults to: <tt>true</tt>)</em>
         &mdash;
-        <div class='inline'><p>negate the result?</p>
+        <div class='inline'><p>log this action</p>
 </div>
     </li>
@@ -2250,12 +827,12 @@ thus should not receive a date on the @done tag</p>
     <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
+        <span class='type'></span>
-        &mdash;
-        <div class='inline'><p>true if tag/bool combination passes</p>
+        <div class='inline'><p>nothing</p>
 </div>
     </li>
@@ -2323,45 +900,6 @@ thus should not receive a date on the @done tag</p>
 <div class="tags">
-</div>
-</div>
-      <div class="method_details ">
-  <h3 class="signature " id="unfinished?-instance_method">
-    #<strong>unfinished?</strong>  &#x21d2; <tt>Boolean</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Test if item does not contain @done tag</p>
-  </div>
-</div>
-<div class="tags">
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>Boolean</tt>)</span>
-        &mdash;
-        <div class='inline'><p>true if item is missing @done tag</p>
-</div>
-    </li>
-</ul>
 </div>
 </div>
@@ -2370,7 +908,7 @@ thus should not receive a date on the @done tag</p>
 </div>
       <div id="footer">
-  Generated on Sat Mar 12 11:56:35 2022 by
+  Generated on Tue Mar 15 11:14:29 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.27 (ruby-3.0.1).
 </div>