doing 2.1.12 → 2.1.16

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.16
 
 === 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,16 +522,16 @@ 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
 way to add entries in post and maintain accurate (albeit manual) time tracking.
 ===== Options
-===== --at DATE_STRING
+===== --at|--finished DATE_STRING
 
 Set finish date to specific date/time (natural langauge parsed, e.g. --at=1:30pm).
-  If used, ignores --back. Used with --took, backdates start date
+  Used with --took, backdates start date
 
 [Default Value] None
 
@@ -514,6 +543,14 @@ Backdate start date by interval or set to time [4pm|20m|2h|"yesterday noon"]
 [Default Value] None
 
 
+===== --from TIME_RANGE
+
+Start and end times as a date/time range `doing done --from "1am to 8am"`.
+        Overrides other date flags.
+
+[Default Value] None
+
+
 ===== -n|--note TEXT
 
 Include a note
@@ -528,7 +565,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 +579,11 @@ Immediately archive the entry
 
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== --[no-]date
 Include date
 
@@ -583,7 +625,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 +653,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 +668,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 +727,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 +789,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 +909,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 +956,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,11 +986,24 @@ 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
 Show elapsed time if entry is not tagged @done
 
@@ -954,6 +1043,11 @@ Note
 [Default Value] None
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -966,7 +1060,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 +1104,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 +1181,11 @@ Archive previous @meanwhile entry
 
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1095,7 +1202,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,9 +1232,22 @@ 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
@@ -1162,7 +1282,9 @@ Record what you're starting now, or backdate the start time using natural langua
 
 A parenthetical at the end of the entry will be converted to a note.
 
-Run with no argument to create a new entry using vim.
+Run without arguments to create a new entry interactively.
+
+Run with --editor to create a new entry using vim.
 ===== Options
 ===== -b|--back|--started DATE_STRING
 
@@ -1185,6 +1307,11 @@ Section
 [Default Value] None
 
 
+===== --ask
+Prompt for note via multi-line input
+
+
+
 ===== -e|--editor
 Edit entry with vim
 
@@ -1337,7 +1464,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 +1494,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 +1544,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 +1582,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 +1626,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 +1634,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 +1680,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 +1701,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 +1715,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 +1759,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 +1802,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 +1817,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 +1874,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 +1895,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 +2005,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 +2056,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 +2116,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 +2135,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 +2182,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 +2339,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 +2351,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 +2365,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 +2373,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 +2429,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 +2450,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