The eternal holiday list is created only for dates after A.D.29.
It can be displayed in different ways:
In case you start Gcal without an explicit (fiscal) date and the eternal holiday list argument (see section Calendar options), e.g.:
gcal --holiday-list gcal -n gcal -n :
Gcal displays all holidays of the eternal holiday list that refer to the actual / fiscal year, without a leading calendar sheet.
In case you start Gcal with the eternal holiday list argument and a month (plus an additional year), e.g.:
gcal --holiday-list july gcal -n july gcal -n 7 1993 gcal -n 7/1993
Gcal displays a month calendar sheet of the specified month (of year), and trailing those holidays of the eternal holiday list that refer to the given month (of the given year).
In case you start Gcal with the eternal holiday list argument and a simple year (or an explicit fiscal year), e.g.:
gcal --holiday-list 1993 gcal -n 1993 gcal -n july: gcal -n :1993 gcal -n 7:1993
Gcal displays a year calendar sheet of the specified year or fiscal year, and trailing all holidays of the eternal holiday list that refer to the given year or fiscal year.
In case you start Gcal with the eternal holiday list argument and a special 3-Month mode command (see section 3-Month mode commands), e.g.:
gcal --holiday-list . gcal -n . gcal -n .. gcal -n .+ gcal -n .-
Gcal displays the according three months using a fixed-style year calendar sheet, and trailing all holidays of the eternal holiday list that refer to the these months.
In case you start Gcal with the eternal holiday list argument and a list or range of commands, it produces the according series of eternal holiday lists. See section Lists of commands, and section Ranges of commands, for more details.
Some annotations:
The following table lists all those characters which are used for marking an entry in the eternal holiday list, i.e. directly leads its date:
@multitable @columnfractions .18 .82
+
@tab Legal holiday which is valid in the whole country.
Is automatically provided with highlighting sequences respectively marking
characters.
#
@tab Legal holiday which is valid in major parts of the whole country.
Is automatically provided with highlighting sequences respectively marking
characters.
*
@tab Legal holiday which is valid in minor parts of the whole country.
Is not provided with highlighting sequences respectively marking characters.
-
@tab Other holiday which serves for memorial or remarking purposes only.
Is not provided with highlighting sequences respectively marking characters.
By using the `--cc-holidays=cc[+...]' option, it is possible to provide the eternal holiday list with additional country specific holidays. Thereafter, those country specific holidays are part of the list likewise the standard holidays, too. See section Calendar options. For example:
--cc-holidays=de+freffects the inclusion of German and French holidays into the eternal holiday list. The inclusion of country specific holidays is not coupled to Gcal's internationalization (see section Aspects in Internationalization). This means, no country specific holidays are automatically respected at program start-up for a definite territory or country. So it's up to the user to decide which country specific holidays are included into the eternal holiday list. See section The
GCAL environment variable,
for informations, how Gcal can be induced to include the country specific
holidays automatically into the eternal holiday list at program start-up.
The free selection of the different country specific holidays can be used very
ingenious in case informations of a definite territory or country are required.
Assuming a business man from Germany proposes to travel to the U.S.A. in
November and needs the information which legal holidays are celebrated there on
work days so he is able to plan his dates. This can be determined as follows:
gcal -f /dev/null -q US -D r -cE nov
Go to the first, previous, next, last section, table of contents.