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

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