home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 2: PC
/
frozenfish_august_1995.bin
/
bbs
/
d09xx
/
d0975.lha
/
PCal
/
pcal.doc
< prev
next >
Wrap
Text File
|
1994-02-14
|
35KB
|
793 lines
PCAL(1) PCAL(1)
NNAAMMEE
pcal - generate PostScript calendars
SSYYNNOOPPSSIISS
ppccaall [--ee|--ff _c_a_l] [--oo _f_i_l_e] [--jj | --JJ] [--ll | --pp] [--mm | --MM]
[--bb _d_a_y|all] [--gg _d_a_y|all] [--OO] [--GG]
[--ss [[_d_a_t_e___s_h_a_d_e]][[//_f_i_l_l___s_h_a_d_e]]_] _[--FF _d_a_y_] _[--AA_|--EE_]
_[--tt _t_i_t_l_e___f_o_n_t_] _[--dd _d_a_y___f_o_n_t_] _[--nn _t_e_x_t___f_o_n_t_[_/_s_i_z_e_]_]
_[--LL _f_o_o_t_e_r___s_t_r_] _[--CC _f_o_o_t_e_r___s_t_r_] _[--RR _f_o_o_t_e_r___s_t_r_]
_[--NN _n_o_t_e_s___s_t_r_] _[--DD _s_y_m_b_o_l_] _[--UU _s_y_m_b_o_l_] _[--xx _x_s_c_a_l_e_]
_[--yy _y_s_c_a_l_e_] _[--XX _x_t_r_a_n_s_] _[--YY _y_t_r_a_n_s_] _[--II_] _[--BB_]
_[--SS _| --kk _| --KK_] _[--ww_] _[--hh _| --uu _| --vv_] _[_m_o_n_t_h_] _[_y_e_a_r_]
_[_n_m_o_n_t_h_s_]
DDEESSCCRRIIPPTTIIOONN
_P_c_a_l generates PostScript to produce landscape or portrait
calendars for any month and year. The arguments mmoonntthh,
yyeeaarr, and nnmmoonntthhss, if provided, should be numeric. The
mmoonntthh value should be in the range 1 - 12, and the yyeeaarr
value should be specified as 1 or 2 digits 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 yyeeaarr value, and calendars for the entire year will be
generated. Otherwise, nnmmoonntthhss months, starting with mmoonntthh
and yyeeaarr, will be generated.
For whole-year calendars (i.e. the --ww option is given),
the command line arguments are interpreted somewhat dif-
ferently. By default, all months in the current year are
printed, starting with January. If the mmoonntthh argument
alone is given, it is expected to be the desired yyeeaarr to
print, and prints all of the months in the given year. If
both mmoonntthh and yyeeaarr are given, then 12 consecutive months
are printed starting at the given month and year. If the
mmoonntthh, yyeeaarr, and nnmmoonntthhss arguments are all present, print-
ing begins with the given month and year and nnmmoonntthhss
months are printed, rounded up to the nearest multiple of
12.
TThhee DDaattee FFiillee
By default, _p_c_a_l simply prints an empty calendar. Its
real power is in its ability to place ``events'' in appro-
priate days on the calendar, thus allowing the user to
create personalized calendars. This is achieved through
the use of the ``date file''.
The date file is named _._c_a_l_e_n_d_a_r (_p_c_a_l_._d_a_t under MS-DOS),
or _c_a_l_e_n_d_a_r for compatibility with older versions. _P_c_a_l
will look in several places for such a file. First, if
the environment variable PPCCAALL__DDIIRR is defined, _p_c_a_l
searches the directory indicated by that variable. Next,
1
PCAL(1) PCAL(1)
_p_c_a_l searches the user's home directory (as specified by
the HHOOMMEE environment variable). If neither PPCCAALL__DDIIRR nor
HHOOMMEE is defined, _p_c_a_l searches the current directory
instead. Finally, the directory where the _p_c_a_l executable
resides will be checked. If no date file is found, an
empty calendar is printed; no error is generated.
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. Dates in
the _._c_a_l_e_n_d_a_r file may be expressed in any of several for-
mats:
<<oorrddiinnaall>> <<ddaayy__ssppeecc>> iinn <<mmoonntthh__ssppeecc>>{{**}} {{<<tteexxtt>>}}
<<ddaayy__ssppeecc>> <<pprreepp>> <<ddaattee__ssppeecc>>{{**}} {{<<tteexxtt>>}}
<<ddaattee__ssppeecc>>{{**}} {{<<tteexxtt>>}}
Where:
<month_name> := first 3+ characters of name of month, or ``all''
<month_spec> := <month_name>, or ``year''
<day_spec> := first 3+ characters of name of weekday, ``day'',
``weekday'', ``workday'', ``holiday'', ``nonweekday'',
``nonworkday'', ``nonholiday'', ``new_moon'',
``first_quarter'', ``full_moon'', or ``last_quarter''
<ordinal> := any ordinal number (``1st'', ``2nd'', etc.), ``first'' ... ``fifth'',
``last'', ``odd'', ``even'', or ``all''
<prep> := ``before'', ``preceding'', ``after'', ``following'',
``on_or_before'' (``oob''), or ``on_or_after'' (``ooa'')
<sep> := one or more non-numeric, non-space, non-`*' characters
<month> := a numeric month (1-12)
<day> := day of month (1-31)
<year> := a numeric year
If the --AA option (American date formats, the default) is
given:
<date_spec> := <month_name> <day> | <month><sep><day>{<sep><year>}
If the --EE option (European date formats) is given:
<date_spec> := <month_name> <day> | <month><sep><day>{<sep><year>}
_P_c_a_l also allows format specifiers in both the text and
foot strings (see the --LL, --CC, --RR, and --NN options below);
each will be replaced by a corresponding string as out-
lined in the table below. Most of these are derived from
the ANSI C ssttrrffttiimmee(()) function; the %%[[lloouuwwMMDD]] and %%[[oo00++--]]
format specifiers are specific to _p_c_a_l:
%a abbreviated weekday
%A full weekday
%b abbreviated month name
2
PCAL(1) PCAL(1)
%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
The %%uu specifier considers the week containing 1/1 as week
1 and the following logical Sunday (the first day of the
week as printed; cf. the --FF option below) as the start of
week 2; %%UU considers the first logical Sunday as the first
day of week 1. %%ww and %%WW behave like %%uu and %%UU respec-
tively, but use the first logical Monday instead. Note
that %%ww ssttrrffttiimmee(())..
The %%oo format specifier prints a number as an ordinal,
with the appropriate suffix (``st'', ``nd'', ``rd'', or
``th'' in English) appended. For example, %%oodd prints the
day of the month as ``1st'', ``2nd'', ``3rd'', etc.
Unlike ssttrrffttiimmee(()),, _p_c_a_l defaults to printing numbers
(except %%yy) without leading zeroes. If leading zeroes are
desired, the `0' prefix may be used. For example, %%00jj
prints the first day of year as ``001''.
The %%++ and %%-- format specifiers direct _p_c_a_l to substitute
the following/previous month/year in the following [[bbBBmmyyYY]]
specifier. For example, %%++BB prints the name of the next
month.
The %%{{[[++--]]NN}}[[DDWWMMYY]] format specifiers do not print any-
thing, but instead adjust the working date by +- NNdays
(DD), weeks (WW), months (MM), or years (YY). Subsequent for-
mat specifiers use the adjusted date instead of the cur-
rent date. For example, %%++11MM %%BB %%YY adjusts the date for-
ward by one month and then prints the resulting month and
year (``January 1992'' in December, 1991); %%--22WW %%bb %%dd
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
3
PCAL(1) PCAL(1)
example, %%++11YY%%--11DD adjusts the date forward by one year and
then backward by one day. If %%DD or %%MM is specified alone
(or if NN is zero), _p_c_a_l restores the original date. Note
that %%MM has a different meaning to the ssttrrffttiimmee(()) func-
tion.
The ``Notes'' box (see below) uses the first of the cur-
rent month as the default date. All foot strings use the
first of the current month in single-month mode and the
first of the starting month in whole-year mode.
Examples:
llaasstt MMoonnddaayy iinn MMaayy** MMeemmoorriiaall DDaayy HHoolliiddaayy
aallll FFrriiddaayyss iinn OOcctt SSttaattuuss MMeeeettiinngg,, 1111 AAMM
ffiirrsstt wwoorrkkddaayy iinn aallll %%--BB pprrooggrreessss rreeppoorrtt dduuee
aallll FFrrii iinn aallll TTiimmee ccaarrdd dduuee,, 33 PPMM
aallll MMoonnddaayy iinn aallll FFiissccaall wweeeekk %%00WW
--22nndd wwoorrkkddaayy iinn aallll SScchheedduullee ffoorr %%++BB dduuee %%++22DD
22nndd ffuullll__mmoooonn iinn aallll BBlluuee MMoooonn
FFrrii oonn__oorr__bbeeffoorree aallll 1155 PPaayy DDaayy
eevveenn FFrriiddaayyss iinn yyeeaarr PPaayy DDaayy
118833rrdd ddaayy ooff yyeeaarr MMiidd--yyeeaarr ((%%ll ddaayyss lleefftt))
TTuuee aafftteerr ffiirrsstt MMoonn iinn NNoovv EElleeccttiioonn DDaayy ((UUSSAA))
44tthh TThhuu iinn NNoovv** TThhaannkkssggiivviinngg
FFrrii aafftteerr 44tthh TThhuu iinn NNoovv** DDaayy aafftteerr TThhaannkkssggiivviinngg
1122//2255//9900** CChhrriissttmmaass ## AAmmeerriiccaann
2255..1122..9900** CChhrriissttmmaass ## EEuurrooppeeaann
DDeecc 2255** CChhrriissttmmaass ## AAmmeerriiccaann
2255 DDeecc** CChhrriissttmmaass ## EEuurrooppeeaann
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 to be printed in gray. ``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 ``week-
day'' applies to any days which are normally printed in
black 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
4
PCAL(1) PCAL(1)
``nonholiday'' are also recognized as negations of the
above. See the CCAAVVEEAATTSS 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.
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 nneewwlliinnee ) and the standard ANSI
character escapes (`\a', `\b', `\f', `\n', `\r', `\t',
`\v') are all replaced by a single blank.
Lines in the _._c_a_l_e_n_d_a_r file consisting of yyeeaarr ######## (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 _._c_a_l_e_n_d_a_r file consisting of oopptt <<ooppttiioonnss>>
can be used to override the defaults for any command-line
options except --cc, --ee, --ff, --hh, --uu, --vv, --DD, and --UU. Any
options specified in this manner are, in turn, overridden
by those specified explicitly on the command line.
Lines in the _._c_a_l_e_n_d_a_r file consisting of nnoottee{{//<<nnuummbbeerr>>}}
<<mmoonntthh>> can be used to place notes regarding the entire
month in one of the unused blocks of the calendar. The
<<mmoonntthh>> indicator may be either a number 1 through 12 or
an alphabetic month name as described above; ``note all''
5
PCAL(1) PCAL(1)
will place the associated text in the notes block for each
month in the current year. <<nnuummbbeerr>> is an optional posi-
tive or negative number specifying the empty box where the
associated text is to be placed. If positive, _p_c_a_l counts
forward from the first empty box; if negative, _p_c_a_l counts
backward from the last empty box. Thus, ````nnoottee//11'''' places
the associated text in the first empty box; nnoottee//--33 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. --SS, --kk, and --KK, below).
Comments are supported in the _._c_a_l_e_n_d_a_r file. Any charac-
ters following a `#' character through the end of the line
are ignored.
_P_c_a_l supports rudimentary _c_p_p-like functionality in the
date file, allowing the following constructs: ddeeffiinnee ||
uunnddeeff, iiff{{{{nn}}ddeeff}} ...... {{eelliiff ......}}** {{eellssee ......}} eennddiiff,, and
iinncclluuddee. Note that these are not preceded by `#' as they
are in C. Symbol names defined using these keywords (or
via the --DD option) are case-insensitive. It is not an
error to uunnddeeff an undefined symbol, nor to ddeeffiinnee a previ-
ously-defined one. An iiffddeeff alone is always ffaallssee; an
iiffnnddeeff alone is always ttrruuee. iiff is accepted as a synonym
for iiffddeeff.
The name of the file in the iinncclluuddee directive may option-
ally 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. _P_c_a_l is smart enough to trans-
late ~~// to the user's home directory.
In addition to pre-processing keywords, _p_c_a_l also accepts
boolean expressions in iiff{{{{nn}}ddeeff}} and eelliiff 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 prece-
dence. The synonyms &&&& and |||| are accepted for && and ||.
A symbol name evaluates to ttrruuee if currently defined,
ffaallssee if not; thus:
iiffddeeff AA || BB || CC
...is ttrruuee if any of the symbols A, B, and C is defined,
and:
iiffddeeff AA && BB && CC
...is ttrruuee if they all are. Note that iiffnnddeeff <<eexxpprr>> is
equivalent to iiffddeeff !!(( <<eexxpprr>> ))..
TThhee MMoooonn FFiillee
6
PCAL(1) PCAL(1)
If a file of the name _._m_o_o_n_#_# (_m_o_o_n_#_#_._d_a_t 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 _p_c_a_l resides), _p_c_a_l uses the information
contained within to calculate the phase of the moon. If
no such file exists, _p_c_a_l uses an approximate algorithm.
Entries in the moon file must conform to the following
syntax:
If the --AA option (American date formats, the default) is
given:
<<qquuaarrtteerr>> <<mmoonntthh>><<sseepp>><<ddaayy>> {{<<hhoouurr>><<sseepp>><<mmiinn>>}}
If the --EE option (European date formats) is given:
<<qquuaarrtteerr>> <<ddaayy>><<sseepp>><<mmoonntthh>> {{<<hhoouurr>><<sseepp>><<mmiinn>>}}
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, _p_c_a_l will revert to using its default algo-
rithm.
As in the date file, comments start with `#' and run
through the end of the given line.
OOppttiioonnss
_P_c_a_l has many options:
--ee Prints an empty calendar. Do not print
entries from a _._c_a_l_e_n_d_a_r file.
--ff _c_a_l Directs _p_c_a_l to use the file name _c_a_l as the
input file in place of the default _._c_a_l_e_n_d_a_r
file. Note that the search rules are differ-
ent when --ff is used. If _c_a_l is an absolute
file name (i.e., starting with a `/'), then
_p_c_a_l attempts to open only that file. Other-
wise, _p_c_a_l looks for _c_a_l in the current direc-
tory, then in the directory indicated by the
environment variable PPCCAALL__DDIIRR (if defined),
and finally in the directory where the _p_c_a_l
executable resides. If the given _c_a_l file is
not found, an error results.
7
PCAL(1) PCAL(1)
--oo _f_i_l_e Directs _p_c_a_l to write the output to _f_i_l_e
instead of to stdout.
--ll Causes the output to be in landscape mode
(default). This also resets the x- and y-axis
scaling and translation factors to the
defaults for landscape mode.
--pp Causes the output to be in portrait mode.
This also resets the x- and y-axis scaling and
translation factors to the defaults for por-
trait mode.
--jj Causes the Julian date (day of year) to be
printed in each calendar box.
--JJ Causes the Julian date and the number of days
remaining in the year to be printed in each
calendar box.
--mm Causes moon icons to be printed on dates cor-
responding to new, half, and full moons (the
default is that no moons are printed).
--MM Causes moon icons to be printed on all dates
(the default is that no moons are printed).
--bb _d_a_y || aallll
Causes all dates falling on weekday _d_a_y to be
printed in black; --bb aallll causes all weekdays
to be printed in black.
--gg _d_a_y || aallll
Causes all dates falling on weekday _d_a_y to be
printed in gray; --gg aallll causes all weekdays to
be printed in gray.
The default for the --bb and --gg options is to
print Saturdays and Sundays in gray and other
days, unless flagged as holidays, in black.
--OO Causes ``gray'' dates to be printed as out-
lined characters.
--GG Causes ``gray'' dates to be printed as out-
lined characters filled with gray.
--ss_{_d_a_t_e_}_{_/_f_i_l_l_}
Overrides the default values for date and/or
fill box shading. These values must be in the
range 0.0 (black) through 1.0 (white); they
may be set independently of each other. The
default values are 0.8 for dates and 0.9 for
empty boxes.
8
PCAL(1) PCAL(1)
--FF _d_a_y Selects weekday _d_a_y as the first day of the
week. The given day will appear in the left-
most column of the calendar.
--AA Directs _p_c_a_l to use American date conventions
mmmm//dddd{{//yyyy}} and mmoonntthh dddd ) when parsing the
date file (default).
--EE Directs _p_c_a_l to use European date conventions
dddd//mmmm{{//yyyy}} and dddd mmoonntthh ) when parsing the
date file.
--XX _x_t_r_a_n_s Specifies the x-axis translation value for
positioning the output on the page.
--YY _y_t_r_a_n_s Specifies the y-axis translation value for
positioning the output on the page.
--xx _x_s_c_a_l_e Specifies the x-axis scaling factor for the
calendar size.
--yy _y_s_c_a_l_e Specifies the y-axis scaling factor for the
calendar size.
--tt _t_i_t_l_e___f_o_n_t
Specifies the name of a font to use to print
the month name and year at the top of the cal-
endar, the foot strings, and the notes box
heading. For example, ppccaall --tt TTiimmeess--RRoommaann.
--dd _d_a_y___f_o_n_t Similar to the --tt option, but selects the font
used to print the day numbers and weekday
names.
--nn _t_e_x_t___f_o_n_t[//_s_i_z_e]
Similar to the --tt option, but selects the font
used to print the text inside each day and in
the notes block. The user may also select the
font size; ppccaall --nn HHeellvveettiiccaa//88 sets the font
to 8-point Helvetica.
--DD _s_y_m_b_o_l Defines the named symbol prior to reading the
date file.
--UU _s_y_m_b_o_l Un-defines the named symbol prior to reading
the date file.
--LL _s_t_r_i_n_g 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.
--CC _s_t_r_i_n_g Similar to --LL, but causes the accompanying
9
PCAL(1) PCAL(1)
string to be printed as a centered footer.
--RR _s_t_r_i_n_g Similar to --LL, but causes the accompanying
string to be printed as a right-justified
footer.
--NN _s_t_r_i_n_g Causes the accompanying string to be printed
as the heading for the "Notes" box. Note,
however, that _p_c_a_l makes no attempt to ensure
that it fits.
--BB Causes _p_c_a_l to leave unused calendar boxes
blank (default is gray).
--SS Causes _p_c_a_l to suppress printing the small
calendars. See the CCAAVVEEAATTSS section for fur-
ther details.
--kk Causes _p_c_a_l to print the small calendars in
the upper left corner (the default is to print
them at the lower right).
--KK Causes _p_c_a_l 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).
--ww Causes _p_c_a_l to print a calendar for 12 consec-
utive months: 3 rows / 4 columns in landscape
mode, 4 rows / 3 columns in portrait mode.
See the CCAAVVEEAATTSS section for details on the use
of this option with other options.
--cc Causes _p_c_a_l to generate a date file suitable
for use as input to the Un*x _c_a_l_e_n_d_a_r_(_1_) util-
ity. The normal PostScript output is sup-
pressed.
--II Resets all parameters to the program defaults.
--hh Causes _p_c_a_l to write version information,
parameter usage message, and full explanation
of options and file formats (to _s_t_d_o_u_t) and
terminate.
--uu Causes _p_c_a_l to write version information and
parameter usage message (to _s_t_d_o_u_t) and termi-
nate.
--vv Causes _p_c_a_l to write version information only
(to _s_t_d_o_u_t) and terminate.
Any option which normally takes an argument may be speci-
fied without the argument in order to reset the value to
10
PCAL(1) PCAL(1)
the program default. Note that while the --DD option alone
clears all the defined symbols, the --UU option alone has no
effect. The -- (or ---- as per System V) argument may be
used to disambiguate command lines such as:
ppccaall --tt 99 9900
This could be written instead as one of the following:
ppccaall --tt -- 99 9900
ppccaall --tt ---- 99 9900
If the environment variable PPCCAALL__OOPPTTSS is defined, its con-
tents are parsed as a command line. Flags set via
PPCCAALL__OOPPTTSS override the program defaults, but are overrid-
den by options set via oopptt lines in the _._c_a_l_e_n_d_a_r file or
explicitly on the command line.
CCAAVVEEAATTSS
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:
JJaannuuaarryy 11999900
SS MM TTuu WW TThh FF SS
11 22 33 44 55 66
77 88 99 1100 1111 1122 1133
1144 1155 1166 1177 1188 1199 2200
2211 2222 2233 2244 2255 2266 2277
2288 2299 3300 3311
If the _._c_a_l_e_n_d_a_r file looked like this:
wwoorrkkddaayy oonn__oorr__bbeeffoorree aallll 1155 ppaayyddaayy
33rrdd MMoonn iinn JJaann** MMLLKK ddaayy
... then _p_c_a_l would mark the 15th as ``payday'' since at
that point in the _._c_a_l_e_n_d_a_r 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 pre-
ceded the ``workday'' wildcard, then _p_c_a_l 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.
When the --ww and --pp options are used together, _p_c_a_l revises
the y-scale factor in order to use the entire portrait
page; therefore, the user should avoid using use the --yy
option when using both the --ww and --pp options. Use of the
--ww option in any case effectively disables the --mm, --MM, --jj,
and --JJ options.
11
PCAL(1) PCAL(1)
The output of the --cc option may be used as input to subse-
quent runs of _p_c_a_l. Note, however, that oopptt lines (except
for an automatic oopptt --[[AA||EE]]), comments, ``note'' text, and
iiffddeeff'd-out source will be lost.
The --SS option interacts with nnoottee{{//<<nnuummbbeerr>>}}; if used, it
should be specified either on the command line or prior to
the first nnoottee line in the date file.
SSEEEE AALLSSOO
cal(1), calendar(1).
AAUUTTHHOORRSS
The original PostScript code to generate the calendars was
written by Patrick Wood (Copyright (c) 1987 by Patrick
Wood of Pipeline Associates, Inc.), and authorized for
modification and redistribution. The calendar file inclu-
sion code was originally written in _b_s(1) by Bill Vogel of
AT&T. Patrick's original PostScript was modified and
enhanced several times by others whose names have regret-
tably been lost. Ken Keirnan of Pacific Bell assembled
the original ``C'' version upon which this is based; addi-
tional modifications and enhancements are the work of
Joseph P. Larson, Ed Hand, Andrew W. Rogers, Mark
Kantrowitz, Joe Brownlee, Jamie Zawinski, Richard L.
Dyson, Bill Hogsett, Floyd Miller, Andy Fyfe, and Geoff
Kuenning.
12