Pcal

   Pcal is a multi-platform program which generates annotated PostScript or
   HTML calendars in a monthly or yearly format.

   It is usually run from the command line but there is an HTML/CGI capability
   as well, to generate calendars from a web-browser interface.

   Various events can be defined in an external text file to control the
   appearance of the calendars generated by 'pcal'.  On monthly PostScript
   calendars, one or more EPS (Encapsulated PostScript) images (photos, icons,
   etc) can be displayed on any given day of the month.

   For much more detail on the available options and use of 'pcal', use any of
   the following sources:

      - View the manual page for 'pcal' by running 'man pcal' after
        installation.

      - View any one of the supplied help files:

           'pcal-help.ps' -- PostScript (nicest to view)
           'pcal-help.html' -- HTML
           'pcal-help.txt' -- ASCII text

        These files contain the same content as the manual page ('man pcal')
        but in different formats.  They were generated prior to the release of
        'pcal' with these commands (on Unix-like systems):

           groff -man -Tps pcal.man >pcal-help.ps
           groff -man -Thtml pcal.man >pcal-help.html
           groff -man -Tascii pcal.man >pcal-help.txt

        A simpler way to generate those files is to run 'make man', which
        should already have been done just prior to the release of a new
        version of 'pcal'.

      - Run the command 'pcal -h' to get a detailed list of help and
        command-line options.  This output is not always as thorough as the
        help sources mentioned above, but since it is generated directly from
        the program's internal variables, it will always show the most
        up-to-date information, in the rare case that the documentation
        mentioned above wasn't updated to match the program changes.

      - Here's a quick, current, alphabetical list of all the 'pcal' options
        and their associated meanings:

           ------------------------------- clip 'n' save
-------------------------------

           -A  parse American date format  -a  select output language (for
months/days)
           -B  don't fill unused day boxes  -b  print day in black
           -C  define centered footer string  -c  generate "calendar" utility
input
           -D  define preprocessor symbol & value -d  select alternate day font
           -E  parse European date format  -e  print empty calendar
           -F  define alternate starting day  -f  select alternate date file
           -G  print day as color-filled outline -g  print days in special color
(default gray)
           -H  generate calendar as HTML table  -h  generate full help message
           -I  re-initialize program defaults  -i  <unused>
           -J  print Julian day and days remaining -j  print Julian day (day of
year)
           -K  prev/next-month in 1st/last box  -k  prev/next-month in 1st 2
boxes
           -L  define left-justified footer string -l  landscape mode
           -M  print all moons    -m  print new/half/full moons
           -N  define heading for notes box  -n  select alternate notes font
           -O  print day as empty colored outline -o  select alternate output
file
           -P  paper size (letter, legal, a4, tabloid) -p  portrait mode
           -Q  <unused>     -q  generate yearly-planner style HTML calendar
           -R  define right-justified footer string -r  remap fonts for 8-bit
characters
           -S  suppress small prev/next-month calendars -s  define date color &
fill box shading color
           -T  select typeface for date/note text -t  select alternate title
font
           -U  undefine preprocessor symbol  -u  display parameter usage message
           -V  <unused>     -v  display version ID
           -W  <unused>     -w  print whole-year/page calendar
           -X  X-axis transformation   -x  X-axis scale factor
           -Y  Y-axis transformation   -y  Y-axis scale factor
           -Z  generate debugging information  -z  specify alternate time zone
           -#  print multiple copies of each page


   The 'pcal' (and 'lcal' [lunar calendar]) homepage is:

      http://pcal.sourceforge.net

   The 'pcal' and 'lcal' applications are available at:

      http://sourceforge.net/projects/pcal/