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/
| |
