.TH KPCAL 1
.SH NAME
kpcal \- generate Kanji PostScript calendars
.SH SYNOPSIS
.B kpcal
[
.BR \-a <ASCII Font>
]
[
.BR \-k <KANJI Font>
]
[
.BR \-t <TITLE Font>
]
[
.BR \-n <NUMBER Font>
]
[
.BR \-e |
.BR \-f <cal>
] [
.B <month>
[
.B <year>
]]
.SH DESCRIPTION
.I Kpcal
generates PostScript to produce landscape calendars for any month and year.
The arguments
.B <month>
and
.BR <year> ,
if provided, should be numeric.  The month should be in the range 1 - 12,
and year should be specified as 1 or 2 digits or as the full 4 digit year.
The defaults for month and year are the current month and year.
.P
If a file named
.I calendar
resides in the callers home directory, it will be searched for lines with
leading dates matching the requested month and year (current by default).
Any text following the date will be printed on the calendar under the
appropriate day of the month.  Dates in the
.I calendar
file may consist of a numeric or alpha month (at least the first 3 characters
for month names) followed by a numeric day and optionally followed by a
year.  Any non-numeric character may separate numeric dates.  Lines in the
.I calendar
file consisting of "year xxxx" (where xxxx 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 ,and that the calendar file written in 
.I JIS
.I Code.
Any date entries containing year information
will set the remembered year to that year.
.P
.I Kpcal has six options:
.P
.TP
.B \-e
Print an empty calendar.  Do not print entries from a calendar file.
.TP
.BR \-f <cal>
Directs
.I kpcal
to use the file name <cal> as the input file in place of the default
calendar file in the callers home directory.
.TP
.BR \-a <ASCII Font>
use the font <ASCII Font> for printing ASCII characters 
in messages of the day. The default is Times-Roman.
.TP
.BR \-k <KANJI Font>
use the font <KANJI Font> for printing KANJI characters
in messages of the day. The default is Ryumin-Light-H.
.TP
.BR \-n <NUMBER Font>
use the font <NUMBER Font> for printing day numbers.
The default is Helvetica-Bold.
.TP
.BR \-t <TITLE Font>
use the font <TITLE Font> for printing titles.
The default is Times-Bold.

.SH SEE ALSO
cal(1)
.SH CAVEATS
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 inclusion code was originally written in "bs(1)" by Bill Vogel of
AT&T.  Patricks original PostScript was modified and enhanced several
times by others whos names have regrettably been lost.  
Ken Keirnan of Pacific Bell was assembled this "C" version (pcal).
If you want to modify or redistribute "kpcal", please retain above Copyright
with the package.

.sp
Kenji Urushima
.br
SECOM Intelligent Systems Laboratory
.br
Shimorenjaku Mitaka, Tokyo.