This section describes how to use a resource file that contains fixed dates and appointments. The name of the standard resource file is HOME/.gcalrc1.
Gcal uses a special file searching mechanism:
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) characters5 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:
 On MS-DOS, OS/2 and some other operating systems, the name of the standard resource file is HOME/gcalrc (without a leading ‘.’).
 On MS-DOS, OS/2 and some other operating systems, another character will be used, e.g. ‘;’ on MS-DOS and OS/2.
 Normally HOME/share/gcal.
 Normally /usr/local/share/gcal or $prefix/share/gcal.
 Operating systems like MS-DOS or OS/2 use the ‘\’ (Backslash) character for separating a file directory from a file name.