doing 2.0.3.pre → 2.0.8.pre

data/doing.rdoc

@@ -2,7 +2,7 @@
 
 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.2.pre
+v2.0.8.pre
 
 === Global Options
 === --config_file arg
@@ -128,11 +128,21 @@ Edit duplicated entry with vim before adding
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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
 
@@ -191,6 +201,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
 
@@ -223,7 +303,7 @@ Archive entries
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 Select item(s) to cancel from a menu of matching entries
 
 
@@ -241,6 +321,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 +383,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.
 
 
@@ -439,11 +539,16 @@ Include date
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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 +559,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
 
@@ -497,11 +607,21 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --[no-]case
+Force case sensitive matching
+
+
+
 ===== -i|--interactive
 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 +637,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
 
@@ -595,6 +720,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 +735,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
 
@@ -644,6 +779,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
 
@@ -721,11 +866,16 @@ Don't ask permission to flag all entries when count is 0
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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 +886,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 +917,7 @@ Section
 [Default Value] None
 
 
-===== -a|--[no-]archive
+===== -a|--archive
 Archive previous @meanwhile entry
 
 
@@ -815,16 +970,26 @@ Edit entry with vim
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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 +1102,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
 
 
@@ -965,7 +1130,7 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 Select from a menu of matching entries to perform additional operations
 
 
@@ -995,7 +1160,7 @@ Boolean (AND|OR|NOT) with which to combine multiple tag filters
 
 ===== -s|--section NAME
 
-Set the start date of an item to now
+Limit search to section
 
 [Default Value] All
 
@@ -1014,16 +1179,26 @@ Reset last entry matching tag
 [Default Value] None
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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
 
@@ -1074,12 +1249,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
 
 
@@ -1140,7 +1325,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 +1365,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
 
@@ -1281,11 +1476,16 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time))
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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 +1501,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
 
@@ -1416,11 +1621,16 @@ Don't ask permission to tag all entries when count is 0
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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,6 +1646,11 @@ 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
 
@@ -1449,7 +1664,7 @@ List in single column for completion
 
 
 
-===== -l|--[no-]list
+===== -l|--list
 List all available templates
 
 
@@ -1605,11 +1820,16 @@ Include colors in output
 
 
 
-===== -i|--[no-]interactive
+===== -i|--interactive
 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 +1845,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/example_plugin.rb

@@ -150,7 +150,7 @@ module Doing
           finished_at = i.end_date
           took += finished_at.strftime('%A %B %e at %I:%M%p')
 
-          d, h, m = wwid.fmt_time(interval)
+          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?

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