This is gcal.info, produced by makeinfo version 4.0 from gcal.texi.

INFO-DIR-SECTION GNU packages
START-INFO-DIR-ENTRY
* Gcal: (gcal).                       GNU calendar program.
* Tcal: (gcal)Invoking tcal.          Run Gcal with tomorrow's date.
* Txt2gcal: (gcal)Invoking txt2gcal.  Calendar text to resource file.
* Gcal2txt: (gcal)Invoking gcal2txt.  Calendar resource to text file.
END-INFO-DIR-ENTRY

  This file documents Gcal, a program for calculating and printing
calendars.

  Copyright (c) 1994, 95, 96, 1997, 2000 Thomas Esken

  This edition is for Gcal version 3.01.

  Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

  Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

  Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
translation approved by the Free Software Foundation.

  Any suggestions, improvements, extensions, bug reports, donations,
proposals for contract work, and so forth are welcome!  Please send
them directly to my eMail address <esken@gmx.net>.  If you like my
work, I'd appreciate a postcard from you!

------------------------oOO      \\\_''/      OOo---------------------------
Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die


File: gcal.info,  Node: Glossary,  Next: Argument Index,  Prev: Error Codes,  Up: Top

Glossary
********

Here is an alphabetical list of most terms with short description that
are introduced and used in this manual:

"Actual date modifier"
     Gcal uses that date as today's date which is declared by the
     actual date modifier, instead of using the date that is given by
     computer's clock as system date.

"Alternation operator"
     The `|' metacharacter is used to specify alternatives in a regular
     expression.

"Amateur-astronomical twilight"
     The time when the center of the Sun passes a reference altitude of
     15 degrees below a mathematical horizon.

"Anchor"
     The `^' and `$' metacharacters in a regular expression.

"ANSI"
     The American National Standards Institute.  This organization
     produces many standards, among them the standards for the C and
     C++ programming languages.

"Asr prayer time"
     The third Islamic prayer time.  Begins in the afternoon when the
     length of the shadow cast by a vertical pole has a definite length,
     and ends just before sunset.

"Astronomical twilight"
     The time when the center of the Sun passes a reference altitude of
     18 degrees below a mathematical horizon.

"Astronomical unit"
     An astronomical unit, abbreviated by ae, is equal to the mean
     distance of the Sun from the Earth, which is about 149,597,870.691
     kilometers.

"Autumnal equinox point on the ecliptic"
     The point where the descending Sun's orbit intersects the
     celestial equator.

"Azimuth"
     The horizontal angular distance between the vertical circle, that
     passes a celestial body, and the North point.

"Biorhythm"
     Ascending and descending curves which show three coherent
     biological cycles, the physical, the emotional and the
     intellectual cycle.

"BSD"
     Short term for `Berkeley Software Distribution', a Unix operating
     system variant.

"C"
     The system programming language that most GNU software is written
     in.

"Calendar option class"
     The option which control the calendar layout.

"Celestial axis"
     The connecting line which runs between the celestial North and
     South Pole.

"Celestial body elevation"
     The vertical angular distance between the celestial body and the
     horizon.

"Celestial equator"
     A celestial great circle, which is vertical to the celestial axis
     and simultaneously represents the Earth's equator that is projected
     onto the celestial sphere.

"Celestial Pole"
     The northern and southern lengthening of the Earth's rotation axis,
     respectively, projected on the celestial sphere.

"Character class"
     A character class in a regular expression is a special notation for
     describing lists of characters that have a specific attribute, but
     where the actual characters themselves can vary from country to
     country and/or from character set to character set.

"Character list"
     Matches any one of the characters that are enclosed in the square
     brackets in a text, which is processed by a regular expression.

"Character set"
     The set of numeric codes used by a computer system to represent
     the characters (letters, numbers, punctuation, etc.) of a
     particular country or place.  The most common character set in use
     today is ASCII (American Standard Code for Information
     Interchange).  Many European countries use an extension of ASCII
     known as ISO-8859-1 (ISO Latin-1).

"Civil Islamic calendar"
     The arithmetically determined Islamic lunar calendar.

"Civil midnight time"
     In terms of Gcal, this is 0 o'clock, the day change just took part.
     This clocktime is alternatively also denoted as 24 o'clock, or
     12pm.

"Civil twilight"
     The time when the center of the Sun passes a reference altitude of
     6 degrees below a mathematical horizon.

"Collating element"
     A special sequence that can appear in a character lists of a
     regular expression.  This apply to non-ASCII character sets, which
     can have single symbols that are represented with more than one
     character, as well as several characters that are equivalent for
     collating, or sorting, purposes.

"Collating symbol"
     A multi-character collating element of a regular expression that
     is enclosed in `[.' and `.]' metacharacters.

"Command line argument"
     A special text that is mostly given on the command line to run
     Gcal, and which serves for controlling the program.

"Command"
     A special type of command line argument which controls the periods
     Gcal respects.

"Common option class"
     The standard options all GNU software should implement at least
     partially.

"Conjunction"
     A celestial body is either behind the Sun or is between Sun and
     Earth (seen from the Earth), and is therefore non-visible from the
     Earth.  In terms of the Moon, this is the New Moon phase.

"Critical day"
     Those days in the biorhythm in which one or more of the biological
     cycles crosses the zero point.  At that time, one's system is said
     to be in a state of flux and it may be desirable to exhibit
     caution.

"Cycle mode"
     The dynamical, i.e. depending on the respective clocktime, Sun and
     Moon oriented special texts are calculated for a series of
     clocktimes for the current day, i.e. determination is done for any
     time interval that can be individually defined by the user.

"Date part"
     That part of a Gcal resource file line that contains the
     information at which date a fixed date happens.

"Decimal system"
     Base-ten notation, where the digits are `0'...`9'.

"Declination"
     The vertical angular distance between the center of a celestial
     body and the celestial equator.

"Delta-t"
     Delta-t is the difference between the Terrestrial Dynamical time
     (abbreviated by TDT), that was formerly known as _Ephemeris time_
     (abbreviated by ET), and the Universal time (UT).  Thus,
     `delta-t == TDT - UT'.

"Early years"
     In terms of eternal holidays that are determined by Gcal, these
     are the years within the period AD 30 until the midth of the 20th
     century.

"Ecliptic latitude"
     The vertical angular distance between the center of a celestial
     body and the ecliptic.

"Ecliptic longitude"
     The vertical angular distance between the center of a celestial
     body and the vernal equinox point on the ecliptic.

"Ecliptic"
     The zodiacal line or Sun's orbit.

"Elongation"
     The horizontal angular distance between the center of a celestial
     body and the Sun's center, as seen from the Earth.

"Ending date"
     A part of a Gcal special text that defines the last or latest date
     at which the fixed date may occur.

"Environment"
     A collection of strings, of the form `name'`='VALUE, that each
     program has available to it.  Users generally place values into
     the environment in order to provide information to various
     programs.  Typical examples are the environment variables `HOME'
     and `PATH'.

"Equation of time"
     A correction to be added to the true solar time --as read on a
     sundial-- to obtain the mean solar time.

"Equivalence class"
     A list of equivalent characters of a regular expression that is
     enclosed in `[=' and `=]' metacharacters.

