git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/dp.rf,v

   1 head    1.7;
   2 access;
   3 symbols;
   4 locks; strict;
   5
   6
   7 1.7
   8 date    92.05.12.22.23.34;      author jromine; state Exp;
   9 branches;
  10 next    1.6;
  11
  12 1.6
  13 date    90.04.05.15.08.58;      author sources; state Exp;
  14 branches;
  15 next    1.5;
  16
  17 1.5
  18 date    90.03.22.11.31.05;      author sources; state Exp;
  19 branches;
  20 next    1.4;
  21
  22 1.4
  23 date    90.03.20.19.41.41;      author sources; state Exp;
  24 branches;
  25 next    1.3;
  26
  27 1.3
  28 date    90.03.20.17.35.59;      author sources; state Exp;
  29 branches;
  30 next    1.2;
  31
  32 1.2
  33 date    90.03.16.15.58.04;      author sources; state Exp;
  34 branches;
  35 next    1.1;
  36
  37 1.1
  38 date    90.03.16.15.57.51;      author sources; state Exp;
  39 branches;
  40 next    ;
  41
  42
  43 desc
  44 @@
  45
  46
  47 1.7
  48 log
  49 @fixup for nroff problems
  50 @
  51 text
  52 @.\"    @@(MHWARNING)
  53 .\" @@(#)$Id: dp.rf,v 1.6 1990/04/05 15:08:58 sources Exp jromine $
  54 .SC DP 8
  55 .NA
  56 dp \- parse dates 822-style
  57 .SY
  58 @@(MHETCPATH)/dp
  59 \%[\-form\ formatfile]
  60 \%[\-format\ string]
  61 \%[\-width\ columns]
  62 dates\ ...
  63 \%[\-help]
  64 .DE
  65 \fIDp\fR is a program that parses dates according to the ARPA Internet
  66 standard.
  67 It also understands many non\-standard formats,
  68 such as those produced by TOPS\-20 sites and some UNIX sites using
  69 \fIctime\fR\0(3).
  70 It is useful for seeing how \fIMH\fR will interpret a date.
  71
  72 The \fIdp\fR program treats each argument as a single date,
  73 and prints the date out in the official 822\-format.
  74 Hence, it is usually best to enclose each argument in double\-quotes for the
  75 shell.
  76
  77 To override the output format used by \fIdp\fR,
  78 the `\-format\ string' or `\-format\ file' switches are used.
  79 This permits individual fields of the address to be extracted with ease.
  80 The string is simply a format stringand thefile is simply a format file.
  81 See \fImh\-format\fR\0(5) for the details.
  82
  83 Here is the default format string used by \fIdp\fR:
  84
  85 .nf
  86 .ti +.5i
  87 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
  88 .fi
  89
  90 which says that if an error was detected, print the error, a `:',
  91 and the date in error.
  92 Otherwise, output the 822\-proper format of the date.
  93 .Fi
  94 ^$HOME/\&.mh\(ruprofile~^The user profile
  95 .Pr
  96 None
  97 .Sa
  98 ap(8)
  99 .br
 100 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
 101 .De
 102 `\-format' default as described above
 103 .Ds
 104 `\-width' default to the width of the terminal
 105 .Co
 106 None
 107 .Bu
 108 The argument to the `\-format' switch must be interpreted as a single token
 109 by the shell that invokes \fIdp\fR.
 110 Therefore,
 111 one must usually place the argument to this switch inside double\-quotes.
 112 .En
 113 @
 114
 115
 116 1.6
 117 log
 118 @add ID
 119 @
 120 text
 121 @d2 1
 122 a2 1
 123 .\" @@(#)$Id:$
 124 d5 1
 125 a5 1
 126 dp \- parse dates 822\-style
 127 @
 128
 129
 130 1.5
 131 log
 132 @put things back, do .NA stuff another way
 133 @
 134 text
 135 @d2 1
 136 @
 137
 138
 139 1.4
 140 log
 141 @typo
 142 @
 143 text
 144 @d2 2
 145 a3 2
 146 .TH DP 8 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 147 .SH .NA
 148 d5 1
 149 a5 1
 150 .SH .SY
 151 @
 152
 153
 154 1.3
 155 log
 156 @fixup for makewhatis
 157 @
 158 text
 159 @d2 1
 160 a2 1
 161 .TH DP 8 [mh.6] MH
 162 @
 163
 164
 165 1.2
 166 log
 167 @fixup
 168 @
 169 text
 170 @d2 2
 171 a3 2
 172 .SC DP 8
 173 .NA
 174 d5 1
 175 a5 1
 176 .SY
 177 @
 178
 179
 180 1.1
 181 log
 182 @Initial revision
 183 @
 184 text
 185 @d33 1
 186 d36 1
 187 @