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