mhical - nmh's manipulator of iCalendar event requests

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

       mhical  produces  output  with  just  newlines  instead of carriage return-newline combinations.  This is
       intentional, to fit with typical nmh convention.

nmh-1.8                                            2015-01-04                                        MHICAL(1mh)

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

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 -formatstring and -formformatfile switches may  be  used  to  specify  a
       format  string  or  a  format  file  to read.  If given a format string, it must be specified 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 directly, 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:

            methodorganizersummarydescriptionlocationdtstartdtendattendees

       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 maximum of 20 will be displayed.

   Timezonemhical  will  display  the  event  with  times  converted to the timezone specified by the TZ environment
       variable, if it is set, see tzset(3).  If not set, its behavior is implementation defined,  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.

       If one of your mailboxes matches more than one attendee in the request, the -attendee switch must be used
       to  select  the  one  to use in the reply.  The -attendee switch can also be used to specify the attendee
       address if no attendees match any of your mailboxes.

   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,
       respectively, switches can be used to override these defaults.

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

mhical looks for format files in multiple locations:  absolute pathnames  are  accessed  directly,  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

       mhical - nmh's manipulator of iCalendar event requests

mhbuild(1), mh-format(5), mh-profile(5), tzset(3), repl(1)

mhical [-help] [-version] [-formformatfile] [-formatformatstring] [[-replyaccept | decline |
            tentative] | -cancel] [-attendeeaddress] [-contenttype] [-infileinfile] [-outfileoutfile]
            [-unfold] [-debug]