doing 2.1.12 → 2.1.13

data/docs/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Dec 21 14:44:17 2021 by
+  Generated on Fri Jan 14 21:59:13 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>

data/doing.rdoc

@@ -5,12 +5,12 @@ record of what you've been doing, complete with tag-based time tracking. The
 command line tool allows you to add entries, annotate with tags and notes, and
 view your entries with myriad options, with a focus on a "natural" language syntax.
 
-v2.1.10
+v2.1.13
 
 === Global Options
 === --config_file arg
 
-Use a specific configuration file. Deprecated, set $DOING_CONFIG instead.
+Use a specific configuration file. Deprecated, set $DOING_CONFIG instead
 
 [Default Value] /Users/ttscoff/.config/doing/config.yml
 
@@ -90,11 +90,11 @@ Add a new section to the "doing" file
 ==== Command: <tt>again|resume </tt>
 Repeat last entry as new entry
 
-This command is designed to allow multiple time intervals to be created for an entry by duplicating it with a new start (and end, eventually) time.
+This command is designed to allow multiple time intervals to be created for an entry by duplicating it with a new start (and end, eventually) time
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans.
+Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -139,11 +139,19 @@ Repeat last entry matching search. Surround with
 
 ===== --tag TAG
 
-Repeat last entry matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?).
+Repeat last entry matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?)
 
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -e|--editor
 Edit duplicated entry with vim before adding
 
@@ -182,7 +190,7 @@ Archive entries older than date
 
 ===== --bool BOOLEAN
 
-Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans.
+Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -220,9 +228,17 @@ Move entries to
 
 ===== --tag TAG
 
-Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands.
+Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands
+
+[Default Value] None
+
+
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
 
 [Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
 
 
 ===== --[no-]label
@@ -303,11 +319,11 @@ Autotag last entry (or entries) not marked @done
 ==== Command: <tt>cancel  COUNT</tt>
 End last X entries with no time tracked
 
-Adds @done tag without datestamp so no elapsed time is recorded. Alias for `doing finish --no-date`.
+Adds @done tag without datestamp so no elapsed time is recorded. Alias for `doing finish --no-date`
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans.
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -337,11 +353,19 @@ Cancel the last X entries matching search filter, surround with slashes for rege
 
 ===== --tag TAG
 
-Cancel the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2). Wildcards allowed (*, ?).
+Cancel the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2). Wildcards allowed (*, ?)
 
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -a|--archive
 Archive entries
 
@@ -493,7 +517,7 @@ Update default config file, adding any missing keys
 
 [Default Command] edit
 ==== Command: <tt>done|did  ENTRY</tt>
-Add a completed item with @done(date). No argument finishes last entry.
+Add a completed item with @done(date). No argument finishes last entry
 
 Use this command to add an entry after you've already finished it. It will be immediately marked as @done.
 You can modify the start and end times of the entry using the --back, --took, and --at flags, making it an easy
@@ -583,7 +607,7 @@ Backdate completed date to date string [4pm|20m|2h|yesterday noon]
 
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans.
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -626,6 +650,14 @@ Finish the last X entries containing TAG.
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -a|--archive
 Archive entries
 
@@ -677,18 +709,26 @@ To search with regular expressions, single quote the string and surround with sl
 ===== Options
 ===== --after DATE_STRING
 
-Search entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Search entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
 
 ===== --before DATE_STRING
 
-Search entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Search entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
 
+===== --bool arg
+
+Combine multiple tags or value queries using AND, OR, or NOT
+
+[Default Value] AND
+[Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
+
+
 ===== --case TYPE
 
 Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart]
@@ -731,11 +771,29 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
+===== -d|--delete
+Delete matching entries
+
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
 
 
+===== -e|--editor
+Edit matching entries with vim
+
+
+
 ===== -i|--interactive
 Display an interactive menu of results to perform further operations
 
@@ -880,7 +938,7 @@ allowing `doing last` to target historical entries.
 ===== Options
 ===== --bool BOOLEAN
 
-Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans.
+Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -910,9 +968,22 @@ Search filter, surround with slashes for regex (/query/), start with single quot
 
 ===== --tag TAG
 
-Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?).
+Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?)
+
+[Default Value] None
+
+
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
 
 [Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
+===== -d|--delete
+Delete the last entry
+
 
 
 ===== --[no-]duration
@@ -966,7 +1037,7 @@ Mark last entry as flagged
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans.
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1010,6 +1081,14 @@ Flag the last entry containing TAG.
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -d|--date
 Include current date/time with tag
 
@@ -1095,7 +1174,7 @@ If -r is provided with no other arguments, the last note is removed.
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans.
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1125,11 +1204,19 @@ Add/remove note from last entry matching search filter, surround with slashes fo
 
 ===== --tag TAG
 
-Add/remove note from last entry matching tag. Wildcards allowed (*, ?).
+Add/remove note from last entry matching tag. Wildcards allowed (*, ?)
 
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1337,7 +1424,7 @@ If a date string is provided as an argument, the start time will be set to the p
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1367,11 +1454,19 @@ Reset last entry matching search filter, surround with slashes for regex (e.g. "
 
 ===== --tag TAG
 
-Reset last entry matching tag. Wildcards allowed (*, ?).
+Reset last entry matching tag. Wildcards allowed (*, ?)
 
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -i|--interactive
 Select from a menu of matching entries
 
@@ -1409,7 +1504,7 @@ Rotate entries older than date
 
 ===== --bool BOOLEAN
 
-Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans.
+Tag boolean (AND|OR|NOT). Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1447,9 +1542,17 @@ Search filter
 
 ===== --tag TAG
 
-Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands.
+Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?). Added for compatibility with other commands
+
+[Default Value] None
+
+
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
 
 [Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
 
 
 ===== --not
@@ -1483,7 +1586,7 @@ selected entries.
 
 Search in the menu by typing:
 
-sbtrkt  fuzzy-match   Items that match sbtrkt
+sbtrkt  fuzzy-match   Items that match s*b*t*r*k*t
 
 'wild   exact-match (quoted)  Items that include wild
 
@@ -1491,14 +1594,14 @@ sbtrkt  fuzzy-match   Items that match sbtrkt
 ===== Options
 ===== --after DATE_STRING
 
-Select from entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Select from entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
 
 ===== --before DATE_STRING
 
-Select from entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Select from entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
@@ -1565,6 +1668,14 @@ Tag selected entries
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -a|--archive
 Archive selected items
 
@@ -1601,12 +1712,12 @@ Add flag to selected item(s)
 
 
 ===== --force
-Perform action without confirmation.
+Perform action without confirmation
 
 
 
 ===== --[no-]menu
-Use --no-menu to skip the interactive menu. Use with --query to filter items and act on results automatically. Test with `--output doing` to preview matches.
+Use --no-menu to skip the interactive menu. Use with --query to filter items and act on results automatically. Test with `--output doing` to preview matches
 
 
 
@@ -1644,14 +1755,14 @@ Age (oldest|newest)
 
 ===== --after DATE_STRING
 
-Show entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Show entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
 
 ===== -b|--bool BOOLEAN
 
-Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans.
+Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1659,7 +1770,7 @@ Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans.
 
 ===== --before DATE_STRING
 
-Show entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+Show entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
@@ -1716,7 +1827,7 @@ Search filter, surround with slashes for regex (/query/), start with single quot
 
 ===== --tag TAG
 
-Tag filter, combine multiple tags with a comma. Use `--tag pick` for a menu of available tags. Wildcards allowed (*, ?). Added for compatibility with other commands.
+Tag filter, combine multiple tags with a comma. Use `--tag pick` for a menu of available tags. Wildcards allowed (*, ?). Added for compatibility with other commands
 
 [Default Value] None
 
@@ -1737,6 +1848,14 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time))
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
@@ -1839,7 +1958,7 @@ Add (or remove) tags from the last entry, or from multiple entries
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans.
+Boolean (AND|OR|NOT) with which to combine multiple tag filters. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1890,6 +2009,21 @@ Tag the last X entries containing TAG.
 [Default Value] None
 
 
+===== -v|--value VALUE
+
+Include a value, e.g. @tag(value)
+
+[Default Value] None
+
+
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -a|--autotag
 Autotag entries based on autotag configuration in ~/.config/doing/config.yml
 
@@ -1935,6 +2069,18 @@ Force exact search string matching (case sensitive)
 
 
 
+==== Command: <tt>tag_dir  TAG [TAG..]</tt>
+Set the default tags for the current directory
+
+Adds default_tags to a .doingrc file in the current directory. Any entry created in this directory or its
+subdirectories will be tagged with the default tags. You can modify these any time using the `config set` commnand or
+manually editing the .doingrc file.
+===== Options
+===== -r|--remove
+Remove all default_tags from the local .doingrc
+
+
+
 ==== Command: <tt>tags </tt>
 List all tags in the current Doing file
 
@@ -1942,7 +2088,7 @@ List all tags in the current Doing file
 ===== Options
 ===== --bool BOOLEAN
 
-Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans.
+Boolean used to combine multiple tags. Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -1989,11 +2135,19 @@ Sort by name or count
 
 ===== --tag TAG
 
-Get tags for entries matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?).
+Get tags for entries matching tags. Combine multiple tags with a comma. Wildcards allowed (*, ?)
 
 [Default Value] None
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== -c|--[no-]counts
 Show count of occurrences
 
@@ -2138,7 +2292,7 @@ Select from recent backups
 
 
 ===== -r|--[no-]redo
-Redo last undo. Note: you cannot undo a redo.
+Redo last undo. Note: you cannot undo a redo
 
 
 
@@ -2150,7 +2304,7 @@ Command line options override view configuration.
 ===== Options
 ===== --after DATE_STRING
 
-View entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+View entries newer than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
@@ -2164,7 +2318,7 @@ Age (oldest|newest)
 
 ===== -b|--bool BOOLEAN
 
-Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans.
+Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans
 
 [Default Value] PATTERN
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none|p(?:at(?:tern)?)?)$)
@@ -2172,7 +2326,7 @@ Tag boolean (AND,OR,NOT). Use PATTERN to parse + and - as booleans.
 
 ===== --before DATE_STRING
 
-View entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day.
+View entries older than date. If this is only a time (8am, 1:30pm, 15:00), all dates will be included, but entries will be filtered by time of day
 
 [Default Value] None
 
@@ -2228,7 +2382,7 @@ Search filter, surround with slashes for regex (/query/), start with single quot
 
 ===== --tag TAG
 
-Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?).
+Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?)
 
 [Default Value] None
 
@@ -2249,6 +2403,14 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --val QUERY
+
+Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
+
+[Default Value] None
+[Must Match] (?-mix:^(?:!)?@?(?:\S+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
 ===== --[no-]color
 Include colors in output