.\" $Id: gcal.1 v0.48 2000/06/14 00:04:08 tom Exp $
.\"
.\" gcal.1:  American-English [n]roff source of Unix manual page
.\"
.\" Copyright (c) 1994, 95, 96, 1997, 2000 Thomas Esken
.\"
.\"
.\" Permission is granted to make and distribute verbatim copies of
.\" this manual provided the copyright notice and this permission notice
.\" are preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the entire
.\" resulting derived work is distributed under the terms of a permission
.\" notice identical to this one.
.\"
.\" Permission is granted to copy and distribute translations of this manual
.\" into another language, under the above conditions for modified versions,
.\" except that this permission notice may be stated in a translation approved
.\" by the Free Software Foundation.
.\"
.\"
.\" ------------------------oOO      \\\_''/      OOo---------------------------
.\" Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
.\" Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
.\" D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die
.\"
.\"
.de EX \"Begin example
.ne 5
.if n .sp 1
.if t .sp .5
.nf
.in +5n
..
.de EE \"End example
.fi
.in -5n
.if n .sp 1
.if t .sp .5
..
.\" Page parameters
.ll 6.5i
.pl 11i
.po 0
.\"
.TH GCAL 1 "June 14, 2000"
.SH NAME
Gcal \- a program for calculating and printing calendars.
.SH SYNOPSIS
.B gcal \fI[[Option\&...] [\fB%\fIDate] [\fB@\fIFile\&...]] [Command]
.SH DESCRIPTION
.B Gcal
is a program similar the standard calendar programs BSD\-`\fBcal\fI'
.ft R
and `\fBcalendar\fI'.
.ft R
.sp
.B Gcal
displays hybrid and proleptic Julian and Gregorian calendar sheets,
respectively, for one month, three months or a whole year.  It also
displays eternal holiday lists for many countries around the globe,
and features a very powerful creation of fixed date lists that can
be used for reminding purposes.  Gcal can calculate various astronomical
data and times of the Sun and the Moon for at pleasure any location,
precisely enough for most civil purposes.  Gcal supports some other
calendar systems, for example the Chinese and Japanese calendar,
the Hebrew calendar and the civil Islamic calendar, too.
.sp
If
.B Gcal
is started without any
.I options
or
.I commands,
a calendar of the current month is displayed.
.sp
If the calendar of a definite year is wanted, the year must be fully specified,
.EX
e.g.:  gcal 94
.EE
displays a year calendar of the year 94, not of the year 1994.
.sp
If two arguments are given in the
.I command
part, the first argument denotes the month and the second argument denotes the
year. In case any illegal
.I commands
are given running
.B Gcal
, the program will use internal defaults.
.SH MORE PROGRAM INFORMATION
You obtain more program information if you start
.B Gcal
as follows:
.EX
gcal \-h
gcal \-?
gcal \-\-help

respectively,

gcal \-hh
gcal \-??
gcal \-\-long-help[=ARG]|[=?]
gcal \-\-usage[=ARG]|[=?]
.EE
A Hypertext file
.I gcal.info
containing detailed online information should be available, which you can
inspect using your GNU Infobrowser.
.bp
.SH COPYRIGHT
.in 0
.sp
.B Gcal
Copyright (c) 1994, 95, 96, 1997, 2000 Thomas Esken
.LP
This software doesn't claim completeness, correctness or usability.
On principle I will not be liable for any damages or losses (implicit
or explicit), which result from using or handling my software.
If you use this software, you agree without any exception to this
agreement, which binds you
.I LEGALLY !!
.sp
.B Gcal
is free software and distributed under the terms of the `GNU General
Public License'; published by the `Free Software Foundation'; version 2 or
(at your option) any later version.
.sp
Any suggestions, improvements, extensions, bug reports, donations, proposals
for contract work, and so forth are welcome!  If you like this tool, I'd
appreciate a
.I postcard
from you!
.sp
Enjoy it   =8^)
.SH AUTHOR
.in 2
.nf
------------------------oOO      \e\e\e_''/      OOo---------------------------
Thomas Esken               O     (/o-o\e)     O  eMail: esken@gmx.net
Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
D-48147 Muenster; Germany    \e____) ~ (____/    MotD : 2old2live, 2young2die
.fi
.SH SEE ALSO
tcal(1),
txt2gcal(1),
gcal2txt(1),
cal(1),
calendar(1).