mhc(5) Message Harmonized Calendaring system


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.
Day of month.
1st 2nd 3rd 4th 5th Last
Week in month.
Sun Mon ... Sat
Day of week.
Jan Feb ... Dec
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. For example,

X-SC-Category: todo
X-SC-Category: done
X-SC-Category: private todo
X-SC-Category: work done

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).