Quis Manualis Manuales?

Could you drive the car over to my sister's place? Then she'll give you the KEYS once you're there.

What a confusing request! What keys could this person mean?

The car KEYS, for the car that she needs. You'll get the KEYS once you're there.

Now you have found the confusion - this person is not thinking clearly. You will need keys, first, or you will not be able to drive the car.

*No, car starts with 'c', so car first. Then 'k' comes after, so you get the KEYS later.

This is all out of order, and we don't even know where she lives.

She does not live at North Street. That's the old address, so don't go there.

Knowing where she does not live does not help us getting there.

She lives on South Street, but I have to tell you about all the changes first.

At last, it all makes sense! This person writes Linux man pages for a living. In fact he just finished writing the manual for the calcurse program.

1
2OPTIONS
3       Most options imply command line mode. Options compatible with interactive
4       mode are marked "(also interactively)".
5
6       -a, --appointment
7           Print the appointments and events for the current day. Equivalent to
8           -Q --filter-type cal.

So -a is equivalent to -Q and the other flag that I don't know. That would make sense if I knew what any of them were. Let's continue reading!

 1
 2       --days num
 3           Specify the range of days when used with -Q. Can be combined with --from, but not with
 4           --to. Without --from, the first day of the range defaults to the current day. The
 5           number may be negative, see -Q --query.
 6
 7       --dump-imported
 8           When importing items, print each newly created object to stdout. Format options can be
 9           used to specify which details are printed. See also Format Options.
10
11       --export-uid
12           When exporting items, add the hash of each item to the exported object as a UID
13           property.
14
15       --from date
16           Specify the start date of the day range when used with -Q. When used without -to or
17           --days the range is one day (the specified day), see -Q --query.
18
19       -F, --filter
20           Deprecated, see -P. Note that this option is for backward compatibility and not the
21           same as -P (it does not use the invert filter option).

So --days lets us specify 'days' when using the (still completely unknown) -Q flag, and --export-uid will help us exporting a uid (which is perfectly clear, assuming you already know how to export (covered later) and know what a hash is). Then --from gives us more options for this mysterious -Q; what a lot of options it has! And -F, I am informed, should not be used. Thanks, manual, for telling me that I should not be using this flag, as it is not quite the same as -P (which we will - gods willing - soon learn about).

But I feel tired. I have forgotten why I opened this calendar. I think I wanted to meet with a human, but I've lost all will to interact with humanity since encountering the calcurse manual. So I'm going to skip ahead to the examples section, which may have an example of whatever it was I wanted to do.

1/Examp
2E486: Pattern not found: Examp

Alas! No examples in the document.

Not one.

...which seems strange, because I have one here:

1
2EXAMPLES
3       calcurse -d tomorrow
4           Display the calendar for tomorrow (same as calcurse -Q --filter-type cal --from
5           tomorrow).
6
7       calcurse -d friday
8           Display the calendar for the upcoming friday.

Now I see my error. It has no 'examples', only 'EXAMPLES', in the standard shouty-caps-language of the Linux manual writer.

Manual writers, eh? They're a funny old lot, but once you get to know them, you can stop wasting your time and just go to Stack Exchange immediately.