"Escape sequence"
     A special sequence of characters used for describing non-printing
     characters, such as `\E' or `\033' or `\x1B' for the ASCII `ESC'
     (escape) character itself.

"Evening width"
"Set width"
     The horizontal angular distance between the set azimuth of a
     celestial body and the West direction.

"Exclusive day period"
"Exclusive date period"
     A Gcal special text that can be specified with the effect, that
     only those fixed dates are respected and displayed which are not
     part of a definite period.

"Extended file name"
     A name that contains one ore more `/' characters, and which 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'.

"Extended language code information"
     A simple language code information, which additionally has a
     territory information that is separated by a `_', like `en_us' for
     american English.

"Fajr prayer time"
     The first Islamic prayer time.  Begins with the beginning of
     astronomical morning twilight, and ends just before sunrise.

"Fixed date option class"
     The options which control the fixed date layout and intensity.

"Format instruction"
     Text variables, special texts and date formats can be provided
     with such an instruction text that results the special
     representation of the contents of text variables, and the
     evaluated special texts and date formats.

"FSF"
"Free Software Foundation"
     A non-profit organization dedicated to the production and
     distribution of freely distributable software.  It was founded by
     Richard M. Stallman, the author of the original Emacs editor.

"Geocentric data"
     Observations of celestial bodies that are done from the fictitious
     center of the Earth yield in geocentrically based values.

"Geocentrical horizon"
     That fictitious horizontal plane that passes through the Earth's
     center, orthogonal to the observer's local vertical.

"Geometrical horizon"
"Mathematical horizon"
"Mathematical-geocentric horizon"
     A purely geometrically-built horizon which disregards the
     phenomenon of refraction as it arises in reality by the influence
     of the Earth's atmosphere.

"Global date variable"
     A Gcal date variable, which is defined in the command line.  Is
     visible in all referenced resource files.

"Global option class"
     The options which modify the program output.

"Global text variable"
     A Gcal text variable, which is defined in the command line.  Is
     visible in all referenced resource files.

"Gnomon"
     A vertical pole which is used to ascertain the length of a shadow.

"GNU"
     `GNU's not Unix'.  An on-going project of the Free Software
     Foundation to create a complete, freely distributable,
     POSIX-compliant computing environment.

"GPL"
"General Public License"
     The terms under which Gcal and its source code may be distributed.

"Gregorian calendar"
     The calendar which was introduced in AD 1582 by Pope Gregory XIII,
     that has an average year length of 365.2425 days.  This calendar
     is most respected around the world today.

"Hexadecimal system"
     Base 16 notation, where the digits are `0'...`9' and `A'...`F',
     with `A' representing 10, `B' representing 11, and so on up to `F'
     for 15.

"Highest culmination point"
     The highest point above or below the horizontal plane which
     transits a celestial body during a day.

"Highlighting sequence"
     A control character sequence which cause a color or intensity
     switch in output text.  Typical control character sequences are
     the ANSI escape sequences which have a leading escape character,
     and trailing more characters that define the type of the ANSI
     escape sequence.

"Horizontal parallax"
     The horizontal parallax of a celestial body specifies the diameter
     of the Earth as it is seen from the surface of the celestial body.

