PSCAL(1)						      General Commands Manual							  PSCAL(1)

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 out-
		 put 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 Rela-
       tion) 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)