} ;
if used, it should be specified either on the command line or prior to
the first
.B note
line in the date file.
.LP
.\" ------------------------------------------------------------------
.SH SEE ALSO
Website for
.I pcal
and
.I lcal
(a lunar calendar generation application):
.PP
.IP
http://pcal.sourceforge.net
.PP
cal(1),
calendar(1).
.PP
The old, simple Unix/BSD 'calendar' program, which can be used with
.I pcal
and the '-c' option is part of the BSD Main Utilities
('bsdmainutils') package and is available at the Debian site:
.RS
.LP
.IR http://packages.debian.org/stable/source/bsdmainutils
.RE
.LP
This old program does not seem to be included with most GNU/Linux
distributions these days.
.PP
For more information on PostScript, consult the free, online Adobe book
entitled
.IR "PostScript Language Reference Manual" ,
which can be found here (as of Dec 2007):
.RS
.LP
.IR http://partners.adobe.com/public/developer/ps/index_specs.html
.RE
.LP
.SH AUTHORS
The original PostScript code to generate the calendars was written by Patrick
Wood (Copyright \(co 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
.I 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).
pcal-4.11.0/doc/pcal-help.html 0000644 0001750 0000144 00000323157 10732024127 014212 0 ustar w users
PCAL
PCAL
NAME
SYNOPSIS
DESCRIPTION
OPTIONS
CAVEATS
SEE ALSO
AUTHORS
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 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.
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:
:= 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_name>, or
‘‘year’’
:= first 3+ characters of name
of weekday, ‘‘day’’,
‘‘weekday’’,
‘‘workday’’,
‘‘holiday’’,
‘‘nonweekday’’,
‘‘nonworkday’’,
‘‘nonholiday’’,
‘‘new_moon’’,
‘‘first_quarter’’,
‘‘full_moon’’, or
‘‘last_quarter’’
:= any ordinal number
(‘‘1st’’,
‘‘2nd’’, etc.),
‘‘first’’ ...
‘‘fifth’’,
‘‘last’’,
‘‘odd’’,
‘‘even’’, or
‘‘all’’
:=
‘‘on’’,
‘‘before’’,
‘‘preceding’’,
‘‘after’’,
‘‘following’’,
‘‘on_or_before’’
(‘‘oob’’),
‘‘on_or_after’’
(‘‘ooa’’),
‘‘nearest’’,
‘‘nearest_before‘‘, or
‘‘nearest_after‘‘
:=
‘‘Christmas’’,
‘‘Thanksgiving’’,
‘‘Easter’’,
‘‘Good_Friday’’,
‘‘GEaster’’ (Orthodox Easter),
‘‘Gstgeorge’’ (Orthodox holiday),
and ‘‘Gmarcus’’ (Orthodox
holiday).
:= one or more non-numeric,
non-space, non-‘*’ characters
:= a numeric month (1-12)
:= day of month (1-31)
:= a numeric year
:= 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:
:= <month_name>
<day> |
<month><sep><day>{<sep><year>}
If the
−E option (European date formats) is given:
:= <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)
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
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 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
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) 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>
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
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.
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
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:
|
• |
|
define |
undef |
|
|
• |
|
if{{n}def} ...
{elif ...}* {else ...} endif |
|
|
• |
|
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 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 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 Browser Interface
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 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 |
|
|
• |
|
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.
−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 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).
−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. |
|
−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
’-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 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) |
|
|
• |
|
"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.
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 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
Patrick Wood (Copyright © 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).
pcal-4.11.0/doc/pcal-help.ps 0000644 0001750 0000144 00000317723 10732024125 013670 0 ustar w users %!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Tue Dec 18 15:06:45 2007
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%+ font Courier
%%+ font Symbol
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 18
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
%%IncludeResource: font Courier
%%IncludeResource: font Symbol
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Courier@0 ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE
/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F/F1 10.95/Times-Bold@0 SF -.219(NA)72 84 S(ME)
.219 E F0(pcal \255 generate PostScript \(or HTML\) calendars)108 96 Q
F1(SYNOPSIS)72 112.8 Q/F2 10/Times-Bold@0 SF(pcal)108 124.8 Q F0([)2.5 E
F2A F0(|)A F2A/F3 10/Times-Italic@0 SF(cal)2.5 E F0 2.5(][)
1.666 G F2-2.5 E F3(\214le)2.5 E F0 2.5(][)1.666 G F2-2.5 E
F0(|)2.5 E F22.5 E F0 2.5(][)C F2-2.5 E F0([letter | le)2.5
E -.05(ga)-.15 G 2.5(l|a).05 G 2.5(4|t)-2.5 G(abloid]] [)-2.5 E F2
A F0(|)2.5 E F22.5 E F0 2.5(][)C F2-2.5 E F0(|)2.5 E F2
2.5 E F0 2.5(][)C F2-2.5 E F3(week-)2.5 E(day)133 136.8 Q F0
([)A F3(\255weekday)A F0(]|all|holiday] [)A F2A F3(weekday)2.5 E
F0([)A F3(\255weekday)A F0(]|all|holiday] [)A F2A F3(weekday)2.5 E
F0([)A F3(\255weekday)A F0(]|all|holi-)A(day] [)133 148.8 Q F2A F3
(weekday)2.5 E F0([)A F3(\255weekday)A F0(]|all|holiday] [)A F2A
F0([)2.5 E F3(day_numerics_color)A F0(][/)A F3
(empty_day_box_\214ll_color)A F0(]])1.666 E([)133 160.8 Q F2A F3
(day)2.5 E F0 2.5(][)1.666 G F2-2.5 E F0(|)A F2A F0 2.5(][)C
F2-2.5 E F3(xtr)2.5 E(ans)-.15 E F0 2.5(][)1.666 G F2-2.5 E
F3(ytr)2.5 E(ans)-.15 E F0 2.5(][)1.666 G F2-2.5 E F3(xscale)2.5 E
F0 2.5(][)1.666 G F2-2.5 E F3(yscale)2.5 E F0 2.5(][)1.666 G F2
-2.5 E F0([)2.5 E F3(title_font)A F0(][/)A F3(size)A F0(]])1.666 E
([)133 172.8 Q F2A F0([)2.5 E F3(day_font)A F0(][/)A F3(size)A F0
(]] [)1.666 E F2A F0([)2.5 E F3(te)A(xt_font)-.2 E F0(][/)A F3
(size)A F0(]] [)1.666 E F2A F3(footer_str)2.5 E F0 2.5(][)1.666 G
F2-2.5 E F3(footer_str)2.5 E F0 2.5(][)1.666 G F2-2.5 E F3
(footer_str)2.5 E F0(])1.666 E([)133 184.8 Q F2A F3(notes_str)2.5
E F0 2.5(][)1.666 G F2-2.5 E F3(symbol)2.5 E F0 2.5(][)1.666 G F2
-2.5 E F3(symbol)2.5 E F0 2.5(][)1.666 G F2-2.5 E F0 2.5(][)
C F2-2.5 E F3(n)2.5 E F0 2.5(][)1.666 G F2-2.5 E F0(|)2.5 E
F22.5 E F0(|)2.5 E F22.5 E F0 2.5(][)C F2-2.5 E F0 2.5
(][)C F2-2.5 E F0 2.5(][)C F2-2.5 E F0(|)2.5 E F22.5 E
F0 2.5(][)C F2-2.5 E F0(])A([)133 196.8 Q F2A F3(time_zone)
2.5 E F0 2.5(][)1.666 G F2-2.5 E F0(|)2.5 E F22.5 E F0(|)2.5
E F22.5 E F0 2.5(][)C F2-2.5 E F3(output_langua)2.5 E -.1
(ge)-.1 G F0 2.5(][)1.766 G F2-2.5 E F0([)2.5 E F3(mapping)A F0
2.5(][)C F2-2.5 E F0([B|I|R]] [)2.5 E F2A F0([left|cen-)2.5
E(ter|right]] [month] [year] [nmonths])133 208.8 Q F1(DESCRIPTION)72
249.6 Q F3(Pcal)108.5 261.6 Q F0
(generates PostScript to produce landscape or portrait calendars for an)
3.01 E 2.5(ym)-.15 G(onth and year)-2.5 E 5(.T)-.55 G(he ar)-5 E(gu-)
-.18 E(ments)108 273.6 Q F2(month)2.5 E F0(,)A F2 -.1(ye)2.5 G(ar).1 E
F0 2.5(,a)C(nd)-2.5 E F2(nmonths)2.5 E F0 2.5(,i)C 2.5(fp)-2.5 G(ro)-2.5
E(vided, should be numeric.)-.15 E(The)5 E F2(month)2.5 E F0 -.25(va)2.5
G(lue should be in the).25 E(range 1 \255 12, and the)108 285.6 Q F2 -.1
(ye)2.5 G(ar).1 E F0 -.25(va)2.5 G(lue should be speci\214ed as 1 or 2 \
digits \(in which case it will be interpreted as).25 E
(that year in the current century\) or as the full 4-digit year)108
297.6 Q 5(.I)-.55 G 2.5(fn)-5 G 2.5(on)-2.5 G(umeric ar)-2.5 E
(guments are pro)-.18 E(vided, the calen-)-.15 E
(dar for the current month and year will be generated.)108 309.6 Q
(If one numeric ar)108 326.4 Q(gument is pro)-.18 E
(vided, it is interpreted as the)-.15 E F2 -.1(ye)2.5 G(ar).1 E F0 -.25
(va)2.5 G(lue, and calendars for the entire year).25 E
(will be generated.)108 338.4 Q(Otherwise,)5 E F2(nmonths)2.5 E F0
(months, starting with)2.5 E F2(month)2.5 E F0(and)2.5 E F2 -.1(ye)2.5 G
(ar).1 E F0 2.5(,w)C(ill be generated.)-2.5 E -.15(Fo)108 355.2 S 2.5
(rw).15 G(hole-year calendars \(i.e. when the)-2.5 E F22.5 E F0
(option is gi)2.5 E -.15(ve)-.25 G(n\), the command line ar).15 E
(guments are interpreted)-.18 E(some)108 367.2 Q(what dif)-.25 E
(ferently)-.25 E 5(.B)-.65 G 2.5(yd)-5 G(ef)-2.5 E(ault, all months in \
the current year are printed, starting with January)-.1 E 5(.I)-.65 G
2.5(ft)-5 G(he)-2.5 E F2(month)108 379.2 Q F0(ar)2.5 E
(gument alone is gi)-.18 E -.15(ve)-.25 G(n, it is e).15 E
(xpected to be the desired)-.15 E F2 -.1(ye)2.5 G(ar).1 E F0
(to print, and prints all of the months in)2.5 E(the gi)108 391.2 Q -.15
(ve)-.25 G 2.5(ny).15 G(ear)-2.5 E 5(.I)-.55 G 2.5(fb)-5 G(oth)-2.5 E F2
(month)2.5 E F0(and)2.5 E F2 -.1(ye)2.5 G(ar).1 E F0(are gi)2.5 E -.15
(ve)-.25 G(n, then 12 consecuti).15 E .3 -.15(ve m)-.25 H
(onths are printed starting at the).15 E(gi)108 403.2 Q -.15(ve)-.25 G
2.5(nm).15 G(onth and year)-2.5 E 5(.I)-.55 G 2.5(ft)-5 G(he)-2.5 E F2
(month)2.5 E F0(,)A F2 -.1(ye)2.5 G(ar).1 E F0 2.5(,a)C(nd)-2.5 E F2
(nmonths)2.5 E F0(ar)2.5 E(guments are all present, printing be)-.18 E
(gins with the)-.15 E(gi)108 415.2 Q -.15(ve)-.25 G 2.5(nm).15 G
(onth and year and)-2.5 E F2(nmonths)2.5 E F0
(months are printed, rounded up to the nearest multiple of 12.)2.5 E F2
(The Date File \(Con\214guration File\))87 456 Q F0(By def)108 468 Q
(ault,)-.1 E F3(pcal)3.75 E F0(simply prints an empty calendar)3.01 E 5
(.I)-.55 G(ts real po)-5 E(wer is in its ability to place `)-.25 E(`e)
-.74 E -.15(ve)-.25 G(nts').15 E 2.5('\()-.74 G(and, for)-2.5 E(monthly\
-format PostScript calendars, Encapsulated PostScript images [e.g. phot\
os and icons]\) in appropri-)108 480 Q
(ate days on the \(PostScript or HTML\) calendar)108 492 Q 2.5(,t)-.4 G
(hus allo)-2.5 E(wing the user to create personalized calendars.)-.25 E
(This is achie)108 504 Q -.15(ve)-.25 G 2.5(dt).15 G
(hrough the use of the `)-2.5 E(`date \214le')-.74 E(', also kno)-.74 E
(wn as the `)-.25 E(`con\214guration \214le')-.74 E('.)-.74 E(The def)
108 520.8 Q(ault date/con\214guration \214le is e)-.1 E
(xpected to be named)-.15 E F3(.calendar)2.5 E F0(\()3.23 E F3(pcal.dat)
1.25 E F0(under MS-DOS\), or)2.5 E F3(calen-)2.7 E(dar)108 532.8 Q F0
(for compatibility with older v)3.23 E(ersions.)-.15 E F3(Pcal)5.5 E F0
(will look in se)3.01 E -.15(ve)-.25 G(ral places for such a \214le.).15
E(First, if the en)5 E(vi-)-.4 E(ronment v)108 544.8 Q(ariable)-.25 E F2
(PCAL_DIR)2.5 E F0(is de\214ned,)2.5 E F3(pcal)3.75 E F0
(searches the directory indicated by that v)3.01 E 2.5(ariable. Ne)-.25
F(xt,)-.15 E F3(pcal)3.75 E F0(searches the user')108 556.8 Q 2.5(sh)
-.55 G(ome directory \(as speci\214ed by the)-2.5 E F2(HOME)2.5 E F0(en)
2.5 E(vironment v)-.4 E 2.5(ariable\). If)-.25 F(neither)2.5 E F2
(PCAL_DIR)108 568.8 Q F0(nor)2.5 E F2(HOME)2.5 E F0(is de\214ned,)2.5 E
F3(pcal)3.75 E F0(searches the current directory instead.)3.01 E
(Finally)5 E 2.5(,i)-.65 G 2.5(fe)-2.5 G(nabled \(via the)-2.5 E
(`SEARCH_PCAL_DIR' \215ag\) when)108 580.8 Q F3(pcal)3.75 E F0 -.1(wa)
3.01 G 2.5(sb).1 G(uilt, the directory where the)-2.7 E F3(pcal)3.75 E
F0 -.15(exe)3.01 G(cutable resides will be).15 E(check)108 592.8 Q 2.5
(ed. If)-.1 F(no date \214le is found, an empty calendar is printed; no\
error is generated.)2.5 E(Alternati)108 609.6 Q -.15(ve)-.25 G(ly).15 E
2.5(,t)-.65 G(he name of the date \214le \(and, optionally)-2.5 E 2.5
(,t)-.65 G(he path where it can be found\) can be speci\214ed)-2.5 E
(using the)108 621.6 Q F22.5 E F0(command-line option.)2.5 E
(See the)5 E F2(OPTIONS)2.5 E F0(section for more details.)2.5 E(Ev)108
638.4 Q(ery)-.15 E F3(pcal)3.75 E F0(distrib)3.01 E
(ution comes with an 'e)-.2 E(xamples' directory)-.15 E 5(.T)-.65 G
(he `pcal-cfg.txt' \214le that is located there)-5 E
(contains a myriad of e)108 650.4 Q
(xamples of settings that can be used in your o)-.15 E
(wn con\214guration \214le.)-.25 E(Please check it)5 E
(out for lots of useful ideas.)108 662.4 Q
(Furthermore, that directory contains se)5 E -.15(ve)-.25 G
(ral language/country-speci\214c e).15 E(xam-)-.15 E
(ples \(including holiday and other e)108 674.4 Q -.15(ve)-.25 G
(nt de\214nitions\) in v).15 E
(arious `calendar_xx.txt' \214les, where `xx' represents)-.25 E
(the 2-letter language code \(e.g. 'calendar_de.txt' is the German e)108
686.4 Q(xample \214le\).)-.15 E(If a date \214le is found, it will be s\
earched for lines with leading dates matching the requested month and)
108 703.2 Q(year)108 715.2 Q(.)-.55 E -1.11(Ve)72 768 S(rsion 4.11.0)
1.11 E(18 Dec 2007)150.4 E(1)203.45 E 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F(An)108 84 Q 2.5(yt)-.15 G -.15(ex)-2.5 G 2.5
(tf).15 G(ollo)-2.5 E(wing the dates found will be printed on the calen\
dar under the appropriate day of the month.)-.25 E(Encapsulated PostScr\
ipt \(EPS\) images are handled similarly as described in a later subsec\
tion.)108 96 Q/F1 10/Times-Bold@0 SF(tr)108 112.8 Q(off)-.18 E F0
(-style escape sequences \\fB, \\fI, \\fP)A 2.5(,a)-1.11 G
(nd \\fR may be used to set the font style to Bold, Italic, the pre)-2.5
E(vi-)-.25 E(ous font style, or Roman respecti)108 124.8 Q -.15(ve)-.25
G(ly).15 E 5(.F)-.65 G(or those more f)-5.15 E
(amiliar with HTML, , , , and may)-.1 E
(be used instead to enable/disable Bold or Italic font styles.)108 136.8
Q(The font style is reset to Roman after each line)5 E(break.)108 148.8
Q(Using the `include' pre-processor directi)108 165.6 Q .3 -.15(ve \()
-.25 H(described in the section entitled `Pre-Processor Functionality',)
.15 E(belo)108 177.6 Q
(w\), other con\214guration \214les can be processed from within an e)
-.25 E(xisting con\214guration \214le.)-.15 E(That is, you)5 E
(can `nest' con\214guration \214les as needed.)108 189.6 Q
(Dates \(essentially `e)108 206.4 Q -.15(ve)-.25 G
(nts'\) in the con\214guration \214les may be e).15 E(xpressed in an)
-.15 E 2.5(yo)-.15 G 2.5(fs)-2.5 G -2.15 -.25(ev e)-2.5 H(ral formats:)
.25 E 6.5<833c>144 228 S(ordinal> in {*} {})-.15 E 6.5<837b>144 244.8 S
(} {*} {})-.15 E 6.5
<833c>144 261.6 S(date_spec>{*} {})-.15 E 6.5<833c>144
278.4 S(pre_de\214ned_e)-6.5 E -.15(ve)-.25 G(nt>{*} {})
-.15 E(Where:)108 295.2 Q 8( :=)144 316.8 R
(\214rst 3+ characters of name of month, or `)2.5 E(`all')-.74 E(')-.74
E F1(Note:)218 333.6 Q/F2 10/Times-Italic@0 SF(pcal)3.75 E F0
(looks for names of the days of the week prior to names of months)3.01 E
(when parsing e)218 345.6 Q -.15(ve)-.25 G(nt date speci\214cations.).15
E(Furthermore, some languages \(e.g.)5 E(French and Finnish\) ha)218
357.6 Q .3 -.15(ve a m)-.2 H
(onth name whose \214rst 3 letters are the same as the).15 E
(\214rst 3 letters of one of the names of the days of the week.)218
369.6 Q(Because of this, the)5 E
(speci\214cation in such a language of an)218 381.6 Q 2.5(ym)-.15 G
(onth name which collides thusly must)-2.5 E(use 4 or more letters to d\
istinguish it from the name of the day of the week with)218 393.6 Q
(which it `collides'.)218 405.6 Q 11.89( :=)144 422.4 R
(, or `)2.5 E(`year')-.74 E(')-.74 E 23.01( :=)144
439.2 R(\214rst 3+ characters of name of weekday)2.5 E 2.5(,`)-.65 G
(`day')-3.24 E(', `)-.74 E(`weekday')-.74 E(', `)-.74 E(`w)-.74 E
(orkday')-.1 E(',)-.74 E -.74(``)218 451.2 S(holiday').74 E(', `)-.74 E
(`nonweekday')-.74 E(', `)-.74 E(`nonw)-.74 E(orkday')-.1 E(', `)-.74 E
(`nonholiday')-.74 E(', `)-.74 E(`ne)-.74 E(w_moon')-.25 E(',)-.74 E
-.74(``)218 463.2 S(\214rst_quarter').74 E(', `)-.74 E(`full_moon')-.74
E(', or `)-.74 E(`last_quarter')-.74 E(')-.74 E 31.89( :=)144
480 R(an)2.5 E 2.5(yo)-.15 G(rdinal number \(`)-2.5 E(`1st')-.74 E(', `)
-.74 E(`2nd')-.74 E(', etc.\), `)-.74 E(`\214rst')-.74 E 2.5('.)-.74 G
(.. `)-2.5 E(`\214fth')-.74 E(', `)-.74 E(`last')-.74 E(', `)-.74 E
(`odd')-.74 E(',)-.74 E -.74(``)218 492 S -2.15 -.25(ev e).74 H(n').25 E
(', or `)-.74 E(`all')-.74 E(')-.74 E 42.45( :=)144 508.8 R -.74
(``)2.5 G(on').74 E(', `)-.74 E(`before')-.74 E(', `)-.74 E(`preceding')
-.74 E(', `)-.74 E(`after')-.74 E(', `)-.74 E(`follo)-.74 E(wing')-.25 E
(', `)-.74 E(`on_or_before')-.74 E(')-.74 E(\(`)218 520.8 Q(`oob')-.74 E
('\), `)-.74 E(`on_or_after')-.74 E 2.5('\()-.74 G -.74(``)-2.5 G(ooa')
.74 E('\), `)-.74 E(`nearest')-.74 E(', `)-.74 E(`nearest_before`)-.74 E
(`, or `)-.74 E(`near)-.74 E(-)-.2 E(est_after`)218 532.8 Q(`)-.74 E
().15 E(:= `)218 561.6 Q
(`Christmas')-.74 E(', `)-.74 E(`Thanksgi)-.74 E(ving')-.25 E(', `)-.74
E(`Easter')-.74 E(', `)-.74 E(`Good_Friday')-.74 E(', `)-.74 E
(`GEaster')-.74 E(')-.74 E(\(Orthodox Easter\), `)218 573.6 Q(`Gstgeor)
-.74 E(ge')-.18 E 2.5('\()-.74 G(Orthodox holiday\), and `)-2.5 E
(`Gmarcus')-.74 E 2.5('\()-.74 G(Ortho-)-2.5 E(dox holiday\).)218 585.6
Q 46.89( :=)144 602.4 R
(one or more non-numeric, non-space, non-`*' characters)2.5 E 34.66
( :=)144 619.2 R 2.5(an)2.5 G(umeric month \(1-12\))-2.5 E 45.78
( :=)144 636 R(day of month \(1-31\))2.5 E 43.01( :=)144
652.8 R 2.5(an)2.5 G(umeric year)-2.5 E( :=)
-.15 F(the te)2.5 E(xt to be displayed for this e)-.15 E -.15(ve)-.25 G
(nt; if the te).15 E(xt be)-.15 E(gins with the constant)-.15 E
(string `)218 681.6 Q(`image:')-.74 E
(', then it is interpreted as a speci\214cation of an Encapsulated)-.74
E(PostScript \(EPS\) image rather than as simple te)218 693.6 Q
(xt; more information on specify-)-.15 E(ing EPS images is a)218 705.6 Q
-.25(va)-.2 G(ilable in a later section of this document).25 E(If the)
108 722.4 Q F12.5 E F0(option \(American date formats, the def)2.5
E(ault\) is gi)-.1 E -.15(ve)-.25 G(n:).15 E -1.11(Ve)72 768 S
(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(2)203.45 E 0 Cg EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F 20.79( :=)144 84 R
( | {})2.5 E(If the)108
100.8 Q/F1 10/Times-Bold@0 SF2.5 E F0
(option \(European date formats\) is gi)2.5 E -.15(ve)-.25 G(n:).15 E
20.79( :=)144 122.4 R( | |)
2.5 E({})218 134.4 Q(The `)108 163.2 Q
(`Notes')-.74 E 2.5('b)-.74 G(ox \(see belo)-2.5 E
(w\) uses the \214rst of the current month as the def)-.25 E(ault date.)
-.1 E(All footer strings use)5 E(the \214rst of the current month in si\
ngle-month mode and the \214rst of the starting month in whole-year mod\
e.)108 175.2 Q(Examples:)108 192 Q/F2 10/Courier@0 SF
(last Monday in May*)144 208.8 Q(Memorial Day Holiday)54 E
(all Fridays in Oct)144 232.8 Q(Status Meeting, 11 AM)60 E
(first workday in all)144 244.8 Q(%-B progress report due)48 E
(all Fri in all)144 256.8 Q(\\fBTime card due,\\fP 3 PM)84 E
(all Monday in all)144 268.8 Q(Fiscal week %0W)66 E(-2nd workday in all)
144 280.8 Q(Schedule for %+B due %+2D)54 E(2nd full_moon in all)144
292.8 Q(Blue Moon)48 E(Fri on_or_before all 15)144 304.8 Q(Pay Day)30 E
(even Fridays in year)144 316.8 Q(Pay Day)48 E(183rd day of year)144
328.8 Q(Mid-year \(%l days left\))66 E(Tue after first Mon in Nov)144
352.8 Q(Election Day \(USA\))12 E(4th Thu in Nov*)144 376.8 Q
(Thanksgiving)78 E(Fri after 4th Thu in Nov*)144 388.8 Q
(Day after Thanksgiving)18 E(workday nearest 12/25*)144 400.8 Q(Holiday)
36 E 108(12/25/04* Christmas)144 424.8 R 6(#A)30 G(merican)-6 E 108
(25.12.04* Christmas)144 436.8 R 6(#E)30 G(uropean)-6 E(25. 12.*)144
448.8 Q 24(Christmas #)120 F(European)6 E(Dec 25*)144 472.8 Q 24
(Christmas #)126 F(American)6 E(25 Dec*)144 484.8 Q 24(Christmas #)126 F
(European)6 E(25. Dec*)144 496.8 Q 24(Christmas #)120 F(European)6 E
(Fri on all 13)144 520.8 Q(Avoid black cats!)90 E 6(#')18 G
(Friday the 13th')-6 E F0(An)108 537.6 Q 2.5(yn)-.15 G
(on-numeric character may separate numeric dates.)-2.5 E
(Holidays may be \215agged by follo)5 E(wing the date)-.25 E
(immediately with `*' as in the e)108 549.6 Q(xamples abo)-.15 E -.15
(ve)-.15 G 2.5(;t).15 G
(his will cause the date numerics to be printed in the color)-2.5 E
(speci\214ed by the)108 561.6 Q F12.5 E F0(option \(def)2.5 E
(ault = gray\) and will cause the associated te)-.1 E
(xt \(on monthly-format calendars\))-.15 E(to be placed adjacent to the\
numeric date in the day box rather than belo)108 573.6 Q 2.5(wt)-.25 G
(he numeric date \(as is done for)-2.5 E(all non-holiday e)108 585.6 Q
-.15(ve)-.25 G 2.5(nts\). `).15 F(`Each')-.74 E 2.5('a)-.74 G(nd `)-2.5
E(`e)-.74 E -.15(ve)-.25 G(ry').15 E 2.5('a)-.74 G(re accepted as synon)
-2.5 E(yms for `)-.15 E(`all')-.74 E(', and an)-.74 E 2.5(yw)-.15 G
(ord may be)-2.6 E(used in place of `)108 597.6 Q(`in')-.74 E 2.5
('. The)-.74 F(abbre)2.5 E(viations `)-.25 E(`oob')-.74 E 2.5('a)-.74 G
(nd `)-2.5 E(`ooa')-.74 E 2.5('m)-.74 G(ay be used in place of the k)
-2.5 E -.15(ey)-.1 G -.1(wo).15 G(rds).1 E -.74(``)108 609.6 S
(on_or_before').74 E 2.5('a)-.74 G(nd `)-2.5 E(`on_or_after')-.74 E
(', respecti)-.74 E -.15(ve)-.25 G(ly).15 E 5(.`)-.65 G(`Nearest')-5.74
E 2.5('a)-.74 G(ttempts to match the speci\214ed date; if that)-2.5 E
-.1(fa)108 621.6 S(ils, it tries the day after).1 E 2.5(,t)-.4 G
(hen the day before, then tw)-2.5 E 2.5(od)-.1 G(ays after)-2.5 E 2.5
(,t)-.4 G .2 -.1(wo d)-2.5 H(ays before, and so forth until a).1 E
(match occurs.)108 633.6 Q -.4(Wi)108 650.4 S
(ldcard day names are also pro).4 E 2.5(vided. The)-.15 F -.1(ke)2.5 G
(yw)-.05 E(ord `)-.1 E(`weekday')-.74 E 2.5('a)-.74 G(pplies to an)-2.5
E 2.5(yd)-.15 G(ays which are normally)-2.5 E(printed in "logical black\
" - the predominant day color - on the calendar)108 662.4 Q 5(.T)-.55 G
(he k)-5 E -.15(ey)-.1 G -.1(wo).15 G(rd `).1 E(`w)-.74 E(orkday')-.1 E
2.5('i)-.74 G 2.5(st)-2.5 G(he)-2.5 E(same, b)108 674.4 Q
(ut does not include an)-.2 E 2.5(yh)-.15 G 2.5(olidays. The)-2.5 F -.1
(ke)2.5 G(yw)-.05 E(ord `)-.1 E(`holiday')-.74 E 2.5('i)-.74 G
(ncludes only those days \215agged as holi-)-2.5 E 2.5(days. The)108
686.4 R -.1(ke)2.5 G(yw)-.05 E(ords `)-.1 E(`nonweekday')-.74 E(', `)
-.74 E(`nonw)-.74 E(orkday')-.1 E(', and `)-.74 E(`nonholiday')-.74 E
2.5('a)-.74 G(re also recognized as ne)-2.5 E -.05(ga)-.15 G(tions).05 E
(of the abo)108 698.4 Q -.15(ve)-.15 G 5(.S).15 G(ee the)-5 E F1(CA)2.5
E(VEA)-1.45 E(TS)-.95 E F0(belo)2.5 E 2.5(wf)-.25 G
(or important notes on using these k)-2.5 E -.15(ey)-.1 G -.1(wo).15 G
2.5(rds. Moon).1 F(phases may)2.5 E(also appear as wildcards; `)108
710.4 Q(`nm')-.74 E 2.5('i)-.74 G 2.5(sa)-2.5 G(ccepted as a synon)-2.5
E(ym for `)-.15 E(`ne)-.74 E(w_moon')-.25 E(', `)-.74 E(`1q')-.74 E 2.5
('a)-.74 G(nd `)-2.5 E(`fq')-.74 E 2.5('f)-.74 G(or)-2.5 E -.74(``)108
722.4 S(\214rst_quarter').74 E(', `)-.74 E(`fm')-.74 E 2.5('f)-.74 G
(or `)-2.5 E(`full_moon')-.74 E(', `)-.74 E(`3q')-.74 E 2.5('f)-.74 G
(or `)-2.5 E(`third_quarter')-.74 E(', and `)-.74 E(`lq')-.74 E 2.5('f)
-.74 G(or `)-2.5 E(`last_quarter')-.74 E('.)-.74 E -1.11(Ve)72 768 S
(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(3)203.45 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F
(Ordinal day numbers may be used to specify dates, either relati)108 84
Q .3 -.15(ve t)-.25 H 2.5(ot).15 G(he month or to the year)-2.5 E 5(.E)
-.55 G(ither w)-5 E(ords)-.1 E(or numeric abbre)108 96 Q
(viations may be used for `)-.25 E(`\214rst')-.74 E 2.5('t)-.74 G
(hrough `)-2.5 E(`\214fth')-.74 E('; higher numbers must be gi)-.74 E
-.15(ve)-.25 G 2.5(nu).15 G(sing the)-2.5 E(numeric equi)108 108 Q -.25
(va)-.25 G(lent \(e.g. 100th\).).25 E(Ne)5 E -.05(ga)-.15 G(ti).05 E .3
-.15(ve o)-.25 H(rdinal numbers may e).15 E -.15(ve)-.25 G 2.5(nb).15 G
2.5(eu)-2.5 G 2.5(sed. F)-2.5 F(or e)-.15 E(xample, `)-.15 E(`\2552nd')
-.74 E(')-.74 E(means `)108 120 Q(`ne)-.74 E(xt to last')-.15 E('.)-.74
E -.74(``)108 136.8 S(Odd').74 E 2.5('a)-.74 G(nd `)-2.5 E(`e)-.74 E
-.15(ve)-.25 G(n').15 E 2.5('d)-.74 G 2.5(on)-2.5 G
(ot refer to the actual date; instead, `)-2.5 E(`odd')-.74 E 2.5('m)-.74
G(eans `)-2.5 E(`alternate, starting with the \214rst')-.74 E(',)-.74 E
(and `)108 148.8 Q(`e)-.74 E -.15(ve)-.25 G(n').15 E 2.5('m)-.74 G
(eans `)-2.5 E(`alternate, starting with the second')-.74 E 2.5
('. Thus,)-.74 F -.74(``)2.5 G(odd Fridays in March').74 E 2.5('r)-.74 G
(efers to the \214rst,)-2.5 E(third, and \(if present\) \214fth Fridays\
in March \212 not to those Fridays f)108 160.8 Q(alling on odd dates.)
-.1 E -.74(``)108 177.6 S(All')-.06 E 2.5('r)-.74 G(efers to each indi)
-2.5 E(vidual month; `)-.25 E(`year')-.74 E 2.5('r)-.74 G
(efers to the year as an entity)-2.5 E 5(.T)-.65 G(hus `)-5 E
(`odd Fridays in all')-.74 E(')-.74 E(refers to the \214rst, third, and\
\214fth Friday of each month, while `)108 189.6 Q
(`odd Fridays in year')-.74 E 2.5('r)-.74 G(efers to the \214rst Fri-)
-2.5 E(day of January and e)108 201.6 Q -.15(ve)-.25 G
(ry other Friday thereafter).15 E(.)-.55 E -.74(``)108 218.4 S(Nearest')
.74 E(', `)-.74 E(`nearest_before')-.74 E(', and `)-.74 E
(`nearest_after')-.74 E 2.5('r)-.74 G
(efer to the nearest weekday or wildcard day with)-2.5 E
(respect to the speci\214ed date.)108 230.4 Q -.74(``)5 G
(Nearest_before').74 E 2.5('a)-.74 G(nd `)-2.5 E(`nearest_after')-.74 E
2.5('a)-.74 G(llo)-2.5 E 2.5(wt)-.25 G(he user to specify ho)-2.5 E(w)
-.25 E/F1 10/Times-Italic@0 SF(pcal)2.5 E F0(is)2.5 E
(to disambiguate between tw)108 242.4 Q 2.5(od)-.1 G
(ates that are equally near: e.g., `)-2.5 E
(`nonweekday nearest_before [W)-.74 E(ed.])-.8 E(9/25/96')108 254.4 Q
2.5('r)-.74 G(efers to Sunday)-2.5 E 2.5(,9)-.65 G(/22 while `)-2.5 E
(`nonweekday nearest_after 9/25/96')-.74 E 2.5('r)-.74 G
(efers to Saturday)-2.5 E 2.5(,9)-.65 G 2.5(/28. \(Note)-2.5 F(that `)
108 266.4 Q(`nearest_before')-.74 E 2.5('a)-.74 G(nd `)-2.5 E
(`nearest_after')-.74 E 2.5('a)-.74 G(re equi)-2.5 E -.25(va)-.25 G
(lent to `).25 E(`nearest')-.74 E 2.5('w)-.74 G(hen no such ambiguity e)
-2.5 E(xists: e.g.,)-.15 E -.74(``)108 278.4 S
(nonweekday nearest_before [Thu.] 9/26/96').74 E 2.5('r)-.74 G
(efers to Saturday)-2.5 E 2.5(,9)-.65 G(/28.\))-2.5 E -1.25 -.7(Te x)108
295.2 T 2.5(ti).7 G 2.5(nt)-2.5 G(he date \214le may use C-lik)-2.5 E
2.5(ee)-.1 G(scape sequences \(i.e. a `\\' follo)-2.5 E
(wed by a character)-.25 E 2.5(,1\2553o)-.4 G(ctal digits, or)-2.5 E
(`x' follo)108 307.2 Q(wed by 1 \255 2 he)-.25 E(xadecimal digits\).)
-.15 E(Escaped whitespace \(including)5 E/F2 10/Times-Bold@0 SF(newline)
2.5 E F0 2.5(\)a)2.5 G(nd the standard)-2.5 E
(ANSI character escapes \(`\\a', `\\b', `\\f)108 319.2 Q
(', `\\n', `\\r', `\\t', `\\v'\) are all replaced by a single blank.).55
E(The HTML special characters `<' `>' `"' `&' ` ' a\
nd `&#NNN;' \(NNN = an)108 336 Q 2.5(yt)-.15 G(hree)-2.5 E
(decimal digits\) are also supported.)108 348 Q(These will be propag)5 E
(ated intact \(be sure to escape the `#' in `&#NNN;'\))-.05 E
(if the output is speci\214ed as HTML \(see the)108 360 Q F22.5 E
F0(\215ag\); otherwise the)2.5 E 2.5(yw)-.15 G(ill be con)-2.5 E -.15
(ve)-.4 G(rted to their ASCII equi).15 E(v-)-.25 E 2.5(alents. This)108
372 R(allo)2.5 E(ws a common date \214le to be used re)-.25 E -.05(ga)
-.15 G(rdless of whether the desired output format is).05 E
(HTML, PostScript, or Un*x)108 384 Q F1(calendar\(1\))2.7 E F0
(\(see the)2.56 E F22.5 E F0(\215ag\) input.)2.5 E
(Lines in the con\214guration \214le consisting of)108 400.8 Q F2 -.1
(ye)2.5 G(ar ####).1 E F0(\(where)2.5 E F2(####)2.5 E F0
(is a numeric year\) can be used to set the)2.5 E(year for follo)108
412.8 Q(wing entries.)-.25 E(This assumes that the follo)5 E
(wing entries do not contain a year; an)-.25 E 2.5(yd)-.15 G
(ate entries)-2.5 E
(containing year information will set the remembered year to that year)
108 424.8 Q(.)-.55 E(Lines in the con\214guration \214le consisting of)
108 441.6 Q F2 -.1(ye)2.5 G(ar all).1 E F0(\(or)2.5 E 2.5(,a)-.4 G
(lternati)-2.5 E -.15(ve)-.25 G(ly).15 E(,)-.65 E F2 -.1(ye)2.5 G(ar *)
.1 E F0 2.5(\)d)C(irect)-2.5 E F1(pcal)2.5 E F0(to wildcard fol-)2.5 E
(lo)108 453.6 Q(wing entries ag)-.25 E(ainst e)-.05 E -.15(ve)-.25 G
(ry applicable year).15 E 5(.T)-.55 G(his assumes that the follo)-5 E
(wing entries do not contain a year;)-.25 E(an)108 465.6 Q 2.5(yd)-.15 G
(ate entries containing year information \(or an e)-2.5 E(xplicit)-.15 E
F2 -.1(ye)2.5 G(ar ####).1 E F0(entry\) will set the remembered year)2.5
E(to that year)108 477.6 Q(.)-.55 E
(Lines in the con\214guration \214le consisting of)108 494.4 Q F2
(opt )2.5 E F0(can be used to o)2.5 E -.15(ve)-.15 G
(rride the def).15 E(aults for an)-.1 E 2.5(yc)-.15 G(om-)-2.5 E
(mand-line options e)108 506.4 Q(xcept)-.15 E F22.5 E F0(,)A F2
2.5 E F0(,)A F22.5 E F0(,)A F22.5 E F0(,)A F22.5
E F0(,)A F22.5 E F0(,)A F22.5 E F0(,)A F22.5 E F0 2.5
(,a)C(nd)-2.5 E F22.5 E F0 5(.A)C .3 -.15(ny o)-5 H
(ptions speci\214ed in this manner).15 E(are, in turn, o)108 518.4 Q
-.15(ve)-.15 G(rridden by those speci\214ed e).15 E
(xplicitly on the command line.)-.15 E
(Lines in the con\214guration \214le consisting of)108 535.2 Q F2
(note{/} )2.5 E F0(can be used to place notes re)2.5 E
-.05(ga)-.15 G(rd-).05 E
(ing the entire month in one of the unused blocks of the calendar)108
547.2 Q 5(.T)-.55 G(he)-5 E F2()2.5 E F0
(indicator may be either a)2.5 E
(number 1 through 12 or an alphabetic month name as described abo)108
559.2 Q -.15(ve)-.15 G 5(;`).15 G(`note all')-5.74 E 2.5('w)-.74 G
(ill place the associated)-2.5 E(te)108 571.2 Q
(xt in the notes block for each month in the current year)-.15 E(.)-.55
E F2()5 E F0(is an optional positi)2.5 E .3 -.15(ve o)-.25 H 2.5
(rn).15 G -2.25 -.15(eg a)-2.5 H(ti).15 E -.15(ve)-.25 G
(number specifying the empty box where the associated te)108 583.2 Q
(xt is to be placed.)-.15 E(If positi)5 E -.15(ve)-.25 G(,).15 E F1
(pcal)3.75 E F0(counts forw)3.01 E(ard)-.1 E
(from the \214rst empty box; if ne)108 595.2 Q -.05(ga)-.15 G(ti).05 E
-.15(ve)-.25 G(,).15 E F1(pcal)3.75 E F0(counts backw)3.01 E
(ard from the last empty box.)-.1 E(Thus,)5 E F2 -.63(``)2.5 G(note/1')
.63 E(')-.63 E F0(places the associated te)108 607.2 Q
(xt in the \214rst empty box;)-.15 E F2(note/-3)2.5 E F0
(in the third-to-last.)2.5 E(The def)5 E(ault is -1 if no is gi)108 619.2 Q -.15(ve)-.25 G 2.5(n\().15 G(last empty box, im\
mediately preceding the small calendars on the bottom ro)-2.5 E(w; cf.)
-.25 E F25 E F0(,)A F22.5 E F0(,)A(and)108 631.2 Q F2
2.5 E F0 2.5(,b)C(elo)-2.5 E 2.5(w\). Y)-.25 F(ou can place se)-1.1 E
-.15(ve)-.25 G(ral notes in the same box.).15 E -1.1(Yo)5 G 2.5(uc)1.1 G
(an also use more than 1 box for the)-2.5 E -.25(va)108 643.2 S
(rious monthly notes.).25 E
(Lines in the con\214guration \214le consisting of)108 660 Q F2
(input-language XX)2.5 E F0(\(where)2.5 E F2(XX)2.5 E F0
(is the 2-letter speci\214cation for)2.5 E(an)108 672 Q 2.5(yo)-.15 G
2.5(ft)-2.5 G(he supported languages\) can be used to set the language \
used for interpretation of the month names)-2.5 E
(and day-of-week names for the remaining e)108 684 Q -.15(ve)-.25 G
(nt entries.).15 E(This option may be speci\214ed more than once, as)5 E
(needed, if the language used to describe e)108 696 Q -.15(ve)-.25 G
(nts changes within the \214le.).15 E -.15(Fo)5 G 2.5(rb).15 G(ackw)-2.5
E(ards compatibility)-.1 E 2.5(,t)-.65 G(he)-2.5 E(def)108 708 Q(ault v)
-.1 E(alue for `input language' if this directi)-.25 E .3 -.15(ve i)-.25
H 2.5(sn).15 G -2.15 -.25(ev e)-2.5 H 2.5(ru).25 G
(sed is 'en' \(English\).)-2.5 E(Note that this directi)5 E .3 -.15
(ve i)-.25 H(s).15 E(distinct from the speci\214cation of 'output langu\
age' as accomplished with the)108 720 Q F22.5 E F0(option.)2.5 E
-1.11(Ve)72 768 S(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(4)203.45 E 0
Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F
(Comments are supported in the con\214guration \214le.)108 84 Q(An)5 E
2.5(yc)-.15 G(haracters follo)-2.5 E(wing a `#' character are ignored,)
-.25 E(through the end of that line, unless the `#' character is escape\
d by `\\'.)108 96 Q/F1 10/Times-Bold@0 SF(Deleting Ev)87 136.8 Q(ents)
-.1 E F0(By prepending the)108 148.8 Q/F2 10/Times-Italic@0 SF(`delete')
1.29 E F0 -.1(ke)2.57 G(yw)-.05 E(ord to an e)-.1 E -.15(ve)-.25 G
(nt speci\214cation, one or more e).15 E -.15(ve)-.25 G
(nts may be deleted from a set).15 E(of pre)108 160.8 Q
(viously-speci\214ed e)-.25 E -.15(ve)-.25 G(nts.).15 E -.15(Fo)108
189.6 S 2.5(re).15 G(xample, the follo)-2.65 E
(wing lines might appear in the date \214le:)-.25 E(all Friday in all)
144 211.2 Q(Pok)5 E(er g)-.1 E(ame)-.05 E(delete \214rst Friday in all)
144 223.2 Q(Pok)5 E(er g)-.1 E(ame)-.05 E(This results in an e)108 240 Q
-.15(ve)-.25 G(nt labeled `Pok).15 E(er g)-.1 E(ame' on e)-.05 E -.15
(ve)-.25 G(ry Friday e).15 E(xcept the \214rst Friday of the month.)-.15
E(If you)5 E(delete an entry which is mark)108 252 Q(ed as a holiday)-.1
E 2.5(,t)-.65 G(he `holiday' \215ag for that day will be recalculated.)
-2.5 E(An)5 E(y)-.15 E(`delete' entries which don')108 264 Q 2.5(tm)-.18
G(atch an)-2.5 E 2.5(yp)-.15 G(re-e)-2.5 E
(xisting entries are silently ignored.)-.15 E F1 -.25(Fo)87 304.8 S
(rmat Speci\214ers).25 E F2(Pcal)108.5 316.8 Q F0(allo)3.01 E
(ws format speci\214ers in both the e)-.25 E -.15(ve)-.25 G(nt te).15 E
(xt and footer strings \(see the)-.15 E F12.5 E F0(,)A F12.5
E F0(,)A F12.5 E F0 2.5(,a)C(nd)-2.5 E F12.5 E F0(options)
2.5 E(belo)108 328.8 Q(w\). Each format speci\214er will be replaced by\
a corresponding string as outlined in the follo)-.25 E(wing table:)-.25
E 20.73(%a abbre)144 345.6 R(viated weekday)-.25 E 17.95(%A full)144
357.6 R(weekday)2.5 E 20.17(%b abbre)144 369.6 R(viated month name)-.25
E 18.5(%B full)144 381.6 R(month name)2.5 E 20.17(%d day)144 393.6 R
(of month \(1-31\))2.5 E 22.39(%j day)144 405.6 R(of year \(1-366\))2.5
E 22.39(%l days)144 417.6 R(left in year \(0-365\))2.5 E 17.39(%m month)
144 429.6 R(\(1-12\))2.5 E 17.95(%U week)144 441.6 R(number \(0-53\))2.5
E 15.73(%W week)144 453.6 R(number \(0-53\))2.5 E 20.17(%u week)144
465.6 R(number \(1-54\))2.5 E 17.95(%w week)144 477.6 R(number \(1-54\))
2.5 E 20.17(%y year)144 489.6 R(w/o century \(00-99\))2.5 E 17.95
(%Y year)144 501.6 R(w/century)2.5 E 16.84(%% `%')144 513.6 R(character)
2.5 E 20.17(%o print)144 537.6 R(number as ordinal)2.5 E 20.17(%0 print)
144 549.6 R(number with leading zeroes)2.5 E 19.53(%+ use)144 561.6 R
(follo)2.5 E(wing month or year)-.25 E 19.53(%\255 use)144 573.6 R(pre)
2.5 E(vious month or year)-.25 E(%{+N}[D)144 585.6 Q -.42(WMY] adjust)
-.3 F(date by +N days/weeks/months/years)2.5 E(%{\255N}[D)144 597.6 Q
-.42(WMY] adjust)-.3 F(date by \255N days/weeks/months/years)2.5 E
(Most of these are deri)108 614.4 Q -.15(ve)-.25 G 2.5(df).15 G
(rom the ANSI C)-2.5 E/F3 10/Courier@0 SF(strftime\(\))2.5 E F0
(function, b)6 E(ut the)-.2 E F1(%[louwMD])2.5 E F0(and)2.5 E F1
(%[o0+\255])2.5 E F0(format speci\214ers are speci\214c to)108 626.4 Q
F2(pcal)2.5 E F0(.).51 E(The)108 643.2 Q F1(%u)2.5 E F0(speci\214er con\
siders the week containing 1/1 \(Jan 1st\) as week 1 and the follo)2.5 E
(wing logical Sunday)-.25 E
(\(the \214rst day of the week as printed; cf. the)108 655.2 Q F1
2.5 E F0(option belo)2.5 E(w\) as the start of week 2;)-.25 E F1(%U)2.5
E F0(considers the \214rst)2.5 E
(logical Sunday as the \214rst day of week 1.)108 667.2 Q F1(%w)5 E F0
(and)2.5 E F1(%W)2.5 E F0(beha)2.5 E .3 -.15(ve l)-.2 H(ik).15 E(e)-.1 E
F1(%u)2.5 E F0(and)2.5 E F1(%U)2.5 E F0(respecti)2.5 E -.15(ve)-.25 G
(ly).15 E 2.5(,b)-.65 G(ut use the)-2.7 E
(\214rst logical Monday instead.)108 679.2 Q(Note that)5 E F1(%w)2.5 E
F0(has a dif)2.5 E(ferent meaning from)-.25 E F3(strftime\(\).)2.5 E F0
(The)108 696 Q F1(%o)2.5 E F0(format speci\214er prints a number as an \
ordinal, with the appropriate suf)2.5 E(\214x \(`)-.25 E(`st')-.74 E
(', `)-.74 E(`nd')-.74 E(', `)-.74 E(`rd')-.74 E(', or)-.74 E -.74(``)
108 708 S(th').74 E 2.5('i)-.74 G 2.5(nE)-2.5 G(nglish\) appended.)-2.5
E -.15(Fo)5 G 2.5(re).15 G(xample,)-2.65 E F1(%od)2.5 E F0
(prints the day of the month as `)2.5 E(`1st')-.74 E(', `)-.74 E(`2nd')
-.74 E(', `)-.74 E(`3rd')-.74 E(', etc.)-.74 E(Unlik)108 724.8 Q(e)-.1 E
F3(strftime\(\),)2.5 E F2(pcal)7.25 E F0(def)3.01 E
(aults to printing numbers \(e)-.1 E(xcept)-.15 E F1(%y)2.5 E F0 2.5
(\)w)C(ithout leading zeroes.)-2.5 E(If leading)5 E -1.11(Ve)72 768 S
(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(5)203.45 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F
(zeroes are desired, the `0' pre\214x may be used.)108 84 Q -.15(Fo)5 G
2.5(re).15 G(xample,)-2.65 E/F1 10/Times-Bold@0 SF(%0j)2.5 E F0
(prints the \214rst day of year as `)2.5 E(`001')-.74 E('.)-.74 E(The)
108 100.8 Q F1(%+)2.5 E F0(and)2.5 E F1<25ad>2.5 E F0
(format speci\214ers direct)2.5 E/F2 10/Times-Italic@0 SF(pcal)3.75 E F0
(to substitute the follo)3.01 E(wing/pre)-.25 E
(vious month/year in the fol-)-.25 E(lo)108 112.8 Q(wing)-.25 E F1
([bBmyY])2.5 E F0(speci\214er)2.5 E 5(.F)-.55 G(or e)-5.15 E(xample,)
-.15 E F1(%+B)2.5 E F0(prints the name of the ne)2.5 E(xt month.)-.15 E
(The)108 129.6 Q F1(%{[+\255]N}[D)2.5 E(WMY])-.4 E F0
(format speci\214ers do not print an)2.5 E(ything, b)-.15 E
(ut instead adjust the w)-.2 E(orking date by)-.1 E/F3 10/Symbol SF
2.5 E F1(N)108 141.6 Q F0(days \()A F1(D)A F0(\), weeks \()A F1(W)A F0
(\), months \()A F1(M)A F0(\), or years \()A F1(Y)A F0 2.5
(\). Subsequent)B(format speci\214ers use the adjusted date)2.5 E
(instead of the current date.)108 153.6 Q -.15(Fo)5 G 2.5(re).15 G
(xample,)-2.65 E F1(%+1M %B %Y)2.5 E F0(adjusts the date forw)2.5 E
(ard by one month and then)-.1 E
(prints the resulting month and year \(`)108 165.6 Q(`January 1992')-.74
E 2.5('i)-.74 G 2.5(nD)-2.5 G(ecember)-2.5 E 2.5(,1)-.4 G(991\);)-2.5 E
F1(%\2552W %b %d)2.5 E F0(adjusts the date)2.5 E(backw)108 177.6 Q
(ard by tw)-.1 E 2.5(ow)-.1 G
(eeks and prints the resulting month and day \(`)-2.5 E(`Jul 26')-.74 E
2.5('o)-.74 G 2.5(nA)-2.5 G(ugust 9\).)-2.5 E
(Such date adjustments are normally cumulati)108 194.4 Q -.15(ve)-.25 G
2.5(;f).15 G(or e)-2.5 E(xample,)-.15 E F1(%+1Y%\2551D)2.5 E F0
(adjusts the date forw)2.5 E(ard by one)-.1 E(year and then backw)108
206.4 Q(ard by one day)-.1 E 5(.I)-.65 G(f)-5 E F1(%D)2.5 E F0(or)2.5 E
F1(%M)2.5 E F0(is speci\214ed alone \(or if)2.5 E F1(N)2.5 E F0
(is zero\),)2.5 E F2(pcal)3.75 E F0(restores the)3.01 E(original date.)
108 218.4 Q(Note that)5 E F1(%M)2.5 E F0(has a dif)2.5 E
(ferent meaning to the)-.25 E/F4 10/Courier@0 SF(strftime\(\))2.5 E F0
(function.)6 E(Here')108 235.2 Q 2.5(sac)-.55 G(ommon, useful e)-2.5 E
(xample of an e)-.15 E -.15(ve)-.25 G(nt entry for the).15 E F2(pcal)
3.75 E F0(date \214le which combines the ability to)3.01 E(adjust w)108
247.2 Q(orking dates and the ability to display ordinals.)-.1 E
(This particular e)5 E(xample is used to display te)-.15 E(xt on)-.15 E
(the birthday of a person born in 1991:)108 259.2 Q(May 10 Eric')144 276
Q 2.5(s%)-.55 G(-1991Y%oY Birthday)-2.5 E(That entry w)108 292.8 Q
(ould result in the follo)-.1 E(wing te)-.25 E
(xt being displayed on May 10, 2005:)-.15 E(Eric')144 314.4 Q 2.5(s1)
-.55 G(4th Birthday)-2.5 E F1(Encapsulated P)87 360 Q
(ostScript \(EPS\) Images)-.2 E F0 -.15(Fo)108 372 S 2.5(rm).15 G
(onthly PostScript calendars only)-2.5 E(,)-.65 E F2(pcal)3.75 E F0
(supports the embedding of one or more EPS images \(photos,)3.01 E
(icons, etc\) into an)108 384 Q 2.5(yg)-.15 G -2.15 -.25(iv e)-2.5 H 2.5
(nd).25 G(ay of the month.)-2.5 E(\(EPS image speci\214cations in the)5
E F2(pcal)3.75 E F0(date \214le are ignored for)3.01 E
(yearly PostScript calendars and for all HTML calendars.\))108 396 Q
(In order to associate an image with a gi)108 420 Q -.15(ve)-.25 G 2.5
(ne).15 G -.15(ve)-2.75 G
(nt, you must add one or more entries to the date \214le.).15 E(The)5 E
-2.15 -.25(ev e)108 432 T(nt date is speci\214ed e).25 E
(xactly as described pre)-.15 E(viously for simple e)-.25 E -.15(ve)-.25
G(nt te).15 E(xt speci\214cation lines.)-.15 E(Ho)5 E(we)-.25 E -.15(ve)
-.25 G -.4(r,).15 G(instead of specifying the te)108 444 Q
(xt associated with the e)-.15 E -.15(ve)-.25 G
(nt, you instead specify the EPS image \214lename and).15 E
(some additional parameters in the follo)108 456 Q(wing format:)-.25 E
F4(image: )
144 472.8 Q F0(Where:)108 489.6 Q 7.45( is)144
511.2 R(the \214lename \(which can include a path\) of the Encapsulated\
PostScript)2.5 E(image.)248 523.2 Q F1(Note:)5 E F0
(The EPS image \214lename must be preceded by the con-)2.5 E(stant te)
248 535.2 Q
(xt `image:' in order to distinguish an EPS image speci\214cation)-.15 E
(from an ordinary e)248 547.2 Q -.15(ve)-.25 G(nt te).15 E
(xt speci\214cation.)-.15 E 61.9( is)144 564 R 2.5(as)2.5 G
(caling f)-2.5 E(actor in the horizontal dimension for the EPS image.)
-.1 E(A)5 E -.25(va)248 576 S
(lue of 1.0 is nominal \(i.e. no change to image scale\).).25 E -1.11
(Va)5 G(lues between)1.11 E
(0.0 and 1.0 shrink the image in the horizontal dimension while v)248
588 Q(alues)-.25 E -.15(ove)248 600 S 2.5(r1).15 G(.0 e)-2.5 E
(xpand the image in the horizontal dimension.)-.15 E(Generally)5 E
(speaking, only positi)248 612 Q .3 -.15(ve v)-.25 H
(alues should be used.)-.1 E(Ho)5 E(we)-.25 E -.15(ve)-.25 G .8 -.4
(r, i).15 H 2.5(nt).4 G(he rare case)-2.5 E
(that you \214nd that your EPS image needs to be \215ipped about the v)
248 624 Q(ertical)-.15 E(axis \(i.e. left to right\), you can use a ne)
248 636 Q -.05(ga)-.15 G(ti).05 E .3 -.15(ve v)-.25 H(alue to achie)-.1
E .3 -.15(ve t)-.25 H(his with-).15 E(out ha)248 648 Q
(ving to tweak the actual PostScript content within the EPS image)-.2 E
2.5(\214le. Use)248 660 R(of a ne)2.5 E -.05(ga)-.15 G(ti).05 E .3 -.15
(ve v)-.25 H(alue will undoubtedly necessitate a correspond-)-.1 E
(ing change to the parameter to account for the image')248 672
Q 2.5(sr)-.55 G(elo-)-2.5 E
(cated position that occurs when it gets \215ipped "left-to-right".)248
684 Q 61.9( is)144 700.8 R 2.5(as)2.5 G(caling f)-2.5 E
(actor in the v)-.1 E(ertical dimension for the EPS image.)-.15 E -1.11
(Va)5 G(lues)1.11 E(between 0.0 and 1.0 shrink the image in the v)248
712.8 Q(ertical dimension while)-.15 E -.25(va)248 724.8 S(lues o).25 E
-.15(ve)-.15 G 2.5(r1).15 G(.0 e)-2.5 E(xpand the image in the v)-.15 E
(ertical dimension.)-.15 E(Note that a)5 E -1.11(Ve)72 768 S
(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(6)203.45 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F(ne)248 84 Q -.05(ga)-.15 G(ti).05 E .3 -.15
(ve v)-.25 H
(alue for this parameter can be useful in the less-than-rare case)-.1 E
(that you \214nd that your EPS image needs to be \215ipped about the ho\
rizon-)248 96 Q(tal axis \(i.e. top to bottom\).)248 108 Q
(In such cases, you can use a ne)5 E -.05(ga)-.15 G(ti).05 E .3 -.15
(ve <)-.25 H(y-).15 E(scale> v)248 120 Q(alue to achie)-.25 E .3 -.15
(ve t)-.25 H(his without ha).15 E(ving to tweak the actual Post-)-.2 E
(Script content within the EPS image \214le.)248 132 Q(Use of a ne)5 E
-.05(ga)-.15 G(ti).05 E .3 -.15(ve v)-.25 H(alue will)-.1 E
(undoubtedly necessitate a corresponding change to the param-)
248 144 Q(eter to account for the image')248 156 Q 2.5(sr)-.55 G
(elocated position that occurs when it)-2.5 E(gets \215ipped "upside do)
248 168 Q(wn".)-.25 E 62.45( :=)144 184.8 R 2.5(ah)2.5 G
(orizontal adjustment in typographic `points' \(i.e. 72nds of an inch\))
-2.5 E(for the positioning of the EPS image.)248 196.8 Q -.4(Wi)5 G
(th of).4 E(fsets of 0 for X and Y)-.25 E 2.5(,t)-1.29 G(he)-2.5 E
(image will be printed at the e)248 208.8 Q
(xtreme left edge of the box for that day)-.15 E 2.5(,j)-.65 G(ust)-2.5
E(under the numerics for that day)248 220.8 Q 5(.P)-.65 G(ositi)-5 E .3
-.15(ve v)-.25 H(alues mo)-.1 E .3 -.15(ve t)-.15 H(he image to the).15
E(right and ne)248 232.8 Q -.05(ga)-.15 G(ti).05 E .3 -.15(ve v)-.25 H
(alues mo)-.1 E .3 -.15(ve t)-.15 H(he image to the left.).15 E 62.45
( :=)144 249.6 R 2.5(av)2.5 G
(ertical adjustment in typographic `points' \(i.e. 72nds of an inch\))
-2.65 E(for the positioning of the EPS image.)248 261.6 Q -.4(Wi)5 G
(th of).4 E(fsets of 0 for X and Y)-.25 E 2.5(,t)-1.29 G(he)-2.5 E
(image will be printed at the e)248 273.6 Q
(xtreme left edge of the box for that day)-.15 E 2.5(,j)-.65 G(ust)-2.5
E(under the numerics for that day)248 285.6 Q 5(.P)-.65 G(ositi)-5 E .3
-.15(ve v)-.25 H(alues mo)-.1 E .3 -.15(ve t)-.15 H(he image up and).15
E(ne)248 297.6 Q -.05(ga)-.15 G(ti).05 E .3 -.15(ve v)-.25 H(alues mo)
-.1 E .3 -.15(ve t)-.15 H(he image do).15 E(wn.)-.25 E(Here')108 314.4 Q
2.5(sa)-.55 G 2.5(ne)-2.5 G(xample of a line from the date \214le that \
associates an EPS image with an e)-2.65 E -.15(ve)-.25 G(nt:).15 E/F1 10
/Courier@0 SF(4th Thu in Nov*)144 331.2 Q(Thanksgiving)18 E
(4th Thu in Nov*)144 343.2 Q(image:/eps-path/turkey.eps 1.0 1.0 0 0)18 E
F0 -1.1(Yo)108 360 S 2.5(uc)1.1 G(an place as man)-2.5 E 2.5(yi)-.15 G
(mages as you w)-2.5 E
(ant on a single day of the month by specifying repeated lines in the)
-.1 E(date \214le.)108 372 Q -.15(Fo)5 G 2.5(re).15 G
(xample, these lines put icons of Geor)-2.65 E(ge W)-.18 E
(ashington and Abraham Lincoln on the day of the)-.8 E(U.S. `)108 384 Q
(`Presidents' Day')-.74 E 2.5('h)-.74 G(oliday)-2.5 E 2.5(,a)-.65 G
(long with the e)-2.5 E -.15(ve)-.25 G(nt te).15 E(xt:)-.15 E F1
(3rd Monday in Feb*)144 400.8 Q(Presidents' Day)18 E(3rd Monday in Feb*)
144 412.8 Q(image:/eps-path/washington.eps 0.08 0.08 8 0)18 E
(3rd Monday in Feb*)144 424.8 Q
(image:/eps-path/lincoln.eps 0.22 0.22 48 0)18 E F0(Note that the icon \
for Lincoln is shifted to the right by 48 typographic points so as not \
to o)108 441.6 Q -.15(ve)-.15 G(rlay the \214rst).15 E(icon.)108 453.6 Q
(The)108 470.4 Q/F2 10/Times-Italic@0 SF(pcal)3.75 E F0
(releases come with a single EPS sample \214le \('eps/rec)3.01 E
(ycle.eps'\) of the ubiquitous ')-.15 E(rec)-.5 E(ycle' icon \(3)-.15 E
(green arro)108 482.4 Q(ws in a triangular shape\).)-.25 E
(Such an image might be used with con\214guration \214le settings lik)5
E 2.5(et)-.1 G(his:)-2.5 E F1(second Sat in all RECYCLE!)144 499.2 Q
(second Sat in all image:/eps-path/recycle.eps 0.039 0.039 34 -9)144
511.2 Q F0(In cases where you')108 528 Q(re displaying non-holiday e)-.5
E -.15(ve)-.25 G(nt te).15 E(xt \(e.g. someone')-.15 E 2.5(sb)-.55 G
(irthday\) and an EPS image, you')-2.5 E(ll)-.1 E
(often need to use a ne)108 540 Q -.05(ga)-.15 G(ti).05 E .3 -.15(ve `)
-.25 H -1.11(Y-).15 G(delta' v)1.11 E(alue on the EPS image speci\214ca\
tion line, in order to shift the image)-.25 E(do)108 552 Q
(wn so that it doesn')-.25 E 2.5(tc)-.18 G -.15(ove)-2.5 G 2.5(rt).15 G
(he e)-2.5 E -.15(ve)-.25 G(nt te).15 E(xt, which appears just belo)-.15
E 2.5(wt)-.25 G(he day')-2.5 E 2.5(sn)-.55 G(umerics for non-holiday)
-2.5 E -2.15 -.25(ev e)108 564 T 2.5(nts. \(T).25 F -.15(ex)-.7 G 2.5
(tf).15 G(or holiday e)-2.5 E -.15(ve)-.25 G
(nts appears higher up, to the right of the day').15 E 2.5(sn)-.55 G
(umerics, so there')-2.5 E 2.5(su)-.55 G(sually no)-2.5 E
(collision with the EPS image.\))108 576 Q/F3 10/Times-Bold@0 SF(Note:)
108 592.8 Q F0(Unfortunately)2.5 E 2.5(,m)-.65 G
(ost EPS images cannot be used directly by)-2.5 E F2(pcal)2.5 E F0(.).51
E(Depending on the EPS image used and ho)144 621.6 Q 2.5(wi)-.25 G 2.5
(tw)-2.5 G(as created, you may ha)-2.6 E .3 -.15(ve t)-.2 H 2.5(or).15 G
(emo)-2.5 E .3 -.15(ve o)-.15 H 2.5(rc).15 G(omment)-2.5 E
(out some or all of the PostScript `translate' commands, in order to a)
144 633.6 Q -.2(vo)-.2 G(id the use of illogical X-).2 E(delta and Y)144
645.6 Q(-delta v)-1.11 E(alues when specifying the EPS image in your)
-.25 E F2(pcal)3.75 E F0(date \214le. Most programs that)3.01 E
(generate EPS output \(either directly or via con)144 657.6 Q -.15(ve)
-.4 G(rsion from some other graphic format\) seem to).15 E(ha)144 669.6
Q .3 -.15(ve t)-.2 H(hese `translate' commands relati).15 E -.15(ve)-.25
G(ly early in the EPS \214le.).15 E(It may tak)144 686.4 Q 2.5(es)-.1 G
(ome e)-2.5 E(xperimentation to get it just right.)-.15 E(Pre)5 E(vie)
-.25 E 2.5(wt)-.25 G(he)-2.5 E F2(pcal)3.75 E F0
(output using a PostScript)3.01 E(vie)144 698.4 Q(wer as you tweak the \
PostScript commands in the EPS image \214le and/or the e)-.25 E -.15(ve)
-.25 G(nt entry in the).15 E F2(pcal)145.25 710.4 Q F0(date \214le.)3.01
E F3(Note:)180 727.2 Q F0
(Depending upon what application you use to pre)2.5 E(vie)-.25 E 2.5(wP)
-.25 G(ostScript content, the)-2.5 E -1.11(Ve)72 768 S(rsion 4.11.0)1.11
E(18 Dec 2007)150.4 E(7)203.45 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F(monthly calendars may not sho)180 84 Q 2.5(wa)
-.25 G .3 -.15(ny e)-2.5 H(mbedded EPS images.).15 E(Here')5 E 2.5(sar)
-.55 G(undo)-2.5 E(wn of some)-.25 E(popular PostScript-vie)180 96 Q
(wing applications and whether the)-.25 E 2.5(yc)-.15 G
(orrectly display the embedded)-2.5 E(EPS images:)180 108 Q 6.5<8367>216
129.6 S 2.5(v\()-6.5 G -.15(ve)-2.5 G
(rsion 3.5.8\) -- EPS images appear \214ne).15 E 6.5<8367>216 146.4 S
(gv \(v)-6.5 E(ersions 2.4.0.1 and 2.6.1\) -- EPS images appear \214ne)
-.15 E 6.5<836f>216 163.2 S(lder kghostvie)-6.5 E 2.5(w\()-.25 G -.15
(ve)-2.5 G(rsions 0.13.2 [KDE 3.1.4] and 0.2.0 [KDE 3.2.3 and).15 E
(3.3.2]\) -- EPS images DO NO)226 175.2 Q 2.5(TA)-.4 G(PPEAR!)-2.5 E 6.5
<836e>216 192 S -.25(ew)-6.5 G(er kghostvie).25 E 2.5(w\()-.25 G -.15
(ve)-2.5 G(rsion 0.2.0 [KDE 3.4.2 and 3.5.4]\) -- EPS images).15 E
(appear \214ne)226 204 Q -.15(Fo)108 230.4 S 2.5(rc).15 G(on)-2.5 E -.15
(ve)-.4 G(rting non-EPS images \(e.g. photos\) to EPS format, one can u\
se the graphical GNU Image Manip-).15 E
(ulation Program, a.k.a. `The GIMP':)108 242.4 Q/F1 10/Times-Italic@0 SF
(http://www)144 259.2 Q(.gimp.or)-.74 E(g)-.37 E F0 -.15(Fo)108 288 S
2.5(ri).15 G(cons/images in WMF format \(which are popular in v)-2.5 E
(arious 3rd-party)-.25 E 2.5(,l)-.65 G -2.25 -.15(eg a)-2.5 H -.15(cy)
.15 G(-OS, commercial calendar).15 E(programs\), the `libwmf)108 300 Q
('/`wmf2eps' library/utility is useful for generating).55 E F1(pcal)2.5
E F0(-capable EPS images.).51 E(It can)5 E(be found at this site:)108
312 Q F1(http://wvwar)144 328.8 Q -.15(e.)-.37 G(sour).15 E(cefor)-.37 E
-.1(ge)-.37 G(.net/libwmf)-.05 E(.html)-.15 E F0 -.15(Fo)108 357.6 S 2.5
(ri).15 G(cons/images in SV)-2.5 E 2.5(Gf)-.15 G
(ormat, the ImageMagick `con)-2.5 E -.15(ve)-.4 G
(rt' utility is sometimes useful for generating).15 E F1(pcal)108 369.6
Q F0(-capable EPS images.).51 E(This suite of utilities \(which include\
s other useful ImageMagick utilities lik)5 E(e)-.1 E
(`display' and `identify'\) may already be a)108 381.6 Q -.25(va)-.2 G
(ilable on your Linux distrib).25 E 2.5(ution. If)-.2 F
(not, it can be found at this)2.5 E(site:)108 393.6 Q F1(http://www)144
410.4 Q(.ima)-.74 E -.1(ge)-.1 G(ma).1 E(gic)-.1 E(k.or)-.2 E(g)-.37 E
F0 -.15(Fo)108 439.2 S 2.5(rc).15 G(ases where ImageMagick')-2.5 E 2.5
(s`)-.55 G(con)-2.5 E -.15(ve)-.4 G(rt' utility f).15 E
(ails to properly con)-.1 E -.15(ve)-.4 G(rt SV).15 E
(G-format images to EPS for)-.15 E(-)-.2 E
(mat, you can try the method of con)108 451.2 Q -.15(ve)-.4 G
(rting the SV).15 E 2.5(Gi)-.15 G
(mage into an intermediate format \(e.g. PNG\) using the)-2.5 E
(`rsvg' utility)108 463.2 Q 5(.T)-.65 G(his utility may already be a)-5
E -.25(va)-.2 G(ilable on your Linux distrib).25 E 2.5(ution. If)-.2 F
(not, it can be found at)2.5 E(this site:)108 475.2 Q F1(http://libr)144
492 Q(svg)-.1 E(.sour)-.15 E(cefor)-.37 E -.1(ge)-.37 G(.net/)-.05 E F0
(From the PNG format, the image can often then be successfully con)108
508.8 Q -.15(ve)-.4 G(rted to EPS format, using the abo).15 E -.15(ve)
-.15 G(-).15 E(mentioned ImageMagick `con)108 520.8 Q -.15(ve)-.4 G
(rt' utility).15 E(.)-.65 E(The)108 549.6 Q F1(Open Clip Art Libr)2.4 E
(ary)-.15 E F0(is a good source of freely-usable images \(man)2.82 E 2.5
(yo)-.15 G 2.5(fw)-2.5 G(hich are in SV)-2.5 E 2.5(Gf)-.15 G
(ormat\) for)-2.5 E(decorating your e)108 561.6 Q -.15(ve)-.25 G(nts:)
.15 E F1(http://www)144 578.4 Q(.openclipart.or)-.74 E(g)-.37 E/F2 10
/Times-Bold@0 SF(Note:)108 607.2 Q F0(The EPS image content is not gene\
rated in the PostScript output -- only a reference to the EPS image)2.5
E(\214lename is generated.)108 619.2 Q
(From a practical standpoint, this means that normally you')5 E
(ll need to print/pre)-.1 E(vie)-.25 E(w)-.25 E
(the PostScript output of)108 631.2 Q F1(pcal)3.75 E F0
(from the same computer/setup as that which w)3.01 E(as used to run)-.1
E F1(pcal)3.75 E F0(in the \214rst)3.01 E 2.5(place. If)108 643.2 R
(you w)2.5 E(ant to generate a calendar with embedded EPS images that w\
ill later be printed/vie)-.1 E(wed on)-.25 E
(another machine which does not ha)108 655.2 Q .3 -.15(ve a)-.2 H
(ccess to those EPS images, you').15 E
(ll need to run the output through a)-.1 E(pre-processor which will put\
the EPS image content into the PostScript output \214le.)108 667.2 Q
-.15(Fo)5 G 2.5(re).15 G(xample, assuming)-2.65 E
(your initial calendar output w)108 679.2 Q(as generated to a \214le na\
med `pcal.ps', on most GNU/Linux systems you could)-.1 E
(run this command, which uses the popular `Ghostscript' interpreter:)108
691.2 Q(gs -r300x300 -dB)144 708 Q -1.11(AT)-.35 G(CH -dNOP)1.11 E -.55
(AU)-.92 G(SE -sDEVICE=pswrite -sOutputFile=out.ps pcal.ps).55 E(This w)
108 724.8 Q(ould generate a PostScript \214le named `out.ps', at 300x30\
0 dpi resolution, which has the actual EPS)-.1 E -1.11(Ve)72 768 S
(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(8)203.45 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F(image content embedded within, allo)108 84 Q
(wing you to transport the `out.ps' \214le to another computer for vie)
-.25 E(w-)-.25 E 2.5(ing/printing. Of)108 96 R(course, the ne)2.5 E 2.5
<778c>-.25 G(le is substantially lar)-2.5 E(ger)-.18 E 2.5(,b)-.4 G
(ut it')-2.7 E 2.5(sp)-.55 G(ortable. Furthermore, the EPS images)-2.5 E
(will be vie)108 108 Q -.1(wa)-.25 G(ble e).1 E -.15(ve)-.25 G 2.5(ni)
.15 G 2.5(nP)-2.5 G(ostScript-vie)-2.5 E(wing applications \(see abo)
-.25 E -.15(ve)-.15 G 2.5(\)w).15 G(hich don')-2.5 E 2.5(tp)-.18 G
(roperly support the dis-)-2.5 E
(play of embedded \(by \214lename only\) EPS images.)108 120 Q/F1 10
/Times-Bold@0 SF(Pr)87 160.8 Q(e-Pr)-.18 E(ocessor Functionality)-.18 E
/F2 10/Times-Italic@0 SF(Pcal)108.5 172.8 Q F0(supports rudimentary)3.01
E F2(cpp)2.5 E F0(-lik).19 E 2.5(ef)-.1 G
(unctionality in the date \214le, allo)-2.5 E(wing the follo)-.25 E
(wing constructs:)-.25 E<83>144 194.4 Q F1(de\214ne | undef)6.5 E F0<83>
144 211.2 Q F1(if{{n}def} ... {elif ...}* {else ...} endif)6.5 E F0<83>
144 228 Q F1(include)6.5 E F0
(Note that these are not preceded by `#' as the)108 244.8 Q 2.5(ya)-.15
G(re in C.)-2.5 E(Symbol names de\214ned using these k)108 261.6 Q -.15
(ey)-.1 G -.1(wo).15 G(rds \(or via the).1 E F1(-D)2.5 E F0
(option\) are case-insensiti)2.5 E -.15(ve)-.25 G 5(.I).15 G 2.5(ti)-5 G
2.5(sn)-2.5 G(ot an error to)-2.5 E F1(undef)108 273.6 Q F0
(an unde\214ned symbol, nor to)2.5 E F1(de\214ne)2.5 E F0 2.5(ap)2.5 G
(re)-2.5 E(viously-de\214ned one.)-.25 E 2.5(As)108 290.4 S
(ymbol can be de\214ned with just a name \(e.g. `)-2.5 E
(`de\214ne MY_SYM')-.74 E('\) or it can tak)-.74 E 2.5(eo)-.1 G 2.5(nav)
-2.5 G(alue \(e.g. `)-2.75 E(`de\214ne)-.74 E(MY_SYM SOME_V)108 302.4 Q
(ALUE')-1.35 E 2.5('\). Use)-.74 F(of symbol v)2.5 E(alues is con)-.25 E
-.15(ve)-.4 G(nient for de\214ning a starting date then using).15 E
(that symbol to reference that starting date in one or more e)108 314.4
Q -.15(ve)-.25 G 2.5(nts. F).15 F(or e)-.15 E
(xample, these de\214nitions in the date)-.15 E(\214le might be useful:)
108 326.4 Q/F3 10/Courier@0 SF(define semester_start 8/23)144 343.2 Q 6
(#B)18 G(eginning of semester)-6 E 96(semester_start Class)144 355.2 R
(Start)6 E 6(7th day)144 367.2 R(after semester_start)6 E(1st Quiz)12 E
(14th day after semester_start)144 379.2 Q(2nd Quiz)12 E
(undef semester_start)144 391.2 Q F0(Be a)108 408 Q -.1(wa)-.15 G
(re that the substitution of symbol v).1 E
(alues for symbol names is not rob)-.25 E(ust, so it')-.2 E 2.5(sw)-.55
G(ise to use a symbol)-2.5 E(name that')108 420 Q 2.5(su)-.55 G(nlik)
-2.5 E(ely to occur in an)-.1 E 2.5(yo)-.15 G 2.5(fy)-2.5 G(our other e)
-2.5 E -.15(ve)-.25 G(nt te).15 E 2.5(xt. In)-.15 F(other w)2.5 E
(ords, if you de\214ned the `semes-)-.1 E(ter_start' symbol in the e)108
432 Q(xample abo)-.15 E .3 -.15(ve a)-.15 H 2.5(sm).15 G
(erely `start', then you')-2.5 E 2.5(dg)-.5 G(et the undesired ef)-2.5 E
(fect of ha)-.25 E(ving the)-.2 E(te)108 444 Q
(xt `Class 8/23' in your calendar on that day instead of `Class Start'!)
-.15 E(The use of `undef semester_start' in)5 E(the abo)108 456 Q .3
-.15(ve ex)-.15 H(ample is optional and is really only useful to pre).15
E -.15(ve)-.25 G(nt an).15 E 2.5(yu)-.15 G(nw)-2.5 E
(anted symbol substitutions later)-.1 E(on, which probably w)108 468 Q
(on')-.1 E 2.5(th)-.18 G
(appen unless you poorly choose your symbol name to be)-2.5 E(gin with.)
-.15 E(An)108 484.8 Q F1(ifdef)2.5 E F0(alone is al)2.5 E -.1(wa)-.1 G
(ys).1 E F1(false)2.5 E F0 2.5(;a)C(n)-2.5 E F1(ifndef)2.5 E F0
(alone is al)2.5 E -.1(wa)-.1 G(ys).1 E F1(true)2.5 E F0(.)A F1(if)5 E
F0(is accepted as a synon)2.5 E(ym for)-.15 E F1(ifdef)2.5 E F0(.)A
(The name of the \214le in the)108 501.6 Q F1(include)2.5 E F0(directi)
2.5 E .3 -.15(ve m)-.25 H
(ay optionally be surrounded by either "" or <>, both of).15 E
(which are ignored.)108 513.6 Q
(If the name is not an absolute path, it is tak)5 E(en to be relati)-.1
E .3 -.15(ve t)-.25 H 2.5(ot).15 G(he directory where the)-2.5 E
(\214le containing the directi)108 525.6 Q .3 -.15(ve i)-.25 H 2.5(sl)
.15 G 2.5(ocated. If)-2.5 F
(the string "%y" appears in the \214le name, it is replaced by the last)
2.5 E(tw)108 537.6 Q 2.5(od)-.1 G(igits of the current year or)-2.5 E
2.5(,i)-.4 G 2.5(f")-2.5 G(year all" is in ef)-2.5 E(fect, is e)-.25 E
(xpanded to all applicable years.)-.15 E F2(Pcal)5.5 E F0(is smart)3.01
E(enough to translate)108 549.6 Q F1(~/)2.5 E F0(to the user')2.5 E 2.5
(sh)-.55 G(ome directory)-2.5 E(.)-.65 E F2(Pcal)108.5 566.4 Q F0
(normally terminates immediately if the \214le speci\214ed in an)3.01 E
F1(include)2.5 E F0(directi)2.5 E .3 -.15(ve d)-.25 H(oes not e).15 E
2.5(xist. An)-.15 F(alter)2.5 E(-)-.2 E(nate form of the directi)108
578.4 Q -.15(ve)-.25 G(,).15 E F1(include?)2.5 E F0 2.5(,d)C(irects)-2.5
E F2(pcal)3.75 E F0(to continue silently if the \214le does not e)3.01 E
(xist or cannot be)-.15 E(opened.)108 590.4 Q
(In addition to pre-processing k)108 607.2 Q -.15(ey)-.1 G -.1(wo).15 G
(rds,).1 E F2(pcal)3.75 E F0(also accepts boolean e)3.01 E
(xpressions in)-.15 E F1(if{{n}def})2.5 E F0(and)2.5 E F1(elif)2.5 E F0
(direc-)2.5 E(ti)108 619.2 Q -.15(ve)-.25 G 2.5(s. These).15 F -.15(ex)
2.5 G(pressions consist of symbol names joined by the boolean operators)
.15 E F1(!)2.5 E F0(,)A F1(&)2.5 E F0(,)A F1(^)2.5 E F0 2.5(,a)C(nd)-2.5
E F1(|)2.5 E F0 2.5(,i)C 2.5(no)-2.5 G(rder of)-2.5 E
(precedence, high to lo)108 631.2 Q 3.8 -.65(w. P)-.25 H
(arentheses may be used to alter the precedence.).5 E(The synon)5 E(yms)
-.15 E F1(&&)2.5 E F0(and)2.5 E F1(||)2.5 E F0(are)2.5 E(accepted for)
108 643.2 Q F1(&)2.5 E F0(and)2.5 E F1(|)2.5 E F0 5(.A)C(symbol name e)
-2.5 E -.25(va)-.25 G(luates to).25 E F1(true)2.5 E F0
(if currently de\214ned,)2.5 E F1(false)2.5 E F0(if not; thus:)2.5 E F3
(ifdef A | B | C)144 660 Q F0(...is)108 676.8 Q F1(true)2.5 E F0(if an)
2.5 E 2.5(yo)-.15 G 2.5(ft)-2.5 G
(he symbols A, B, and C is de\214ned, and:)-2.5 E F3(ifdef A & B & C)144
693.6 Q F0(...is)108 710.4 Q F1(true)2.5 E F0(if the)2.5 E 2.5(ya)-.15 G
(ll are.)-2.5 E(Note that)5 E F1(ifndef )2.5 E F0(is equi)2.5 E
-.25(va)-.25 G(lent to).25 E F1(ifdef !\( \).)2.5 E F0 -1.11(Ve)
72 768 S(rsion 4.11.0)1.11 E(18 Dec 2007)150.4 E(9)203.45 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 150.805(PCAL\(1\) USER)72 48 R 150.805
(COMMANDS PCAL\(1\))2.5 F/F1 10/Times-Bold@0 SF(The Moon File)87 84 Q F0
(If a \214le of the name)108 96 Q/F2 10/Times-Italic@0 SF(.moon##)2.5 E
F0(\()3.4 E F2(moon##.dat).38 E F0(under MS-DOS\), where)2.5 E F1(##)2.5
E F0(is the last tw)2.5 E 2.5(od)-.1 G(igits of the calendar)-2.5 E
(year)108 108 Q 2.5(,e)-.4 G(xists in the same directory as the date \
\214le \(or in the directory where)-2.65 E F2(pcal)3.75 E F0(resides\),)
3.01 E F2(pcal)3.75 E F0(uses the)3.01 E
(information contained within to calculate the phase of the moon.)108
120 Q(If a\) no such \214le e)5 E(xists, b\) the)-.15 E F12.5 E F0
(\215ag \(do)2.5 E(not use a date \214le\) is speci\214ed, or c\) the)
108 132 Q F12.5 E F0
(\215ag \(specify time zone\) is speci\214ed, then)2.5 E F2(pcal)3.75 E
F0(uses an algo-)3.01 E(rithm to calculate the phase of the moon.)108
144 Q(Entries in the moon \214le must conform to the follo)108 160.8 Q
(wing syntax:)-.25 E(If the)108 177.6 Q F12.5 E F0
(option \(American date formats, the def)2.5 E(ault\) is gi)-.1 E -.15
(ve)-.25 G(n:).15 E/F3 10/Courier@0 SF
( {})144 194.4 Q F0(If the)
108 211.2 Q F12.5 E F0(option \(European date formats\) is gi)2.5
E -.15(ve)-.25 G(n:).15 E F3
(