"Hybrid calendar mode"
     The automatical change from one calendar system to another if there
     are relations to a date for which the other calendar system is
     valid.  Thus, Gcal automatically changes from the Julian calendar
     system to the Gregorian calendar system if output is related to
     dates after the Gregorian Reformation has happened.

"Inclusive day period"
"Inclusive date period"
     A Gcal special text that can be specified with the effect, that
     only those fixed dates are respected and displayed which are part
     of a definite period.

"Integer number"
     A whole number, i.e. a number that does not have a fractional part.

"Interval expression"
     One or two numbers inside braces in a regular expression.

"Isha prayer time"
     The fifth Islamic prayer time.  Begins at the end of the
     astronomical evening twilight, and ends just before the
     astronomical midnight time of the Sun.

"ISO"
     ISO is the abbreviation of `International Organization for
     Standardization'.

"ISO week number"
     The week starts on a Monday, and the first week of a year is the
     one which includes the first Thursday; equivalently, the one which
     includes the 4th January.

"Julian Ephemeris date"
     A Julian date that is corrected by _delta-t_.

"Julian calendar"
     The calendar which was introduced in 46 BC by Julius Caesar and in
     the later years corrected by emperor Augustus, that has an average
     year length of 365.25 years.  This calendar was replaced by the
     Gregorian calendar in AD 1582.

"Julian date"
"Julian day number"
     A day number that is based on the date 1st January 4713 BCE, which
     is the starting day zero of a consecutive day counting used in
     astronomical computations.  The real zero of this date is at 12
     o'clock Universal time (UTC/GMT); the day does not change at
     midnight, but at noon Universal time.

"Leap day"
     The 29th February in the Gregorian calendar.

"Leap year"
     In the Gregorian calendar, a leap year is any year which number
     can be divided by 4 without a remainder, and years ending in
     hundreds are no leap years unless they are divisible by 400.  But
     the Eastern Orthodox churches compute leap years within the
     Gregorian calendar by using another rule; and that, a leap year is
     any year which number can be divided by 4 without a remainder, and
     years ending in hundreds are leap years, if a remainder of 2 or 6
     occurs when such a year is divided by 9.

"Legal holiday"
     A day people don't have to work -- as in most companies, and
     businesses are closed; like `New Year's Day' on January 1st.

"Lists of commands"
"Ranges of commands"
     Produce more than one calendar sheet per program run.

"Local date variable"
     A Gcal date variable, which is defined in a resource file.  Is
     visible only in this specific resource file, and that file which
     is included by it.

"Local star time"
"Local sidereal time"
     The momentary period which is past between the last upper
     culmination of the vernal equinox point in the meridian of the
     observer's location (the momentary hour angle of the vernal
     equinox point), thus the right ascension of the stars in the
     observer's meridian at the moment.

"Local text variable"
     A Gcal text variable, which is defined in a resource file.  Is
     visible only in this specific resource file, and that file which
     is included by it.

"Long-style option"
     A special --non-standard-- style to write an option, e.g. `--foo'.

"Lowest culmination point"
     The lowest point below or above the horizontal plane which
     transits a celestial body during a day.

"Lunar Arctic Circle"
     The geographical latitude circle that is between about 61.5 and
     71.9 decimal degrees, and the geographical pole.

"Lunation"
"Synodic month"
     The mean time between two consecutive New Moon phases.

"Maghrib prayer time"
     The forth Islamic prayer time.  Begins at sunset, and ends at the
     beginning of the _Isha_ prayer time.

"Magnitude unit"
     Is used to define the brightness of a star, and is a non-metrical
     value (Latin term `magnitudo', abbreviated m).  The difference
     between two consecutive magnitudes is 1 to 2.512.  Therefore, a
     star with the brightness of 1m is 2.512 times brighter than a star
     of 2m.  A negative magnitude denotes a very bright star, for
     example almost -27m for the Sun, whereas the hardly visible planet
     Pluto has a magnitude of a bit more than +14m.  The Full Moon has
     a visual brightness of about -12m.55.

"Marking character"
     Single, printable characters which lead and trail the output text
     for marking purposes.

"Mean Earth equator radius"
     The mean radius of Earth at the equator is about 6,378.137
     kilometer.

"Mean solar time"
"Mean solar day"
"Mean sun"
     A star day is also known as a _mean solar day_.  Because the Sun
     apparently shifts with respect to the vernal equinox point on the
     ecliptic due to the Earth's orbit around the Sun, the star day and
     the true solar day have a different length.  As the true Sun
     namely moves irregularly through the ecliptic, a fictitious _mean
     Sun_ with a symmetrical motion through the celestial equator is
     used for deriving the mean solar time.

"Meridian"
     Either a geographical longitude or an astronomical vertical circle.

"Metacharacters"
"Regular expression operators"
     Special characters in a regular expression.

"Midnight height"
     The elevation of a celestial body as it happen at astronomical
     midnight time of the celestial body.

"Midnight phase angle"
     The phase angle of a celestial body as it happen at astronomical
     midnight time of the celestial body.

"Modifier"
     One or more characters which directly trail a short-style option,
     and which define a special mode of operation for this option.

"Morning width"
"Rise width"
     The horizontal angular distance between the rise azimuth of a
     celestial body and the East direction.

