PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
NAME
pcal - generate PostScript (or HTML) calendars
SYNOPSIS
pcal [-e|-f cal] [-o file] [-l | -p] [-P [letter | legal | a4 |
tabloid]] [-j | -J] [-m | -M] [-g weekday[-weekday]|all|holiday]
[-O weekday[-weekday]|all|holiday]
[-G weekday[-weekday]|all|holiday]
[-b weekday[-weekday]|all|holiday]
[-s [day_numerics_color][/empty_day_box_fill_color]] [-F day]
[-A|-E] [-X xtrans] [-Y ytrans] [-x xscale] [-y yscale]
[-t [title_font][/size]] [-d [day_font][/size]]
[-n [text_font][/size]] [-L footer_str] [-C footer_str]
[-R footer_str] [-N notes_str] [-D symbol] [-U symbol] [-B] [-# n]
[-S | -k | -K] [-w] [-I] [-c | -H] [-q] [-z time_zone]
[-h | -u | -v] [-a output_language] [-r [mapping] [-T [B|I|R]]
[-W [left|center|right]] [month] [year] [nmonths]
DESCRIPTION
Pcal generates PostScript to produce landscape or portrait calendars
for any month and year. The arguments month, year, and nmonths, if
provided, should be numeric. The month value should be in the range 1
- 12, and the year value should be specified as 1 or 2 digits (in
which case it will be interpreted as that year in the current century)
or as the full 4-digit year. If no numeric arguments are provided,
the calendar for the current month and year will be generated.
If one numeric argument is provided, it is interpreted as the year
value, and calendars for the entire year will be generated.
Otherwise, nmonths months, starting with month and year, will be
generated.
For whole-year calendars (i.e. when the -w option is given), the
command line arguments are interpreted somewhat differently. By
default, all months in the current year are printed, starting with
January. If the month argument alone is given, it is expected to be
the desired year to print, and prints all of the months in the given
year. If both month and year are given, then 12 consecutive months
are printed starting at the given month and year. If the month, year,
and nmonths arguments are all present, printing begins with the given
month and year and nmonths months are printed, rounded up to the
nearest multiple of 12.
The Date File (Configuration File)
By default, pcal simply prints an empty calendar. Its real power is
- 1 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
in its ability to place ``events'' (and, for monthly-format PostScript
calendars, Encapsulated PostScript images [e.g. photos and icons]) in
appropriate days on the (PostScript or HTML) calendar, thus allowing
the user to create personalized calendars. This is achieved through
the use of the ``date file'', also known as the ``configuration
file''.
The default date/configuration file is expected to be named .calendar
(pcal.dat under MS-DOS), or calendar for compatibility with older
versions. Pcal will look in several places for such a file. First,
if the environment variable PCAL_DIR is defined, pcal searches the
directory indicated by that variable. Next, pcal searches the user's
home directory (as specified by the HOME environment variable). If
neither PCAL_DIR nor HOME is defined, pcal searches the current
directory instead. Finally, if enabled (via the `SEARCH_PCAL_DIR'
flag) when pcal was built, the directory where the pcal executable
resides will be checked. If no date file is found, an empty calendar
is printed; no error is generated.
Alternatively, the name of the date file (and, optionally, the path
where it can be found) can be specified using the -f command-line
option. See the OPTIONS section for more details.
Every pcal distribution comes with an 'examples' directory. The
`pcal-cfg.txt' file that is located there contains a myriad of
examples of settings that can be used in your own configuration file.
Please check it out for lots of useful ideas. Furthermore, that
directory contains several language/country-specific examples
(including holiday and other event definitions) in various
`calendar_xx.txt' files, where `xx' represents the 2-letter language
code (e.g. 'calendar_de.txt' is the German example file).
If a date file is found, it will be searched for lines with leading
dates matching the requested month and year.
Any text following the dates found will be printed on the calendar
under the appropriate day of the month. Encapsulated PostScript (EPS)
images are handled similarly as described in a later subsection.
troff-style escape sequences \fB, \fI, \fP, and \fR may be used to set
the font style to Bold, Italic, the previous font style, or Roman
respectively. For those more familiar with HTML, <B>, <I>, </B>, and
</I> may be used instead to enable/disable Bold or Italic font styles.
The font style is reset to Roman after each line break.
Using the `include' pre-processor directive (described in the section
entitled `Pre-Processor Functionality', below), other configuration
files can be processed from within an existing configuration file.
That is, you can `nest' configuration files as needed.
- 2 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
Dates (essentially `events') in the configuration files may be
expressed in any of several formats:
+ <ordinal> <day_spec> in <month_spec>{*} {<text>}
+ {<ordinal>} <day_spec> <prep> <date_spec>{*} {<text>}
+ <date_spec>{*} {<text>}
+ <pre_defined_event>{*} {<text>}
Where:
<month_name> := first 3+ characters of name of month, or
``all''
Note: pcal looks for names of the days of the
week prior to names of months when parsing event
date specifications. Furthermore, some
languages (e.g. French and Finnish) have a month
name whose first 3 letters are the same as the
first 3 letters of one of the names of the days
of the week. Because of this, the specification
in such a language of any month name which
collides thusly must use 4 or more letters to
distinguish it from the name of the day of the
week with which it `collides'.
<month_spec> := <month_name>, or ``year''
<day_spec> := first 3+ characters of name of weekday,
``day'', ``weekday'', ``workday'', ``holiday'',
``nonweekday'', ``nonworkday'', ``nonholiday'',
``new_moon'', ``first_quarter'', ``full_moon'',
or ``last_quarter''
<ordinal> := any ordinal number (``1st'', ``2nd'', etc.),
``first'' ... ``fifth'', ``last'', ``odd'',
``even'', or ``all''
<prep> := ``on'', ``before'', ``preceding'', ``after'',
``following'', ``on_or_before'' (``oob''),
``on_or_after'' (``ooa''), ``nearest'',
``nearest_before``, or ``nearest_after``
<pre_defined_event>
:= ``Christmas'', ``Thanksgiving'', ``Easter'',
``Good_Friday'', ``GEaster'' (Orthodox Easter),
``Gstgeorge'' (Orthodox holiday), and
``Gmarcus'' (Orthodox holiday).
- 3 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
<sep> := one or more non-numeric, non-space, non-`*'
characters
<month> := a numeric month (1-12)
<day> := day of month (1-31)
<year> := a numeric year
<text> := the text to be displayed for this event; if
the text begins with the constant string
``image:'', then it is interpreted as a
specification of an Encapsulated PostScript
(EPS) image rather than as simple text; more
information on specifying EPS images is
available in a later section of this document
If the -A option (American date formats, the default) is given:
<date_spec> := <month_name> <day> |
<month><sep><day>{<sep><year>}
If the -E option (European date formats) is given:
<date_spec> := <day> <month_name> | <day> <month> |
<day><sep><month>{<sep><year>}
The ``Notes'' box (see below) uses the first of the current month as
the default date. All footer strings use the first of the current
month in single-month mode and the first of the starting month in
whole-year mode.
Examples:
last Monday in May* Memorial Day Holiday
all Fridays in Oct Status Meeting, 11 AM
first workday in all %-B progress report due
all Fri in all \fBTime card due,\fP 3 PM
all Monday in all Fiscal week %0W
-2nd workday in all Schedule for %+B due %+2D
2nd full_moon in all Blue Moon
Fri on_or_before all 15 Pay Day
even Fridays in year Pay Day
183rd day of year Mid-year (%l days left)
Tue after first Mon in Nov Election Day (USA)
- 4 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
4th Thu in Nov* Thanksgiving
Fri after 4th Thu in Nov* Day after Thanksgiving
workday nearest 12/25* Holiday
12/25/04* Christmas # American
25.12.04* Christmas # European
25. 12.* Christmas # European
Dec 25* Christmas # American
25 Dec* Christmas # European
25. Dec* Christmas # European
Fri on all 13 Avoid black cats! # 'Friday the 13th'
Any non-numeric character may separate numeric dates. Holidays may be
flagged by following the date immediately with `*' as in the examples
above; this will cause the date numerics to be printed in the color
specified by the -s option (default = gray) and will cause the
associated text (on monthly-format calendars) to be placed adjacent to
the numeric date in the day box rather than below the numeric date (as
is done for all non-holiday events). ``Each'' and ``every'' are
accepted as synonyms for ``all'', and any word may be used in place of
``in''. The abbreviations ``oob'' and ``ooa'' may be used in place of
the keywords ``on_or_before'' and ``on_or_after'', respectively.
``Nearest'' attempts to match the specified date; if that fails, it
tries the day after, then the day before, then two days after, two
days before, and so forth until a match occurs.
Wildcard day names are also provided. The keyword ``weekday'' applies
to any days which are normally printed in "logical black" - the
predominant day color - on the calendar. The keyword ``workday'' is
the same, but does not include any holidays. The keyword ``holiday''
includes only those days flagged as holidays. The keywords
``nonweekday'', ``nonworkday'', and ``nonholiday'' are also recognized
as negations of the above. See the CAVEATS below for important notes
on using these keywords. Moon phases may also appear as wildcards;
``nm'' is accepted as a synonym for ``new_moon'', ``1q'' and ``fq''
for ``first_quarter'', ``fm'' for ``full_moon'', ``3q'' for
``third_quarter'', and ``lq'' for ``last_quarter''.
Ordinal day numbers may be used to specify dates, either relative to
the month or to the year. Either words or numeric abbreviations may
be used for ``first'' through ``fifth''; higher numbers must be given
using the numeric equivalent (e.g. 100th). Negative ordinal numbers
may even be used. For example, ``-2nd'' means ``next to last''.
``Odd'' and ``even'' do not refer to the actual date; instead, ``odd''
means ``alternate, starting with the first'', and ``even'' means
``alternate, starting with the second''. Thus, ``odd Fridays in
- 5 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
March'' refers to the first, third, and (if present) fifth Fridays in
March - not to those Fridays falling on odd dates.
``All'' refers to each individual month; ``year'' refers to the year
as an entity. Thus ``odd Fridays in all'' refers to the first, third,
and fifth Friday of each month, while ``odd Fridays in year'' refers
to the first Friday of January and every other Friday thereafter.
``Nearest'', ``nearest_before'', and ``nearest_after'' refer to the
nearest weekday or wildcard day with respect to the specified date.
``Nearest_before'' and ``nearest_after'' allow the user to specify how
pcal is to disambiguate between two dates that are equally near: e.g.,
``nonweekday nearest_before [Wed.] 9/25/96'' refers to Sunday, 9/22
while ``nonweekday nearest_after 9/25/96'' refers to Saturday, 9/28.
(Note that ``nearest_before'' and ``nearest_after'' are equivalent to
``nearest'' when no such ambiguity exists: e.g., ``nonweekday
nearest_before [Thu.] 9/26/96'' refers to Saturday, 9/28.)
Text in the date file may use C-like escape sequences (i.e. a `\'
followed by a character, 1 - 3 octal digits, or `x' followed by 1 - 2
hexadecimal digits). Escaped whitespace (including newline ) and the
standard ANSI character escapes (`\a', `\b', `\f', `\n', `\r', `\t',
`\v') are all replaced by a single blank.
The HTML special characters `<' `>' `"' `&' ` '
and `&#NNN;' (NNN = any three decimal digits) are also supported.
These will be propagated intact (be sure to escape the `#' in
`&#NNN;') if the output is specified as HTML (see the -H flag);
otherwise they will be converted to their ASCII equivalents. This
allows a common date file to be used regardless of whether the desired
output format is HTML, PostScript, or Un*x calendar(1) (see the -c
flag) input.
Lines in the configuration file consisting of year #### (where #### is
a numeric year) can be used to set the year for following entries.
This assumes that the following entries do not contain a year; any
date entries containing year information will set the remembered year
to that year.
Lines in the configuration file consisting of year all (or,
alternatively, year *) direct pcal to wildcard following entries
against every applicable year. This assumes that the following
entries do not contain a year; any date entries containing year
information (or an explicit year #### entry) will set the remembered
year to that year.
Lines in the configuration file consisting of opt <options> can be
used to override the defaults for any command-line options except -c,
-e, -f, -h, -H, -u, -v, -D, and -U. Any options specified in this
- 6 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
manner are, in turn, overridden by those specified explicitly on the
command line.
Lines in the configuration file consisting of note{/<number>} <month>
can be used to place notes regarding the entire month in one of the
unused blocks of the calendar. The <month> indicator may be either a
number 1 through 12 or an alphabetic month name as described above;
``note all'' will place the associated text in the notes block for
each month in the current year. <number> is an optional positive or
negative number specifying the empty box where the associated text is
to be placed. If positive, pcal counts forward from the first empty
box; if negative, pcal counts backward from the last empty box. Thus,
``note/1'' places the associated text in the first empty box; note/-3
in the third-to-last. The default is -1 if no <number> is given (last
empty box, immediately preceding the small calendars on the bottom
row; cf. -S, -k, and -K, below). You can place several notes in the
same box. You can also use more than 1 box for the various monthly
notes.
Lines in the configuration file consisting of input-language XX (where
XX is the 2-letter specification for any of the supported languages)
can be used to set the language used for interpretation of the month
names and day-of-week names for the remaining event entries. This
option may be specified more than once, as needed, if the language
used to describe events changes within the file. For backwards
compatibility, the default value for `input language' if this
directive is never used is 'en' (English). Note that this directive
is distinct from the specification of 'output language' as
accomplished with the -a option.
Comments are supported in the configuration file. Any characters
following a `#' character are ignored, through the end of that line,
unless the `#' character is escaped by `\'.
Deleting Events
By prepending the `delete' keyword to an event specification, one or
more events may be deleted from a set of previously-specified events.
For example, the following lines might appear in the date file:
all Friday in all Poker game
delete first Friday in all Poker game
This results in an event labeled `Poker game' on every Friday except
the first Friday of the month. If you delete an entry which is marked
as a holiday, the `holiday' flag for that day will be recalculated.
Any `delete' entries which don't match any pre-existing entries are
- 7 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
silently ignored.
Format Specifiers
Pcal allows format specifiers in both the event text and footer
strings (see the -L, -C, -R, and -N options below). Each format
specifier will be replaced by a corresponding string as outlined in
the following table:
%a abbreviated weekday
%A full weekday
%b abbreviated month name
%B full month name
%d day of month (1-31)
%j day of year (1-366)
%l days left in year (0-365)
%m month (1-12)
%U week number (0-53)
%W week number (0-53)
%u week number (1-54)
%w week number (1-54)
%y year w/o century (00-99)
%Y year w/century
%% `%' character
%o print number as ordinal
%0 print number with leading zeroes
%+ use following month or year
%- use previous month or year
%{+N}[DWMY] adjust date by +N days/weeks/months/years
%{-N}[DWMY] adjust date by -N days/weeks/months/years
Most of these are derived from the ANSI C strftime() function, but the
%[louwMD] and %[o0+-] format specifiers are specific to pcal.
The %u specifier considers the week containing 1/1 (Jan 1st) as week 1
and the following logical Sunday (the first day of the week as
printed; cf. the -F option below) as the start of week 2; %U considers
the first logical Sunday as the first day of week 1. %w and %W behave
like %u and %U respectively, but use the first logical Monday instead.
Note that %w has a different meaning from strftime().
The %o format specifier prints a number as an ordinal, with the
appropriate suffix (``st'', ``nd'', ``rd'', or ``th'' in English)
appended. For example, %od prints the day of the month as ``1st'',
``2nd'', ``3rd'', etc.
Unlike strftime(), pcal defaults to printing numbers (except %y)
- 8 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
without leading zeroes. If leading zeroes are desired, the `0' prefix
may be used. For example, %0j prints the first day of year as
``001''.
The %+ and %- format specifiers direct pcal to substitute the
following/previous month/year in the following [bBmyY] specifier. For
example, %+B prints the name of the next month.
The %{[+-]N}[DWMY] format specifiers do not print anything, but
instead adjust the working date by _ Ndays (D), weeks (W), months (M),
or years (Y). Subsequent format specifiers use the adjusted date
instead of the current date. For example, %+1M %B %Y adjusts the date
forward by one month and then prints the resulting month and year
(``January 1992'' in December, 1991); %-2W %b %d adjusts the date
backward by two weeks and prints the resulting month and day (``Jul
26'' on August 9).
Such date adjustments are normally cumulative; for example, %+1Y%-1D
adjusts the date forward by one year and then backward by one day. If
%D or %M is specified alone (or if N is zero), pcal restores the
original date. Note that %M has a different meaning to the strftime()
function.
Here's a common, useful example of an event entry for the pcal date
file which combines the ability to adjust working dates and the
ability to display ordinals. This particular example is used to
display text on the birthday of a person born in 1991:
May 10 Eric's %-1991Y%oY Birthday
That entry would result in the following text being displayed on May
10, 2005:
Eric's 14th Birthday
Encapsulated PostScript (EPS) Images
For monthly PostScript calendars only, pcal supports the embedding of
one or more EPS images (photos, icons, etc) into any given day of the
month. (EPS image specifications in the pcal date file are ignored
for yearly PostScript calendars and for all HTML calendars.)
In order to associate an image with a given event, you must add one or
more entries to the date file. The event date is specified exactly as
described previously for simple event text specification lines.
However, instead of specifying the text associated with the event, you
instead specify the EPS image filename and some additional parameters
in the following format:
image:<EPS-image-filename> <x-scale> <y-scale> <x-delta> <y-delta>
- 9 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
Where:
<EPS-image-filename> is the filename (which can include a path)
of the Encapsulated PostScript image.
Note: The EPS image filename must be
preceded by the constant text `image:' in
order to distinguish an EPS image
specification from an ordinary event text
specification.
<x-scale> is a scaling factor in the horizontal
dimension for the EPS image. A value of
1.0 is nominal (i.e. no change to image
scale). Values between 0.0 and 1.0 shrink
the image in the horizontal dimension
while values over 1.0 expand the image in
the horizontal dimension. Generally
speaking, only positive values should be
used. However, in the rare case that you
find that your EPS image needs to be
flipped about the vertical axis (i.e. left
to right), you can use a negative value to
achieve this without having to tweak the
actual PostScript content within the EPS
image file. Use of a negative value will
undoubtedly necessitate a corresponding
change to the <x-delta> parameter to
account for the image's relocated position
that occurs when it gets flipped "left-
to-right".
<y-scale> is a scaling factor in the vertical
dimension for the EPS image. Values
between 0.0 and 1.0 shrink the image in
the vertical dimension while values over
1.0 expand the image in the vertical
dimension. Note that a negative value for
this parameter can be useful in the less-
than-rare case that you find that your EPS
image needs to be flipped about the
horizontal axis (i.e. top to bottom). In
such cases, you can use a negative <y-
scale> value to achieve this without
having to tweak the actual PostScript
content within the EPS image file. Use of
a negative value will undoubtedly
necessitate a corresponding change to the
<y-delta> parameter to account for the
image's relocated position that occurs
- 10 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
when it gets flipped "upside down".
<x-delta> := a horizontal adjustment in typographic
`points' (i.e. 72nds of an inch) for the
positioning of the EPS image. With
offsets of 0 for X and Y, the image will
be printed at the extreme left edge of the
box for that day, just under the numerics
for that day. Positive values move the
image to the right and negative values
move the image to the left.
<y-delta> := a vertical adjustment in typographic
`points' (i.e. 72nds of an inch) for the
positioning of the EPS image. With
offsets of 0 for X and Y, the image will
be printed at the extreme left edge of the
box for that day, just under the numerics
for that day. Positive values move the
image up and negative values move the
image down.
Here's an example of a line from the date file that associates an EPS
image with an event:
4th Thu in Nov* Thanksgiving
4th Thu in Nov* image:/eps-path/turkey.eps 1.0 1.0 0 0
You can place as many images as you want on a single day of the month
by specifying repeated lines in the date file. For example, these
lines put icons of George Washington and Abraham Lincoln on the day of
the U.S. ``Presidents' Day'' holiday, along with the event text:
3rd Monday in Feb* Presidents' Day
3rd Monday in Feb* image:/eps-path/washington.eps 0.08 0.08 8 0
3rd Monday in Feb* image:/eps-path/lincoln.eps 0.22 0.22 48 0
Note that the icon for Lincoln is shifted to the right by 48
typographic points so as not to overlay the first icon.
The pcal releases come with a single EPS sample file
('eps/recycle.eps') of the ubiquitous 'recycle' icon (3 green arrows
in a triangular shape). Such an image might be used with
configuration file settings like this:
second Sat in all RECYCLE!
second Sat in all image:/eps-path/recycle.eps 0.039 0.039 34 -9
In cases where you're displaying non-holiday event text (e.g.
- 11 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
someone's birthday) and an EPS image, you'll often need to use a
negative `Y-delta' value on the EPS image specification line, in order
to shift the image down so that it doesn't cover the event text, which
appears just below the day's numerics for non-holiday events. (Text
for holiday events appears higher up, to the right of the day's
numerics, so there's usually no collision with the EPS image.)
Note: Unfortunately, most EPS images cannot be used directly by pcal.
Depending on the EPS image used and how it was created, you may
have to remove or comment out some or all of the PostScript
`translate' commands, in order to avoid the use of illogical X-
delta and Y-delta values when specifying the EPS image in your
pcal date file. Most programs that generate EPS output (either
directly or via conversion from some other graphic format) seem
to have these `translate' commands relatively early in the EPS
file.
It may take some experimentation to get it just right. Preview
the pcal output using a PostScript viewer as you tweak the
PostScript commands in the EPS image file and/or the event entry
in the pcal date file.
Note: Depending upon what application you use to preview
PostScript content, the monthly calendars may not show any
embedded EPS images. Here's a rundown of some popular
PostScript-viewing applications and whether they correctly
display the embedded EPS images:
+ gv (version 3.5.8) -- EPS images appear fine
+ ggv (versions 2.4.0.1 and 2.6.1) -- EPS images appear
fine
+ older kghostview (versions 0.13.2 [KDE 3.1.4] and
0.2.0 [KDE 3.2.3 and 3.3.2]) -- EPS images DO NOT
APPEAR!
+ newer kghostview (version 0.2.0 [KDE 3.4.2 and
3.5.4]) -- EPS images appear fine
For converting non-EPS images (e.g. photos) to EPS format, one can use
the graphical GNU Image Manipulation Program, a.k.a. `The GIMP':
http://www.gimp.org
For icons/images in WMF format (which are popular in various 3rd-
party, legacy-OS, commercial calendar programs), the
`libwmf'/`wmf2eps' library/utility is useful for generating pcal-
capable EPS images. It can be found at this site:
http://wvware.sourceforge.net/libwmf.html
- 12 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
For icons/images in SVG format, the ImageMagick `convert' utility is
sometimes useful for generating pcal-capable EPS images. This suite
of utilities (which includes other useful ImageMagick utilities like
`display' and `identify') may already be available on your Linux
distribution. If not, it can be found at this site:
http://www.imagemagick.org
For cases where ImageMagick's `convert' utility fails to properly
convert SVG-format images to EPS format, you can try the method of
converting the SVG image into an intermediate format (e.g. PNG) using
the `rsvg' utility. This utility may already be available on your
Linux distribution. If not, it can be found at this site:
http://librsvg.sourceforge.net/
From the PNG format, the image can often then be successfully
converted to EPS format, using the above-mentioned ImageMagick
`convert' utility.
The Open Clip Art Library is a good source of freely-usable images
(many of which are in SVG format) for decorating your events:
http://www.openclipart.org
Note: The EPS image content is not generated in the PostScript output
-- only a reference to the EPS image filename is generated. From a
practical standpoint, this means that normally you'll need to
print/preview the PostScript output of pcal from the same
computer/setup as that which was used to run pcal in the first place.
If you want to generate a calendar with embedded EPS images that will
later be printed/viewed on another machine which does not have access
to those EPS images, you'll need to run the output through a pre-
processor which will put the EPS image content into the PostScript
output file. For example, assuming your initial calendar output was
generated to a file named `pcal.ps', on most GNU/Linux systems you
could run this command, which uses the popular `Ghostscript'
interpreter:
gs -r300x300 -dBATCH -dNOPAUSE -sDEVICE=pswrite
-sOutputFile=out.ps pcal.ps
This would generate a PostScript file named `out.ps', at 300x300 dpi
resolution, which has the actual EPS image content embedded within,
allowing you to transport the `out.ps' file to another computer for
viewing/printing. Of course, the new file is substantially larger,
but it's portable. Furthermore, the EPS images will be viewable even
in PostScript-viewing applications (see above) which don't properly
support the display of embedded (by filename only) EPS images.
Pre-Processor Functionality
Pcal supports rudimentary cpp-like functionality in the date file,
allowing the following constructs:
- 13 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
+ define | undef
+ if{{n}def} ... {elif ...}* {else ...}
+ include
Note that these are not preceded by `#' as they are in C.
Symbol names defined using these keywords (or via the -D option) are
case-insensitive. It is not an error to undef an undefined symbol,
nor to define a previously-defined one.
A symbol can be defined with just a name (e.g. ``define MY_SYM'') or
it can take on a value (e.g. ``define MY_SYM SOME_VALUE''). Use of
symbol values is convenient for defining a starting date then using
that symbol to reference that starting date in one or more events.
For example, these definitions in the date file might be useful:
define semester_start 8/23 # Beginning of semester
semester_start Class Start
7th day after semester_start 1st Quiz
14th day after semester_start 2nd Quiz
undef semester_start
Be aware that the substitution of symbol values for symbol names is
not robust, so it's wise to use a symbol name that's unlikely to occur
in any of your other event text. In other words, if you defined the
`semester_start' symbol in the example above as merely `start', then
you'd get the undesired effect of having the text `Class 8/23' in your
calendar on that day instead of `Class Start'! The use of `undef
semester_start' in the above example is optional and is really only
useful to prevent any unwanted symbol substitutions later on, which
probably won't happen unless you poorly choose your symbol name to
begin with.
An ifdef alone is always false; an ifndef alone is always true. if is
accepted as a synonym for ifdef.
The name of the file in the include directive may optionally be
surrounded by either "" or <>, both of which are ignored. If the name
is not an absolute path, it is taken to be relative to the directory
where the file containing the directive is located. If the string
"%y" appears in the file name, it is replaced by the last two digits
of the current year or, if "year all" is in effect, is expanded to all
applicable years. Pcal is smart enough to translate ~/ to the user's
home directory.
Pcal normally terminates immediately if the file specified in an
include directive does not exist. An alternate form of the directive,
include?, directs pcal to continue silently if the file does not exist
- 14 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
or cannot be opened.
In addition to pre-processing keywords, pcal also accepts boolean
expressions in if{{n}def} and elif directives. These expressions
consist of symbol names joined by the boolean operators !, &, ^, and
|, in order of precedence, high to low. Parentheses may be used to
alter the precedence. The synonyms && and || are accepted for & and
|. A symbol name evaluates to true if currently defined, false if
not; thus:
ifdef A | B | C
...is true if any of the symbols A, B, and C is defined, and:
ifdef A & B & C
...is true if they all are. Note that ifndef <expr> is equivalent to
ifdef !( <expr> ).
The Moon File
If a file of the name .moon## (moon##.dat under MS-DOS), where ## is
the last two digits of the calendar year, exists in the same directory
as the date file (or in the directory where pcal resides), pcal uses
the information contained within to calculate the phase of the moon.
If a) no such file exists, b) the -e flag (do not use a date file) is
specified, or c) the -z flag (specify time zone) is specified, then
pcal uses an algorithm to calculate the phase of the moon.
Entries in the moon file must conform to the following syntax:
If the -A option (American date formats, the default) is given:
<quarter> <month><sep><day> {<hour><sep><min>}
If the -E option (European date formats) is given:
<quarter> <day><sep><month> {<hour><sep><min>}
Where:
<quarter> := ``nm'', ``fq'' or ``1q'', ``fm'', ``3q'' or ``lq'' (new moon,
first quarter, full moon, last quarter)
<hour> := number 0-23 (24-hour clock)
<min> := number 0-59
This file must contain entries for all quarter moons in the year, in
chronological order; if any errors are encountered, pcal will revert
- 15 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
to using its default algorithm.
As in the date file, comments start with `#' and run through the end
of the given line.
The moon file may optionally contain an opt -A or opt -E line to
specify the format of its own date entries independently of the format
used in the date file. No other flags are legal in the moon file.
Generating PostScript Calendars Via A Web
PostScript-format pcal calendars can be generated and viewed from a
web browser interface.
Note: This is not to be confused with the ability to generate
non-PostScript, HTML-format (using the -H command-line option)
calendars, which is a different capability entirely.
Pcal comes with 4 files that provide this ability: `pcal.cgi' (a
Bourne shell script), `pcal.pl' (a Perl equivalent of `pcal.cgi'),
`pcal.html', and `pcalw.html'.
The CGI file (either `pcal.cgi' or `pcal.pl') must be edited before
using it. Change the definition for `pcal=' (Bourne shell script) or
`my $PCAL =' (Perl script) to point to the location of the pcal
executable file. Change the definition for `file=' (Bourne shell
script) or `my $FILE =' (Perl script) to point to the location of the
pcal `date file' (e.g. `.calendar'), which contains the options for
running pcal. Finally, copy the `pcal.cgi' (or `pcal.pl') file to the
location where your web server expects to find such files (e.g.
`/var/www/cgi-bin/').
The `pcal.html' and `pcalw.html' files must also be edited. Each one
has a line like this:
<FORM ACTION="http://yourpath/cgi-bin/pcal.cgi" METHOD=GET>
That line must be edited to point to the host and location of your CGI
script file (`pcal.cgi' or `pcal.pl').
Once that's done, point your web browser to the `pcal.html' or
`pcalw.html' file to generate monthly/yearly PostScript calendars for
viewing within your web browser.
Note: Depending upon what application your web browser spawns to
preview PostScript content, the monthly calendars generated via
this web browser interface may not show any embedded EPS images.
For a rundown of some popular PostScript-viewing applications and
whether they correctly display the embedded EPS images, see the
section (above) entitled `Encapsulated PostScript (EPS) Images'.
OPTIONS
-e Prints an empty calendar. Do not print entries from a .calendar
- 16 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
file even if one exists.
-f cal
Directs pcal to use the file name cal as the input file in place
of the default .calendar file. Note that the search rules are
different when -f is used. If cal is an absolute file name (i.e.
starting with a `/'), then pcal attempts to open only that file.
Otherwise, pcal looks for cal in the current directory, then in
the directory indicated by the environment variable PCAL_DIR (if
defined), and finally, if enabled (via the `SEARCH_PCAL_DIR'
flag) when pcal was built, in the directory where the pcal
executable resides. If the given cal file is not found, an error
results.
-o file
Directs pcal to write the output to file instead of to stdout.
-l Causes the output to be in landscape mode (default).
Pcal predefines the symbol `ORIENTATION_LANDSCAPE' whenever
`landscape' page orientation is enabled. This can be useful for
providing alternate values in the configuration file for EPS
image placement and scaling, based on the page orientation.
-p Causes the output to be in portrait mode.
Pcal predefines the symbol `ORIENTATION_PORTRAIT' whenever
`portrait' page orientation is enabled. This can be useful for
providing alternate values in the configuration file for EPS
image placement and scaling, based on the page orientation.
-P Selects the paper size. The following sizes are supported:
+ letter - 8.5 x 11.0 inches
+ legal - 8.5 x 14.0 inches
+ a4 - 210 x 297 mm
+ tabloid - 11.0 x 17.0 inches
Pcal predefines one of the following symbols based on the current
paper size:
+ PAPERSIZE_LETTER
+ PAPERSIZE_LEGAL
- 17 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
+ PAPERSIZE_A4
+ PAPERSIZE_TABLOID
These symbol definitions can be useful for providing alternate
values in the configuration file for EPS image placement and
scaling, based on paper size.
-j Causes the Julian date (day of year) to be printed in each
calendar box.
-J Causes the Julian date and the number of days remaining in the
year to be printed in each calendar box.
-m Causes moon icons to be printed on dates corresponding to new,
half, and full moons (the default is that no moons are printed).
-M Causes moon icons to be printed on all dates (the default is that
no moons are printed).
-g day1[-day2] | all | holiday
Causes all dates falling on weekday day1 (through day2 if
specified) to be printed in the `day numerics color' (i.e. the
color specified by the -s option [default = gray]); -g all causes
all weekdays (other than holidays) to be printed in the `day
numerics color'; -g holiday causes all holidays to be printed in
`day numerics color'. day1 and day2 may wrap around weekends;
for example, -g fri-sun causes Fridays, Saturdays, and Sundays to
be printed in the `day numerics color'.
-O day1[-day2] | all | holiday
Similar to -g, but the selected days will be printed as outlined
characters, using the `day numerics color'.
-G day1[-day2] | all | holiday
Similar to -g, but the selected days will be printed in the `day
numerics color', outlined in black.
-b day1[-day2] | all | holiday
Similar to - you guessed it - -g, but the selected days will be
printed in black. Since black is the default for weekdays, -b is
primarily used to overriding other flags (e.g., -g all -b sat-sun
).
Note:
The default for the above options is to print Saturdays, Sundays,
and holidays in the `day numerics color' and all other days in
black. For backward compatibility with earlier versions of pcal,
-O and -G alone change all non-black days to the specified color.
- 18 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
-s [day_numerics_color][/empty_day_box_fill_color]
Overrides the default value(s) for the color of the numerics for
each day and/or the color of the fill used on boxes for 'empty'
days. Note: This option only applies to PostScript-format
calendars, not to HTML-format calendars. These values may be set
independently of each other. For use with non-color printers,
these values should be in the range 0.0 (black) through 1.0
(white). The default values are 0.8 for day numerics and 0.9 for
empty day boxes. For use with color printers, these values may
optionally be specified as a set of red:green:blue (RGB) values,
each of which must in the range 0.0 through 1.0. At least one
`:' must be present for these values to be recognized as RGB
colors; omitted values are set to 0.0.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-F day
Selects weekday day as the first day of the week. The given day
will appear in the left-most column of the calendar. day may be
specified either as a weekday name or, optionally, as a number in
the range 0 (Sunday) through 6 (Saturday).
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-A Directs pcal to use American date conventions ( mm/dd{/yy} and
month dd ) when parsing the date file. This is the default.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-E Directs pcal to use European date conventions ( dd/mm{/yy} and dd
month ) when parsing the date file.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-X xtrans
Specifies the x-axis translation value for positioning the output
on the page. Positive values shift the output to the right.
Negative values shift the output to the left.
-Y ytrans
Specifies the y-axis translation value for positioning the output
- 19 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
on the page. Positive values shift the output up. Negative
values shift the output down.
-x xscale
Specifies the x-axis scaling factor for the calendar size.
-y yscale
Specifies the y-axis scaling factor for the calendar size.
-t [title_font][/size]
Specifies the name of a font to use for all the calendar heading
text:
+ the month name and year at the top of the calendar (for
monthly-format calendars) or at the top of each month (for
yearly-format calendars and for the small previous/next-
month calendars [if enabled] on monthly-format calendars)
+ the day-of-week names
+ the footer strings (if any)
+ the ``Notes'' box heading (if any; for monthly calendars
only)
For monthly calendars only, the user may optionally specify the
font size, which applies only to the main month/year heading.
For example, pcal -t Times-Roman/54 sets the font to Times-Roman
and the month/year point size to 54. The font size may also be
changed independently: pcal -t /54 changes the point size to 54
without affecting the font name.
Note: For yearly calendars, any specification of font size is
ignored.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-d [date_font][/size]
Similar to the -t option, but selects the font and/or size used
for the day numerics (the numbers inside the box for each day).
Note: For yearly calendars, any specification of font size is
ignored.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
- 20 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
-n [text_font][/size]
Similar to the -t and -d options, but selects the font and/or
size used for any `event' text associated with each day and for
any text in the monthly ``Notes'' box.
Note: This option applies to monthly calendars only. For yearly
calendars, this option does not apply.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-L string
Causes the accompanying string to be printed as a left-justified
footer. Format specifiers denoting the month and/or year may
appear in the string; the appropriate values will be substituted
upon printing.
-C string
Similar to -L, but causes the accompanying string to be printed
as a centered footer. If the -H flag (generate calendar as HTML
table) was specified, this string will be used as the title and
heading.
-R string
Similar to -L, but causes the accompanying string to be printed
as a right-justified footer.
-N string
Causes the accompanying string to be printed as the heading for
the "Notes" box. Note, however, that pcal makes no attempt to
ensure that it fits.
-D symbol [value]
Defines the named symbol and an optional value to be associated
with that symbol, prior to reading the date file.
-U symbol
Un-defines the named symbol prior to reading the date file.
-B Causes pcal to leave unused calendar day boxes blank as opposed
to the default behavior of filling them using the `empty day-box
fill color' (i.e. the color specified by the -s option [default =
gray]).
-# n Causes pcal to print n copies (maximum: 100) of each output page.
-S Causes pcal to suppress printing the small calendars. See the
CAVEATS section for further details.
- 21 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
-k Causes pcal to print the small calendars in the upper left corner
(the default is to print them at the lower right).
-K Causes pcal to print the small calendar for the previous month in
the upper left corner and the next month in the lower right (the
default is to print both at the lower right).
-w Causes pcal to print a calendar for 12 consecutive months: 3 rows
/ 4 columns in landscape mode, 4 rows / 3 columns in portrait
mode. See the CAVEATS section for details on the use of this
option with other options.
Pcal predefines the symbol whole_year when the -w flag is in
effect, allowing directives like `ifdef whole_year' in the
configuration file.
-I Resets all parameters to the program defaults.
-c Causes pcal to generate a date file suitable for use as input to
the Un*x calendar(1) utility. The normal PostScript output is
suppressed.
-H Causes pcal to generate a calendar in HTML table format. The
normal PostScript output is suppressed.
The HTML table format does not support moon graphics, Julian date
information, `day numerics' color, `empty day' `box fill' color,
left or right footer strings (but see the -C flag), alternate
fonts/sizes, transformation and scaling factors, or embedded EPS
images.
-q This option is only valid when used in conjunction with the -H
(generate HTML-format calendar) option. It generates a yearly-
planner style of HTML calendar whereby a single column for each
month is used, resulting in table that gives a quicker overview
of several months. Since there is less space for text, only the
first character of the weekday and the first 5 characters of text
from each event for that day are printed. The day numerics for
holidays are colored red but the text of the holiday event is not
printed. The day numerics are grey for Saturdays and bold black
for Sundays.
-z time_zone
Forces pcal to ignore the moon file and to use its internal
algorithm for moon phase calculations, adjusting the phase by
time_zone hours (where time_zone is expressed in hours west of
UTC).
For example, New York residents (USA Eastern time zone) would use
- 22 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
'-z 5' while on Eastern Standard Time (winter) and '-z 4' while
on Eastern Daylight Time (summer). People in India would use '-
z-5.5'. Notice that fractional values are allowed.
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-h Causes pcal to write version information, parameter usage
message, and full explanation of options and file formats (to
stdout) and terminate.
-u Causes pcal to write version information and parameter usage
message (to stdout) and terminate.
-v Causes pcal to write version information only (to stdout) and
terminate.
Pcal predefines the symbol vX_Y_Z, where X_Y_Z denotes the
current version of Pcal (e.g. version 4.9.0 predefines the symbol
v4_9_0).
-a output_language
Select the output language (for the names of months and days on
the calendar).
Currently, the following languages are supported: ca (Catalan),
cs (Czech), da (Danish), de (German), el (Greek), en (English),
eo (Esperanto), es (Spanish), et (Estonian), fi (Finnish), fr
(French), ha (Hawaiian), hu (Hungarian), it (Italian), lt
(Lithuanian), lv (Latvian), nl (Dutch), pl (Polish), pt
(Portuguese), ro (Romanian), ru (Russian), sk (Slovak), sv
(Swedish), and uk (Ukrainian). The default is en.
Note that this option does not specify the `input language',
which is the language used to process events in the configuration
file ('English', by default, unless changed with the input-
language XX directive). See the section The Date File for more
details on specifying the `input language'.
Note: In order to display diacritical marks, languages other than
English require that the characters be remapped. Normally, no
action is required since pcal automatically selects a remapping
which is appropriate to the selected language. However, if you
want to override the default remapping for a given language, you
would use the -r option (e.g. "-r Latin1").
Furthermore, an appropriate font should be selected as needed
using the -t option (e.g. "-t some-latin1-font-name"). Any
- 23 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
language using the "Latin1" remapping (e.g. French, German,
Italian, Spanish, etc) requires an ISO 8859-1 ('Latin1') font.
The Greek language requires an ISO 8859-7 (similar to ELOT-928)
font (available from Angelo Haritsis <ah@doc.ic.ac.uk>; also see
http://www.hellenic.net/fonts/). Similarly, Russian requires a
KOI8-R font while Ukrainian requires a KOI8-U font.
Pcal predefines the symbol lang_XX, where XX is the two-character
abbreviation for the selected output language.
-r [mapping]
Specifies an 8-bit character set remapping (encoding) for
printing the diacritical marks common to European languages.
Note: This option is not usually needed since pcal will
automatically select an appropriate default character encoding
(mapping) for the language for which the calendar is being
generated.
The value specified for mapping is case-insensitive and may be
abbreviated to the point where it is still unique. The value
used may be any of the following:
+ "none" (use built-in character set)
+ "Latin1" (ISO 8859-1)
+ "Latin2" (ISO 8859-2)
+ "Latin3" (ISO 8859-3)
+ "Latin4" (ISO 8859-4)
+ "Cyrillic" (ISO 8859-5)
+ "Greek" (ISO 8859-7)
+ "Latin5" (ISO 8859-9)
+ "Latin6" (ISO 8859-10)
+ "Thai" (ISO 8859-11)
+ "Latin7" (ISO 8859-13)
+ "Latin8" (ISO 8859-14)
+ "Latin9" (ISO 8859-15)
- 24 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
+ "KOI8-R" (Russian)
+ "KOI8-U" (Ukrainian)
+ "Roman8"
This option may also be set semi-permanently by altering the
makefile (`Makefile' for most environments, 'Makefile.DOS' for
MS-DOS).
-T [B|I|R]
Select the default typeface (Bold, Italic, or Roman) for printing
date/note text. This flag may be specified multiple times within
the date file (via "opt") to reset the font style on the fly -
for example, to print all holidays in Bold.
-W [left|center|right]
Specify the horizontal alignment of the month/year heading (left,
center, right) (for monthly-format calendars only).
Any option taking a negative value (e.g. -Y -###) should be specified
with no space between the option and the (negative) value to avoid
pcal interpreting the value as an illegal flag and aborting. For
example, use ` -Y-50' instead of ` -Y -50' on your option
specification.
Any option (except -G and -O, for backward-compatibility) which
normally takes an argument may be specified without the argument in
order to reset the value to the program default. Note that while the
-D option alone clears all the defined symbols, the -U option alone
has no effect. The - (or -- as per System V) argument may be used to
disambiguate command lines such as:
pcal -t 9 90
This could be written instead as one of the following:
pcal -t - 9 90
pcal -t -- 9 90
If the environment variable PCAL_OPTS is defined, its contents are
parsed as a command line. Flags set via PCAL_OPTS override the
program defaults, but are overridden by options set via opt lines in
the configuration file or explicitly on the command line.
- 25 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
Additional Options For Debugging Only
The -Z flag is used to print debugging information which is of
interest primarily to pcal hackers. This flag is a "hidden" flag; it
does not appear as part of the usage message. At present, the
following options are supported:
+ -ZD print dates and text as read from date file
+ -ZF print date file search paths
+ -ZM print moon phases and identify quarters
+ -ZO print option flags and where set
+ -ZP print "preprocessor" debug info
+ -ZT print dates and text as written to output file
+ -Z turn off all debugging info
The subflags may be combined: e.g. "-ZDF" is equivalent to "-ZD -ZF".
All of the aforementioned debugging information is written to stderr.
CAVEATS
+ The ``workday'' and ``holiday'' keywords are aware of only those
holidays which have already been flagged at the point where they
appear. For example, consider January 1990:
January 1990
S M Tu W Th F S
1 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30 31
If the configuration file looked like this:
workday on_or_before all 15 payday
3rd Mon in Jan* MLK day
... then pcal would mark the 15th as ``payday'' since at that point
in the configuration file it has no way of knowing that January 15th
will later be flagged as a holiday. If the two lines were reversed,
such that the holiday preceded the ``workday'' wildcard, then pcal
would work as intended, marking instead the 12th as ``payday''.
Also, beware of year boundaries which affect the handling of all of
- 26 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
the day wildcard keywords. In general, it is best to place monthly
wildcards such as the example above at the end of each year to
achieve the desired effect.
+ Only the positive ordinals may be used in conjunction with
prepositions (e.g. "fourth Sunday before 12/25"). (It could be
argued that "last Sunday before 12/25" should be accepted as a
synonym for "first Sunday before 12/25", but then what does "last
Sunday after 12/25" mean?)
+ When the -w and -p options are used together, pcal revises the y-
scale factor in order to use the entire portrait page; therefore,
the user should avoid using use the -y option when using both the -w
and -p options. Use of the -w option in any case effectively
disables the -m, -M, -j, and -J options.
+ The output of the -c option may be used as input to subsequent runs
of pcal. Note, however, that opt lines (except for an automatic opt
-[A|E]), comments, ``note'' text, and ifdef'd-out source will be
lost.
+ The -S option interacts with note{/<number>}; if used, it should be
specified either on the command line or prior to the first note line
in the date file.
SEE ALSO
Website for pcal and lcal (a lunar calendar generation application):
http://pcal.sourceforge.net
cal(1), calendar(1).
The old, simple Unix/BSD 'calendar' program, which can be used with
pcal and the '-c' option is part of the BSD Main Utilities
('bsdmainutils') package and is available at the Debian site:
http://packages.debian.org/stable/source/bsdmainutils
This old program does not seem to be included with most GNU/Linux
distributions these days.
For more information on PostScript, consult the free, online Adobe
book entitled PostScript Language Reference Manual, which can be found
here (as of Dec 2007):
http://partners.adobe.com/public/developer/ps/index_specs.html
AUTHORS
The original PostScript code to generate the calendars was written by
- 27 - Formatted: December 14, 2025
PCAL(1) Version 4.11.0 PCAL(1)
USER COMMANDS USER COMMANDS
18 Dec 2007
Patrick Wood (Copyright c 1987 by Patrick Wood of Pipeline Associates,
Inc.), and authorized for modification and redistribution. The
calendar file inclusion code was originally written in "bs(1)" by Bill
Vogel of AT&T. Patrick's original PostScript was modified and
enhanced several times by King Ables, Tim Tessin, Joe Wood, Jeff
Mogul, Mark Hanson, and others whose names have regrettably been lost.
This C version was originally created by Ken Keirnan of Pacific Bell;
additional enhancements by Joseph P. Larson, Ed Hand, Andrew Rogers,
Mark Kantrowitz, Joe Brownlee, Andy Fyfe, Steve Grandi, Geoff
Kuenning, Stefan Fronzek (1-column HTML output), Bill Bogstad (event
deletion capability), and Bill Marr (embedded EPS images, command-line
paper size specification, new paper sizes [legal & tabloid],
additional character mappings for new languages, and various
cleanups). The moon routines were originally written by Jef Poskanzer
and Craig Leres, and were incorporated into pcal by Richard Dyson.
International language support was initially added by Angelo Haritsis.
Additional languages were added by Andrew Rogers (Esperanto), Lars
Wirzenius (Finnish), Pedro Zorzenon Neto (Portuguese), Joel Fredrikson
(Swedish), Volodymyr M. Lisivka (Ukrainian), Neeme Praks (Estonian,
Russian, Latvian, Lithuanian), Peter Cernoch (Czech), Ferenc Kruzslicz
(Hungarian), Carles Sadurn Anguita (Catalan), Dominik 'Chiron'
Derlatka (Polish), Ewald Beekman (Dutch), Claudiu Costin (Romanian),
Kenneth Geisshirt (Danish), Zdenko Podobny (Slovak), and Eric Nichols
(Hawaiian).
- 28 - Formatted: December 14, 2025
