doing 2.0.5.pre → 2.0.9.pre

data/doing.rdoc

@@ -1,8 +1,11 @@
 == doing - A CLI for a What Was I Doing system
 
-Doing uses a TaskPaper-like formatting to keep a plain text 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.
+Doing uses a TaskPaper-like formatting to keep a plain text
+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.0.5.pre
+v2.0.9.pre
 
 === Global Options
 === --config_file arg
@@ -87,6 +90,14 @@ Boolean used to combine multiple tags
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== --in SECTION_NAME
 
 Add new entry to section (default: same section as repeated entry)
@@ -133,6 +144,16 @@ Select item to resume from a menu of matching entries
 
 
 
+===== --not
+Resume items that *don't* match search/tag filters
+
+
+
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>archive|move  SECTION_OR_TAG</tt>
 Move entries between sections
 
@@ -157,6 +178,14 @@ Tag boolean (AND|OR|NOT)
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -k|--keep X
 
 How many items to keep (ignored if archiving by tag or search)
@@ -191,6 +220,76 @@ Label moved items with @from(SECTION_NAME)
 
 
 
+===== --not
+Show items that *don't* match search string
+
+
+
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
+==== Command: <tt>autotag </tt>
+Autotag last entry or filtered entries
+
+
+===== Options
+===== --bool BOOLEAN
+
+Boolean (AND|OR|NOT) with which to combine multiple tag filters
+
+[Default Value] AND
+[Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
+
+
+===== -c|--count COUNT
+
+How many recent entries to autotag (0 for all)
+
+[Default Value] 1
+[Must Match] (?-mix:^\d+$)
+
+
+===== -s|--section SECTION_NAME
+
+Section
+
+[Default Value] All
+
+
+===== --search QUERY
+
+Autotag entries matching search filter,
+  surround with slashes for regex (e.g. "/query.*/"),
+  start with single quote for exact match ("'query")
+
+[Default Value] None
+
+
+===== --tag TAG
+
+Autotag the last X entries containing TAG.
+  Separate multiple tags with comma (--tag=tag1,tag2), combine with --bool
+
+[Default Value] None
+
+
+===== --force
+Don't ask permission to autotag all entries when count is 0
+
+
+
+===== -i|--interactive
+Select item(s) to tag from a menu of matching entries
+
+
+
+===== -u|--unfinished
+Autotag last entry (or entries) not marked @done
+
+
+
 ==== Command: <tt>cancel  COUNT</tt>
 End last X entries with no time tracked
 
@@ -204,6 +303,14 @@ Boolean (AND|OR|NOT) with which to combine multiple tag filters
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section NAME
 
 Section
@@ -211,6 +318,13 @@ Section
 [Default Value] None
 
 
+===== --search QUERY
+
+Cancel the last X entries matching search filter, surround with slashes for regex (e.g. "/query.*/"), start with single quote for exact match ("'query")
+
+[Default Value] None
+
+
 ===== --tag TAG
 
 Cancel the last X entries containing TAG. Separate multiple tags with comma (--tag=tag1,tag2)
@@ -228,11 +342,21 @@ Select item(s) to cancel from a menu of matching entries
 
 
 
+===== --not
+Finish items that *don't* match search/tag filters
+
+
+
 ===== -u|--unfinished
 Cancel last entry (or entries) not already marked @done
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>choose </tt>
 Select a section to display from a menu
 
@@ -241,6 +365,26 @@ Select a section to display from a menu
 List available color variables for configuration templates and views
 
 
+==== Command: <tt>completion </tt>
+Generate shell completion scripts
+
+
+===== Options
+===== -f|--file PATH
+
+File to write output to
+
+[Default Value] stdout
+
+
+===== -t|--type SHELL
+
+Shell to generate for (bash, zsh, fish)
+
+[Default Value] zsh
+[Must Match] (?i-mx:^[bzf](?:[ai]?sh)?$)
+
+
 ==== Command: <tt>config  KEY_PATH</tt>
 Edit the configuration file or output a value from it
 
@@ -283,7 +427,7 @@ Format for --dump (json|yaml|raw)
 [Must Match] (?-mix:^(?:y(?:aml)?|j(?:son)?|r(?:aw)?)$)
 
 
-===== -d|--[no-]dump
+===== -d|--dump
 Show a config key value based on arguments. Separate key paths with colons or dots, e.g. "export_templates.html". Empty arguments outputs the entire config.
 
 
@@ -393,6 +537,14 @@ Boolean (AND|OR|NOT) with which to combine multiple tag filters
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section NAME
 
 Section
@@ -444,6 +596,11 @@ Select item(s) to finish from a menu of matching entries
 
 
 
+===== --not
+Finish items that *don't* match search/tag filters
+
+
+
 ===== -r|--remove
 Remove done tag
 
@@ -454,6 +611,11 @@ Finish last entry (or entries) not already marked @done
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>grep|search  SEARCH_PATTERN</tt>
 Search for entries
 
@@ -475,6 +637,14 @@ Constrain search to entries older than date
 [Default Value] None
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -o|--output FORMAT
 
 Output to export format (csv|doing|html|markdown|say|taskpaper|template|timeline|wiki)
@@ -502,6 +672,11 @@ Display an interactive menu of results to perform further operations
 
 
 
+===== --not
+Show items that *don't* match search string
+
+
+
 ===== --only_timed
 Only show items with recorded time intervals
 
@@ -517,6 +692,11 @@ Show intervals with totals at the end of output
 
 
 
+===== -x|--exact
+Force exact string matching (case sensitive)
+
+
+
 ==== Command: <tt>help  command</tt>
 Shows a list of commands or help for one command
 
@@ -546,6 +726,14 @@ Import entries older than date
 [Default Value] None
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -f|--from DATE_OR_RANGE
 
 Date range to import. Date range argument should be quoted. Date specifications can be natural language.
@@ -595,6 +783,11 @@ Autotag entries
 
 
 
+===== --not
+Import items that *don't* match search/tag/date filters
+
+
+
 ===== --only_timed
 Only import items with recorded time intervals
 
@@ -605,6 +798,11 @@ Allow entries that overlap existing times
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>last </tt>
 Show the last entry, optionally edit
 
@@ -618,6 +816,14 @@ Tag boolean
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section NAME
 
 Specify a section
@@ -644,6 +850,16 @@ Edit entry with vim
 
 
 
+===== --not
+Show items that *don't* match search string or tag filter
+
+
+
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>later  ENTRY</tt>
 Add an item to the Later section
 
@@ -689,6 +905,14 @@ How many recent entries to tag (0 for all)
 [Must Match] (?-mix:^\d+$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section SECTION_NAME
 
 Section
@@ -726,6 +950,11 @@ Select item(s) to flag from a menu of matching entries
 
 
 
+===== --not
+Flag items that *don't* match search/tag/date filters
+
+
+
 ===== -r|--remove
 Remove flag
 
@@ -736,6 +965,11 @@ Flag last entry (or entries) not marked @done
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>meanwhile  ENTRY</tt>
 Finish any running @meanwhile tasks and optionally create a new one
 
@@ -762,7 +996,7 @@ Section
 [Default Value] None
 
 
-===== -a|--[no-]archive
+===== -a|--archive
 Archive previous @meanwhile entry
 
 
@@ -789,6 +1023,14 @@ Boolean (AND|OR|NOT) with which to combine multiple tag filters
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section NAME
 
 Section
@@ -820,11 +1062,21 @@ Select item for new note from a menu of matching entries
 
 
 
+===== --not
+Add note to item that *doesn't* match search/tag filters
+
+
+
 ===== -r|--remove
 Replace/Remove last entry's note (default append)
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>now|next  ENTRY</tt>
 Add an entry
 
@@ -937,10 +1189,10 @@ Import plugins are available using `doing import --type PLUGIN`.
 List plugins of type (import, export)
 
 [Default Value] all
-[Must Match] (?i-mx:^[iea].*$)
+[Must Match] (?i-mx:^(?:[iea].*)$)
 
 
-===== -c|--[no-]column
+===== -c|--column
 List in single column for completion
 
 
@@ -993,9 +1245,17 @@ Boolean (AND|OR|NOT) with which to combine multiple tag filters
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -s|--section NAME
 
-Set the start date of an item to now
+Limit search to section
 
 [Default Value] All
 
@@ -1019,11 +1279,21 @@ Select from a menu of matching entries
 
 
 
+===== --not
+Reset items that *don't* match search/tag filters
+
+
+
 ===== -r|--[no-]resume
 Resume entry (remove @done)
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>rotate </tt>
 Move entries to archive file
 
@@ -1045,6 +1315,14 @@ Tag boolean (AND|OR|NOT)
 [Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -k|--keep X
 
 How many items to keep in each section (most recent)
@@ -1074,12 +1352,22 @@ Tag filter, combine multiple tags with a comma. Added for compatibility with oth
 [Default Value] None
 
 
+===== --not
+Rotate items that *don't* match search string or tag filter
+
+
+
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>sections </tt>
 List sections
 
 
 ===== Options
-===== -c|--[no-]column
+===== -c|--column
 List in single column
 
 
@@ -1093,6 +1381,14 @@ Multiple selections are allowed, hit tab to add the highlighted entry to the
 selection, and use ctrl-a to select all visible items. Return processes the
 selected entries.
 ===== Options
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -m|--move SECTION
 
 Move selected items to section
@@ -1140,7 +1436,7 @@ Archive selected items
 
 
 
-===== --[no-]again|--[no-]resume
+===== --again|--resume
 Copy selection as a new entry with current time and no @done tag. Only works with single selections. Can be combined with --editor.
 
 
@@ -1180,11 +1476,21 @@ Use --no-menu to skip the interactive menu. Use with --query to filter items and
 
 
 
+===== --not
+Select items that *don't* match search/tag filters
+
+
+
 ===== -r|--remove
 Reverse -c, -f, --flag, and -t (remove instead of adding)
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>show  [SECTION|@TAGS]</tt>
 List all entries
 
@@ -1227,6 +1533,14 @@ Max count to show
 [Default Value] 0
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -f|--from DATE_OR_RANGE
 
 Date range to show, or a single day to filter date on.
@@ -1286,6 +1600,11 @@ Select from a menu of matching entries to perform additional operations
 
 
 
+===== --not
+Show items that *don't* match search/tag/date filters
+
+
+
 ===== --only_timed
 Only show items with recorded time intervals
 
@@ -1301,6 +1620,11 @@ Show intervals with totals at the end of output
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>since  DATE_STRING</tt>
 List entries since a date
 
@@ -1372,6 +1696,14 @@ How many recent entries to tag (0 for all)
 [Must Match] (?-mix:^\d+$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== --rename ORIG_TAG
 
 Replace existing tag with tag argument, wildcards (*,?) allowed, or use with --regex
@@ -1421,6 +1753,11 @@ Select item(s) to tag from a menu of matching entries
 
 
 
+===== --not
+Tag items that *don't* match search/tag filters
+
+
+
 ===== -r|--remove
 Remove given tag(s)
 
@@ -1436,20 +1773,23 @@ Tag last entry (or entries) not marked @done
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>template  TYPE</tt>
 Output HTML, CSS, and Markdown (ERB) templates for customization
 
 Templates are printed to STDOUT for piping to a file.
-  Save them and use them in the configuration file under html_template.
-
-  Example `doing template haml > ~/styles/my_doing.haml`
+  Save them and use them in the configuration file under export_templates.
 ===== Options
 ===== -c
 List in single column for completion
 
 
 
-===== -l|--[no-]list
+===== -l|--list
 List all available templates
 
 
@@ -1556,6 +1896,14 @@ Count to display
 [Must Match] (?-mix:^\d+$)
 
 
+===== --case TYPE
+
+Case sensitivity for search string matching [(c)ase-sensitive, (i)nsensitive, (s)mart]
+
+[Default Value] smart
+[Must Match] (?-mix:^[csi])
+
+
 ===== -o|--output FORMAT
 
 Output to export format (csv|doing|html|markdown|say|taskpaper|template|timeline|wiki)
@@ -1610,6 +1958,11 @@ Select from a menu of matching entries to perform additional operations
 
 
 
+===== --not
+Show items that *don't* match search string
+
+
+
 ===== --only_timed
 Only show items with recorded time intervals (override view settings)
 
@@ -1625,6 +1978,11 @@ Show intervals with totals at the end of output
 
 
 
+===== -x|--exact
+Force exact search string matching (case sensitive)
+
+
+
 ==== Command: <tt>views </tt>
 List available custom views
 

data/generate_completions.sh

@@ -2,3 +2,4 @@
 
 scripts/generate_fish_completions.rb > lib/completion/doing.fish
 scripts/generate_bash_completions.rb > lib/completion/doing.bash
+scripts/generate_zsh_completions.rb > lib/completion/_doing.zsh