"Nautical twilight"
     The time when the center of the Sun passes a reference altitude of
     12 degrees below a mathematical horizon.

"Negated character list"
"Complemented character list"
     Matches any one of the characters, except those in the square
     brackets, in a text, that is processed by a regular expression.

"Negative day"
     Those days in the biorhythm in which one or more of the biological
     cycles have a negative maximum value.  At that time, one's system
     is said to be in a lessen state.

"Noon height"
     The elevation of a celestial body as it happen at astronomical
     noon time of the celestial body.

"Noon line"
     The straight line which connects the North and the South point.

"Noon phase angle"
     The phase angle of a celestial body as it happen at astronomical
     noon time of the celestial body.

"Octal system"
     Base-eight notation, where the digits are `0'...`7'.

"Opposition"
     The Earth is in one line between the celestial body and the Sun,
     and therefore, the celestial body is completely visible from the
     Earth.  In terms of the Moon, this is the Full Moon phase.

"Option"
     A special type of command line argument which controls how Gcal
     behaves.

"Orthodrome"
     A great circles arc that is casted between two points on a surface
     of a sphere.  Is the shortest geodetic connecting line between two
     points on a sphere.

"Pattern"
     A pattern is an arbitrary conditional expression against which
     input is tested.  If the condition is satisfied, the pattern is
     said to `match' the input.  A typical pattern might compare the
     input against a regular expression.

"Phase angle"
     The phase angle states the phase of a celestial body, i.e. the
     illuminated fraction of it as it can be seen from the Earth.

"Pipelining"
     The output of a program is used as an input data stream for
     another program.

"Positive day"
     Those days in the biorhythm in which one or more of the biological
     cycles have a positive maximum value.  At that time, one's system
     is said to be in a raised state.

"POSIX"
     The name for a series of standards being developed by the IEEE
     that specify a Portable Operating System interface.  The `IX'
     denotes the Unix heritage of these standards.

"Proleptic calendar mode"
     This means, Gcal only uses a definite calendar system during a
     definite period, although there was a change to another calendar
     system in the historic reality during this definite period.

"Rational number"
"Floating Point number"
     This is a number that can have a fractional part.

"RFC"
     RFC is the abbreviation of `Request for Comments'.

"Redirection"
     The output of a program is sent to another device instead of
     sending it to the _standard output channel_.

"Refraction"
     Refraction is an optical phenomenon caused by the Earth's
     atmosphere, which leads to an apparent raising of the location of
     a celestial body.  The amount of refraction increases with growing
     air pressure and sinking temperature and vice-versa.

"Regexp"
"Regular expression"
     A way of describing a set of strings.

"Relative time offset value"
     A time offset value which is related to a base time.

"Religious Islamic calendar"
     The astronomically determined Islamic lunar calendar.

"Resource file"
     A file that essentially contains the fixed date entries.

"Response file"
     A file used by Gcal to preload options and commands at program
     start-up.  A response file may contain options and commands, but
     *no* references to further response files.

"Right ascension"
     The horizontal angular distance between the center of a celestial
     body and the hour circle that passes through the vernal equinox
     point on the ecliptic.

"Rise azimuth"
     The azimuth of a celestial body as it happen at rise time of the
     celestial body.

"Rise height"
     The elevation of a celestial body as it happen at rise time of the
     celestial body.

"Rise phase angle"
     The phase angle of a celestial body as it happen at rise time of
     the celestial body.

"Set azimuth"
     The azimuth of a celestial body as it happen at set time of the
     celestial body.

"Set height"
     The elevation of a celestial body as it happen at set time of the
     celestial body.

"Set phase angle"
     The apparent phase angle of a celestial body as it happen at set
     time of the celestial body.

"Shell"
     The command processor of the operating system.  This operating
     system program interprets and runs given command lines.

"Short-style option"
     The traditional --standard-- style to write an option, e.g. `-x'.

"Simple file name"
     A name that 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'.

"Simple language code information"
     A language code that consists of two-letters like `de' for the
     German language, as it is defined in the ISO-639:1988.

"Single command"
"3-Month mode command"
     Produce only one calendar sheet per program run.

"Solar Arctic Circle"
     The geographical latitude circle that is between about 66.7 and
     65.9 (corrected for atmospheric refraction) decimal degrees, and
     the geographical pole.  For computing the different twilight
     phases, this latitude circle decreases to about:

        * 60.7 decimal degrees for civil twilight.

        * 54.7 decimal degrees for nautical twilight.

        * 51.7 decimal degrees for amateur-astronomers twilight.

        * 48.7 decimal degrees for astronomical twilight.

"Special text"
     A text in a Gcal resource file which is started by a `%' character
     and whose purpose is to suppress output of fixed dates in definite
     cases, either, or to provide them with particular texts
     respectively to start external commands.

"Summer point on the ecliptic"
"Summer solstice"
"Solstice in summer"
     The Sun's orbit crosses the highest point above the celestial
     equator that is passed during a revolution of the Earth around the
     Sun.

"Standard week number"
     The week starts on the respective starting day of the week, and
     the days in a new year that are preceding the first starting day
     of the week are in the last week of the previous year,
     respectively in week zero of the new year.

