www.delorie.com/gnu/docs/gcal/gcal_37.html   search  
Buy GNU books!

Gcal 3.01

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

B.1 Invoking tcal

The Tcal program runs the Gcal program with the date of tomorrow's day(68). Its arguments are as follows:

tcal [--help | --version] | [--shift=[+|-]number] [argument...]

All given 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 `--shift=[+|-]number' option, in which `[+|-]number' is the distance of days the desired date is distant from the actual system date (==today). (Works only for Gregorian years.) The `--shift' option must be given before all other arguments that are passed to the Gcal program.

In case a GCALPROG environment variable (see section Environment Variable GCALPROG) is defined and set with the file name of the executable Gcal program, Tcal will use this file name for calling Gcal. Otherwise, the file name gcal --which is burned-in during the compilation step of the Tcal program-- is used for calling the Gcal program. The GCALPROG environment variable must always be set if the Gcal program is installed under another name than the standard name gcal, otherwise Tcal is unable to execute the Gcal program automatically! An exit status of 0 means all processing is successfully done, any other value means an error has occurred.

The program accepts the following options:

Print a usage message listing all available options, then exit successfully.

Print the version number, then exit successfully.

Define the displacement in `[+|-]number' days the desired date is distant from the actual date.

  webmaster     delorie software   privacy  
  Copyright 2003   by The Free Software Foundation     Updated Jun 2003