NAME

       pscal - generates postscript showing your calendar for given year and month

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.

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

       -f font   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).

                                                 8/January/1990                                         PSCAL(1)