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/calcurse.1.txt | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc/calcurse.1.txt') diff --git a/doc/calcurse.1.txt b/doc/calcurse.1.txt index 367729f..829ede2 100644 --- a/doc/calcurse.1.txt +++ b/doc/calcurse.1.txt @@ -100,10 +100,20 @@ appointments can be specified using the *-c* flag. Specify the length of the range (in days) when used with *-Q*. Cannot be combined with *--to*. +*--export-uid*:: + When exporting items, add the hash of each item to the exported object as an + UID property. + *-D* , *--directory* :: Specify the data directory to use. If not specified, the default directory is *~/.calcurse/*. +*-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: 'Filter Options'. + *--from* :: Specify the start date of the range when used with *-Q*. @@ -125,6 +135,9 @@ appointments 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. @@ -132,6 +145,9 @@ appointments 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 @@ -203,6 +219,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', @@ -384,6 +404,13 @@ appointment in 50 hours will show as 02:00 with the formatting string 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)* + Notes ----- -- cgit v1.2.3-54-g00ecf