Clbuttic Computer Calendar 2005

"Charlie Gibbs"

Multics PL-I code for line printer calendars is available at

Info segment:

08-20-80 calendar

Syntax: calendar {paths} {-controlargs}

Function: prints a calendar for one month. The preceding and following months are also shown.

Arguments: paths are segments listing calendar events. See "Input" below.

Control arguments: -date D, -dt D D is any date acceptable to convertdatetobinary. The calendar is printed for the month containing this -date. If -date is not given, current month is printed. -fw, -fiscalweek labels boxes with fiscal week. -wait, -wt waits for the user to type a newline (carriage return) before printing the calendar. -stop, -sp waits for the user to type a newline (carriage return) before printing the calendar and again after printing it. -force, -fc prints the calendar even if errors are found in the input files. Prints "Error diagnostics complete." after the error messages (but only if there were errors). -boxheight, -bht changes the height of each calendar box from 7 lines to months do not appear in margin. -julian, -jul prints "julian dates" in bottom line of each box -- number of day from beginning of year and number of days remaining in year.

Output: The calendar has the month name and two-digit year at the top in big letters. Each calendar box is 16 characters wide; by default it is 7 lines high (see -boxheight control argument). The boxes contain nothing but the number of the day in the month, unless one or more paths are specified in the command line. Small calendars for previous and following months are fitted in above or below the main calendar.

Input: Each path specifies a segment containing comment lines that begin with "*", and lines that set up a string to be inserted into the calendar. The latter lines have from two to five fields, separated by commas. The first field is always the operation code (date, rel, repeat, rename, or easter).

Date opcode: For the "date" opcode, there are three fields. The second field is any date acceptable to convertdatetobinary. (This date will be converted relative to the day before the beginning of the month, so that "Mon" is the first Monday in the month, etc.) The third field is arbitrary text. Up to 16 characters are inserted into the calendar in the appropriate place if the specified date falls in the calendar month.

Rel opcode: For the "rel" opcode, there are five fields. The second is the month number. 0 indicates the current month, -1 the previous month, +1 the following month. The third is a date, relative to the day before the first of the month. The fourth field is a date relative to the third field, which is the day selected. The fifth field is text. Thus, the line rel,11,Mon,Tue,Election Day defines the first Tuesday after the first Monday in November.

Repeat opcode: For the "repeat" opcode there are 5 fields. The second is the starting date for a series of identical notations. It may be an ordinary date, or 0 (to indicate that the series starts at the first of any month), or a relative date or a date offset. The third field is the end date for the series, or an unsigned integer indicating the number of entries in the series, or 0 to indicate a perpetual series. The fourth field is the interval expressed as a date offset (e.g. 1week). The fifth field is text. Example: repeat,04-01-80,9weeks,1week,Karate lesson repeat,Thursday,0,1week,Staff Meeting

Easter opcode: For the "easter" opcode, there are only two fields. The second is text to be inserted into the box for Easter.

Rename opcode: For the "rename" opcode, there are three fields. The second is a day or month name to be replaced by the third. rename,Monday,segunda-feira changes the heading for the Monday column.

Example file: The following is an example file that defines permanent holidays. * holidays date,01-01,New Year's Day date,02-02,Ground Hog Day rel,2,Mon,2 weeks,Washington Bday easter,Easter rel,5,sun,1 week,Mothers Day rel,5,05-24,Mon,Memorial Day date,07-04,Independence Day rel,9,0,Mon,Labor Day rel,10,Mon,1 week,Columbus Day rel,10,Mon,3 weeks,Veterans Day rel,11,Mon,Tue,Election Day rel,11,Thu,3 weeks,Thanksgiving date,12-25,Christmas Day repeat,02-29-04,0,4years,Leap Day * end