1 02/23/84  calendar
  2 
  3 Syntax:  calendar {paths} {-control_args}
  4 
  5 
  6 Function:  prints a calendar page for one month.  The preceding and
  7 following months are also shown.
  8 
  9 
 10 Arguments:
 11 paths
 12    are the pathnames of segments that contain a list of events in the
 13    form of text to be inserted into the calendar.
 14 
 15 
 16 Control arguments:
 17 -date DATE, -dt DATE
 18    identifies which month is printed.  DATE must be acceptable to
 19    convert_date_to_binary_ (see date_time_strings.gi.info).
 20    If -date is not given, the current month is printed.
 21 -fiscal_week, -fw
 22    labels boxes with fiscal week numbers.
 23 -wait, -wt
 24    causes the command to wait for a single newline character from you
 25    before printing the calendar.
 26 -stop, -sp
 27    causes the command to wait for a single newline character from you
 28    before printing the calendar and after printing it.
 29 
 30 
 31 -force, -fc
 32    prints a calendar regardless of errors in the input files.
 33 -box_height HEIGHT, -bht HEIGHT
 34    changes the height of each calendar box from seven lines to HEIGHT
 35    lines.  If HEIGHT is greater than seven, calendars for previous and
 36    following months do not appear in margin.
 37 -julian, -jul
 38    prints "julian dates" in bottom line of each box--the number
 39    of days from the beginning of the year and the number of days
 40    remaining in the year.
 41 
 42 
 43 Notes on output: Each box for a calendar day is 16 characters wide and
 44 seven lines high unless otherwise determined by -box_height.  Each box
 45 in the calendar contains the number of the day of the month; other
 46 information can also appear in the box, at your option.  The month
 47 preceding the specified month and the month following it are also
 48 printed.
 49 
 50 
 51 Notes on input: Each segment contains lines that set up a string to be
 52 inserted into the appropriate box of the calendar.  The fields in
 53 these lines are separated by commas and have the form
 54 
 55    opcode,dtfield,...,dtfield,text
 56 
 57 The first field is the operation code (date, rel, repeat, easter, or
 58 rename).  The second and succeeding fields depend on which operation
 59 code is used.  Lines that produce a date not in the current month are
 60 ignored.
 61 
 62 
 63 List of operation codes:
 64 date
 65    inserts a note for a specified date.  It has the syntax:
 66 
 67             date,DT,TEXT
 68 
 69    where DT is the date and TEXT is arbitrary text up to 16 characters
 70    long.
 71 
 72 
 73 rel
 74    inserts a note for a day that is calculated relative to the
 75    beginning of a month.  Its syntax is:
 76 
 77             rel,MONTHNO,RELDT1,RELDT2,TEXT.
 78 
 79       MONTHNO is a one- or two-digit number from one to 12
 80    indicating the month from which the event is to be calculated, or
 81    can be -1, 0 or +1 (-1 indicates the month previous to the printed
 82    month, 0 refers to the month being printed, and +1 indicates the
 83    month after the printed month.
 84       RELDT1 is a date converted relative to the day before the
 85    beginning of the specified month.  RELDT2 is a date that is
 86    converted relative to the date indicated by the RELDT1 of the
 87    third field.  It specifies the date selected for the insertion of
 88    the TEXT.
 89       TEXT is arbitrary text.
 90 
 91 
 92 repeat
 93    inserts a note into the boxes for several days that are separated
 94    by a constant interval of time.  The syntax is:
 95 
 96            repeat,STARTDT,END_OR_COUNT,INTERVAL,TEXT
 97 
 98       STARTDT is the date on which the series of events starts.  Zero
 99    indicates that the series starts on the first day of the printed
100    month.
101       END_OR_COUNT is the end date or 0, or a count of the number of
102    events in the series.  Zero indicates that the series continues
103    throughout the entire month being printed.  An integer number gives
104    the number of events in the series.
105 
106 
107       INTERVAL is any offset acceptable to convert_date_to_binary_
108    or 0.  An offset is truncated to an integral number of days; but if
109    it is less than one day, it is treated as if it were 1 day.  Zero
110    indicates an interval of 1 day.
111       TEXT is arbritrary text to be placed in the box of each day in
112    the series.
113 
114 
115 easter
116    calculates the date for Easter and inserts its text in that date if
117    it falls in the printed month.  The syntax is:
118 
119             easter,TEXT
120 
121 
122 rename
123    allows you to change the names of days or months.  Its syntax is:
124 
125             rename,OLDNAME,NEWNAME.
126 
127       OLDNAME gives the name of a day or month to be changed. If the
128    name of that day or month was previously changed in the current
129    invocation of the command, OLDNAME must be the current name.
130       NEWNAME gives the name to replace the OLDNAME.
131 
132 
133 Notes: All dates must be acceptable to convert_date_to_binary.  See
134 date_time_strings.gi.info for acceptable forms.
135 
136 If the command finds errors in its arguments, it reports the errors
137 and does not print a calendar.  If it finds errors in an input file,
138 it stops after all errors have been reported, unless you use -force to
139 indicate that the calendar should be printed in spite of errors.
140 
141 For more information, see the Commands and Active Functions manual,
142 Order no. AG92.