From 6ebcbd4d69a90e9d100220e4e5dea6e88f202a6d Mon Sep 17 00:00:00 2001 From: Lukas Fleischer Date: Fri, 15 Jan 2016 18:53:19 +0100 Subject: Document new options and format specifiers Signed-off-by: Lukas Fleischer --- doc/manual.txt | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc/manual.txt') 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 <> 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: <>. + `--from `:: Specify the start date of the range when used with `-Q`. @@ -314,6 +324,9 @@ can be specified using the `-c` flag. `-l , --limit `:: 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 `:: + Only include items with a hash starting with the specified pattern. The + pattern can be inverted by prepending an exclamation mark (`!`). + `--filter-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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- cgit v1.2.3-54-g00ecf