This chapter describes how to use the fixed date feature of Gcal. For that purpose, you may create a Gcal resource file for showing fixed dates and appointments (see section Resource file).
Each time you execute Gcal in simple single month mode, i.e. no explicit month, year or fiscal year is given in the command line, but the fixed date argument, e.g.:
gcal --list-of-fixed-dates gcal -c
it checks the resource file for dates and processes those that refer to the actual system date (==today)! Then Gcal displays all fixed dates found in the resource file which refer to the actual day (week/month/year) of the actual year, without a leading calendar sheet.
Some more examples:
gcal -ce gcal -cw- gcal -c-m gcal -c-y- gcal -jcb -c-et gcal -cey- gcal -jc -cey
The fixed dates can be displayed in different ways:
In case you start Gcal with the fixed date argument and/or a month and/or an explicit year or fiscal year; respectively with the special 3-Month mode command, e.g.:
gcal -c july gcal -ce 7 1994 gcal -c-y 7/1994 gcal -c 7:1993 gcal -c 1993 gcal -c . gcal -c .+
Gcal displays a (three) month / year calendar sheet of the specified respectively actual month / year, and trailing those fixed dates found in the resource file that refer to the given period; the intensity level is the same as the `-cy' option if the period refers to a year or fiscal year or to a three month period, respectively, is the same as the `-cm' option if the period refers to a month.
In case you start Gcal without an explicit date and the fixed date argument in connection with the eternal holiday list argument, e.g.:
gcal -c -n gcal -Cm -n gcal -Cl1224 -n gcal -cl3+ -n
then Gcal displays all fixed dates found in the resource file that refer to the requested period, and after that all holidays of the eternal holiday list that refer to the whole actual year, without a leading calendar sheet. See section Eternal Holidays, for more details how to use an eternal holiday list.
Annotation to previous examples:
In case an additional standard/special calendar format argument or an additional starting day of week argument (30) is found in the command line, e.g.:
gcal -c -n -i gcal -c -i- gcal -n -i- : gcal -n -s Sunday
Gcal displays a leading month, year or fiscal year calendar sheet before all other lists. See section Calendar options, and section Calendar options, for more information.
Each time you execute Gcal in simple single year mode, i.e. no explicit month, year or fiscal year is given in the command line, but the fixed date argument (with optional modifiers) and the number of blocks argument (see section Calendar options), e.g.:
gcal -c --blocks=3 gcal -C-em -b 3 gcal -c-t -b 6 -jc
it checks the resource file for dates and processes those that refer to the actual system date (==today)! Gcal displays a leading year calendar sheet, and all fixed dates found in the resource file that refer to the actual day (week/month/year) of the actual year.
You can list fixed dates of past, present or future month/years, too. This can be done on the one hand, if you use the `%date' option in the way you require (see section Actual date modifier), and on the other hand, if a command respectively a list or range of commands is used.
For example:
Go to the first, previous, next, last section, table of contents.