This manual page documents briefly the mhc file format. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.


Mhc file format is based on STD11/RFC822: Standard for the format of ARPA Internet text messages. In mhc file, the following extra header fields are used.


Date of event in format yyyymmdd. You can specify multiple date with space separated like:

X-SC-Day: 19990409 19990413

  • which means April 9th 1999 and April 13th 1999.


Time of event in format hh:mm-hh:mm or hh:mm. For event which has no meanings about time, you can leave it empty in this field.


Period of event in yyyymmdd-yyyymmdd. You can omit start date or end date, like "19991121-". X-SC-Duration: is used only to limit date specified by X-SC-Day: or X-SC-Cond, so you can't describe event date only by X-SC-Duration:. If X-SC-Duration: is empty, it means no limit.


Condition of event date by using following keyword.

00-31 Day of month. 1st 2nd 3rd 4th 5th Last Week in month. Sun Mon ... Sat Day of week. Jan Feb ... Dec Month

  • Examples,

    X-SC-Cond: Tue Fri

    Every Tuesday and Friday.

    X-SC-Cond: 31 Aug

    Every August 31th.

    X-SC-Cond: 1st 3rd Fri

    Every 1st and 3rd Friday.

    X-SC-Cond: Fri

    X-SC-Day: !19990409

    Every Friday, but except April 9th 1999.

    X-SC-Cond: Fri 13

    Every 13th and Every Friday, not 13th Friday.


Hint for alarm of event. Currently, mhc.el doesn't alaram, but gemcal will pop-up alarm window. It will be useful if you transfer this event to PalmOS. In X-SC-Alarm:, you can specify the number (1 to 99) with suffix such as minute, hour or day. For example,

X-SC-Alarm: 10 minutes

Alarm 10 minutes before event.

X-SC-Alarm: 3 hour

Alarm 3 hours before event.

X-SC-Alarm: 3 day

Alarm 3 day before event.


Subject of event. unstructured?


Location of event. unstructured?


Category of event. Any keyword, space separeated. Case ignored.


Internal use only.



This program was written by Yoshinari Nomura <[email protected]> and this manual page was written by Fumitoshi UKAI <[email protected]>, for the Debian GNU/Linux system (but may be used by others).