{ "content": [ { "type": "text", "text": "# mhical(1mh) (man)\n\n**Summary:** mhical - nmh's manipulator of iCalendar event requests\n\n**Synopsis:** mhical [-help] [-version] [-form formatfile] [-format formatstring] [[-reply accept | decline\n| tentative] | -cancel] [-contenttype] [-infile infile] [-outfile outfile] [-unfold]\n[-debug]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| — | — | — | |\n\n## See Also\n\n- mhbuild(1)\n- mh-format(5)\n- tzset(3)\n- repl(1)\n\n## Section Outline\n\n- **NAME** (2 lines)\n- **SYNOPSIS** (4 lines)\n- **DESCRIPTION** (30 lines) — 6 subsections\n - Timezone (4 lines)\n - Reply (3 lines)\n - Cancel (2 lines)\n - Input/Output (1 lines)\n - -outfile (1 lines)\n - Miscellaneous Switches (7 lines)\n- **FILES** (8 lines)\n- **SEE ALSO** (2 lines)\n- **DEFAULTS** (4 lines)\n- **BUGS** (6 lines)\n\n## Full Content\n\n### NAME\n\nmhical - nmh's manipulator of iCalendar event requests\n\n### SYNOPSIS\n\nmhical [-help] [-version] [-form formatfile] [-format formatstring] [[-reply accept | decline\n| tentative] | -cancel] [-contenttype] [-infile infile] [-outfile outfile] [-unfold]\n[-debug]\n\n### DESCRIPTION\n\nmhical manipulates an iCalendar (.ics) event request, to display it, generate a reply to it,\nor cancel it. iCalendar event requests and replies are defined by RFC 5545.\n\nThe default operation is to display the iCalendar event request in a human-readable format.\n\nFor the display operation, the -format string and -form formatfile switches may be used to\nspecify a format string or a format file to read. If given a format string, it must be spec‐\nified as a single argument to the -format switch. If given a format file name with -form,\nthe file is searched for using the normal nmh rules: absolute pathnames are accessed di‐\nrectly, tilde expansion is done on usernames, and files are searched for in the user's Mail\ndirectory as specified in their profile. If not found there, the directory “/etc/nmh” is\nchecked. mhical defaults to using a format file named mhical.24hour, and will use the one\ninstalled in the “/etc/nmh” directory if not found elsewhere.\n\nThe following format components are supported:\n\nmethod\norganizer\nsummary\ndescription\nlocation\ndtstart\ndtend\nattendees\n\nThose format names are case-sensitive. Each corresponds to the iCalendar property of the\nsame name as defined in RFC 5545, with the exception of attendees. That is a comma-delimited\nlist of the common name (CN), if available, or email address of Attendee properties. A maxi‐\nmum of 20 will be displayed.\n\n#### Timezone\n\nmhical will display the event with times converted to the timezone specified by the TZ envi‐\nronment variable, if it is set, see tzset(3). If not set, its behavior is implementation de‐\nfined, but may use the user's local timezone.\n\n#### Reply\n\nThe -reply switch generates a reply from the event request. The required action parameter\nmust be one of accept, decline, or tentative. Delegation is not supported.\n\n#### Cancel\n\nThe -cancel switch generates an iCalendar event that can be used to cancel the event request.\n\n#### Input/Output\n\nBy default, mhical reads from standard input and writes to standard output. The -infile and\n\n#### -outfile\n\n#### Miscellaneous Switches\n\nThe -contenttype switch instructs mhical to insert a Content-Type header at the beginning of\nits output, for use by mhbuild. It can only be used with -reply and -cancel.\n\nThe -unfold switch echoes the event request, but with all lines unfolded.\n\nThe -debug switch reveals minute details of the parse process.\n\n### FILES\n\nmhical looks for format files in multiple locations: absolute pathnames are accessed di‐\nrectly, tilde expansion is done on usernames, and files are searched for in the user's Mail\ndirectory as specified in their profile. If not found there, the directory “/etc/nmh” is\nchecked.\n\n/etc/nmh/mhical.24hour The default display template\n/etc/nmh/mhical.12hour Display template that uses 12-hour clock\n\n### SEE ALSO\n\nmhbuild(1), mh-format(5), tzset(3), repl(1)\n\n### DEFAULTS\n\n`-form' defaults to mhical.24hour\n`-infile' defaults to standard input\n`-outfile' defaults to standard output\n\n### BUGS\n\nmhical supports only a very limited subset of RRULE formats. Specifically, only a frequency\nof YEARLY and an interval of 1 are supported.\n\n\n\nnmh-1.7.1 2015-01-04 MHICAL(1mh)\n\n" } ], "structuredContent": { "command": "mhical", "section": "1mh", "mode": "man", "summary": "mhical - nmh's manipulator of iCalendar event requests", "synopsis": "mhical [-help] [-version] [-form formatfile] [-format formatstring] [[-reply accept | decline\n| tentative] | -cancel] [-contenttype] [-infile infile] [-outfile outfile] [-unfold]\n[-debug]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": null, "arg": null, "description": "" } ], "examples": [], "see_also": [ { "name": "mhbuild", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/mhbuild/1/json" }, { "name": "mh-format", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/mh-format/5/json" }, { "name": "tzset", "section": "3", "url": "https://www.chedong.com/phpMan.php/man/tzset/3/json" }, { "name": "repl", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/repl/1/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 4, "subsections": [] }, { "name": "DESCRIPTION", "lines": 30, "subsections": [ { "name": "Timezone", "lines": 4 }, { "name": "Reply", "lines": 3 }, { "name": "Cancel", "lines": 2 }, { "name": "Input/Output", "lines": 1 }, { "name": "-outfile", "lines": 1 }, { "name": "Miscellaneous Switches", "lines": 7 } ] }, { "name": "FILES", "lines": 8, "subsections": [] }, { "name": "SEE ALSO", "lines": 2, "subsections": [] }, { "name": "DEFAULTS", "lines": 4, "subsections": [] }, { "name": "BUGS", "lines": 6, "subsections": [] } ] } }