PSCAL(1)

NAME
pscal

SYNOPSIS:
pscal [ -Pprinter ] [ -R ] [ -r ] [ -t ] [ -d directory ] [ other printer flags ] [ month [ year ] ]

DESCRIPTION:
Pscal generates the Postscript showing a calendar for the specified month and year. The year, if omitted, defaults to the current year. If both month and year are omitted, the current month is printed. Year can be between 1753 and 9999. The month is a number between 1 and 12. I can also be a three letter month abbreviation.

The calendar can be loaded with information from the user. The information either comes in an `Event' file or can be derived from files under the user's Calendar directory should this exist. The search for this data is as follows, if any of these succeeds the data for the calendar is taken from that source.

1)  The shell variable EFILE may be set to the name of an Event file.

2)  An event file called `Event' may exist in the current directory.

3)  The file $HOME/.holiday may exist and contain a list of events.

4)  The directory $HOME/Calendar (or a different directory specified with the -d option) may exist containing XCal files.

An event file should consist of lines of the form

    month:day:message string

Messages should be 20 characters or less, with no more than 6 messages per day. No spaces should appear from the beginning of a line until after the second colon. Month and day should be numbers in the obvious ranges.

OPTIONS

-Pprinter
    The printer may be specified with the usual -Pprinter syntax.

-r  The calendar page is printed in ``landscape'' orientation (the default).

-R  The calendar page is printed in ``portrait'' orientation; this yields a slightly smaller image and may be more suitable for embedding into other documents.

-d directory
    Use the given directory instead of $HOME/Calendar.

-t  Causes the PostScript to be sent to the standard output, rather than to the printer. This is useful if you wish to save the output in a file, or if you want to use options with the lpr(1) command.

-Ffont
    Sets the font family for the title text (the month and year).

-ffont
    Sets the font family for the day-of-month numbers.

Other arguments starting with `-' are passed through to lpr(1).

Any argument whose first character is '-' is passed on to lpr. The shell variables BANNER, LFOOT, CFOOT, and RFOOT become a top centered banner, and left, centered, or right justified footers respectively. As in:

    BANNER="Schedule 1" CFOOT=Preliminary pscal 4 90

AUTHOR
Patrick Wood
Copyright (C) 1987 by Pipeline Associates, Inc.
Permission is granted to modify and distribute this free of charge.

HISTORY
Original From: patwood@unirot.UUCP (Patrick Wood)
Shell stuff added 3/9/87 by King Ables
Made pretty by tjt 1988
Holiday and printer flag passing hacks added Dec 1988 by smann@june.cs.washington.edu
Used the better looking version with 5 rows of days rather than 6 hacked together with holiday and banner/footnotes added by Joe (No Relation) Wood, 12/89, jlw@lzga.ATT.COM

BUGS
`Pscal' doesn't work for months before 1753 (weird stuff happened in September, 1752).

A better format for the dates of holidays would be nice. An escape to allow holiday messages to be raw PostScript would also be nice.

The holiday messages should be handled more intelligently (ie, the messages should be clipped to the day).