Man Linux: Main Page and Category List

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