# mhical(1mh) - man - phpman

[MHICAL(1mh)](https://www.chedong.com/phpMan.php/man/MHICAL/1mh/markdown)                                                                              [MHICAL(1mh)](https://www.chedong.com/phpMan.php/man/MHICAL/1mh/markdown)



## NAME
       mhical - nmh's manipulator of iCalendar event requests

## SYNOPSIS
       **mhical** [**-help**] [**-version**] [**-form** _formatfile_] [**-format** _formatstring_] [[**-reply** _accept_ | _decline_
            | _tentative_] | **-cancel**] [**-contenttype**] [**-infile** _infile_] [**-outfile** _outfile_] [**-unfold**]
            [**-debug**]

## DESCRIPTION
       **mhical**  manipulates an iCalendar (.ics) event request, to display it, generate a reply to it,
       or cancel it.  iCalendar event requests and replies are defined by RFC 5545.

       The default operation is to display the iCalendar event request in a human-readable format.

       For the display operation, the **-format** _string_ and **-form** _formatfile_ switches may  be  used  to
       specify a format string or a format file to read.  If given a format string, it must be spec‐
       ified as a single argument to the **-format** switch.  If given a format file  name  with  **-form**,
       the  file  is  searched  for  using the normal **nmh** rules: absolute pathnames are accessed di‐
       rectly, tilde expansion is done on usernames, and files are searched for in the  user's  _Mail_
       directory  as  specified  in  their profile.  If not found there, the directory “_/etc/nmh_” is
       checked.  **mhical** defaults to using a format file named **mhical.24hour**, and will  use  the  one
       installed in the “_/etc/nmh_” directory if not found elsewhere.

       The following format components are supported:

            **method**
            **organizer**
            **summary**
            **description**
            **location**
            **dtstart**
            **dtend**
            **attendees**

       Those  format  names  are  case-sensitive.  Each corresponds to the iCalendar property of the
       same name as defined in RFC 5545, with the exception of **attendees**.  That is a comma-delimited
       list of the common name (CN), if available, or email address of Attendee properties.  A maxi‐
       mum of 20 will be displayed.

### Timezone
       **mhical** will display the event with times converted to the timezone specified by the **TZ**  envi‐
       ronment variable, if it is set, see [tzset(3)](https://www.chedong.com/phpMan.php/man/tzset/3/markdown).  If not set, its behavior is implementation de‐
       fined, but may use the user's local timezone.

### Reply
       The **-reply** switch generates a reply from the event request.  The  required  action  parameter
       must be one of _accept_, _decline_, or _tentative_.  Delegation is not supported.

### Cancel
       The **-cancel** switch generates an iCalendar event that can be used to cancel the event request.

### Input/Output
       By  default, **mhical** reads from standard input and writes to standard output.  The **-infile** and
### -outfile

### Miscellaneous Switches
       The **-contenttype** switch instructs **mhical** to insert a Content-Type header at the beginning  of
       its output, for use by **mhbuild**.  It can only be used with **-reply** and **-cancel**.

       The **-unfold** switch echoes the event request, but with all lines unfolded.

       The **-debug** switch reveals minute details of the parse process.

## FILES
       **mhical**  looks  for  format  files in multiple locations:  absolute pathnames are accessed di‐
       rectly, tilde expansion is done on usernames, and files are searched for in the  user's  _Mail_
       directory  as  specified  in  their profile.  If not found there, the directory “_/etc/nmh_” is
       checked.

       /etc/nmh/mhical.24hour  The default display template
       /etc/nmh/mhical.12hour  Display template that uses 12-hour clock

## SEE ALSO
       [_mhbuild_(1)](https://www.chedong.com/phpMan.php/man/mhbuild/1/markdown), [_mh-format_(5)](https://www.chedong.com/phpMan.php/man/mh-format/5/markdown), [_tzset_(3)](https://www.chedong.com/phpMan.php/man/tzset/3/markdown), [_repl_(1)](https://www.chedong.com/phpMan.php/man/repl/1/markdown)

## DEFAULTS
       `**-form**' defaults to mhical.24hour
       `**-infile**' defaults to standard input
       `**-outfile**' defaults to standard output

## BUGS
       **mhical** supports only a very limited subset of RRULE formats.  Specifically, only a  frequency
       of YEARLY and an interval of 1 are supported.



nmh-1.7.1                                    2015-01-04                                  [MHICAL(1mh)](https://www.chedong.com/phpMan.php/man/MHICAL/1mh/markdown)