This chapter describes how to use the fixed date feature of Gcal. Normally, the fixed dates are stored line by line in a so-called resource file (see Resource file). On request, Gcal searches any of such resource files for those fixed dates, that are happening in the period for which a fixed date list is wanted. If Gcal has found any fixed dates that are happening in the requested period, the program displays them collectively as a fixed date list.
Thus, 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 --ast -ce gcal -cw- gcal -c-m gcal -c-y- gcal -qbe -jcb -c-et gcal --zod -cey- gcal -qfr -jc -cey
The fixed date list can be embraced by different other leading and trailing output, respectively, that is also created by Gcal:
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 -qfr -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.
If you start Gcal without an explicit date and the fixed date argument in connection with the eternal holiday list argument, e.g.:
gcal -qbe -n -c gcal -qbe -n -Cm gcal -qbe -n -Cl1224 gcal -qbe -n -cl3+ gcal -qbe -n -4-
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 Eternal Holidays, for more details how to use an eternal holiday list.
Annotation to previous examples:
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 Calendar option --blocks=number), e.g.:
gcal -c --blocks=3 gcal -C-em -b 3 --cc-holidays=be 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 Actual date modifier), and on the other hand, if a command respectively a list or range of commands is used.