|• Structure of resource file:||How to write a Resource file.|
|• Date part of a line:||How to write the Date part.|
|• Further date part attributes:||What are Further date part attributes?|
|• Text part of a line:||How to write the Text part.|
|• Special Texts processed:||What are |
|• Comment line:||What is a Comment line?|
|• Include directives:||What are Include directives.|
|• Date variables:||How Date variables can be used.|
|• Text variables:||How Text variables can be used.|
This section describes how to use a resource file that contains
fixed dates and appointments. The name of the standard resource file is
Gcal uses a special file searching mechanism:
GCALPATH(see Environment Variable
GCALPATH) to find the standard resource file. The
GCALPATHenvironment variable contains a (‘:’) colon-separated38 list of file directories. If no such environment variable is defined and set, Gcal omits this step.
HOME. If no
HOMEenvironment variable is defined and set, Gcal also omits this step. See Environment Variable
HOMEfile directory. If an environment variable
GCAL_USR_DATADIRis set, Gcal appends the contents of this environment variable to the contents of the
HOMEenvironment variable, and tries to use this file directory instead of using the burned-in default name of this file directory (see Environment Variable
GCAL_USR_DATADIR). If no
HOMEenvironment variable is defined and set, Gcal of course also omits this step.
GCAL_SYS_DATADIRis set, Gcal tries to use this file directory instead of using the burned-in default name of this file directory (see Environment Variable
If the standard resource file is not found during the steps 1…4 of the file searching mechanism, no fixed date messages will be created!
In case the --debug=abort option is given and no standard resource file is found during the steps 1…4 of the file searching mechanism, the Gcal program will be aborted with an error code. See Error Code 118, and Global option --debug=abort, for more information.
If a -f|F name[+…] respectively --resource-file=name command line argument is given, a file name will be used for the resource file instead of the standard resource file. See Fixed date option --resource-file=name.
An extended file name contains one ore more ‘/’ (slash) characters41 and denotes a file, whose fixed access path either starts from the root file directory, like ‘/foo/bar/file’, or from the actual file directory, like ‘./bar/file’ or ‘../bar/file’. If name is an extended file name:
A simple file name denotes a file, whose access-path either does not start from the root file directory or from the actual file directory, like ‘file’ or ‘bar/file’. If name is a simple file name: