.\" $Id: tcal.1 v0.10 2000/06/14 00:01:00 tom Exp $
.\"
.\" tcal.1:  American-English [n]roff source of Unix manual page
.\"
.\" Copyright (c) 1996, 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 TCAL 1 "June 14, 2000"
.SH NAME
Tcal \- runs the Gcal program with the date of tomorrow's day.
.SH SYNOPSIS
.B tcal \fI[\fB\-\-help\fI | \fB\-\-version\fI] | [\fB\-\-shift=\fI[\fB+\fI|\fB\-\fI]number] [Argument\&...]
.SH DESCRIPTION
.B Tcal
is a program which runs
.B gcal
with a date set one day ahead (equivalent the
.B \-\-shift=\fI1
.ft R
option). All given
.I arguments
are passed unmodified to the Gcal program. If the Gcal program
shall be called with another date than tomorrow's date, this desired
date can be selected by using the
.B \-\-shift=\fI[\fB+\fI|\fB\-\fI]number
.ft R
option, in which [\fB+\fI|\fB\-\fI]number
.ft R
is the distance of days the desired date is distant from the actual
date (works only for Gregorian years). The
.B \-\-shift
option must be given before all other
.I arguments
which are passed to the Gcal program. An exit status of 0 means all
processing is successfully done, any other value means an error has occurred.
.SH OPTIONS
.TP
.B \-\-help
Print a usage message listing all available options, then exit
successfully.
.TP
.B \-\-version
Print the version number, then exit successfully.
.TP
.B \-\-shift=\fI[\fB+\fI|\fB\-\fI]number
.ft R
Define the displacement in [\fB+\fI|\fB\-\fI]number
.ft R
days the desired date is distant from the actual date.
.SH ENVIRONMENT
.TP
GCALPROG
The
.I GCALPROG
environment variable contains the file name of the
executable Gcal program, which is used by
.B Tcal
to call Gcal. This takes precedence over the file name `\fBgcal\fI',
.ft R
which is burned\-in during the compilation step of \fBtcal\fI.
.ft R
.bp
.SH COPYRIGHT
.in 0
.sp
.B Tcal
Copyright (c) 1995, 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 Tcal
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
gcal(1),
txt2gcal(1),
gcal2txt(1).