"Star day"
     The period between two consecutive upper culminations of the
     vernal equinox point on the ecliptic in the meridian of the
     observer's location.

"Starting date"
     A part of a Gcal special text that defines the first or earliest
     date at which the fixed date may occur.

"Statute mile"
     A linear measure, one statute mile is equal to 1.609344 kilometer.

"String"
     A chain of characters.

"Switch character"
     An option is defined by a leading switch character, either the `-'
     or the `/' character for traditional short-style options, or `--'
     for mnemonic long-style options; a command may not have a leading
     switch character.

"Text part"
     That part of a Gcal resource file line that contains the fixed
     date text.

"Topocentric data"
     Observations of celestial bodies that are done from the surface of
     the Earth yield in topocentrically based values.

"True solar time"
"True solar day"
     A true solar day is the period between two consecutive lower
     culminations of the Sun.  This entity is taken as the base for
     deriving the true solar time (as it is also shown by a sundial
     during the day).

"True track"
"Course angle"
     The course angle gives the direction, which is the vertex of a
     great circles arc (Orthodrome) that is casted between two points
     on a surface of a sphere, at a meridian (Gcal uses a geoid
     (rotation ellipsoid) that is calculated taking pattern from the
     `World Geodetic System', short W.G.S, that was designed in 1961).
     Such an arc is the shortest geodetic connecting line between two
     points on a sphere.  Indeed, the course angles on such an arc are
     changing continually, because the circular line that is casted
     intersects each meridian with another angle -- except the case,
     that both co-ordinates are referring to exactly the same longitude
     or to exactly the same latitude.

"Twilight"
     The interval of time before sunrise and again after sunset, during
     which natural light is provided by the upper atmosphere that does
     receive direct sunlight and reflects parts of it towards the
     Earth's surface.

"Unix"
     A computer operating system originally developed in the early
     1970's at AT&T Bell Laboratories.  It initially became popular in
     universities around the world, and later moved into commercial
     environments as a software development system and network server
     system. There are many commercial versions of Unix, as well as
     several work-alike systems whose source code is freely available
     (such as Linux, NetBSD, and FreeBSD).

"Vernal equinox point on the ecliptic"
     The point where the ascending Sun's orbit intersects the celestial
     equator.

"Whitespace character"
     For example _Tab_, _Space_, _Form-feed_ and similar characters.

"Winter point on the ecliptic"
"Winter solstice"
"Solstice in winter"
     The Sun's orbit crosses the lowest point below the celestial
     equator that is passed during a revolution of the Earth around the
     Sun.

"Word"
     A sequence of one or more letters, digits, or underscores (`_') in
     a regular expression.

"Zuhr prayer time"
     The second Islamic prayer time.  Begins after the astronomical
     noon time of the Sun, and ends at the beginning of the _Asr_
     prayer time.


File: gcal.info,  Node: Argument Index,  Next: Variable Index,  Prev: Glossary,  Up: Top

Command Line Argument Index
***************************

Here is an alphabetical list of the command line arguments processed by
Gcal:

* Menu:

* %DATE:                                 Actual date modifier.
* -# LINE:                               Fixed date options.
* -*dN:                                  Fixed date options.
* -*dNWWW:                               Fixed date options.
* -*wN[WWW]:                             Fixed date options.
* --adjust-value=ARGUMENT:               Fixed date options.
* --alternative-format:                  Fixed date options.
* --astronomical-holidays:               Calendar options.
* --atmosphere=AIR-PRESSURE[,TEMPERATURE]: Fixed date options.
* --bahai-holidays:                      Calendar options.
* --bahai-months:                        Calendar options.
* --biorhythm-axis=NUMBER:               Fixed date options.
* --blocks=1:                            Calendar options.
* --blocks=12:                           Calendar options.
* --blocks=2:                            Calendar options.
* --blocks=3:                            Calendar options.
* --blocks=4:                            Calendar options.
* --blocks=6:                            Calendar options.
* --blocks=NUMBER:                       Calendar options.
* --calendar-dates=both:                 Calendar options.
* --calendar-dates=special:              Calendar options.
* --calendar-dates=special|both:         Calendar options.
* --cc-holidays=CC[_TT][+...]:           Calendar options.
* --celtic-holidays:                     Calendar options.
* --chinese-flexible-holidays:           Calendar options.
* --chinese-flexible-months:             Calendar options.
* --chinese-holidays:                    Calendar options.
* --chinese-months:                      Calendar options.
* --christian-holidays:                  Calendar options.
* --coptic-months:                       Calendar options.
* --copyleft:                            Common options.
* --copyright:                           Common options.
* --cycle-end=ARGUMENT:                  Fixed date options.
* --cycle-step=ARGUMENT:                 Fixed date options.
* --date-format=de|us|gb|TEXT:           Calendar options.
* --date-variable=ARGUMENT:              Fixed date options.
* --debug=abort:                         Global options.
* --debug=all:                           Global options.
* --debug=handled:                       Global options.
* --debug=internal:                      Global options.
* --debug=unhandled:                     Global options.
* --debug[=internal|handled|unhandled|all|abort]: Global options.
* --descending-fixed-dates=long:         Fixed date options.
* --descending-fixed-dates=short:        Fixed date options.
* --descending-fixed-dates[=short|long]: Fixed date options.
* --descending-holiday-list=long:        Calendar options.
* --descending-holiday-list=short:       Calendar options.
* --descending-holiday-list[=long|short]: Calendar options.
* --disable-highlighting:                Global options.
* --end-of-month:                        Fixed date options.
* --end-of-week:                         Fixed date options.
* --end-of-year:                         Fixed date options.
* --ethiopic-months:                     Calendar options.
* --exclude-fixed-dates-list-title:      Fixed date options.
* --exclude-holiday-list-title:          Calendar options.
* --execute-command:                     Fixed date options.
* --exit-status-help-non-zero:           Common options.
* --export-date-variables <1>:           Date variables.
* --export-date-variables:               Fixed date options.
* --export-text-variables <1>:           Text variables.
* --export-text-variables:               Fixed date options.
* --filter-day=ARGUMENT:                 Fixed date options.
* --filter-period=ARGUMENT:              Fixed date options.
* --filter-text=PATTERN:                 Fixed date options.
* --fixed-dates=both:                    Calendar options.
* --fixed-dates=special:                 Calendar options.
* --fixed-dates=special|both:            Calendar options.
* --force-highlighting:                  Global options.
* --french-revolutionary-months:         Calendar options.
* --gregorian-reform=1582|1700|1752|1753|ARGUMENT: Calendar options.
* --grouping-text[=TEXT]:                Fixed date options.
* --heading-text=TEXT:                   Fixed date options.
* --hebrew-holidays:                     Calendar options.
* --hebrew-months:                       Calendar options.
* --help <1>:                            Invoking gcal2txt.
* --help <2>:                            Invoking txt2gcal.
* --help <3>:                            Invoking tcal.
* --help:                                Common options.
* --here=LINE:                           Fixed date options.
* --highlighting=no:                     Global options.
* --highlighting=TEXT:                   Global options.
* --highlighting=yes:                    Global options.
* --holiday-dates=both:                  Calendar options.
* --holiday-dates=special:               Calendar options.
* --holiday-dates=special|both:          Calendar options.
* --holiday-list=long:                   Calendar options.
* --holiday-list=short:                  Calendar options.
* --holiday-list[=long|short]:           Calendar options.
* --ignore-case:                         Fixed date options.
* --include-consecutive-number:          Fixed date options.
* --include-holidays=long:               Fixed date options.
* --include-holidays=short:              Fixed date options.
* --include-resource-file-name:          Fixed date options.
* --include-today:                       Fixed date options.
* --include-week-number:                 Fixed date options.
* --indian-civil-months:                 Calendar options.
* --islamic-civil-holidays:              Calendar options.
* --islamic-civil-months:                Calendar options.
* --iso-week-number=no:                  Calendar options.
* --iso-week-number=yes:                 Calendar options.
* --iso-week-number=yes|no:              Calendar options.
* --japanese-flexible-holidays:          Calendar options.
* --japanese-flexible-months:            Calendar options.
* --japanese-holidays:                   Calendar options.
* --japanese-months:                     Calendar options.
* --leap-day=february:                   Fixed date options.
* --leap-day=february|march:             Fixed date options.
* --leap-day=march:                      Fixed date options.
* --license:                             Common options.
* --limit:                               Fixed date options.
* --list-mode:                           Fixed date options.
* --list-of-fixed-dates=long:            Fixed date options.
* --list-of-fixed-dates=short:           Fixed date options.
* --list-of-fixed-dates[=short|long]:    Fixed date options.
* --long-help=?:                         Common options.
* --long-help[=ARGUMENT]:                Common options.
* --mail[=ADDRESS]:                      Global options.
* --month:                               Fixed date options.
* --moonimage-lines=NUMBER:              Fixed date options.
* --multicultural-new-year-holidays:     Calendar options.
* --old-armenic-months:                  Calendar options.
* --old-egyptic-months:                  Calendar options.
* --omit-multiple-date-part:             Fixed date options.
* --orthodox-calendar:                   Calendar options.
* --orthodox-new-holidays:               Calendar options.
* --orthodox-old-holidays:               Calendar options.
* --pager:                               Global options.
* --period-of-fixed-dates=ARGUMENT:      Fixed date options.
* --persian-jalaali-holidays:            Calendar options.
* --persian-jalaali-months:              Calendar options.
* --precise:                             Fixed date options.
* --resource-file=NAME[+...]:            Fixed date options.
* --response-file=NAME:                  Global options.
* --revert-match:                        Fixed date options.
* --shell-script=NAME:                   Global options.
* --shift=[+|-]NUMBER:                   Invoking tcal.
* --start-of-month:                      Fixed date options.
* --start-of-week:                       Fixed date options.
* --start-of-year:                       Fixed date options.
* --starting-day=ARGUMENT:               Calendar options.
* --suppress-calendar:                   Calendar options.
* --suppress-date-part:                  Fixed date options.
* --suppress-fixed-dates-list-separator: Fixed date options.
* --suppress-holiday-list-separator:     Calendar options.
* --suppress-text-part:                  Fixed date options.
* --text-variable=ARGUMENT:              Fixed date options.
* --time-offset=ARGUMENT:                Calendar options.
* --today:                               Fixed date options.
* --tomorrow:                            Fixed date options.
* --transform-year=ARGUMENT:             Calendar options.
* --translate-string=TEXT:               Calendar options.
* --type=special|standard:               Calendar options.
* --usage=?:                             Common options.
* --usage[=ARGUMENT]:                    Common options.
* --version <1>:                         Invoking gcal2txt.
* --version <2>:                         Invoking txt2gcal.
* --version <3>:                         Invoking tcal.
* --version:                             Common options.
* --week:                                Fixed date options.
* --with-week-number:                    Calendar options.
* --year:                                Fixed date options.
* --zero-dates-only:                     Fixed date options.
* --zodical-marker-holidays:             Calendar options.
* -?:                                    Common options.
* -??:                                   Common options.
* -@DVAR[+|-]NWWW:                       Fixed date options.
* -@DVAR[[+|-]N]:                        Fixed date options.
* -@e[+|-]NWWW:                          Fixed date options.
* -@e[[+|-]N]:                           Fixed date options.
* -@t[+|-]NWWW:                          Fixed date options.
* -@t[[+|-]N]:                           Fixed date options.
* -A:                                    Fixed date options.
* -a:                                    Fixed date options.
* -b 1:                                  Calendar options.
* -b 12:                                 Calendar options.
* -b 2:                                  Calendar options.
* -b 3:                                  Calendar options.
* -b 4:                                  Calendar options.
* -b 6:                                  Calendar options.
* -b NUMBER:                             Calendar options.
* -C:                                    Fixed date options.
* -c:                                    Fixed date options.
* -c*dN:                                 Fixed date options.
* -c*dNWWW:                              Fixed date options.
* -c*wN[WWW]:                            Fixed date options.
* -C-:                                   Fixed date options.
* -c-:                                   Fixed date options.
* -c@DVAR[+|-]NWWW:                      Fixed date options.
* -c@DVAR[[+|-]N]:                       Fixed date options.
* -c@e[+|-]NWWW:                         Fixed date options.
* -c@e[[+|-]N]:                          Fixed date options.
* -c@t[+|-]NWWW:                         Fixed date options.
* -c@t[[+|-]N]:                          Fixed date options.
* -c[m|M[+|-]]:                          Fixed date options.
* -c[t|T]:                               Fixed date options.
* -c[w|W[+|-]]:                          Fixed date options.
* -c[y|Y[+|-]]:                          Fixed date options.
* -cA:                                   Fixed date options.
* -ca:                                   Fixed date options.
* -cd:                                   Fixed date options.
* -cE:                                   Fixed date options.
* -ce:                                   Fixed date options.
* -cg[TEXT]:                             Fixed date options.
* -cJ:                                   Fixed date options.
* -ck:                                   Fixed date options.
* -cl:                                   Fixed date options.
* -cl*dN:                                Fixed date options.
* -cl*dNWWW:                             Fixed date options.
* -cl*wN[WWW]:                           Fixed date options.
* -cl@DVAR[+|-]NWWW:                     Fixed date options.
* -cl@DVAR[[+|-]N]:                      Fixed date options.
* -cl@e[+|-]NWWW:                        Fixed date options.
* -cl@e[[+|-]N]:                         Fixed date options.
* -cl@t[+|-]NWWW:                        Fixed date options.
* -cl@t[[+|-]N]:                         Fixed date options.
* -clMMDD:                               Fixed date options.
* -clMMWWWN:                             Fixed date options.
* -clN+|-:                               Fixed date options.
* -clNd:                                 Fixed date options.
* -clNw:                                 Fixed date options.
* -cm:                                   Fixed date options.
* -cm+:                                  Fixed date options.
* -cm-:                                  Fixed date options.
* -cMMDD:                                Fixed date options.
* -cMMWWWN:                              Fixed date options.
* -cN+|-:                                Fixed date options.
* -cNd:                                  Fixed date options.
* -cNw:                                  Fixed date options.
* -co:                                   Fixed date options.
* -cQ:                                   Fixed date options.
* -cT:                                   Fixed date options.
* -ct:                                   Fixed date options.
* -cU:                                   Fixed date options.
* -cw:                                   Fixed date options.
* -cw+:                                  Fixed date options.
* -cw-:                                  Fixed date options.
* -cx:                                   Fixed date options.
* -cy:                                   Fixed date options.
* -cy+:                                  Fixed date options.
* -cy-:                                  Fixed date options.
* -cZ:                                   Fixed date options.
* -cz:                                   Fixed date options.
* -c|C[-]:                               Fixed date options.
* -d:                                    Fixed date options.
* -D ARGUMENT:                           Fixed date options.
* -E:                                    Fixed date options.
* -e:                                    Fixed date options.
* -f|F NAME[+...]:                       Fixed date options.
* -G:                                    Calendar options.
* -g[TEXT]:                              Fixed date options.
* -h:                                    Common options.
* -H no:                                 Global options.
* -H TEXT:                               Global options.
* -H yes:                                Global options.
* -hh:                                   Common options.
* -i:                                    Calendar options.
* -I PATTERN:                            Fixed date options.
* -i[-]:                                 Calendar options.
* -J:                                    Fixed date options.
* -j:                                    Calendar options.
* -j[b]:                                 Calendar options.
* -jb:                                   Calendar options.
* -jc:                                   Calendar options.
* -jc[b]:                                Calendar options.
* -jcb:                                  Calendar options.
* -jn:                                   Calendar options.
* -jn[b]:                                Calendar options.
* -jnb:                                  Calendar options.
* -k:                                    Fixed date options.
* -K:                                    Calendar options.
* -l:                                    Fixed date options.
* -L:                                    Common options.
* -l*dN:                                 Fixed date options.
* -l*dNWWW:                              Fixed date options.
* -l*wN[WWW]:                            Fixed date options.
* -l@DVAR[+|-]NWWW:                      Fixed date options.
* -l@DVAR[[+|-]N]:                       Fixed date options.
* -l@e[+|-]NWWW:                         Fixed date options.
* -l@e[[+|-]N]:                          Fixed date options.
* -l@t[+|-]NWWW:                         Fixed date options.
* -l@t[[+|-]N]:                          Fixed date options.
* -lMMDD:                                Fixed date options.
* -lMMWWWN:                              Fixed date options.
* -lN+|-:                                Fixed date options.
* -lNd:                                  Fixed date options.
* -lNw:                                  Fixed date options.
* -m:                                    Fixed date options.
* -M:                                    Fixed date options.
* -m:                                    Fixed date options.
* -m+:                                   Fixed date options.
* -m-:                                   Fixed date options.
* -M[+|-]]:                              Fixed date options.
* -m[+|-]]:                              Fixed date options.
* -m|M[+|-]]:                            Fixed date options.
* -N:                                    Calendar options.
* -n:                                    Calendar options.
* -N-:                                   Calendar options.
* -n-:                                   Calendar options.
* -n|N[-]:                               Calendar options.
* -o:                                    Fixed date options.
* -O:                                    Calendar options.
* -p:                                    Global options.
* -P ARGUMENT:                           Fixed date options.
* -Q:                                    Fixed date options.
* -q CC[_TT][+...]:                      Calendar options.
* -r ARGUMENT:                           Fixed date options.
* -R NAME:                               Global options.
* -s ARGUMENT:                           Calendar options.
* -S NAME:                               Global options.
* -T:                                    Fixed date options.
* -t:                                    Fixed date options.
* -U:                                    Fixed date options.
* -u:                                    Calendar options.
* -V:                                    Common options.
* -v ARGUMENT:                           Fixed date options.
* -w:                                    Fixed date options.
* -W:                                    Fixed date options.
* -w:                                    Fixed date options.
* -w+:                                   Fixed date options.
* -w-:                                   Fixed date options.
* -W[+|-]]:                              Fixed date options.
* -w[+|-]]:                              Fixed date options.
* -w|W[+|-]]:                            Fixed date options.
* -X:                                    Calendar options.
* -y:                                    Fixed date options.
* -Y:                                    Fixed date options.
* -y:                                    Fixed date options.
* -y+:                                   Fixed date options.
* -y-:                                   Fixed date options.
* -Y[+|-]]:                              Fixed date options.
* -y[+|-]]:                              Fixed date options.
* -y|Y[+|-]]:                            Fixed date options.
* -Z:                                    Fixed date options.
* -z:                                    Fixed date options.
* @FILE:                                 Response file.
* Command, .:                            3-Month mode commands.
* Command, . YYYY:                       3-Month mode commands.
* Command, .+:                           3-Month mode commands.
* Command, .+ YYYY:                      3-Month mode commands.
* Command, .-:                           3-Month mode commands.
* Command, .- YYYY:                      3-Month mode commands.
* Command, ..:                           3-Month mode commands.
* Command, .. YYYY:                      3-Month mode commands.
* Command, ::                            Single commands.
* Command, :YYYY:                        Single commands.
* Command, MM YYYY:                      Single commands.
* Command, MM YYYY-YYYY:                 Ranges of commands.
* Command, MM,...,MM:                    Lists of commands.
* Command, MM,...,MM YYYY:               Lists of commands.
* Command, MM,MM/YYYY,...:               Lists of commands.
* Command, MM-MM:                        Ranges of commands.
* Command, MM-MM YYYY:                   Ranges of commands.
* Command, MM-MM YYYY+YYYY:              Ranges of commands.
* Command, MM/YYYY:                      Single commands.
* Command, MM/YYYY,...,MM/YYYY:          Lists of commands.
* Command, MM/YYYY-MM/YYYY:              Ranges of commands.
* Command, MM/YYYY-YYYY:                 Ranges of commands.
* Command, MM::                          Single commands.
* Command, MM:;MM:;...:                  Lists of commands.
* Command, MM:;MM:YYYY;...:              Lists of commands.
* Command, MM:YYYY:                      Single commands.
* Command, MM:YYYY+MM:YYYY:              Ranges of commands.
* Command, MM:YYYY;...;MM:YYYY:          Lists of commands.
* Command, MONTH NAME:                   Single commands.
* Command, NOTHING:                      Single commands.
* Command, YYYY:                         Single commands.
* Command, YYYY+YYYY:                    Ranges of commands.
* Command, YYYY;...;YYYY:                Lists of commands.

