Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / miscellany / mem / promptdate.1
1 .TH PROMPTDATE 1 3/13/86
2 .SH NAME
3 promptdate \- accept date entry and print out in specified format
4 .SH SYNOPSIS
5 .B promptdate
6 [
7 .B -f format
8 ] [
9 .B datespec
10 ]
11 .SH DESCRIPTION
12 If no format is specified, one suitable for parsing by MH
13 will be used.
14 .PP
15 If no date is given on the command line,
16 .I promptdate
17 will interactively prompt for one.
18 It will persist in asking for a date until
19 a legal date is supplied.
20 To exit, type the EOF character (normally control-d).
21 .PP
22 The syntax of an acceptable date specification is:
23 .IP
24 "today" | "tomorrow" | <dayofweek> | "+"<daysfromtoday>
25 | <date> [<month> [<year>]]
26 .PP
27 where:
28 .IP
29 <dayofweek> is "sunday",...,"saturday"
30 .IP
31 <daysfromtoday> is an unsigned decimal number
32 .IP
33 <date> is a valid date for that month
34 .IP
35 <month> is "january",...,"december"
36 .IP
37 <year> is > 1970
38 .PP
39 Alphabetic strings may be in
40 any mix of upper or lower case.
41 They may also be abbreviated to
42 the first three letters.
43 .PP
44 <dayofweek> is equivalent
45 to specifying from "+1" to "+7".
46 .SH AUTHOR
47 Ken Yap (University of Rochester)
48 .SH BUGS
49 This manual page lies - the format is hardwired for MH.
50 General date formatting is not implemented yet.
51 .PP
52 Should accept more date formats. Will be replaced by a
53 user-friendlier version soon.