================================================================================

				 Checkmail @VERSION@

		    (c) 2005--2014 Martin Mares <mj@ucw.cz>
		    (c) 2020--2021 Jiri Kalvoda <jirikalvoda@kam.mff.cuni.cz>

================================================================================

Checkmail is nothing more than a smart textual menu allowing easy browsing
through a set of mailboxes (or maildirs), displayed together with numbers of
all messages and new messages. It is also able to notify the user that a new
mail has arrived by means of beeps, keyboard LEDs and on-screen display.

Checkmail can be freely used and distributed according to the terms of the GNU
General Public License version 2, as published by the Free Software Foundation.

Build requirements: libncurses, locales and iconv, and a decent C99 compiler
(preferably GCC). For full UTF-8 support, libncursesw is necessary. Options
for controlling XKB leds need libX11, on-screen display needs libX11 and OSDD.
See Makefile for several build-time switches.

Usage:
~~~~~~
	see `cm --help'

Keys:
~~~~~
	q / Ctrl-C	quit
	arrow keys	moves through the list
	h, j, k, l	vi-like movement keys also work
	ENTER		invokes mutt (or a program specified with the -m option)
			on the current mailbox
	TAB		jumps to the next mailbox with some new messages
			(mailboxes with higher priority are preferred)
	`		TAB in reverse direction
	Ctrl-R		forces full reload of the list
			(otherwise, it gets updated incrementally)
	Ctrl-L		redraw screen
	0...9		sets minimum priority of mailboxes to show (0=show all)
	b, B		enable/disable beeping
	d, D		enable/disable on-screen display
	/		start incremental search mode
	<hotkey>	activate a specific mailbox and invoke mutt on it
			(hotkeys are defined as mailbox options and they override
			 the default key bindings)

OSD Messages:
~~~~~~~~~~~~~
When OSDD is installed (see http://mj.ucw.cz/linux.html#osdd), Checkmail can
send on-screen notifications on incoming mail. This can be enabled by the "d"
mailbox option. Additionally, you can customize the OSD messages using the "-s"
switch: "-s<key>=<value>" sets an OSD attribute (e.g., "-scolor=red" or
"-sduration=3000" [ms]), "-s=<text>" adds a line to the message. If no text
lines are defined, Checkmail uses built-in default.

Each <text> can contain the following formatting sequences:

	%f		sender of the highest-priority new message
	%s		subject of the same message
	%n		total number of new messages
	%m		the number of more new messages (i.e., %n-1)
			if it is 0, the whole <text> line is skipped
	%<width>...	you can add an optional maximum width in characters

Examples:
~~~~~~~~~
	cm -i				display just the inbox
	cm -i '~/Mail/*_list'		display inbox and all mailing lists
	cm -i '~/Mail/*_list' -oINBOX=1t  highlight the inbox and prefer it on TAB

Caveats:
~~~~~~~~

  - Checkmail currently does no mailbox locking, but the incremental update mechanism
    is able to recover from mailboxes caught in the middle of mail delivery.

Please send all bug reports and suggestions to mj@ucw.cz.

				Have fun
							Martin
