summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWilliam Pettersson <william.pettersson@gmail.com>2013-07-20 00:05:11 +1000
committerLukas Fleischer <calcurse@cryptocrack.de>2013-07-19 16:21:50 +0200
commitc2d324be516ad03bd1935f909b58efbc17b858a0 (patch)
tree99470fc7ecb66fc96eaecd6a531470a711618ee4
parentaea877145e08d99641cac9310ca94becf3df3587 (diff)
downloadcalcurse-c2d324be516ad03bd1935f909b58efbc17b858a0.zip
Document for -l/--limit and %(remaing)/%(duration)
Update man-page and manual to describe limit option, and new formatting options for %(remaining) and %(duration). Signed-off-by: William Pettersson <william.pettersson@gmail.com> Signed-off-by: Lukas Fleischer <calcurse@cryptocrack.de>
-rw-r--r--doc/calcurse.1.txt23
-rw-r--r--doc/manual.txt19
2 files changed, 38 insertions, 4 deletions
diff --git a/doc/calcurse.1.txt b/doc/calcurse.1.txt
index 369eafc..4b10d80 100644
--- a/doc/calcurse.1.txt
+++ b/doc/calcurse.1.txt
@@ -43,8 +43,8 @@ Synopsis
[verse]
*calcurse* [*-h*|*-v*] [*-an*] [*-t*[num]] [*-c*<file>] [*-D*<dir>]
- [*-i*<file>] [*-x*[format]] [*-d* <date>|<num>]
- [*-s*[date]] [*-r*[range]] [*-S* <regex>] [*--status*]
+ [*-i*<file>] [*-x*[format]] [*-d* <date>|<num>] [*-s*[date]]
+ [*-l* <num>] [*-r*[range]] [*-S* <regex>] [*--status*]
Description
-----------
@@ -135,6 +135,9 @@ appointments can be specified using the *-c* flag.
*-i* <file>, *--import* <file>::
Import the icalendar data contained in 'file'.
+*-l* <num>, *--limit* <num>::
+ Limit the number of results printed to 'num'.
+
*-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.
@@ -265,9 +268,10 @@ short specifiers and corresponding long options:
* *s*: *(start)*
* *S*: *(start:epoch)*
-* *d*: *(duration)*
* *e*: *(end)*
* *E*: *(end:epoch)*
+* *d*: *(duration)*
+* *r*: *(remaining)*
* *m*: *(message)*
* *n*: *(noteid)*
* *N*: *(note)*
@@ -280,6 +284,19 @@ and *default* (which is mostly equivalent to *(start:%H:%M)* or *(end:%H:%M)*
but displays *..:..* if the item doesn't start/end at the current day) are
supported.
+The *(remaining)* and *(duration)* specifiers support a subset of the
+strftime()-style formatting options, along with two extra qualifiers.
+The supported options are *%d*, *%H*, *%M* and *%S*, and by default each
+of these is zero-padded to two decimal places. To avoid the
+zero-padding, add *-* in front of the formatting option (for example,
+*%-d*). Additionally, the *E* option will display the total number of
+time units until the appointment, rather than showing the remaining
+number of time units modulo the next larger time unit. For example, an
+appointment in 50 hours will show as 02:00 with the formatting string
+*%H:%M*, but will 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*.
+
Notes
-----
diff --git a/doc/manual.txt b/doc/manual.txt
index 09dc035..02aff4f 100644
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -245,6 +245,9 @@ can be specified using the `-c` flag.
`-i <file>, --import <file>`::
Import the icalendar data contained in `file`.
+`-l <num>, --limit <num>`::
+ Limit the number of results printed to 'num'.
+
`-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.
@@ -377,9 +380,10 @@ short specifiers and corresponding long options:
* `s`: `(start)`
* `S`: `(start:epoch)`
-* `d`: `(duration)`
* `e`: `(end)`
* `E`: `(end:epoch)`
+* `d`: `(duration)`
+* `r`: `(remaining)`
* `m`: `(message)`
* `n`: `(noteid)`
* `N`: `(note)`
@@ -392,6 +396,19 @@ and `default` (which is mostly equivalent to `(start:%H:%M)` or `(end:%H:%M)`
but displays `..:..` if the item doesn't start/end at the current day) are
supported.
+The `(remaining)` and `(duration)` specifiers support a subset of the
+strftime()-style formatting options, along with two extra qualifiers.
+The supported options are `%d`, `%H`, `%M` and `%S`, and by default each
+of these is zero-padded to two decimal places. To avoid the
+zero-padding, add `-` before the formatting option (for example, `%-d`).
+Additionally, the `E` option will display the total number of time units
+until the appointment, rather than showing the remaining number of time
+units modulo the next larger time unit. For example, an appointment in
+50 hours will show as 02:00 with the formatting string `%H:%M`, but will
+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`.
+
[[basics_invocation_variable]]
Environment variable for i18n
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^