git.marmaro.de Git - mmh/blob - man/dp.man8

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH DP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 dp \- parse dates 822-style
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B %libdir%/dp
  11 .RB [ \-form
  12 .IR formatfile ]
  13 .RB [ \-Version ]
  14 .RB [ \-help ]
  15 .I dates
  16 \&...
  17 .ad
  18 .SH DESCRIPTION
  19 .B Dp
  20 is a program that parses dates according to the ARPA Internet standard.
  21 It also understands many non\-standard formats,
  22 such as those produced by TOPS\-20 sites and some UNIX sites using
  23 .BR ctime (3).
  24 It is useful for seeing how
  25 .B mmh
  26 will interpret a date.
  27 .PP
  28 The
  29 .B dp
  30 program treats each argument as a single date,
  31 and prints the date out in the official 822\-format.
  32 Hence, it is usually best to enclose each argument in double\-quotes for the
  33 shell.
  34 .PP
  35 To override the output format used by
  36 .BR dp ,
  37 the
  38 .B \-form
  39 .I file
  40 switch is used.
  41 This permits individual fields of the address to be extracted with ease.
  42 The
  43 .I file
  44 is either the name of a format file or
  45 a format string directly, if prepended with an equal sign `='.
  46 See
  47 .BR mh\-format (5)
  48 for the details.
  49 .PP
  50 Here is the default format string used by
  51 .BR dp :
  52 .PP
  53 .RS 5
  54 .nf
  55 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
  56 .fi
  57 .RE
  58 .PP
  59 which says that if an error was detected, print the error, a `:',
  60 and the date in error.
  61 Otherwise, output the 822\-proper format of the date.
  62
  63 .SH FILES
  64 .fc ^ ~
  65 .nf
  66 .ta \w'%etcdir%/ExtraBigFileName  'u
  67 ^$HOME/.mmh/profile~^The user profile
  68 .fi
  69
  70 .SH "PROFILE COMPONENTS"
  71 None
  72
  73 .SH "SEE ALSO"
  74 ap(8),
  75 .I "Standard for the Format of ARPA Internet Text Messages"
  76 (RFC\-822)
  77
  78 .SH DEFAULTS
  79 .nf
  80 .RB ` \-form "' default as described above"
  81 .fi
  82
  83 .SH CONTEXT
  84 None