doing 2.1.11 → 2.1.15

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.15
 
 === 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)?)?)$)
@@ -117,7 +117,7 @@ Add new entry to section (default: same section as repeated entry)
 
 ===== -n|--note TEXT
 
-Note
+Add a note
 
 [Default Value] None
 
@@ -139,11 +139,24 @@ 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+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit duplicated entry with vim before adding
 
@@ -182,7 +195,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,11 +233,19 @@ 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
 Label moved items with @from(SECTION_NAME)
 
@@ -303,11 +324,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 +358,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 +522,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
@@ -528,7 +557,7 @@ Section
 [Default Value] None
 
 
-===== -t|--took INTERVAL
+===== -t|--took|--for INTERVAL
 
 Set completion date to start date plus interval (XX[mhd] or HH:MM).
   If used without the --back option, the start date will be moved back to allow
@@ -542,6 +571,11 @@ Immediately archive the entry
 
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== --[no-]date
 Include date
 
@@ -583,7 +617,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)?)?)$)
@@ -611,7 +645,7 @@ Finish the last X entries matching search filter, surround with slashes for rege
 [Default Value] None
 
 
-===== -t|--took INTERVAL
+===== -t|--took|--for INTERVAL
 
 Set the completed date to the start date plus XX[hmd]
 
@@ -626,6 +660,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 +719,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 +781,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
 
@@ -833,7 +901,7 @@ Only import items matching search. Surround with slashes for regex (/query/), st
 [Default Value] None
 
 
-===== --tag TAGS
+===== -t|--tag TAGS
 
 Tag all imported entries
 
@@ -880,7 +948,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 +978,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
@@ -954,6 +1035,11 @@ Note
 [Default Value] None
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -966,7 +1052,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 +1096,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
 
@@ -1079,6 +1173,11 @@ Archive previous @meanwhile entry
 
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1095,7 +1194,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 +1224,24 @@ 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+) +(?:!?[<>=][=*]?|[$*^]=) +(?:.*?)$)
+
+
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1185,6 +1297,11 @@ Section
 [Default Value] None
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1337,7 +1454,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 +1484,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 +1534,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 +1572,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 +1616,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 +1624,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
 
@@ -1537,7 +1670,7 @@ Output entries to format (csv|dayone|dayone-days|dayone-entries|doing|html|json|
 [Default Value] None
 
 
-===== -q|--query|--search QUERY
+===== -q|--query QUERY
 
 Initial search query for filtering. Matching is fuzzy. For exact matching, start query with a single quote, e.g. `--query "'search"
 
@@ -1558,6 +1691,13 @@ Save selected entries to file using --output format
 [Default Value] None
 
 
+===== --search QUERY
+
+Select from entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query")
+
+[Default Value] None
+
+
 ===== -t|--tag TAG
 
 Tag selected entries
@@ -1565,6 +1705,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 +1749,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 +1792,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 +1807,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 +1864,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 +1885,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 +1995,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 +2046,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 +2106,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 +2125,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,9 +2172,17 @@ 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
@@ -2138,7 +2329,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 +2341,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 +2355,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 +2363,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 +2419,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 +2440,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
 

data/example_plugin.rb

@@ -152,11 +152,9 @@ module Doing
           finished_at = i.end_date
           took += finished_at.strftime('%A %B %e at %I:%M%p')
 
-          d, h, m = wwid.format_time(interval)
+
           took += ' and it took'
-          took += " #{d.to_i} days" if d.to_i.positive?
-          took += " #{h.to_i} hours" if h.to_i.positive?
-          took += " #{m.to_i} minutes" if m.to_i.positive?
+          took += interval.time_string(format: :natural)
         end
       end