git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/doc/dp.me

   1 .\"     This file is automatically generated.  Do not edit!
   2 .\" @(#)$Id: dp.rf,v 1.7 1992/05/12 22:23:34 jromine Exp $
   3 .SC DP 8
   4 .NA
   5 dp \- parse dates 822-style
   6 .SY
   7 /opt/mh-6.8.5/lib/dp
   8 \%[\-form\ formatfile]
   9 \%[\-format\ string]
  10 \%[\-width\ columns]
  11 dates\ ...
  12 \%[\-help]
  13 .DE
  14 \fIDp\fR is a program that parses dates according to the ARPA Internet
  15 standard.
  16 It also understands many non\-standard formats,
  17 such as those produced by TOPS\-20 sites and some UNIX sites using
  18 \fIctime\fR\0(3).
  19 It is useful for seeing how \fIMH\fR will interpret a date.
  20
  21 The \fIdp\fR program treats each argument as a single date,
  22 and prints the date out in the official 822\-format.
  23 Hence, it is usually best to enclose each argument in double\-quotes for the
  24 shell.
  25
  26 To override the output format used by \fIdp\fR,
  27 the `\-format\ string' or `\-format\ file' switches are used.
  28 This permits individual fields of the address to be extracted with ease.
  29 The string is simply a format stringand thefile is simply a format file.
  30 See \fImh\-format\fR\0(5) for the details.
  31
  32 Here is the default format string used by \fIdp\fR:
  33
  34 .nf
  35 .ti +.5i
  36 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
  37 .fi
  38
  39 which says that if an error was detected, print the error, a `:',
  40 and the date in error.
  41 Otherwise, output the 822\-proper format of the date.
  42 .Fi
  43 ^$HOME/\&.mh\(ruprofile~^The user profile
  44 .Pr
  45 None
  46 .Sa
  47 ap(8)
  48 .br
  49 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
  50 .De
  51 `\-format' default as described above
  52 .Ds
  53 `\-width' default to the width of the terminal
  54 .Co
  55 None
  56 .Bu
  57 The argument to the `\-format' switch must be interpreted as a single token
  58 by the shell that invokes \fIdp\fR.
  59 Therefore,
  60 one must usually place the argument to this switch inside double\-quotes.
  61 .En