doing.rdoc in doing-2.1.0pre vs doing.rdoc in doing-2.1.1pre
- old
+ new
@@ -3,11 +3,11 @@
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.1.0pre
+v2.1.1pre
=== Global Options
=== --config_file arg
Use a specific configuration file. Deprecated, set $DOING_CONFIG instead.
@@ -143,11 +143,11 @@
[Default Value] None
===== -e|--editor
-Edit duplicated entry with vim before adding
+Edit duplicated entry with emacs -nw before adding
===== -i|--interactive
Select item to resume from a menu of matching entries
@@ -539,11 +539,11 @@
Include date
===== -e|--editor
-Edit entry with vim (with no arguments, edits the last entry)
+Edit entry with emacs -nw (with no arguments, edits the last entry)
===== -r|--remove
Remove @done tag
@@ -668,18 +668,18 @@
To search with regular expressions, single quote the string and surround with slashes: `doing search '/\bm.*?x\b/'`
===== Options
===== --after DATE_STRING
-Constrain search to entries newer than date
+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
-Constrain search to entries older than date
+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
===== --case TYPE
@@ -688,10 +688,22 @@
[Default Value] smart
[Must Match] (?-mix:^[csi])
+===== --from DATE_OR_RANGE
+
+Date range to show, or a single day to filter date on.
+ Date range argument should be quoted. Date specifications can be natural language.
+ To specify a range, use "to" or "through": `doing search --from "monday 8am to friday 5pm"`.
+
+ If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
+ by time of day.
+
+[Default Value] None
+
+
===== -o|--output FORMAT
Output to export format (csv|doing|html|markdown|say|taskpaper|template|timeline|wiki)
[Default Value] None
@@ -889,11 +901,11 @@
[Default Value] None
===== -e|--editor
-Edit entry with vim
+Edit entry with emacs -nw
===== --not
Show items that *don't* match search string or tag filter
@@ -923,11 +935,11 @@
[Default Value] None
===== -e|--editor
-Edit entry with vim
+Edit entry with emacs -nw
==== Command: <tt>mark|flag </tt>
Mark last entry as flagged
@@ -1045,11 +1057,11 @@
Archive previous @meanwhile entry
===== -e|--editor
-Edit entry with vim
+Edit entry with emacs -nw
==== Command: <tt>note NOTE_TEXT</tt>
Add a note to the last entry
@@ -1096,11 +1108,11 @@
[Default Value] None
===== -e|--editor
-Edit entry with vim
+Edit entry with emacs -nw
===== -i|--interactive
Select item for new note from a menu of matching entries
@@ -1127,11 +1139,11 @@
Record what you're starting now, or backdate the start time using natural language.
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 with no argument to create a new entry using emacs -nw.
===== Options
===== -b|--back|--started DATE_STRING
Backdate start time [4pm|20m|2h|"yesterday noon"]
@@ -1151,11 +1163,11 @@
[Default Value] None
===== -e|--editor
-Edit entry with vim
+Edit entry with emacs -nw
===== -f|--finish_last
Timed entry, marks last entry in section as @done
@@ -1431,18 +1443,44 @@
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
+===== --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.
+
+[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.
+
+[Default Value] None
+
+
===== --case TYPE
Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart]
[Default Value] smart
[Must Match] (?-mix:^[csi])
+===== --from DATE_OR_RANGE
+
+Date range to show, or a single day to filter date on.
+ Date range argument should be quoted. Date specifications can be natural language.
+ To specify a range, use "to" or "through": `doing select --from "monday 8am to friday 5pm"`.
+
+ If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
+ by time of day.
+
+[Default Value] None
+
+
===== -m|--move SECTION
Move selected items to section
[Default Value] None
@@ -1556,11 +1594,11 @@
[Default Value] newest
===== --after DATE_STRING
-View entries newer than date
+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
@@ -1571,11 +1609,11 @@
[Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
===== --before DATE_STRING
-View entries older than date
+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
===== -c|--count MAX
@@ -1591,16 +1629,19 @@
[Default Value] smart
[Must Match] (?-mix:^[csi])
-===== -f|--from DATE_OR_RANGE
+===== --from DATE_OR_RANGE
Date range to show, or a single day to filter date on.
- Date range argument should be quoted. Date specifications can be natural language.
- To specify a range, use "to" or "through": `doing show --from "monday to friday"`
+ Date range argument should be quoted. Date specifications can be natural language.
+ To specify a range, use "to" or "through": `doing show --from "monday 8am to friday 5pm"`.
+ If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
+ by time of day.
+
[Default Value] None
===== -o|--output FORMAT
@@ -1867,10 +1908,17 @@
View entries before specified time (e.g. 8am, 12:30pm, 15:00)
[Default Value] None
+===== --from DATE_OR_RANGE
+
+Time range to show `doing today --from "12pm to 4pm"`
+
+[Default Value] None
+
+
===== -o|--output FORMAT
Output to export format (csv|doing|html|markdown|say|taskpaper|template|timeline|wiki)
[Default Value] None
@@ -1918,11 +1966,11 @@
Command line options override view configuration
===== Options
===== --after DATE_STRING
-View entries newer than date
+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
===== -b|--bool BOOLEAN
@@ -1933,11 +1981,11 @@
[Must Match] (?i-mx:^(?:and|all|any|or|not|none)$)
===== --before DATE_STRING
-View entries older than date
+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
===== -c|--count COUNT
@@ -1954,10 +2002,22 @@
[Default Value] smart
[Must Match] (?-mix:^[csi])
+===== --from DATE_OR_RANGE
+
+Date range to show, or a single day to filter date on.
+ Date range argument should be quoted. Date specifications can be natural language.
+ To specify a range, use "to" or "through": `doing view --from "monday 8am to friday 5pm" view_name`.
+
+ If values are only time(s) (6am to noon) all dates will be included, but entries will be filtered
+ by time of day.
+
+[Default Value] None
+
+
===== -o|--output FORMAT
Output to export format (csv|doing|html|markdown|say|taskpaper|template|timeline|wiki)
[Default Value] None
@@ -2120,9 +2180,16 @@
===== --before TIME_STRING
View entries before specified time (e.g. 8am, 12:30pm, 15:00)
+
+[Default Value] None
+
+
+===== --from TIME_RANGE
+
+Time range to show, e.g. `doing yesterday --from "1am to 8am"`
[Default Value] None
===== -o|--output FORMAT