Provided by: nmh_1.2-3_i386 bug

NAME

       dp - parse dates 822-style

SYNOPSIS

       /usr/lib/mh/dp [-form formatfile] [-format string] [-width columns]
            [-version] [-help] dates ...

DESCRIPTION

       Dp is a program that  parses  dates  according  to  the  ARPA  Internet
       standard.  It also understands many non-standard formats, such as those
       produced by TOPS-20 sites and some UNIX sites using  ctime(3).   It  is
       useful for seeing how nmh will interpret a date.

       The  dp  program  treats each argument as a single date, and prints the
       date out in the official 822-format.  Hence,  it  is  usually  best  to
       enclose each argument in double-quotes for the shell.

       To override the output format used by dp, the -format string or -format
       file switches are used.  This permits individual fields of the  address
       to  be  extracted  with ease.  The string is simply a format string and
       the file is simply a format file.  See mh-format(5) for the details.

       Here is the default format string used by dp:

            %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>

       which says that if an error was detected, print the error, a  ‘:’,  and
       the  date  in  error.   Otherwise,  output the 822-proper format of the
       date.

FILES

       $HOME/.mh_profile          The user profile

PROFILE COMPONENTS

       None

SEE ALSO

       ap(8), Standard for the Format of ARPA Internet Text Messages (RFC-822)

DEFAULTS

-format’ default as described above
       ‘-width’ default to the width of the terminal

CONTEXT

       None

BUGS

       The  argument  to  the  -format  switch must be interpreted as a single
       token by the shell that invokes dp.  Therefore, one must usually  place
       the argument to this switch inside double-quotes.