Document new options and format specifiers

Signed-off-by: Lukas Fleischer <lfleischer@calcurse.org>

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/manual.txt b/doc/manual.txt
index 77d4990..f105be0 100644
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -293,6 +293,16 @@ can be specified using the `-c` flag.
   See the <<basics_format_strings,Format strings>> section for detailed
   information on format strings.
 
+`--export-uid`::
+  When exporting items, add the hash of each item to the exported object as an
+  UID property.
+
+`-F`, `--filter`::
+  Read items from the data files and write them back. The filter interface can
+  be used to drop specific items. Be careful with this option, specifying a
+  wrong filter might result it data loss! It is highly recommended to test the
+  effect of filters with -G first. See also: <<basics_filters,Filters>>.
+
 `--from <date>`::
   Specify the start date of the range when used with `-Q`.
 
@@ -314,6 +324,9 @@ can be specified using the `-c` flag.
 `-l <num>, --limit <num>`::
   Limit the number of results printed to 'num'.
 
+`--list-imported`::
+  When importing items, print the hash of each newly created object to stdout.
+
 `-n, --next`::
   Print the next appointment within upcoming 24 hours and exit.  The indicated
   time is the number of hours and minutes left before this appointment.
@@ -321,6 +334,9 @@ can be specified using the `-c` flag.
 Note: the calendar from which to read the appointments can be specified using
 the `-c` flag.
 
+`-q`, `--quiet`::
+  Be quiet. Do not show system dialogs.
+
 `-Q, --query`::
   Print all appointments inside a given query range, followed by all TODO
   items. The query range defaults to the current day and can be changed by
@@ -394,6 +410,10 @@ Filters can be used to restrict the set of items which are loaded from the
 appointments file when using calcurse in non-interactive mode. The following
 filters are currently supported:
 
+`--filter-hash <pattern>`::
+  Only include items with a hash starting with the specified pattern. The
+  pattern can be inverted by prepending an exclamation mark (`!`).
+
 `--filter-type <type>`::
   Ignore any items that do not match the type mask. The type mask is a
   comma-separated list of valid type descriptions which include `event`, `apt`,
@@ -550,6 +570,13 @@ show 50:00 with the formatting string `%EH:%M`. Note that if you are
 combining the `-` and `E` options, the `-` must come first. The default
 format for the `(remaining)` specifier is `%EH:%M`.
 
+There are two additional long format specifiers that do not have any
+corresponding short options. They can be used to print an item's hash or its
+internal representation and were designed to be used for scripting:
+
+* `(hash)`
+* `(raw)`
+
 [[basics_invocation_variable]]
 Environment variable for i18n
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^