This is gcal.info, produced by makeinfo version 6.1 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 Copyright (c)
2010, 2011, 2013 Free Software Foundation, Inc.

  This edition is for Gcal version 4.1.

     Permission is granted to copy, distribute and/or modify this
     document under the terms of the GNU Free Documentation License,
     Version 1.3 or any later version published by the Free Software
     Foundation; with no Invariant Sections, with no Front-Cover Texts,
     and with no Back-Cover Texts.  A copy of the license is included in
     the section entitled "GNU Free Documentation License".

  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> or to <bug-gcal@gnu.org>.
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: Top,  Next: Preface,  Prev: (dir),  Up: (dir)

Gcal
****

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

  Gcal displays hybrid and proleptic Julian and Gregorian calendar
sheets, respectively, for one month, three months or a whole year.  It
also displays eternal holiday lists for many countries around the globe,
and features a very powerful creation of fixed date lists that can be
used for reminding purposes.  Gcal can calculate various astronomical
data and times of the Sun and the Moon for at pleasure any location,
precisely enough for most civil purposes.  Gcal supports some other
calendar systems, for example the Chinese calendar, the Hebrew calendar
and the civil Islamic calendar, too.

  This is Edition 4.1 of 'Gcal, an Extended Calendar Program',
24 June 2000, for the 4.1 version of the GNU implementation
of 'cal' and 'calendar'.

  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

* Menu:

* Preface::            Preliminary remarks to Gcal.
* Gcal Introduction::  Gcal in brief.
* Invoking Gcal::      How to run and use the 'gcal' program.
* Eternal Holidays::   How to create an Eternal Holiday list.
* Fixed Dates::        How to create a Fixed Date list.

Appendices

* Todays Calendar::        Genesis of the Gregorian Calendar.
* Gcal Utilities::         Utility programs which are part of the distribution.
* Internationalization::   Aspects of Internationalization been made.
* Metasymbols::            Metasymbols used in this manual.
* Regular Expressions::    Description of all Regular Expressions.
* Regexp Summary::         Summary of all Regular Expressions.
* Special Texts::          Description of all '%?'... Special Texts.
* Special Texts Summary::  Summary of all '%?'... Special Texts.
* Obsolete Special Texts:: Tables of obsolete Special Texts et cetera.
* Format Instruction::     Description of the Format Instruction components.
* Coding Scheme::          Coding Scheme of date part in resource file.
* Environment Variables::  Used Environment Variables.
* Error Codes::            Which Error Codes does Gcal return?
* Glossary::               Short descriptions of the terms used here.

Indices

* Argument Index::  Index of Command line arguments respected.
* Variable Index::  Index of Environment Variables used.
* Table Index::     Index of Tables that can be found in this manual.
* GNU Free Documentation License:: Copying and sharing this manual.
* Concept Index::   A menu covering many topics.

  -- The Detailed Node Listing --

Invoking Gcal

* Command line arguments::         Command line arguments.
* The GCAL environment variable::  How to use the 'GCAL' environment variable.

Command line arguments

* Options::               How to use Options.
* Response file::         How to use a '@FILE' Response file.
* Actual date modifier::  How to use a '%DATE' Actual date modifier.
* Commands::              How to use Commands.

Options

* Common options::      How to use Common options.
* Global options::      How to use Global options.
* Calendar options::    How to use Calendar options.
* Fixed date options::  How to use Fixed date options.

Commands

* Single commands::        How to use a Single command.
* 3-Month mode commands::  How to use a 3-Month mode command.
* Lists of commands::      How to use a List of commands.
* Ranges of commands::     How to use a Range of commands.

Fixed Dates

* Resource file::           How to use a Resource file.
* Resource file examples::  Examples of Resource file entries.

Resource file

* Structure of resource file::    How to write a Resource file.
* Date part of a line::           How to write the Date part.
* Further date part attributes::  What are Further date part attributes?
* Text part of a line::           How to write the Text part.
* Special Texts processed::       What are '%?'... Special Texts?
* Comment line::                  What is a Comment line?
* Include directives::            What are Include directives?
* Date variables::                How Date variables can be used.
* Text variables::                How Text variables can be used.

Further date part attributes

* Lists of days::              How Lists of days can be used.
* Ranges of days::             How Ranges of days can be used.
* Repetition factor of days::  How to use such a factor.
* Appearance factor of days::  How to use such a factor.

Gcal Utilities

* Invoking tcal::      How to run 'tcal' and a summary of its options.
* Invoking txt2gcal::  How to run 'txt2gcal' and a summary of its options.
* Invoking gcal2txt::  How to run 'gcal2txt' and a summary of its options.

Regular Expressions

* Regexp Usage::      How to Use Regular Expressions.
* Regexp Operators::  Regular Expression Operators.

Special Texts

* Exclusions::     How to Exclude dates.
* Replacements::   How to Replace texts.
* Shell Command::  How to run a Shell Command.

Exclusions

* Exclusions with date argument::
* Exclusions without any argument::

Exclusions with date argument

* Inclusive date period::
* Exclusive date period::

Exclusions without any argument

* Inclusive day period::
* Exclusive day period::

Replacements

* Replacements with date argument::
* Replacements with other argument::
* Replacements without any argument::

Replacements with date argument

* Weekday name::
* Weekday number::
* Day-of-year number::
* Day number::
* Week number::
* Month name::
* Month number::
* Year number::
* Moon phase::
* Biorhythm::
* Difference value::

Replacements with other argument

* Actual clocktime::
* Textual date::
* Julian day number::
* Geographical distance and course angle::
* Sun data::
* Moon data::
* Contents of Environment variable::

Replacements without any argument

* Other difference values::
* Highlighting::

Obsolete Special Texts

* Table of Obsolete Special Texts::
* Table of Obsolete Date Format Elements::
* Table of Obsolete Date Formats::

Coding Scheme

* Coding Scheme Table 1::
* Coding Scheme Table 2::


File: gcal.info,  Node: Preface,  Next: Gcal Introduction,  Prev: Top,  Up: Top

1 Preface
*********

The reason why I have written Gcal was mainly to have an _off-line_
tool(1) (*note Preface-Footnote-1::) which is able to display Julian and
Gregorian calendar sheets in a highly flexible and internationalized
manner, fixed date lists for reminding purposes and country respectively
territory specific holiday lists.  At a later stage, Gcal was extended
in the way to perform some basic astronomical calculations like Moon
phase, moonrise, moonset and other Moon based data, sunset, sunrise,
different twilight times and other Sun based data, zodiacal markers,
solar and lunar eclipses, equinoxes and solstices.  Other gimmicks like
biorhythm calculation and the computation of a distance between two
geographical point locations and their course angles (true tracks) are
also done by it now, plus a lot more.

  The accuracy of most of the astronomical calculations done by Gcal is
low because it is really hard to perform accurate astronomical
predictions more that 100 years ahead.  Of course, this also has
consequences for some country specific holidays which are based on such
astronomical calculations.  So it is really possible that some output
may differ from the real astronomical date and time of the event
calculated, and that by one or more minutes/hours/days.  This can happen
when the date of a real astronomical event occurs near around midnight.
So don't be surprised!  Strictly speaking, take all such astronomically
based output as a more or less good approximation of the true value, but
do not rely on it!

  Because Gcal is not primarily designed for the purpose of having a
high precision astronomical calculation tool, the world currently has to
live with these limitations.  But if *you* have C source code functions,
which

   * perform the astronomical calculations more precise for the period
     that is respected by Gcal,

   * have the similar or faster processing speed than Gcal's actual
     functions,

   * are either put into the public domain or are covered by the GPL(2)
     (*note Preface-Footnote-2::),

   * have the same calling conventions and return types like Gcal's
     actual functions,

   * conform to the GNU coding standard and are therefore easy to
     maintain and extend,

   * do not break Gcal internal limitations and concepts,

and you want to grant them to the public, I would be very pleased if you
would contact me so I am able to implement your result to a next release
of this software.

  Some words to the build-in country specific holidays now...

  As you certainly know, there are several other calendar systems
actually existing around the world among the Gregorian calendar.  The
Gregorian calendar that Gcal mainly represents as a software is only one
calendar of many others, but it is that one which is most respected
around the world today.  Even countries which use another calendar
system officially mostly respect the Gregorian calendar for civil and
administrative purposes.

  But when Gcal offers the ability to include holidays from a definite
country into its eternal holiday list, it is possible that not all
holidays are displayed which are respected in that country.  One reason
is that my various sources simply don't tell me about the existence of a
holiday.  A second reason is that the holiday is just designed or
changed or removed by political or society reality during Gcal's
development phase.  And another reason is that the method to calculate a
holiday is not build-in Gcal yet.  This case is marked by a '#'
character behind the country name in the list of countries, which are
respected by Gcal.  *Note Calendar option '--cc-holidays=CC[_TT][+...]':
x-cc-holidays, for the above mentioned list.
The holidays of "early" years that are included into the eternal holiday
list --i.e. those within the period AD 30 until the midth of the 20th
century-- are certainly not accomplishing the requirements of historians
to such a list.  Gcal cannot be understood as a complete and
historically correct data base, and it is not designed for that purpose!
This is caused by the fact that the territorial borders and names of the
national structures and the settlement in earlier times was partly quite
different as it is nowadays.  Moreover, I am yet lacking reliable
information that tells me the precise date of the introduction of a
holiday in a region.  Here I appeal to the historians to support me with
the concrete country and culture based data if they are bothered by this
fact and they want to have it removed.

  Still unsupported *alive* and *major* calendar systems, respectively
methods to derive country specific holidays from them, are:

   * Religious Islamic lunar calendar

   * Hindu solar and lunar calendars

   * Buddhist calendar

   * Sikh calendar

   * Jain calendar

  Even if the list of supported countries seems to be almost complete if
you compare it with the actual list of all nations existing around the
world, you should note that there are still some countries missing!  If
you can grant me support to complete Gcal's list of respected countries,
or if you would work out or have C functions which manage the missing
calendar systems, I also would be very pleased about if you would
contact me.

  I have recorded the country specific holiday dates as good as I can,
but I cannot guarantee that I did not made any mistakes while I hacked
them in.  So it is possible that some country specific holiday lists
contain errors.

  Well, if you think that I forgot to provide Gcal with the specific
holidays of a/your country, or you think that a country specific holiday
list is incomplete, or you think that some of the already implemented
holidays are wrong, please feel free to send me a complete list of all
the holidays which are celebrated in this country respectively to give
me hints how to correct or to complete them!

  Such a list should ideally include the following information:

   * The English name of the holiday.

   * The rule how it is built (like 10th October each year, or 47 days
     after Easter Sunday's date, or three Fridays before the last
     Saturday in June...).  If there are any exceptions from such a
     general rule, please state them in a detailed manner.  And please
     tell me the date since what time the holiday is or was celebrated
     for the first time, respectively.

     By the way, if the holiday is tied to the Easter Sunday's date,
     please tell me whether you mean the Easter Sunday of the Christian
     Western churches or the Easter Sunday of the Orthodox Christian
     Eastern churches.

   * Whether it is a "legal holiday" which is respected in the whole
     country.  (Use a '+' character for marking this case.)  In this
     sense, a legal holiday means a day people don't have to work -- as
     in most companies, and businesses are closed; like 'New Year's Day'
     on January 1st.

   * Whether it is a legal holiday in some parts of your country only.
     Please tell me whether such a holiday is valid in major parts of
     the country or not, try to express that by using percent points.
     (If such a holiday is celebrated in more than 70% of the country,
     use a '#' character for marking this case, otherwise use a '*'
     character.)

   * Whether it is a day only used for memorial or remembering purposes.
     (Use a '-' character for marking this case.)  Like 'All Fool's Day'
     on April 1st is not a holiday in the sense that anyone has a day
     off from school or work, just a _play jokes_ day, pretty ordinary.
     Other holidays may be celebrated with cards or presents etc. -- but
     they are working days such as:

          Valentine's day, Father's day, Mother's day.

  The Islamic holidays inserted into the country specific holiday list
are calculated arithmetically, not astronomically.  This is what people
call the "civil" Islamic lunar calendar.  This type of calendar is just
a rough estimate of the religious Islamic lunar calendar, which is
determined quite astronomically.  So don't be surprised too much if some
holiday dates differ from the religious Islamic calendar about +/- 1...2
days in some years.
The main difficulty to implement the religious Islamic calendar
correctly into Gcal are the several different criteria that are existing
for the first sighting of the crescent Moon after a New Moon phase --
that event, which defines the beginning of a new (lunar) month in the
religious oriented Islamic calendar.  So on the one hand, there are
quite astronomically-based criteria, and on the other hand, there are
also quite religiously-based criteria.  Furthermore, the local
predominant weather conditions, the geographical co-ordinate of the
observer's location and the kind of the observance method used also
affect these criteria.  Moreover, to render all more difficult, I as yet
do not have any reliable information that tells me which kind of
criteria is used in the countries (around 60 world-wide) which respect
this religious Islamic calendar.  So due to all the above mentioned
facts of problematic nature, this religious Islamic calendar is not
included into Gcal yet.

  The Chinese (and Japanese) holidays also inserted into the country
specific holiday list are calculated by using that algorithm as it is
used by the Purple Mountain Observatory in Nanjing to determine the
astronomical lunisolar Chinese calendar.  This calendar is obligatory
for (the Peoples Republic of) China since 1929 and is determined
annually always new.  Nevertheless and strictly speaking, in the
historic reality and depending on the region, the Chinese calendar,
especially in the 17th and 18th century, was either calculated using
this _modern_ algorithm, or by the use of a different method, so that a
different calendar structure for one and the same year was possibly
calculated as result.

  And last...

  This manual shows the possible use of the Gcal program only briefly
and deliberately renounces to present the topics that are covered by
this software arranged in a novel-like style.  The use of Gcal is
illustrated in an exemplary manner only!  A detailed description of all
possible use is inexpedient here because there are simply too many of
such possibilities which are caused by the existing variety of
combinations of all useable modes of operation.

  Furthermore, this manual does not contain detailed explanations about
the calendar systems supported by Gcal, nor it can be understood as a
reference-book for the basics in celestial mechanics or spherical
trigonometry!  A detailed discussion of the above topics is completely
beyond the scope of this manual.  If you are interested to learn more
about these subjects, you unfortunately have to read the specific
pertinent literature.

  Any further errors occurring in the output of the above mentioned
holiday lists and in the astronomical calculations are my own fault, and
are not intended to offend members of any culture, religion or
profession!


File: gcal.info,  Node: Preface-Footnotes,  Up: Preface

   (1) I.e. no need to search for calendar information in the net so
phone and Internet Service Provider (ISP) costs are reduced, and
furthermore, neither searching for such information in books or data
files nor the need to use several other software which altogether do
what Gcal actually also does.

   (2) The "General Public License" of the Free Software Foundation.


File: gcal.info,  Node: Gcal Introduction,  Next: Invoking Gcal,  Prev: Preface,  Up: Top

2 Gcal Introduction
*******************

Apart from the usual and well known calendar functions like the output
of a month or a year calendar sheet, or the output of an eternal holiday
list, Gcal, the Gregorian calendar program of the Free Software
Foundation, offers the facility to display fixed dates on the day of
their occurrence and to remind or inform the user about them.  So it is
imaginable after booting the computer or starting the work session, that
the user is informed on screen or by means of electronic mail about all
holidays or appointments which are observed or scheduled for that day.

  The period, for which Gcal respects occurring fixed dates, may be
freely selected by the user.  So it is possible that Gcal displays all
fixed dates which occur on tomorrow's date, the whole week, the whole
month or in the whole year.  Fixed dates which occur on a selected date
of the year, and those that occur relative to another given date, are
displayed either related to this single date only, or in listed manner
starting on this date and ending on the actual date(1) (*note Gcal
Introduction-Footnote-1::).

  There are two methods to display a preview of fixed dates(2) (*note
Gcal Introduction-Footnote-2::) or retrospective view of fixed dates(3)
(*note Gcal Introduction-Footnote-3::).  On the one hand, Gcal can be
started by using an option that sets the system date of the computer to
the given date during the time of the program execution with the result,
the program assumes the system date is set to this given date and the
user can define any needed period that should be respected by an option.
On the other hand, Gcal can be started with a command which forces the
program to use a different year instead of the actual year, so Gcal will
display all occurring fixed dates for this particular year.  But this
limits the user in that it disables defining any needed period by an
option, because the period is always set to the whole year by default.

  Gcal isn't only able to display fixed dates which are stored for a
concrete date, e.g. 'Fixed date on 1st December 1995', rather than fixed
dates occurring periodically again and again.  So it is possible to
define repeated events like 'This fixed date occurs every day in May
1995' or 'Every 15th November in any years'.  These fixed date
definitions are stored in resource files and whenever Gcal is started,
an option to evaluate the necessary resource files can be given.

  Once the user has set his/her preferred command line arguments for
querying the fixed dates data base, it is possible to store them in a
response file or shell script file.  A response file contains all
arguments delivered to Gcal, but unlike a shell script file, such a
response file isn't executable; it is only a pool of command line
arguments which can be preloaded if needed.  A shell script file can be
started and calls Gcal directly with all arguments stored in it and all
arguments which are given further in the command line.

  A list of all usable command line arguments and their descriptions can
be found in the next chapter, which helps one to use Gcal in the most
efficient and productive way possible.  After it follows the description
how to use the eternal holiday list, and in the succeeding chapter, how
to use the fixed date list.  Comprehensive explanations respectively
summaries and tables to definite details or themes from other
disciplines can be found in the numerous appendices.


File: gcal.info,  Node: Gcal Introduction-Footnotes,  Up: Gcal Introduction

   (1) Inclusive or exclusive.

   (2) Future years.

   (3) Past years.


File: gcal.info,  Node: Invoking Gcal,  Next: Eternal Holidays,  Prev: Gcal Introduction,  Up: Top

3 Invoking 'gcal'
*****************

* Menu:

* Command line arguments::         Command line arguments.
* The GCAL environment variable::  How to use the 'GCAL' environment variable.

Gcal is a command line oriented program.  It is usually called from the
"shell"(1) (*note Invoking Gcal-Footnote-1::) and processes given
arguments that are options and commands.  Options must be given before
commands, i.e. you must call Gcal like this:

           gcal [ [OPTION...] [%DATE] [@FILE...] ] [COMMAND]

  If Gcal is started without any options or commands, a calendar of the
current month is displayed.  If the calendar of a definite year is
wanted, the year must be fully specified, e.g. 'gcal 94' displays a year
calendar of the year 94, not of the year 1994.

  If two arguments are given in the command part, the *first* argument
denotes the month, and the *second* argument denotes the year.  In case
any incorrect commands are given running Gcal, the program will use
internal defaults.

  In the English program version, Gcal assumes the Gregorian Reformation
has occurred in 1752 on the 3rd of September.  *Note Genesis of the
Gregorian Calendar: Todays Calendar, and *note Aspects in
Internationalization: Internationalization, for further details.


File: gcal.info,  Node: Invoking Gcal-Footnotes,  Up: Invoking Gcal

   (1) This is an operating system program which interprets and runs
given command lines.


File: gcal.info,  Node: Command line arguments,  Next: The GCAL environment variable,  Prev: Invoking Gcal,  Up: Invoking Gcal

3.1 Command line arguments
==========================

* Menu:

* Options::               How to use Options.
* Response file::         How to use a '@FILE' Response file.
* Actual date modifier::  How to use a '%DATE' Actual date modifier.
* Commands::              How to use Commands.

This section describes all command line arguments processed by Gcal.
Four different types of command line arguments exists.  One important
type of arguments are the "options" which control how Gcal behaves.
Other types of arguments are the '%DATE' and the '@FILE' options.  The
'%DATE' option sets the period Gcal shall work on to any starting date;
the '@FILE' option preloads options and commands from a response file.
The most important arguments are the "commands" which control the
periods Gcal respects.

  An option is defined by a leading "switch" character; either the '-'
(dash) or the '/' (slash) character for traditional short-style options,
or '--' for mnemonic long-style options; a command may not have a
leading switch character.  Options(1) (*note Command line
arguments-Footnote-1::) *must* be given before commands!

  Depending on operating system and used shell, some of the arguments
and texts given in command line must be quoted by '"' or ''' characters
respectively protected or depreciated by a '\' character to avoid
expansion by the shell.

  Here is an incomplete list of characters which must potentially be
protected:

     '(', ')', '<', '>', '[', ']', '{', '}', '\', '|', '$', '@', '!',
     '&', '~', '"', ''', '`', ';'


File: gcal.info,  Node: Command line arguments-Footnotes,  Up: Command line arguments

   (1) Inclusive '%DATE' and '@FILE'.


File: gcal.info,  Node: Options,  Next: Response file,  Prev: Command line arguments,  Up: Command line arguments

3.1.1 Options
-------------

* Menu:

* Common options::      How to use Common options.
* Global options::      How to use Global options.
* Calendar options::    How to use Calendar options.
* Fixed date options::  How to use Fixed date options.

The options processed by Gcal can be grouped into four major option
classes.  The options of the "common option class" are the standard
options all GNU software should implement at least partially.  The
"global option class" contains options which affect the program output.
The options of the "calendar option class" control the calendar layout,
and the options of the "fixed date option class" control the fixed date
layout and intensity.

  Gcal supports both short-style options and GNU long-style options.
Traditional short-style options are indicated by a single switch
character, and trailed by the option character itself and perhaps a
modifier or an argument.  The most single character options(1) (*note
Options-Footnote-1::) can be composed into a single command line word:
'-Ax' is equivalent to '-A -x'.  GNU long-style options are indicated
with '--', and trailed by the mnemonic option name itself and perhaps an
argument.  Long-style options and their arguments may be abbreviated if
done unambiguously.  When a long-style option takes an argument, connect
the option name and the argument with '='.

  Brackets ([ and ]) indicate in the following tables, that an option
takes an optional argument.  The '|' character is used to separate
several arguments from each other.

  Gcal processes the GNU long-style options in a special, non-standard
way.  There are five different types of long-style options:

  1. '--foo'
     Enables option '--foo'.

  2. '--foo=BAR'
     Enables option '--foo' with the required argument BAR.

  3. '--foo[=BAR[|...|BAR]]'
     Option '--foo' may have one BAR argument.  If no argument list is
     given, any argument can be given to this option.  If an argument
     list is given, exactly one BAR argument may be selected from the
     given list.  If there is no argument chosen in this case, the first
     BAR argument of the argument list is preselected by default.

  4. '--foo=BAR|...|BAR'
     Option '--foo' requires exactly one BAR argument which must be
     selected from the given argument list.

  5. '--foo=BAR|...|BAR|BAZ'
     Option '--foo' requires exactly one BAR argument which must be
     selected from the given BAR argument list, or the alternative BAZ
     argument.

  Traditional short-style options differ as follows:

  1. '-x'
     Enables option '-x'.

  2. '-x BAR'
     Enables option '-x' with the required argument BAR.  The BAR
     argument may be separated by a leading _whitespace_ character from
     the short-style option character 'x'.  This means, the following
     notations are valid for giving an argument, namely '-x BAR' or
     '-xBAR'.

  3. '-x[BAR|...|BAR]'
     Option '-x' may have one or more BAR "modifier".  In this sense,
     modifiers are one or more characters which define a special mode of
     operation enabled by the '-x' option.  A modifier may not be
     separated by a leading _whitespace_ character from the short-style
     option character.


File: gcal.info,  Node: Options-Footnotes,  Up: Options

   (1) Unless they take an argument.


File: gcal.info,  Node: Common options,  Next: Global options,  Prev: Options,  Up: Options

3.1.1.1 Common options
......................

'-?'
'-h'
'--help'
     Print a short usage message listing only some few of all available
     options, then exit successfully.

'-??'
'-hh'
'--usage[=ARGUMENT]'
'--long-help[=ARGUMENT]'
     Print an extended usage message listing all available options, then
     exit successfully.  If an ARGUMENT is given and it is a valid
     long-style option name, an extended help text related to the given
     long-style option name is displayed only, e.g.:

          --long-help=long-help

     displays the extended help text for the long option '--long-help'.

     If the ARGUMENT only consists of the single '?' character or is no
     valid long-style option name, a list of all valid long-style option
     names is displayed.

'-L'
'--license'
'--copyleft'
'--copyright'
     Print the software license message, then exit successfully.

'-V'
'--version'
     Print the version number and compilation options, then exit
     successfully.

'--exit-status-help-non-zero'
     Set the exit state of program to 127 instead to 0, if one of the
     other options of the _common option class_ is used.


File: gcal.info,  Node: Global options,  Next: Calendar options,  Prev: Common options,  Up: Options

3.1.1.2 Global options
......................

'-R NAME'
'--response-file=NAME'
     Write the contents of the environment variable 'GCAL' (*note
     Environment Variable 'GCAL': x-GCAL.), and then the arguments of
     command line (in the given order) to file NAME, i.e. create
     response file 'name'.  *Note Response file::, for more details.

'-S NAME'
'--shell-script=NAME'
     Write the contents of the environment variable 'GCAL' (*note
     Environment Variable 'GCAL': x-GCAL.), and then the arguments of
     command line (in the given order) to file NAME, i.e. create shell
     script file 'name'.  An automatically created shell script file is
     executable and calls Gcal directly with the arguments stored in it.
     You may start the shell script with other command line arguments
     which are directed to Gcal, too.

'--debug[=internal|handled|unhandled|all|abort]'
     Display some debug information.

     '--debug=internal'
          Display informational texts if program internal maxima are
          reached or other conditions occurred, respectively.

     '--debug=handled'
          Like '--debug=internal', additionally display the file names
          which can be processed respectively handled.

     '--debug=unhandled'
          Like '--debug=internal', additionally display file names which
          cannot be processed respectively handled.

     '--debug=all'
          Like '--debug=handled' and '--debug=unhandled' together.

     '--debug=abort'
          Like '--debug=all' and abort program with an error code if the
          file name cannot be handled or other unmanageable conditions
          occurred, respectively.  *Note Error Codes::.

'-p'
'--pager'
     Enables either an _external_ pager or a simple, _internal_ pager.
     If an environment variable 'PAGER' is set, its contents will be
     used for detecting the external pager program.  *Note Environment
     Variable 'PAGER': x-PAGER, for more information.

     If no 'PAGER' environment variable is set or if its contents is
     invalid, Gcal tries to use the 'less' pager; if this program cannot
     be found during scanning the 'PATH' environment variable, Gcal
     tries to use the 'more' pager, if this program cannot be found, the
     'pg' pager in the same way(1) (*note Global options-Footnote-1::).
     *Note Environment Variable 'PATH': x-PATH.

     If all these actions fail, Gcal will use its simple, built-in
     pager.  If the internal pager is used, Gcal detects the number of
     lines shown before it prompts and waits for user input by using
     these methods:

       1. Gcal respects the values set in the environment variables
          'GCAL_LINES' and 'GCAL_COLUMNS'.  *Note Environment Variable
          'GCAL_LINES': x-GCAL_LINES, and *note Environment Variable
          'GCAL_COLUMNS': x-GCAL_COLUMNS, for further information.

       2. If above action fails, Gcal respects the values set in the
          environment variables 'LINES' and 'COLUMNS'.  *Note
          Environment Variable 'LINES': x-LINES, and *note Environment
          Variable 'COLUMNS': x-COLUMNS, for more details.

       3. If above action fails, Gcal respects the values set in the
          'termcap'(2) (*note Global options-Footnote-2::) file which
          refers to the terminal used (*note Environment Variable
          'TERM': x-TERM.).  This step is only done on systems which
          support the use of Termcap by default.

          On MS-DOS, OS/2 and some other operating systems, Gcal uses a
          system dependent _low-level_ function and respects the
          reported values.

       4. If all above actions have failed, Gcal uses default values(3)
          (*note Global options-Footnote-3::).

'-H yes'
'--force-highlighting'
'--highlighting=yes'
     If the output of the program is redirected(4) (*note Global
     options-Footnote-4::) or piped(5) (*note Global
     options-Footnote-5::), the highlighting sequences are *not*
     automatically converted into the according marking characters, they
     remain unchanged.  This option takes no effect if the output of the
     program is sent by means of electronic mail.  *Note Global option
     '--mail[=ADDRESS]': x-mail.

'-H no'
'--disable-highlighting'
'--highlighting=no'
     Disable highlighting sequence / marking character pairs of current
     day, holiday or text explicitly.

'-H TEXT'
'--highlighting=TEXT'
     Set highlighting sequence / marking character pairs explicitly.  In
     this sense, "highlighting" sequences are control character
     sequences 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.  In this sense,
     "marking" characters are single, printable characters which lead
     and trail the output text.

     The TEXT argument must be a (':') colon-separated text which is
     structured in this way: SEQ1_START:SEQ1_END:SEQ2_START:SEQ2_END.
     The *first* sequence is used for highlighting/marking an actual
     day, the *second* for a holiday.  The sequences must be given in
     form of a sequence pair; SEQ?_START enables the
     highlighting/marking, SEQ?_END disables it.  Only two sequence
     pairs will be processed, others are ignored.  Either highlighting
     sequence pairs or marking character pairs may be defined, i.e.
     using them both in a mixed couple is not permitted!

     For example:

          '-H \x20:\x20:\x1:#' respectively
          '--highlighting=\x20:\x20:\x1:#'
          marks the actual day like '\x20ACTUAL DATE\x20'(6) (*note
          Global options-Footnote-6::) and the holiday date like
          '\x1HOLIDAY DATE#' using the given marking characters.

          '-H \x1b[34;42m:\x1b[0;40m' or
          '-H \033[34;42m:\033[0;40m' or
          '-H \E[34;42m:\E[0;40m'
          defines a starting ANSI escape highlighting sequence
          '\x1b[34;42m' used for actual day and ending ANSI escape
          highlighting sequence '\x1b[0;40m' with no given highlighting
          sequence for holidays, so default highlighting sequences for
          holidays are used (non-given entries are always skipped).
          Please note the last abstract of this text part which informs
          you more detailed of this context.  *Note Environment Variable
          'GCALANSI': x-GCALANSI, too.

     Control code definitions may contain any printable characters.
     Non-printable characters may be encoded in octal or hexadecimal
     notation.  The abbreviation '\E' directly encodes the escape
     character (octal '\033' respectively hexadecimal '\x1B').

     A character can be encoded octal by typing '\NNN'
     (backslash-octal digit(s)), where N must be a valid octal digit
     (0...7).  Normally, three octal digits must be given.  If the octal
     character code consists of one or two octal digits, leading zeroes
     must be added, except the case, where the encoded octal character
     is given at last in the single sequence.

     A character can be encoded hexadecimal by typing '\xNN'
     (backslash-x hexadecimal digit(s)), where N must be a valid
     hexadecimal digit (0...9A...Fa...f).  Normally, two hexadecimal
     digits must be given.  If the hexadecimal character code consists
     of one hexadecimal digit, a leading zero must be added, except the
     case, where the encoded hexadecimal character is given at last in
     the single sequence.

     If the sequence separator character, thus the ':' (colon) character
     itself, is used as a marking character, it must be encoded either
     octal by '\072' or hexadecimal by '\x3A'.

     If the C Preprocessor symbol 'USE_PAGER' was defined and the output
     of the program is redirected or used in a pipeline, the
     highlighting sequences are automatically converted into the
     according marking characters; if 'USE_PAGER' was not defined, they
     remain untouched.

     Incomplete or non-given highlighting sequences will be replaced by
     internal default ANSI escape highlighting sequences if a 'GCALANSI'
     environment variable is defined; otherwise completely replaced by
     their according marking characters.  *Note Environment Variable
     'GCALANSI': x-GCALANSI.

'--mail[=ADDRESS]'
     Send Gcal's output via 'mail'(7) (*note Global
     options-Footnote-7::) program to the given ADDRESS, e.g.:

          --mail=esken@gmx.net

     If no ADDRESS is given, Gcal tries to send the eMail by using the
     following methods:

       1. If an environment variable 'MAILTO' is defined and set, the
          eMail is send to the address which is listed in this
          environment variable.  *Note Environment Variable 'MAILTO':
          x-MAILTO, for more information.

       2. If above action fails, and if an environment variable 'USER'
          is defined and set, the eMail is send to the address which is
          listed in this environment variable.  *Note Environment
          Variable 'USER': x-USER, for more information.

       3. If above action fails, and if an environment variable
          'LOGNAME' is defined and set, the eMail is send to the address
          which is listed in this environment variable.  *Note
          Environment Variable 'LOGNAME': x-LOGNAME, for more
          information.

       4. If all above actions have failed, no eMail is send.

     Generally, Gcal does not send electronic Mails whose message body
     is empty!  An informational message will be shown on the _standard
     error channel_ if this case occurs.

     All highlighting sequences produced by Gcal itself are always
     disabled respectively automatically converted into the according
     marking characters if an eMail must be send; no matter if the
     '--force-highlighting' option was given or not.  This behavior of
     Gcal is an imperative necessity, because it is possible that the
     'mail' program cannot perform the mailing correctly.  Please pay
     attention in this context to the further explanations concerning
     the limitations of the _text part_ of a resource file line (*note
     Text part of a line::).

     If an environment variable 'MAILPROG' is defined and set, its
     contents will be used as the program name of the mailer instead of
     the standard name 'mail'.  *Note Environment Variable 'MAILPROG':
     x-MAILPROG, for more information.


File: gcal.info,  Node: Global options-Footnotes,  Up: Global options

   (1) See the standard manual pages for 'less', 'more' and 'pg'.

   (2) See the standard manual pages for Termcap.

   (3) Either 23 or 24 lines, and 80 columns.

   (4) This means, sent to another device.

   (5) This means, used as an input data stream for another program.

   (6) This means with a leading and a trailing blank.

   (7) See the standard manual pages for 'mail'.


File: gcal.info,  Node: Calendar options,  Next: Fixed date options,  Prev: Global options,  Up: Options

3.1.1.3 Calendar options
........................

'-n|N[-]'
'--holiday-list[=long|short]'
'--descending-holiday-list[=long|short]'
     Display the eternal holiday list.  By default, there are no entries
     in the eternal holiday list.  You have to choose country specific
     holidays or holidays from other calendar systems to provide the
     eternal holiday list with entries.  *Note Eternal Holidays::, and
     *note Calendar option '--cc-holidays=CC[+...]': x-cc-holidays, for
     additional information.

     '-n'
     '--holiday-list=long'
          Display all holidays of eternal holiday list --this means, all
          legal holidays and all further memorial days-- sorted in
          ascending order.

     '-n-'
     '--descending-holiday-list=long'
          Display all holidays of eternal holiday list --this means, all
          legal holidays and all further memorial days-- sorted in
          descending order.

     '-N'
     '--holiday-list=short'
          Display legal holidays only of eternal holiday list, sorted in
          ascending order.

     '-N-'
     '--descending-holiday-list=short'
          Display legal holidays only of eternal holiday list, sorted in
          descending order.

'-G'
'--suppress-holiday-list-separator'
     Suppress displaying of the blank line which is always leading an
     eternal holiday list.

'-X'
'--exclude-holiday-list-title'
     Suppress the title text line of the eternal holiday list.

'--astronomical-holidays'
     Provide the eternal holiday list additionally with some
     astronomical data, and that the Full and New Moon phases, waning
     and waxing Half Moon phases, solar and lunar eclipses, and the
     solstices and equinoxes.  *Note Calendar option
     '--time-offset=ARGUMENT': x-time-offset, how to change the timezone
     respectively base time for which the astronomical data is
     calculated.

'--bahai-holidays'
     Provide the eternal holiday list additionally with Baha''i`
     holidays (only for dates after AD 1843).

'--celtic-holidays'
     Provide the eternal holiday list additionally with Celtic holidays.
     *Note Calendar option '--time-offset=ARGUMENT': x-time-offset, how
     to change the timezone for which the Celtic holidays are
     calculated.

'--chinese-flexible-holidays'
     Provide the eternal holiday list additionally with Chinese
     holidays, that are determined in a flexible manner (only for dates
     after AD 1644).  *Note Calendar option '--time-offset=ARGUMENT':
     x-time-offset, how to change the timezone for which the Chinese
     holidays are calculated in a flexible manner.  *Note Preface::, for
     further details.

'--chinese-holidays'
     Provide the eternal holiday list additionally with Chinese holidays
     (only for dates after AD 1644).  For dates until AD 1928 all
     computations done are depending fixed on Beijing local time, for
     later dates fixed on the timezone GMT-8.  *Note Preface::, for
     further details.

'--christian-holidays'
     Provide the eternal holiday list additionally with Christian
     holidays.

'--hebrew-holidays'
     Provide the eternal holiday list additionally with Hebrew holidays.

'--islamic-civil-holidays'
     Provide the eternal holiday list additionally with Islamic holidays
     (only for dates after AD 621), that are based on the civil Islamic
     calendar.  *Note Preface::, for further details.

'--japanese-flexible-holidays'
     Provide the eternal holiday list additionally with Japanese
     holidays, that are determined in a flexible manner (only for dates
     after AD 1644).  *Note Calendar option '--time-offset=ARGUMENT':
     x-time-offset, how to change the timezone for which the Japanese
     holidays are calculated in a flexible manner.

'--japanese-holidays'
     Provide the eternal holiday list additionally with Japanese
     holidays (only for dates after AD 1644).  For dates until AD 1887
     all computations done are depending fixed on Beijing local time,
     for later dates fixed on the timezone GMT-9.

'--multicultural-new-year-holidays'
     Provide the eternal holiday list additionally with multicultural
     New Year holidays.  *Note Calendar option '--time-offset=ARGUMENT':
     x-time-offset, how to change the timezone for which the
     multicultural New Year holidays are calculated.

'--orthodox-new-holidays'
     Provide the eternal holiday list additionally with Orthodox new
     calendar holidays, and it is assumed that the Gregorian Reformation
     has occurred from 10th till 22nd March 1924.  *Note Calendar option
     '--orthodox-calendar': x-orthodox-calendar, for further details.

'--orthodox-old-holidays'
     Provide the eternal holiday list additionally with Orthodox new
     calendar holidays, and it is assumed that the Gregorian Reformation
     has occurred from 10th till 22nd March 1924.  *Note Calendar option
     '--orthodox-calendar': x-orthodox-calendar, for further details.

'--persian-jalaali-holidays'
     Provide the eternal holiday list additionally with Persian holidays
     (only for dates after AD 621), which are based on the Persian
     _Jalaali_ calendar.  All computations done are depending on the
     timezone GMT-3.5.

'--zodiacal-marker-holidays'
     Provide the eternal holiday list additionally with zodiacal marker
     holidays, i.e. the dates when the Sun enters a zodiac sign or when
     the Sun reaches the turning-point in the zodiac sign.  *Note
     Calendar option '--time-offset=ARGUMENT': x-time-offset, how to
     change the timezone for which the zodiacal marker holidays are
     calculated.

'-q CC[_TT][+...]'
'--cc-holidays=CC[_TT][+...]'
     Provide the eternal holiday list additionally with country specific
     holidays.  Furthermore, all additionally highlighted days of the
     eternal holiday list are highlighted in the calendar sheets, too.

     The CC argument is a two-letter country code as defined by the
     ISO-3166(1) (*note Calendar options-Footnote-1::) like 'BE' for
     Belgium or 'ES' for Spain.  See the pertinent literature for more
     details.

     In some cases, such a country code may be trailed by a two-letter
     territory code TT for better specification, which is separated by a
     '_' character from the country code.

     You can use more than one country code CC[_TT] by connecting them
     with a '+' character, e.g.:

          '--cc-holidays=be+Fr+IT' resp.,
          '-q be+Fr+IT'

     includes all the country specific holidays given in the preceding
     argument into the eternal holiday list, i.e. Belgian, French and
     Italian holidays.

     Actually, Gcal respects the following country codes, at which
     countries marked by a '#' character have only an incomplete
     recording of holidays:

     'AD'
          Andorra

     'AE'
          United Arab Emirates

     'AF'
          Afghanistan

     'AG'
          Antigua and Barbuda

     'AI'
          Anguilla

     'AL'
          Albania

     'AM'
          Armenia

     'AN_BO'
          Netherlands Antilles/Bonaire

     'AN_CU'
          Netherlands Antilles/Curac,ao

     'AN_MA'
          Netherlands Antilles/St Maarten

     'AN_SA'
          Netherlands Antilles/Saba and Statia

     'AO'
          Angola #

     'AR'
          Argentina

     'AS'
          American Samoa

     'AT'
          Austria

     'AU_CT'
          Australia/Canberra

     'AU_NT'
          Australia/Northern Territory

     'AU_QU'
          Australia/Queensland

     'AU_SA'
          Australia/Southern Australia

     'AU_SW'
          Australia/New South Wales

     'AU_TA'
          Australia/Tasmania

     'AU_VI'
          Australia/Victoria

     'AU_WA'
          Australia/Western Australia

     'AW'
          Aruba

     'AZ'
          Azerbaijan

     'BA'
          Bosnia-Herzegovina

     'BB'
          Barbados

     'BD'
          Bangladesh #

     'BE'
          Belgium

     'BF'
          Burkina Faso

     'BG'
          Bulgaria

     'BH'
          Bahrain

     'BI'
          Burundi #

     'BJ'
          Benin #

     'BM'
          Bermuda

     'BN'
          Brunei

     'BO'
          Bolivia

     'BR'
          Brazil

     'BS'
          Bahamas

     'BT'
          Bhutan #

     'BV'
          Bouvet Island

     'BW'
          Botswana

     'BY'
          Belarus

     'BZ'
          Belize

     'CA_AL'
          Canada/Alberta

     'CA_BC'
          Canada/British Columbia

     'CA_MA'
          Canada/Manitoba

     'CA_NB'
          Canada/New Brunswick

     'CA_NF'
          Canada/Newfoundland and Labrador

     'CA_NS'
          Canada/Nova Scotia

     'CA_NW'
          Canada/Northwest Territories

     'CA_ON'
          Canada/Ontario

     'CA_PE'
          Canada/Prince Edward Island

     'CA_QU'
          Canada/Que'bec

     'CA_SA'
          Canada/Saskatchewan

     'CA_YU'
          Canada/Yukon

     'CC'
          Cocos Islands (Keeling)

     'CD'
          Democratic Republic of Congo #

     'CF'
          Central African Republic #

     'CG'
          Republic of Congo #

     'CH_AG'
          Switzerland/Aargau

     'CH_AI'
          Switzerland/Appenzell Innerrhoden

     'CH_AR'
          Switzerland/Appenzell Ausserrhoden

     'CH_BE'
          Switzerland/Bern

     'CH_BL'
          Switzerland/Basel-Land

     'CH_BS'
          Switzerland/Basel-Stadt

     'CH_FR'
          Switzerland/Fribourg

     'CH_GE'
          Switzerland/Gene`ve

     'CH_GL'
          Switzerland/Glarus

     'CH_GR'
          Switzerland/Graubu"nden

     'CH_JU'
          Switzerland/Jura

     'CH_LU'
          Switzerland/Luzern

     'CH_NE'
          Switzerland/Neucha^tel

     'CH_NW'
          Switzerland/Nidwalden

     'CH_OW'
          Switzerland/Obwalden

     'CH_SG'
          Switzerland/St Gallen

     'CH_SH'
          Switzerland/Schaffhausen

     'CH_SO'
          Switzerland/Solothurn

     'CH_SZ'
          Switzerland/Schwyz

     'CH_TG'
          Switzerland/Thurgau

     'CH_TI'
          Switzerland/Ticino

     'CH_UR'
          Switzerland/Uri

     'CH_VD'
          Switzerland/Vaud

     'CH_VS'
          Switzerland/Valais

     'CH_ZG'
          Switzerland/Zug

     'CH_ZH'
          Switzerland/Zu"rich

     'CI'
          Co^te d'Ivoire

     'CK'
          Cook Islands

     'CL'
          Chile

     'CM'
          Cameroon

     'CN'
          China

     'CO'
          Colombia

     'CR'
          Costa Rica

     'CU'
          Cuba

     'CV'
          Cape Verde

     'CX'
          Christmas Islands

     'CY'
          Cyprus

     'CZ'
          Czech Republic

     'DE_BB'
          Germany/Brandenburg

     'DE_BE'
          Germany/Berlin

     'DE_BW'
          Germany/Baden-Wu"rttemberg

     'DE_BY'
          Germany/Bavaria

     'DE_HB'
          Germany/Bremen

     'DE_HE'
          Germany/Hesse

     'DE_HH'
          Germany/Hamburg

     'DE_MV'
          Germany/Mecklenburg-West Pomerania

     'DE_NI'
          Germany/Lower Saxony

     'DE_NW'
          Germany/North Rhine-Westphalia

     'DE_RP'
          Germany/Rhineland Palatinate

     'DE_SH'
          Germany/Schleswig-Holstein

     'DE_SL'
          Germany/Saar

     'DE_SN'
          Germany/Saxony

     'DE_ST'
          Germany/Saxony-Anhalt

     'DE_TH'
          Germany/Thuringia

     'DJ'
          Djibouti

     'DK'
          Denmark

     'DM'
          Dominica

     'DO'
          Dominican Republic

     'DZ'
          Algeria

     'EC'
          Ecuador

     'EE'
          Estonia

     'EG'
          Egypt

     'EH'
          Western Sahara

     'ER'
          Eritrea

     'ES'
          Spain

     'ET'
          Ethiopia

     'FI'
          Finland

     'FJ'
          Fiji #

     'FK'
          Falkland Islands (Malvinas)

     'FM'
          Federated States of Micronesia

     'FO'
          Faroes

     'FR'
          France

     'GA'
          Gabon #

     'GB_EN'
          Great Britain/England and Wales

     'GB_NI'
          Great Britain/Northern Ireland

     'GB_SL'
          Great Britain/Scotland

     'GD'
          Grenada

     'GE'
          Georgia

     'GF'
          French Guiana

     'GH'
          Ghana

     'GI'
          Gibraltar

     'GL'
          Greenland

     'GM'
          Gambia

     'GN'
          Guinea

     'GP'
          Guadeloupe

     'GQ'
          Equatorial Guinea

     'GR'
          Greece

     'GS'
          South Georgia and South Sandwich Islands

     'GT'
          Guatemala

     'GU'
          Guam

     'GW'
          Guinea-Bissau #

     'GY'
          Guyana #

     'HK'
          Hong Kong

     'HM'
          Heard and Mc Donald Islands

     'HN'
          Honduras

     'HR'
          Croatia

     'HT'
          Haiti

     'HU'
          Hungary

     'ID'
          Indonesia #

     'IE'
          Ireland

     'IL'
          Israel

     'IN'
          India #

     'IQ'
          Iraq

     'IR'
          Islamic Republic of Iran

     'IS'
          Iceland

     'IT'
          Italy

     'JM'
          Jamaica

     'JO'
          Jordan

     'JP'
          Japan

     'KE'
          Kenya #

     'KG'
          Kyrgyzstan

     'KH'
          Cambodia #

     'KI'
          Kiribati #

     'KM'
          Comoros

     'KN'
          St Kitts and Nevis

     'KP'
          Democratic People's Republic of Korea #

     'KR'
          Republic of Korea

     'KW'
          Kuwait

     'KY'
          Cayman Islands

     'KZ'
          Kazakhstan

     'LA'
          Laos People's Democratic Republic #

     'LB'
          Lebanon

     'LC'
          St Lucia

     'LI'
          Liechtenstein

     'LK'
          Sri Lanka #

     'LR'
          Liberia

     'LS'
          Lesotho

     'LT'
          Lithuania

     'LU'
          Luxembourg

     'LV'
          Latvia

     'LY'
          Libyan Arab Jamahiriya (Libya)

     'MA'
          Morocco

     'MC'
          Monaco

     'MD'
          Republic of Moldova

     'MG'
          Madagascar #

     'MH'
          Marshall Islands

     'MK'
          Former Yugoslav Republic of Macedonia

     'ML'
          Mali

     'MN'
          Mongolia #

     'MO'
          Macau

     'MP'
          Northern Marian Islands (Saipan)

     'MQ'
          Martinique

     'MR'
          Mauritania

     'MS'
          Montserrat

     'MT'
          Malta

     'MU'
          Mauritius

     'MV'
          Maldives

     'MW'
          Malawi

     'MX'
          Mexico

     'MY'
          Malaysia #

     'MZ'
          Mozambique

     'NA'
          Namibia

     'NC'
          New Caledonia

     'NE'
          Niger

     'NF'
          Norfolk Island

     'NG'
          Nigeria

     'NI'
          Nicaragua

     'NL'
          Netherlands

     'NM'
          Myanmar (Burma) #

     'NO'
          Norway

     'NP'
          Nepal #

     'NR'
          Nauru

     'NU'
          Niue

     'NZ'
          New Zealand

     'OM'
          Oman

     'PA'
          Panama

     'PE'
          Peru

     'PF'
          French Polynesia

     'PG'
          Papua New Guinea

     'PH'
          Philippines

     'PK'
          Pakistan

     'PL'
          Poland

     'PM'
          Saint-Pierre and Miquelon

     'PN'
          Pitcairn

     'PR'
          Puerto Rico

     'PT'
          Portugal

     'PW'
          Palau

     'PY'
          Paraguay

     'QA'
          Qatar

     'RE'
          Re'union

     'RO'
          Romania

     'RU'
          Russian Federation

     'RW'
          Rwanda

     'SA'
          Saudi Arabia

     'SB'
          Solomon Islands

     'SC'
          Seychellen

     'SD'
          Sudan

     'SE'
          Sweden

     'SG'
          Singapore #

     'SH'
          St Helena

     'SI'
          Slovenia

     'SJ'
          Svalbard and Jan Mayen Islands

     'SK'
          Slovakia

     'SL'
          Sierra Leone

     'SM'
          San Marino

     'SN'
          Senegal

     'SO'
          Somalia

     'SR'
          Suriname #

     'ST'
          Sao Tome' and Principe

     'SV'
          El Salvador

     'SY'
          Syrian Arab Republic (Syria)

     'SZ'
          Swaziland

     'TC'
          Turks and Caicos Islands

     'TD'
          Chad

     'TG'
          Togo #

     'TH'
          Thailand #

     'TJ'
          Tajikistan

     'TK'
          Tokelau

     'TM'
          Turkmenistan

     'TN'
          Tunisia

     'TO'
          Tonga

     'TR'
          Turkey

     'TT'
          Trinidad and Tobago #

     'TV'
          Tuvalu

     'TW'
          Taiwan

     'TZ'
          Tanzania

     'UA'
          Ukraine

     'UG'
          Uganda

     'US_AK'
          United States/Alaska

     'US_AL'
          United States/Alabama

     'US_AR'
          United States/Arkansas

     'US_AZ'
          United States/Arizona

     'US_CA'
          United States/California

     'US_CO'
          United States/Colorado

     'US_CT'
          United States/Connecticut

     'US_DC'
          United States/District of Columbia

     'US_DE'
          United States/Delaware

     'US_FL'
          United States/Florida

     'US_GA'
          United States/Georgia

     'US_HI'
          United States/Hawaii

     'US_IA'
          United States/Iowa

     'US_ID'
          United States/Idaho

     'US_IL'
          United States/Illinois

     'US_IN'
          United States/Indiana

     'US_KS'
          United States/Kansas

     'US_KY'
          United States/Kentucky

     'US_LA'
          United States/Louisiana

     'US_MA'
          United States/Massachusetts

     'US_MD'
          United States/Maryland

     'US_ME'
          United States/Maine

     'US_MI'
          United States/Michigan

     'US_MN'
          United States/Minnesota

     'US_MO'
          United States/Missouri

     'US_MS'
          United States/Mississippi

     'US_MT'
          United States/Montana

     'US_NC'
          United States/North Carolina

     'US_ND'
          United States/North Dakota

     'US_NE'
          United States/Nebraska

     'US_NH'
          United States/New Hampshire

     'US_NJ'
          United States/New Jersey

     'US_NM'
          United States/New Mexico

     'US_NV'
          United States/Nevada

     'US_NY'
          United States/New York

     'US_OH'
          United States/Ohio

     'US_OK'
          United States/Oklahoma

     'US_OR'
          United States/Oregon

     'US_PA'
          United States/Pennsylvania

     'US_RI'
          United States/Rhode Island

     'US_SC'
          United States/South Carolina

     'US_SD'
          United States/South Dakota

     'US_TN'
          United States/Tennessee

     'US_TX'
          United States/Texas

     'US_UT'
          United States/Utah

     'US_VA'
          United States/Virginia

     'US_VT'
          United States/Vermont

     'US_WA'
          United States/Washington

     'US_WI'
          United States/Wisconsin

     'US_WV'
          United States/West Virginia

     'US_WY'
          United States/Wyoming

     'UY'
          Uruguay

     'UZ'
          Uzbekistan

     'VC'
          St Vincent and Grenadines

     'VE'
          Venezuela

     'VG'
          British Virgin Islands

     'VI'
          U.S. Virgin Islands

     'VN'
          Viet Nam

     'VU'
          Vanuatu

     'WF'
          Wallis and Futuna Islands

     'WS'
          Samoa

     'YE'
          Yemen

     'YT'
          Mayotte

     'YU'
          Serbia and Montenegro

     'ZA'
          South Africa

     'ZM'
          Zambia

     'ZW'
          Zimbabwe

'--bahai-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Baha''i` calendar.  *Note Calendar option '--bahai-holidays':
     x-bahai-holidays, for further details.

'--chinese-flexible-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Chinese calendar, that is determined in a flexible manner.  *Note
     Calendar option '--chinese-flexible-holidays':
     x-chinese-flexible-holidays, for further details.

'--chinese-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Chinese calendar.  *Note Calendar option '--chinese-holidays':
     x-chinese-holidays, for further details.

'--coptic-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the Coptic
     calendar (only for dates after AD 283).

'--ethiopic-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Ethiopic calendar.

'--french-revolutionary-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the French
     Revolutionary calendar (only for dates after AD 1791).

'--hebrew-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the Hebrew
     calendar.

'--indian-civil-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the civil
     Indian calendar (only for dates after AD 1956).

'--islamic-civil-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the civil
     Islamic calendar.  *Note Calendar option
     '--islamic-civil-holidays': x-islamic-civil-holidays, for further
     details.

'--japanese-flexible-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Japanese calendar, that is determined in a flexible manner.  *Note
     Calendar option '--japanese-flexible-holidays':
     x-japanese-flexible-holidays, for further details.

'--japanese-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Japanese calendar.  *Note Calendar option '--japanese-holidays':
     x-japanese-holidays, for further details.

'--old-armenic-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Old-Armenic calendar (only for dates after AD 551).

'--old-egyptic-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Old-Egyptic calendar.

'--persian-jalaali-months'
     Provide the eternal holiday list additionally with the starting
     dates of the common and leap months, as they result from the
     Persian _Jalaali_ calendar.  *Note Calendar option
     '--persian-jalaali-holidays': x-persian-jalaali-holidays, for
     further details.

'-i[-]'
'--type=special|standard'
     To obtain the "standard calendar format"(2) (*note Calendar
     options-Footnote-2::), either start Gcal omitting the '-i[-]'
     option because it is set by default, *note Aspects in
     Internationalization: Internationalization, or start Gcal with the
     '-i-' respectively '--type=standard' option:

          $ gcal -i-
          -|
          -|    September 1994
          -| Su Mo Tu We Th Fr Sa
          -|              1  2  3
          -|  4  5  6  7  8  9 10
          -| 11 12 13 14 15 16 17
          -| 18 19 20 21 22 23 24
          -| 25 26 27 28 29 30

     To obtain the "special calendar format", start Gcal with the '-i'
     respectively '--type=special' option:

          $ gcal -i
          -|
          -| September 1994
          -|
          -| Sunday          4 11 18 25
          -| Monday          5 12 19 26
          -| Tuesday         6 13 20 27
          -| Wednesday       7 14 21 28
          -| Thursday     1  8 15 22 29
          -| Friday       2  9 16 23 30
          -| Saturday     3 10 17 24

'-O'
'--orthodox-calendar'
     Use the leap year rule as used by the Eastern Orthodox churches.

     Without specifying the '--orthodox-calendar' option, Gcal is unable
     to display Gregorian years later than 2799 in the correct way for
     the Eastern churches, because they use a different scheme for
     calculating the leap years.  The method for computing leap years
     within the common Gregorian calendar, which Gcal uses by default,
     is as follows:

          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:

          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.

     The first difference therefore occurs in the year 2800 which is a
     leap year in the common Gregorian calendar, but an ordinary year
     only in the calendar as used by the Eastern Orthodox churches.

'-K'
'--with-week-number'
     Provide the calendar sheet with week numbers.  *Note Calendar
     option '--starting-day=ARGUMENT': x-starting-day, *note Calendar
     option '--iso-week-number=yes|no': x-iso-week-number, and *note
     Aspects in Internationalization: Internationalization, for further
     details.

'--iso-week-number=yes|no'
     Determine the type of week numbers which are used in the calendar
     sheet, in the fixed date list and by the '%DATE' actual date
     modifier.  *Note Calendar option '--starting-day=ARGUMENT':
     x-starting-day, and *note Aspects in Internationalization:
     Internationalization, for more details.

     '--iso-week-number=yes'
          The methods of the ISO-8601:1988 are used for detecting week
          numbers; this means a week starts on Mondays, and the first
          week of a year is the one which includes the first Thursday;
          equivalently, the one which includes the 4th January.  This
          method is called "ISO week number" in the further context.  If
          the starting day of the week is not set to Monday, the week
          numbers are not represented correctly in most cases.  If you
          use this option, you should take care of setting Monday as the
          starting day of the week!

     '--iso-week-number=no'
          Weeks start 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.  This method is
          called "standard week number" in the further context.

'-u'
'--suppress-calendar'
     Suppress output of calendar sheet explicitly.

'-b NUMBER'
'--blocks=NUMBER'
     Set NUMBER of calendar sheet blocks (valid arguments:
     '1|2|3|4|6|12').  The default NUMBER for the _standard calendar
     format_ is '-b4 ' respectively '--blocks=4', and for the _special
     calendar format_ '-b 3' respectively '--blocks=3'.  If this option
     is found, the program sees that a year calendar output is desired!

     '-b 1'
     '--blocks=1'
          Displays one block with twelve months at a time.

     '-b 2'
     '--blocks=2'
          Displays two blocks with six months at a time.

     '-b 3'
     '--blocks=3'
          Displays three blocks with four months at a time.

     '-b 4'
     '--blocks=4'
          Displays four blocks with three months at a time.

     '-b 6'
     '--blocks=6'
          Displays six blocks with two months at a time.

     '-b 12'
     '--blocks=12'
          Displays twelve blocks with one month at a time.

'-j[b]'
'--calendar-dates=special|both'
     Use alternative date format in calendar sheet instead of the
     default standard format which displays the days of month in
     consecutive manner.

     '-j'
     '--calendar-dates=special'
          Display the calendar sheet by using the special date format.
          This means, the days of year are displayed in consecutive
          manner instead of the days of month.

     '-jb'
     '--calendar-dates=both'
          Display the calendar sheet by using both the standard date
          format and special date format.

'-jn[b]'
'--holiday-dates=special|both'
     Use alternative date format in eternal holiday list instead of the
     default standard format which displays the days of month in
     consecutive manner.  *Note Calendar option
     '--holiday-list[=long|short]': x-holiday-list.

     '-jn'
     '--holiday-dates=special'
          Display the eternal holiday list by using the special date
          format.  This means, the days of year are displayed in
          consecutive manner instead of the days of month.

     '-jnb'
     '--holiday-dates=both'
          Display the eternal holiday list by using both the standard
          date format and special date format.

'-jc[b]'
'--fixed-dates=special|both'
     Use alternative date format in fixed date list instead of the
     default standard format which displays the days of month in
     consecutive manner.  *Note Fixed date option
     '--list-of-fixed-dates[=short|long]': x-list-of-fixed-dates.

     '-jc'
     '--fixed-dates=special'
          Display the fixed date list by using the special date format.
          This means, the days of year are displayed in consecutive
          manner instead of the days of month.

     '-jcb'
     '--fixed-dates=both'
          Display the fixed date list by using both the standard date
          format and special date format.

'-s ARGUMENT'
'--starting-day=ARGUMENT'
     Set the starting day of the week (valid ARGUMENT:
     '0, 1...7 | today | WEEKDAY NAME').

     For example:

          --starting-day=Sunday or
          --starting-day=7 or
          -s SUNDAY or
          -s sund or
          -sSu or
          -s 7

     thus all specifies the Sunday (1==Mon, 2==Tue ... 7==Sun).

     If the '-s today' option (or '--starting-day=today') or the '-s 0'
     option (or '--starting-day=0') is given, the starting day of the
     week is set to the actual weekday as it is delivered by the system
     date.  *Note Aspects in Internationalization: Internationalization,
     for more details.

'--time-offset=ARGUMENT'
     Change the base time of the astronomical functions (valid ARGUMENT:
     't|@|[t|@][+|-]MMMM|HH:[MM]').

     If no '--time-offset=ARGUMENT' option is given, the astronomical
     data that is inserted into the eternal holiday list by the
     '--astronomical-holidays' option (*note Calendar option
     '--astronomical-holidays': x-astronomical-holidays.), and all Sun
     and Moon related special texts are always calculated for 0 o'clock
     Universal time (UTC/GMT), thus "civil midnight time".

     *Note Sun data::, and *note Moon data::, likewise *note Moon
     phase::, for further information.

     The ARGUMENT is either the 't' or the '@' character --where 't'
     means a relation to the actual local time(3) (*note Calendar
     options-Footnote-3::) and '@' denotes a relation to the actual
     Universal time--, or one of these characters followed by a
     displacement value, or only a displacement value which has to be
     specified either by using the '[+|-]MMMM' format or the
     '[+|-]HH:[MM]' format.  '[+|-]MMMM' adds respectively subtracts the
     specified amount of minutes MMMM from the base time value 0 o'clock
     Universal time (range '0...9999'), while '[+|-]HH:[MM]' adds
     respectively subtracts the given amount of hours HH (range
     '0...99') and minutes MM (range '0...59') from the base time value
     0 o'clock Universal time.  The displacement value is always added
     to the base time value 0 o'clock Universal time in case it is
     specified without a '+|-' sign.

     For example, the '--time-offset=+1:' option causes that while
     displaying eternal holiday lists and fixed date lists, the time 0
     o'clock of the timezone GMT-1 (== CET) is used as the base time by
     the astronomical functions instead of the base time 0 o'clock
     Universal time (== GMT).

     For example, the '--time-offset=t-2:' option causes that while
     displaying eternal holiday lists and fixed date lists, the time
     that is two hours earlier than the actual local time is used as the
     base time by the astronomical functions instead of the base time 0
     o'clock Universal time (== GMT).  For such a kind of relation, the
     term "relative time offset value" will be used in the further
     context.

'--transform-year=ARGUMENT'
     Change the base year of calendar (valid ARGUMENT:
     '-9999...[+]9999').

     For example, the '--transform-year=-543' option causes that while
     displaying calendar sheets, eternal holiday lists and fixed date
     lists, the year 543 BC is used as the base year of the calendar
     instead of the year AD 1.  This results in the case that --for
     example-- for the year 1999 (Christian era), the year number 1999
     is not used in the above mentioned outputs, but the year number
     2542 which is used in the western oriented Thai calendar.

     Nevertheless, Gcal does not respect the '--transform-year=ARGUMENT'
     option when using the actual date modifier '%DATE' (*note Actual
     date modifier::), the commands (*note Commands::), and the fixed
     date entries in a resource file (*note Date part of a line::).
     There, all references made to a definite year are always treated in
     the way that the year AD 1 is the base year of the calendar, so in
     fact it is *only* possible to use references based on the Christian
     era.

'--gregorian-reform=1582|1700|1752|1753|ARGUMENT'
     Set the period which was skipped during the Gregorian Reformation.
     By default, Gcal runs in the "hybrid" calendar mode, i.e. 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.  *Note Aspects in
     Internationalization: Internationalization, for more details.
     Actually, four fixed default periods are supported, and that of the
     year 1582, of the year 1700, of the year 1752 and of the year 1753.

     If Gcal is called with the '--gregorian-reform=1582' option, it
     assumes the Gregorian Reformation has occurred from 5th till 14th
     October 1582.

     If Gcal is called with the '--gregorian-reform=1700' option, it
     assumes the Gregorian Reformation has occurred from 19th till 28th
     February 1700.

     If Gcal is called with the '--gregorian-reform=1752' option, it
     assumes the Gregorian Reformation has occurred from 3rd till 13th
     September 1752.

     If Gcal is called with the '--gregorian-reform=1753' option, it
     assumes the Gregorian Reformation has occurred from 18th till 28th
     February 1753.

     In case another period shall be respected, it can be arranged by
     the option ARGUMENT like 'YYYYY,MM,FIRST-DAY,LAST-DAY'.  If the
     Gregorian Reformation has occurred for example on the 7th till the
     17th April 1802, this can be arranged as follows:

          --gregorian-reform=1802,4,7,17

     Gcal is able to represent so-called "proleptic" calendars of a
     definite calendar system.  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.  The following proleptic calendar systems are
     actually supported by Gcal:

        * Proleptic Gregorian calendars can be created from AD 302 until
          AD 9999 if '--gregorian-reform=301,12,31,31' is used.
          Unfortunately, Gcal actually cannot represent years before AD
          302 in a proleptic-Gregorian manner.

        * Proleptic Julian calendars can be created from AD 1 until AD
          9999 if '--gregorian-reform=10002,12,31,31' is used.  In this
          case, the actual system date that is normally based on the
          Gregorian calendar and that is used by Gcal, is internally and
          automatically converted into the according Julian date(4)
          (*note Calendar options-Footnote-4::).  The same happens if
          the actual system date is modified by using the actual date
          modifier '%DATE'.  In such a case, Gcal also assumes that the
          given date is a Gregorian date, and converts it automatically
          into the according Julian date internally.  *Note Actual date
          modifier::, for further details.

     Please note that it is possible to corrupt the calendars likewise
     the fixed date feature logically (which works correctly now for the
     year in which the Gregorian Reformation has occurred) if the
     argument of the '--gregorian-reform' option is not used with care.

'--date-format=de|us|gb|TEXT'
     Set the date format which affects the ordering and representation
     of a displayed date.  *Note Aspects in Internationalization:
     Internationalization, for more details.  The date format text is
     respected by Gcal in the eternal holiday list, in the fixed date
     list and the calendar sheets.  Moreover, Gcal internally tries to
     obtain the best representation of a displayed date in case the
     day-of-year numbers instead of the day-of-month numbers must be
     displayed, or both types of numbers are used in a combined manner.

     Actually, three fixed default date formats are supported, and that
     for German users, U.S. American users and for users in Great
     Britain.

     If Gcal is called with the '--date-format=de' option,
     the '%<2#K,  %1%>2*D%2 %<3#U %>04*Y' date format text is used.
     This result in that a date is displayed by using the
     'WW,  DD MMM YYYY' ordering, for example 'Sa,  28 Aug 1999'.

     If Gcal is called with the '--date-format=us' option,
     the '%<3#K, %<3#U  %1%>2&*D%2 %>04*Y' date format text is used.
     This result in that a date is displayed by using the
     'WWW, MMM  DD YYYY' ordering, for example 'Sat, Aug  28th 1999'.

     If Gcal is called with the '--date-format=gb' option,
     the '%<3#K,  %1%>2&*D%2 %<3#U %>04*Y' date format text is used.
     This result in that a date is displayed by using the
     'WWW,  DD MMM YYYY' ordering, for example 'Sat,  28th Aug 1999'.

     In case another format text shall be respected, this format text
     can either be set in the 'GCAL_DATE_FORMAT' environment variable(5)
     (*note Calendar options-Footnote-5::), or it can be arranged by the
     option argument TEXT.  For example,
     '--date-format='%Y %D %>02*M ; %1(%>5u#K)%2'' displays a date by
     using the '[[[Y]Y]Y]Y [D]D MM ; (WWWWW)' ordering, thus for example
     '1999 28 08 ; (SATUR)'.  *Note Environment Variable
     'GCAL_DATE_FORMAT': x-GCAL_DATE_FORMAT, for further information.

     The format text may contain on the one hand all characters which
     can be managed by Gcal, and on the other hand character replacement
     instructions and format elements which are transformed into their
     according values at run-time.  Some format elements may have a
     format instruction which is called FORMAT in the further context.
     *Note Format Instruction::, for the detailed description of the
     format instruction and its components.

     A minimum date format text must contain the following format
     elements minimum:

          The day number, one component of the month group, the year
          number and both components of the highlighting group.

     A weekday name format element may be included optionally into the
     date format text.  The following format elements and character
     replacement instructions are currently supported:

     '%[FORMAT]D'
          Day number (must be defined)

     '%[FORMAT]Y'
          Year number (must be defined)

     '%[FORMAT]K'
          Weekday name (may be defined)

     Month group (exactly one member must be defined):

     '%[FORMAT]M'
          Month number

     '%[FORMAT]U'
          Month name

     Highlighting group (all members must be defined and '%1' must be
     specified before '%2'):

     '%1'
          Start of highlighting sequence / marking character

     '%2'
          End of highlighting sequence / marking character

     Character replacement instructions:

     '_'
          Space/blank character ' '

     '\_'
          Underscore character '_'

     '\%'
          Percent character '%'

     '\\'
          Backslash character '\'

     *Note Table of Obsolete Date Formats::, and *note Table of Obsolete
     Date Format Elements::, for further information.

'--translate-string=TEXT'
     Define the country specific special character pairs which are
     respected or translated by a STYLE format instruction component,
     respectively.  *Note Format Instruction::, for the detailed
     description of the format instruction and its components.  The
     country specific special character pairs are arranged by the TEXT
     option argument as a sequence of single character pairs, and that
     in any number and order.  The upper-case representation of the
     country specific special character has to be specified at first,
     and after that its lower-case representation.  Country specific
     special characters which do not have an upper-case resp.,
     lower-case representation in the character set used, like e.g. the
     'ss'-character which is very usual in the German character set, are
     also specified as a special character pair (here: 'ssss'),
     otherwise these special characters are not recognized and they are
     converted incorrectly by the STYLE format instruction component.
     In case the lower-case representation of the country specific
     special character is specified at first, and after that its
     upper-case representation, this option does not cause any further
     affects to the STYLE format instruction component; resulting, the
     country specific special characters specified are not recognized as
     such and they remain untranslated therefore.

     For example, a 'A"a"O"o"U"u"ssss' option argument causes the
     correct conversion of the preceding special characters in an
     individual date format, which has a STYLE format instruction
     component, and that, how they are used by the character set used in
     Germany.


File: gcal.info,  Node: Calendar options-Footnotes,  Up: Calendar options

   (1) ISO is the abbreviation of 'International Organization for
Standardization'.

   (2) Similar the BSD-'cal' program.

   (3) The time which is set as system time in the computer's clock.

   (4) The automatical conversion into the according Julian date is
always done if the actual system date, that is based on the Gregorian
calendar, is before the date of the Gregorian Reformation.

   (5) But 'GCAL_DATE_FORMAT' is only used in case no
'--date-format=de|us|gb|TEXT' option is given.


File: gcal.info,  Node: Fixed date options,  Prev: Calendar options,  Up: Options

3.1.1.4 Fixed date options
..........................

'-v ARGUMENT'
'--date-variable=ARGUMENT'
     Define "global" date variable which is visible in all referenced
     resource files (*note Date variables::).  The option ARGUMENT must
     either be a valid single date variable definition or a (':')
     colon-connected series of definitions.

     A date variable name DVAR consists of a single, case-insensitive
     letter(1) (*note Fixed date options-Footnote-1::).  In a
     definition, this name is trailed by the assignment operator
     character '=', and the numerical values of month MM (or a short,
     three characters month name, e.g. 'Jan', 'Feb'...) and day DD, this
     variable has to store(2) (*note Fixed date options-Footnote-2::).

     For example:

          '--date-variable=a=1127:c=a' respectively
          '-v a=1127:c=a'
          stores the 27th November into the global date variable A and
          into the global date variable C.

'--export-date-variables'
     Causes the export of local date variables from one resource file to
     another resource file.  *Note Date variables::, for more details.

'-r ARGUMENT'
'--text-variable=ARGUMENT'
     Define "global" text variable which is visible in all referenced
     resource files (*note Text variables::).  The option ARGUMENT must
     either be a valid single text variable definition or a (':')
     colon-connected series of definitions.

     A text variable name TVAR consists of the '$' prefix and a single,
     case-insensitive letter.

     A text variable is defined as follows:

        * If the name of a text variable is trailed by the assignment
          operator character '=', all the text which appears at the
          right side of this assignment operator is assigned to this
          text variable.

        * If the name of a text variable is trailed by the assignment
          operator character '?', all the text which appears at the
          right side of this assignment operator is assumed as an
          external command and executed by Gcal.  The output, which is
          created on the _standard output channel_ by the command run,
          is assigned to this text variable; and that in an interpreted
          manner.  This means, Gcal interprets all special texts and
          references to other text variables which are contained in this
          output.  *Note Text variables::, and *note Special Texts
          processed::, for further information.

        * If the name of a text variable is trailed by the assignment
          operator character ':', all the text which appears at the
          right side of this assignment operator is assumed as an
          external command and executed by Gcal.  The output, which is
          created on the _standard output channel_ by the command run,
          is assigned to this text variable; and that in an
          uninterpreted manner.  This means, Gcal does not interpret any
          special texts and references to other text variables which are
          contained in this output.  See also *note Text variables::,
          and *note Special Texts processed::, for further details.

     Indeed, Gcal executes external commands only if the
     '--execute-command' option is given at program start-up.  *Note
     Fixed date option '--execute-command': x-execute-command, for more
     details.

     The text which appears at the right side of one of the valid
     assignment operator characters may reference names of already
     defined global text variables.  These references are converted to
     the according textual values just before the assignment is
     performed by Gcal.

     A global text variable is defined with an _empty contents_ in case
     no text appears at the right side of one of the valid assignment
     operator characters.

     For example:

          '--text-variable=$a=foo:$c=$a' respectively
          '-r $a=foo:$c=$a'
          stores the 'foo' text into the global text variable $A and
          into the global text variable $C.

          '--text-variable=$a\:foo:$c?bar' respectively
          '-r $a\:foo:$c?bar'
          stores the uninterpreted output of the 'foo' command into the
          global text variable $A, and the interpreted output of the
          'bar' command into the global text variable $C.

     You may depreciate the special meaning of the ':' separator
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\:'.  If you need the
     '\:' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\:'.

     You may depreciate the special meaning of the '$' prefix character
     --in case this character itself is needed in the text-- by placing
     a '\' (backslash) character before it, e.g. '\$'.  If you need the
     '\$' characters themselves in the text, you have to protect the '\'
     (backslash) character by another '\' (backslash) character, e.g.
     '\\$'.

     Each time a '_' (underscore) character is found in ARGUMENT, this
     character is replaced by a real ' ' (space) character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' themselves, you have to protect the '\' (backslash) character
     by another '\' (backslash) character, e.g. '\\_'.

'--export-text-variables'
     Causes the export of local text variables from one resource file to
     another resource file.  *Note Text variables::, for more details.

'--adjust-value=ARGUMENT'
     Causes on the one hand, that the number given as ARGUMENT to the
     '--adjust-value' option is used as reference altitude to calculate
     the rise and set times by the Sun and Moon oriented special texts.
     The option argument must be a rational number in range
     -90.0...+90.0, which declares the angle distance in decimal degrees
     from the center of astronomical object to the horizon.  For
     example, you can detect the time when the center of the Sun or the
     Moon is 20.5 decimal degrees below the horizon if you use
     '--adjust-value=-20.5'.

     And causes on the other hand, that the number that is given as
     ARGUMENT is used as factor for computing the shadow length of a
     vertical pole by the Sun oriented special texts.  The option
     argument must be a rational number in range 0.0...+90.0, which
     declares the shadow length.  For example, you can detect the time
     when the shadow length of vertical pole is three and a half times
     longer than the shadow length that appears at astronomical noon if
     you use '--adjust-value=3.5'.

     *Note Sun data::, and *note Moon data::, for further information.

'--atmosphere=AIR-PRESSURE[,TEMPERATURE]'
     Set the base data of the Earth's atmosphere that is necessary to
     calculate the amount of "refraction"(3) (*note Fixed date
     options-Footnote-3::), that is used by the Sun and Moon oriented
     special texts.  The option argument consists of one or two rational
     numbers, which are separated by a ',' character.  The first number
     denotes the air pressure in millibar, and the second number
     specifies the air temperature in degree Celsius.  The default value
     for the air pressure is 1013.25 millibar, and the default value for
     the temperature is 15.0 degree Celsius.  For example, if you use
     '--atmosphere=1010,10', you define atmospheric conditions as they
     are existing for an air pressure of 1010 millibar and a temperature
     of 10 degree Celsius.  If you set an air pressure value less or
     equal zero, no atmospheric refraction will be respected by the Sun
     and Moon oriented special texts, as for example done by
     '--atmosphere=0'.

     *Note Sun data::, and *note Moon data::, for further information.

'--limit'
     Causes when calculating the rise and set times by the Sun oriented
     special texts for high latitudes, that a rise or set event which
     possibly occurs on a previous or next day, is not displayed as
     occurring on the actual day as it is done by default.  At high
     latitudes, i.e. above the solar Arctic Circle, it is fact that no,
     or more than one sunrise or sunset happens during a day at definite
     dates of the year.  As a special text basically leads in a single,
     atomical output, even it should result in several output in
     reality, Gcal puts such an event on a previous or next day.  Then,
     data represented in this manner could be misinterpreted very
     easily.

     The following example is used to explain this.  It calculates the
     time the astronomical twilight ends for the location Mu"nster,
     Germany, during some days in May 2000, and that with and without
     the '--limit' option in each case:

          $ gcal %20000506 -f/dev/null -cxl4+ \
          >      -#'0*d1#999_%s9+5158+00738,120'
          -|
          -| Sun, May   7th 2000: 23:52
          -| Mon, May   8th 2000: 23:57
          -| Tue, May   9th 2000: 00:01
          -| Wed, May  10th 2000: 00:06
          $ gcal %20000506 -f/dev/null -cxl4+ --limit \
          >      -#'0*d1#999_%s9+5158+00738,120'
          -|
          -| Sun, May   7th 2000: 23:52
          -| Mon, May   8th 2000: 23:57
          -| Tue, May   9th 2000: **:**
          -| Wed, May  10th 2000: **:**

     As one can see well in the above example, the output for the days
     since 9th May differs in that the times shown without the '--limit'
     option obviously exceeded the civil midnight time and actually
     cannot happen during these days, whereas no times are shown for the
     days since 9th May if the '--limit' option is used because the time
     circle is exceeded.  Astronomically seen, it is the case that the
     end of the astronomical twilight is at 23:57 o'clock local time on
     8th May, no end of astronomical twilight happens on 9th May because
     the center of the Sun's disk is always above 18 degrees (the
     reference altitude of the astronomical twilight) below a geometric
     horizon, but on 10th May at 00:01 o'clock local time, this
     reference altitude is passed again.  Thus, the time that is
     detected for the 9th May has properly to be moved to the 10th May,
     et cetera, as it is expressed by the output that is created by
     using the '--limit' option.

     *Note Sun data::, for further information.

'--cycle-end=ARGUMENT'
     Calculates the Sun and Moon oriented special texts that are
     dynamical, i.e. depending on the respective clocktime, 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.
     Gcal is always put into such a "cycle mode" if the '--cycle-end'
     option is given at program start-up.  The ARGUMENT of the
     '--cycle-end' option is syntactically according to the argument
     which may be given to the '--time-offset' option, thus
     't|@|[t|@][+|-]MMMM|HH:[MM]'.  *Note Calendar option
     '--time-offset=ARGUMENT': x-time-offset, for the detailed
     explanation of the preceding option argument.  Thus, the
     '--cycle-end' option is used to fix the ending time of the time
     interval, whereas the '--time-offset' option is *implicitly* used
     to fix the starting time of the time interval, that is 0 o'clock by
     default(4) (*note Fixed date options-Footnote-4::).

     If values for the time interval are given to both above mentioned
     options that fall short of 0 o'clock, these values are
     automatically set to 0 o'clock.  If values for the time interval
     are given that exceed 23:39 o'clock, these values are automatically
     set to 23:59 o'clock.

     The timestep value between the starting and the ending time of the
     time interval that is respected by Gcal is one minute by default.
     This value can at pleasure be changed by using the '--cycle-step'
     option.  *Note Fixed date option '--cycle-step=ARGUMENT':
     x-cycle-step, for more details.

     You should always keep in mind that the use of the cycle mode is
     efficient only if the current time of the time interval is also
     part of that resource file line that has to be evaluated in this
     manner.  Otherwise, it is difficult to find out unobjectionably
     lateron when displaying the data and times, which Sun or Moon
     oriented value resulted in what time.

     The following example shows how the topocentric elevation angle of
     the Sun for the location Mu"nster, Germany, is calculated during
     two days in April 2000, and that for the time interval 12:00
     o'clock until 12:05 o'clock local time in each case:

          $ gcal %20000420 -Hno -f/dev/null -xdt -g::: \
          >      --here='0*d1#999_%ot+00+000_:_%oa+5158+00738,120' \
          >      --cycle-end=12:05 --time=12:00
          -|
          -| Thu, Apr  20th 2000: +12h00': +045d58'
          -| Thu, Apr  20th 2000: +12h01': +046d03'
          -| Thu, Apr  20th 2000: +12h02': +046d07'
          -| Thu, Apr  20th 2000: +12h03': +046d12'
          -| Thu, Apr  20th 2000: +12h04': +046d17'
          -| Thu, Apr  20th 2000: +12h05': +046d22'
          -| :::
          -| Fri, Apr  21st 2000: +12h00': +046d18'
          -| Fri, Apr  21st 2000: +12h01': +046d23'
          -| Fri, Apr  21st 2000: +12h02': +046d28'
          -| Fri, Apr  21st 2000: +12h03': +046d32'
          -| Fri, Apr  21st 2000: +12h04': +046d37'
          -| Fri, Apr  21st 2000: +12h05': +046d42'

     *Note Sun data::, and *note Moon data::, for further information.

'--cycle-step=ARGUMENT'
     Changes the timestep value that is used between the starting and
     ending clocktime of the time interval, in which the Sun and Moon
     oriented special texts are calculated, that are dynamical, i.e.
     depending on the respective clocktime.  *Note Fixed date option
     '--cycle-end=ARGUMENT': x-cycle-end, how to define such a time
     interval.  Without the '--cycle-end' option, a '--cycle-step'
     option is completely ignored.  It also does not enable Gcal's cycle
     mode.  The ARGUMENT of the '--cycle-step' option is by change
     syntactically according to the argument which may be given to the
     '--time-offset' option, and that relative time offset value
     references based on the actual local time and Universal time cannot
     be made, respectively.  Gcal always uses the amount of the given
     timestep value.  Thus, the template for the argument that may be
     given to the '--cycle-step' option is '[+|-]MMMM|HH:[MM]'.  *Note
     Calendar option '--time-offset=ARGUMENT': x-time-offset, for the
     detailed explanation of the preceding option argument.

     The timestep value between the starting and the ending time of the
     time interval that is respected by Gcal is one minute by default.

     The following example shows how the topocentric elevation angle of
     the Sun for the location Mu"nster, Germany, is calculated during
     two days in April 2000, and that for the time interval 10:00
     o'clock until 17:00 o'clock local time with a timestep value of one
     hour and 15 minutes in each case:

          $ gcal %20000420 -Hno -f/dev/null -xdt -g::: \
          >      --here='0*d1#999_%ot+00+000_:_%o*a+5158+00738,120' \
          >      --cycle-end=10:00 --time=17:00 --cycle-step=1:15
          -|
          -| Thu, Apr  20th 2000: +10h45': +38.038
          -| Thu, Apr  20th 2000: +12h00': +45.962
          -| Thu, Apr  20th 2000: +13h15': +49.665
          -| Thu, Apr  20th 2000: +14h30': +47.882
          -| Thu, Apr  20th 2000: +15h45': +41.267
          -| Thu, Apr  20th 2000: +17h00': +31.633
          -| :::
          -| Fri, Apr  21st 2000: +10h45': +38.355
          -| Fri, Apr  21st 2000: +12h00': +46.299
          -| Fri, Apr  21st 2000: +13h15': +50.006
          -| Fri, Apr  21st 2000: +14h30': +48.198
          -| Fri, Apr  21st 2000: +15h45': +41.545
          -| Fri, Apr  21st 2000: +17h00': +31.881

     *Note Sun data::, and *note Moon data::, for further information.

'--precise'
     The astronomical data and times that are created by the Sun and
     Moon oriented special texts, and the geographical data that is
     created by the distance and course angle oriented special text,
     respectively, are displayed by using a higher precision, i.e.
     according to the mode or style of representation and the type of
     special text, decimal values are displayed with more decimal
     places, or output of the time seconds part or the arcseconds part.

     *Note Sun data::, and *note Moon data::, likewise *note
     Geographical distance and course angle::, for further information.

'--execute-command'
     Causes on the one hand, that shell command '%![ARGUMENT]' special
     texts are executed, and not displayed textually only.  *Note Shell
     command '%![ARGUMENT]' special text: Shell Command, for more
     details.  And causes on the other hand, that 'TVAR?[COMMAND]' and
     'TVAR:[COMMAND]' text variable definitions is assigned the output
     of an external command, and not the text which contains the call of
     the external command.  *Note Text variables::, for further
     information.

'-D ARGUMENT'
'--filter-day=ARGUMENT'
     Displays only those fixed dates, whose date is not excluded by the
     given ARGUMENT.  *Note Date part of a line::, and likewise *note
     Exclusions without any argument '%?' special texts: Exclusions
     without any argument..  The ARGUMENT consists of one or more
     characters as used in the exclusion without any argument '%?'
     special text; but without the leading '%' character in each case.

     For example, it is possible to induce Gcal to display only those
     fixed dates from the resource file 'demo.rc' for the whole year
     which are legals holidays, and moreover, Saturdays or Sundays:

          gcal -f demo.rc --year --filter-day=Rv

'-P ARGUMENT'
'--filter-period=ARGUMENT'
     Displays only those fixed dates, whose date is not excluded by the
     given ARGUMENT.  *Note Date part of a line::, and likewise *note
     Exclusions with date argument '%?[DATE]' special texts: Exclusions
     with date argument..  The ARGUMENT consists of one or more
     expressions as used in the exclusion with date argument '%?[DATE]'
     special text; but without the leading '%' character in each case.
     You can use more than one of these '%?[DATE]' expressions by
     connecting them with a ',' character.

     For example, it is possible to induce Gcal to display only those
     fixed dates from the resource file 'demo.rc' for the whole year
     which appear within the period of the 17th and the 20th of any
     month, and which appear on the 31st of any month.

          gcal -f demo.rc -y -P i00000017#00000020,i00000031#00000031

'-I PATTERN'
'--filter-text=PATTERN'
     Displays only those fixed dates, whose completely expanded text(5)
     (*note Fixed date options-Footnote-5::) is matched by the given
     PATTERN.  *Note Text part of a line::, and *note '%?'... special
     texts for text replacement: Replacements..  The PATTERN is a
     _regular expression_, as recognized by the Unix 'ed' line-editor.
     *Note Regular Expressions::, for further information.

     For example, it is possible to induce Gcal to display all fixed
     dates from the resource file 'doctor.rc' for the current month,
     which are defined for dentists or oculists:

          gcal -f doctor.rc --month -I "[dD]entist|[oO]culist"

     Each time a '_' (underscore) character is found in the PATTERN
     argument, this character is replaced by a real ' ' (space)
     character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.

'--ignore-case'
     Ignores all case distinctions in both the completely expanded text
     and the PATTERN of the '--filter-text=PATTERN' option.  *Note Fixed
     date option '--filter-text=PATTERN': x-filter-text.

'--revert-match'
     Displays all those fixed dates, whose completely expanded text does
     not match the PATTERN of the '--filter-text=PATTERN' option.  *Note
     Fixed date option '--filter-text=PATTERN': x-filter-text.

'-c|C[-]'
'--today'
'--list-of-fixed-dates[=short|long]'
'--descending-fixed-dates[=short|long]'
     Activate the fixed date function and display fixed date messages,
     if any.

     '-c'
     '--today'
     '--list-of-fixed-dates=short'
          Activate fixed date function (use standard resource file
          implicitly) and list all dates related to the actual system
          date (==today), sorted in ascending order.  If no fixed dates
          related to the current day are found, no fixed date messages
          are displayed and the program is terminated with an error
          code.  *Note Error Code 1: x-1-Error-code.

     '-c-'
     '--descending-fixed-dates=short'
          Activate fixed date function (use standard resource file
          implicitly) and list all dates related to the actual system
          date (==today), sorted in descending order.  If no fixed dates
          related to the current day are found, no fixed date messages
          are displayed and the program is terminated with an error
          code.  *Note Error Code 1: x-1-Error-code.

     '-C'
     '--list-of-fixed-dates=long'
          Activate fixed date function (use standard resource file
          implicitly) and list all dates related to the actual system
          date (==today), sorted in ascending order.  If no fixed dates
          related to the current day are found, an "empty" fixed date
          message is displayed which is only consisting of the date.

     '-C-'
     '--descending-fixed-dates=long'
          Activate fixed date function (use standard resource file
          implicitly) and list all dates related to the actual system
          date (==today), sorted in descending order.  If no fixed dates
          related to the current day are found, an "empty" fixed date
          message is displayed which is only consisting of the date.

'-f|F NAME[+...]'
'--resource-file=NAME[+...]'
     Activate fixed date function and use file NAME instead of the
     standard resource file.  Then list all dates, sorted in ascending
     order which occur in the fixed date period.  If no other fixed date
     period is specified, the actual system date (==today) is used for
     the fixed date period.  If the option letter 'f' of the short-style
     option is used and no dates related to the fixed date period are
     found in NAME, no fixed date messages are displayed and the program
     is terminated with an error code.  *Note Error Code 1:
     x-1-Error-code.  If the option letter 'F' of the short-style option
     is used and no dates related to the fixed date period are found in
     NAME, an "empty" fixed date message is displayed which is only
     consisting of the date.

     You can use more than one resource file NAME by connecting them
     with a '+' character, e.g.:

          '--resource-file=./foo+xyz+/data/bar+$HOME/.gcalrc' resp.,
          '-f ./foo+xyz+/data/bar+$HOME/.gcalrc'

     respects all files given in the preceding argument by using a
     special file search mechanism.  *Note File searching mechanism:
     x-File-searching-mechanism, for more details.  Use '/dev/null' to
     avoid the use of the standard resource file, useful for creating
     _empty fixed date lists_.  If a single '-' character is given as
     file NAME, like '--resource-file=./foo+-+xyz' or '-F-', but not
     '-F -', Gcal reads and processes all input received from the
     _standard input channel_.

     You may depreciate the special meaning of the '+' separator
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\+'.  If you need the
     '\+' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\+'.

     Each time a '_' (underscore) character is found in NAME, this
     character is replaced by a real ' ' (space) character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.

'-# LINE'
'--here=LINE'
     Activate fixed date function and use the LINE argument together
     with the standard resource file respectively additional resource
     files.  The LINE argument has to be a valid line as it may occur in
     a Gcal resource file (*note Structure of resource file::), and is
     always evaluated last *after* the processing of all resource files,
     so dealing with references to exported local date or text variables
     is enabled.  This option may be given multiple and it will be
     processed exactly in the given order.  All dates are listed, sorted
     in ascending order which occur in the fixed date period.  If no
     other fixed date period is specified, the actual system date
     (==today) is used for the fixed date period.  If no dates related
     to the fixed date period are found in the LINE, no fixed date
     messages are displayed and the program is terminated with an error
     code.  *Note Error Code 1: x-1-Error-code.

     For example, the call:

          gcal -# "0*d1su#99su.7 ^%Z" --here="#include <foo>" -y

     causes the implicit processing of the standard resource file just
     before the further resource file line '0*d1su#99su.7 ^%Z' and
     following '#include <foo>' are processed, and that as if these
     lines were a physical part of the standard resource file.

     Each time a '_' (underscore) character is found in LINE, this
     character is replaced by a real ' ' (space) character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.

*Please note:*
If the short-style option '-c' and/or its modifiers 't|[w|m|y[+|-]', or
the short-style option '-f' is/are given in *upper-case*, e.g.:

     -C
     -F foo.bar
     -CeT
     -c-aW+
     -CeaxY-
     -c-M

Gcal displays fixed date messages for *every* day of the requested
period.

  The modifiers of a combined/complex/packed short-style fixed date
option must be constructed according to following steps, because Gcal
treats them as positional parameters:

     First step: _Representation-of-text-modifier_
          'a', 'A', 'e|E', 'J', 'k', 'o', 'Q', 'U', 'x', 'z', 'Z'

     Second step: _Period-of-fixed-dates-modifier_
          'd', 'l', 't|T', 'w|W|m|M|y|Y[+|-]', 'N+|-', 'Nd', 'Nw',
          '*dN[WWW]', '*wN[WWW]', '@e|t|DVAR[[+|-]N]',
          '@e|t|DVAR[+|-]NWWW', 'MMDD', 'MMWWWN'

  If you want to operate with the preceding modifiers, an *explicit*
'-c|C[-]' short-style option must be leading on the one hand, e.g.:

     -c-t
     -cw-
     -CZdekloQUzJaxA12+

and only *one* period defining fixed date period modifier may be
given(6) (*note Fixed date options-Footnote-6::).

Or on the other hand, the modifiers must be given as single character
options or composed into a single command line word, and additionally
either the short-style option '-c|C[-]', '-f|F NAME[+...]' or
'-# LINE'(7) (*note Fixed date options-Footnote-7::) must be given like:

     -c -t
     -w- -c
     -a -Ad -e -kloQUxz -C12+
     -F foo.bar -dJZA -l*d10
     --here="; Comment" -dZAa

If the modifiers are given as single character options or composed into
a single command line word, and one of the 't|T|[w|W|m|M|y|Y[+|-]]'
modifiers is used(8) (*note Fixed date options-Footnote-8::), it is
unnecessary to give a '-c|C[-]' respectively '-f|F NAME[+...]'
short-style option(9) (*note Fixed date options-Footnote-9::) to
activate the fixed date function of Gcal, because it is triggered
implicitly by means of these modifiers / alias names.

  *Note Coding Scheme::, whose tables explain the relations between the
_date part_ (YYYY...) of a resource file line and the modifiers, the
short-style option '-c|C[]' --which is used for enabling the fixed date
feature-- respectively the long-style option
'--period-of-fixed-dates=ARGUMENT' may have, i.e. they point out all
possible correspondences.  This is necessary because Gcal does not
respect all entries found in a resource file if a _fixed date_ argument
is given, it respects only those entries which have a definite relation
to the _fixed date_ argument to avoid the output of redundant
information!

*Fixed date text modifiers and options:*

'--biorhythm-axis=NUMBER'
     The width of the biorhythm text graphics --which can be created by
     means of the biorhythm text graphics '%;[DATE]' special text-- is
     changed to NUMBER characters for each axis of the bar.  The NUMBER
     argument must be an integer value between 1...100, the default
     number of characters is 20.  If the NUMBER divides 100 with a
     remainder, it is internally reduced to the nearest number that
     divides 100 without any remainder.  This means, only the numbers 1,
     2, 4, 5, 10, 20, 25, 50 and 100 are factually respected, so a
     NUMBER argument of 19 is internally reduced to 10.

     For example:

          $ cat bio.rc
          -| 0*d1#999 %;19620921
          $ gcal -fbio.rc %19961212 -s0 -xw --biorhythm-axis=19
          -|
          -| Thu, Dec <12th>1996: 0- I       P1 E        +0
          -| Fri, Dec  13th 1996: 0-  I   P   1          +0
          -| Sat, Dec  14th 1996: 0-    @   E 0          +0
          -| Sun, Dec  15th 1996: 0-  P  IE   0          +0
          -| Mon, Dec  16th 1996: 0- P  E  I  0          +0
          -| Tue, Dec  17th 1996: 1-P  E     I0          +0
          -| Wed, Dec  18th 1996: 0- @        1          +0

     *Note Biorhythm '%?[DATE]' special texts: Biorhythm, for more
     details.

'--moonimage-lines=NUMBER'
     The height of the Moon phase text graphics --which can be created
     by means of the Moon phase text graphics '%Z[DATE]' special text--
     is changed to NUMBER lines.  The NUMBER argument must be an integer
     value between 6...30, the default number of lines is 12.

     For example:

          $ gcal -f/dev/null -#0*d1#999_%Z__%O %19950407 -x --moon=8
          -|
          -| Fri, Apr < 7th>1995:          (    @@@@@
          -|                          (           @@@@@@@@
          -|                       (              @@@@@@@@@@@
          -|                      (               @@@@@@@@@@@@
          -|                      (               @@@@@@@@@@@@
          -|                       (              @@@@@@@@@@@
          -|                        (             @@@@@@@@@@
          -|                            (        @@@@@@@ 42%+

     *Note Moon phase '%[FORMAT]?[DATE]' special texts: Moon phase, for
     more details.

'a'
'--include-resource-file-name'
     Extend fixed date text by the name of the resource file and the
     line number which the fixed date text comes from, e.g.:

          Mon, Jan   1st 1995: (`Eternal holiday list'#00003) New Year's day
          Mon, Jan   1st 1995: (.gcalrc#00987) No fixed dates
          ...

'A'
'--alternative-format'
     Instead of using the "standard" list format, e.g.:

          Mon, Jan   1st 1995: New Year's day
          Mon, Jan   1st 1995: No fixed dates
          ...

     Gcal uses the "alternative" list format, e.g.:

          Mon, Jan   1st 1995:
          New Year's day
          No fixed dates
          ...

'e'
'--include-holidays=long'
     Enable inclusion of all built-in eternal holiday dates.  This
     includes legal holidays and memorial days.

'E'
'--include-holidays=short'
     Enable inclusion of those built-in eternal holiday dates which are
     legal holidays only.

'g[TEXT]'
'--grouping-text[=TEXT]'
     Group fixed dates by day by using the TEXT separator.  If TEXT is
     not given, the built-in TEXT(10) (*note Fixed date
     options-Footnote-10::) is used for grouping, e.g.:

          $ gcal -Cxw -cg
          -|
          -| Sun, Nov   6th 1994: Text 1
          -| Sun, Nov   6th 1994: Text 2
          -|
          -| Mon, Nov   7th 1994: Text 3
          -|
          -| Tue, Nov   8th 1994: Text 4
          ...


          $ gcal -Cxw -g'-A_user\_defined-~-grouping text-'
          -|
          -| Sun, Nov   6th 1994: Text 1
          -| Sun, Nov   6th 1994: Text 2
          -| -A user_defined-
          -| -grouping text-
          -| Mon, Nov   7th 1994: Text 3
          -| -A user_defined-
          -| -grouping text-
          -| Tue, Nov   8th 1994: Text 4
          ...

     The TEXT may contain references to global date and text variables
     (*note Fixed date option '--date-variable=ARGUMENT':
     x-date-variable, and *note Fixed date option
     '--date-variable=ARGUMENT': x-text-variable.).  Furthermore, all
     special texts which cause a text replacement may be used in the
     TEXT (*note '%?'... special texts for text replacement:
     Replacements.).

     Each time a '~' (tilde) or '^' (caret) character is found in TEXT,
     this character is replaced by a real '\n' (newline) character.

     You may depreciate the special meaning of the '~' (tilde) character
     --in case this character itself is needed-- by placing a '\'
     (backslash) character before it, e.g. '\~'.  If you need the '\~'
     characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.  All
     above mentioned facts are also valid for the '^' (caret) character.

     Each time a '_' (underscore) character is found in TEXT, this
     character is replaced by a real ' ' (space) character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.

'k'
'--include-week-number'
     The leading date of a fixed date message is either extended by the
     ISO week number or the standard week number.  *Note Calendar option
     '--starting-day=ARGUMENT': x-starting-day, *note Calendar option
     '--iso-week-number=yes|no': x-iso-week-number, and *note Aspects in
     Internationalization: Internationalization, for further details.

'o'
'--omit-multiple-date-part'
     Omit displaying the leading date of a fixed date message in case
     more than one message refers to that date(11) (*note Fixed date
     options-Footnote-11::), e.g.:

          $ gcal -cxo
          -|
          -| Sun, Nov   6th 1994: Text 1
          -|                      Text 2
          ...

'Q'
'--suppress-fixed-dates-list-separator'
     Suppress displaying of the blank line which is always leading a
     fixed date list.  For example, to cause Gcal to print only the
     number of days between 1st January 1970 and 1st January 1980, you
     can call the program like this:

          $ gcal -f /dev/null -QUx %19800101 -#0_%j-2440588
          -| 3652

'U'
'--suppress-date-part'
     Suppress displaying the leading date of a fixed date message, e.g.:

          $ gcal -cxU
          -|
          -| Text 1
          -| Text 2
          ...

'J'
'--suppress-text-part'
     Suppress displaying the text part of a fixed date message, e.g.:

          $ gcal -cxJ
          -|
          -| Sun, Nov   6th 1994:
          -| Sun, Nov   6th 1994:
          ...

'x'
'--exclude-fixed-dates-list-title'
     Suppress the title text line of the fixed date list.

'--heading-text=TEXT'
     Changes the title text line of the fixed date list.  Instead of
     displaying the default 'Fixed date list:' text, any other text can
     be used as heading text of the fixed date list, e.g.:

          $ gcal -cUJ --heading-text=Hello,_it_is_%K_,~%t__o'clock
          -|
          -| Hello, it is Sunday,
          -| 14:32 o'clock
          -|
          -| Sun, Nov   6th 1994:
          ...

     The TEXT may contain references to global date and text variables
     (*note Fixed date option '--date-variable=ARGUMENT':
     x-date-variable, and *note Fixed date option
     '--date-variable=ARGUMENT': x-text-variable.).  Furthermore, all
     special texts which cause a text replacement may be used in the
     TEXT (*note '%?'... special texts for text replacement:
     Replacements.).

     Each time a '~' (tilde) or '^' (caret) character is found in TEXT,
     this character is replaced by a real '\n' (newline) character.

     You may depreciate the special meaning of the '~' (tilde) character
     --in case this character itself is needed-- by placing a '\'
     (backslash) character before it, e.g. '\~'.  If you need the '\~'
     characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.  All
     above mentioned facts are also valid for the '^' (caret) character.

     Each time a '_' (underscore) character is found in TEXT, this
     character is replaced by a real ' ' (space) character.

     You may depreciate the special meaning of the '_' (underscore)
     character --in case this character itself is needed-- by placing a
     '\' (backslash) character before it, e.g. '\_'.  If you need the
     '\_' characters themselves, you have to protect the '\' (backslash)
     character by another '\' (backslash) character, e.g. '\\_'.

'z'
'--include-consecutive-number'
     Display consecutive numbers of fixed date messages.

'Z'
'--zero-dates-only'
     Display only those dates, for which fixed dates do not exist, i.e.
     all "empty" fixed dates only consisting of the date.

*Fixed date period modifiers and options:*

'--leap-day=february|march'
     The "leap day"(12) (*note Fixed date options-Footnote-12::) is
     observed in non-leap years.

     '--leap-day=february'
          A fixed date that appears in every year and which is related
          to the leap day, is displayed on the 28th February in non-leap
          years.

     '--leap-day=march'
          A fixed date that appears in every year and which is related
          to the leap day, is displayed on the 1st March in non-leap
          years.

'd'
'--include-today'
     If lists of periods are generated, include the actual date into the
     list.  *Note Fixed date option '--list-mode': x-list-mode, how to
     create a list of periods.

'l'
'--list-mode'
     Generate a list of periods instead of a single period.

     *Please note:*
     The following examples assumes the actual system date is the *17th
     February of any year* (00000217), weeks start on Mondays and ISO
     week numbers are used!

'--period-of-fixed-dates=ARGUMENT'

'Nd'
'*dN'
     Single date of absolute day N == '1...365|366|999' of the actual
     year; the intensity level is the same as the simple '-c' option.
     If the value 999 for N is given, the last day of the year (31st
     December) is assumed.

        * E.g. 'gcal -c10d' respectively
          'gcal --period-of-fixed-dates=10d' or 'gcal -c*d10'
          respectively 'gcal --period-of-fixed-dates=*d10' displays all
          fixed dates which occur on the 10th day of the year.

'lNd'
'l*dN'
     List dates starting yesterday or tomorrow (depending on the given
     day number N) and ending on the N'th absolute day of the actual
     year; the intensity level is the same as the '-cy' option.

        * E.g. 'gcal -cl10d' respectively 'gcal -cl*d10' displays a list
          of all fixed dates which start on the 10th day of year and end
          on the 16th February.

'N+|-'
     Single date of day _actual day '+/-' N days_ of the actual year;
     the intensity level is the same as the simple '-c' option.

        * E.g. 'gcal -c10+' displays all fixed dates which occur 10 days
          after the 17th February (today).

        * E.g. 'gcal -c10-' displays all fixed dates which occur 10 days
          before the 17th February (today).

'lN+|-'
     List dates starting yesterday '-' or tomorrow '+' and ending on
     _actual day '+/-' N days_ of the actual year; the intensity level
     is the same as the '-cy' option.

        * E.g. 'gcal -cl10+' displays a list of all fixed dates which
          start on the 18th February and end 10 days after.

        * E.g. 'gcal -cl10-' displays a list of all fixed dates which
          start 10 days before the 16th February and end on the 16th
          February.

'Nw'
     Single dates of week number N == '0|1...52|53|99' of the actual
     year; the intensity level is the same as the '-cw' option.  *Note
     Calendar option '--starting-day=ARGUMENT': x-starting-day, *note
     Calendar option '--iso-week-number=yes|no': x-iso-week-number, and
     *note Aspects in Internationalization: Internationalization, for
     more details.

        * E.g. 'gcal -c0w' displays all fixed dates which occur in the
          53rd week of the previous year, in case the previous year has
          a 53rd week.  If the previous year has no 53rd week, all fixed
          dates occurring in the 1st week of the actual year are
          displayed.

        * E.g. 'gcal -c6w' displays all fixed dates which occur in the
          6th week of year.

        * E.g. 'gcal -c52w' displays all fixed dates which occur in the
          52nd week of year.

        * E.g. 'gcal -c53w' displays all fixed dates which occur in the
          53rd week of the actual year, in case the actual year has a
          53rd week.  If the actual year has no 53rd week, no fixed date
          messages are displayed and the program is terminated with an
          error code.  *Note Error Code 126: x-126-Error-code.

        * E.g. 'gcal -c99w' displays all fixed dates which occur in the
          last week of the actual year, i.e. either the 52nd or the 53rd
          week.

'lNw'
     List dates starting yesterday or tomorrow (depending on the given
     week number N) and ending on the first respectively last day of
     given week number N == '0|1...52|53|99' of the actual year; the
     intensity level is the same as the '-cy' option.  *Note Calendar
     option '--starting-day=ARGUMENT': x-starting-day, *note Calendar
     option '--iso-week-number=yes|no': x-iso-week-number, and *note
     Aspects in Internationalization: Internationalization, for further
     details.

        * E.g. 'gcal -cl12w' displays a list of all fixed dates which
          start on the 18th February and end on the last day of the 12th
          week.

        * E.g. 'gcal -cl3w' displays a list of all fixed dates which
          start on the first day of the 3rd week and end on the 16th
          February.

'MMDD'
     Single date of day DD in month MM of the actual year; the intensity
     level is the same as the simple '-c' option.

        * E.g. 'gcal -c0225' displays all fixed dates which occur on the
          25th February.

'lMMDD'
     List dates starting yesterday or tomorrow (depending on the value
     given in MMDD) and ending on day DD of month MM of the actual year;
     the intensity level is the same as the '-cy' option.

        * E.g. 'gcal -cl0225' displays a list of all fixed dates which
          start on the 18th February and end on the 25th February.

        * E.g. 'gcal -cl0109' displays a list of all fixed dates which
          start on the 9th January and end on the 16th February.

'MMWWWN'
     Single date of N'th == '1...5|9' weekday DD|WWW in month MM of the
     actual year; the intensity level is the same as the simple '-c'
     option.

        * E.g. 'gcal -c01mon3' displays all fixed dates which occur on
          the 3rd Monday in January.

        * E.g. 'gcal -c02fri9' displays all fixed dates which occur on
          the last Friday in February.

'lMMWWWN'
     List dates starting yesterday or tomorrow (depending on the value
     given in MMWWWN) and ending on N'th == '1...5|9' weekday DD of
     month MM of the actual year; the intensity level is the same as the
     '-cy' option.

        * E.g. 'gcal -cl01mon3' displays a list of all fixed dates which
          start on the 3rd Monday in January and end on the 16th
          February.

        * E.g. 'gcal -cl02fri9' displays a list of all fixed dates which
          start on the 18th February and end on the last Friday in
          February.

'*dNWWW'
     Single date of N'th == '1...51|52|53|99' weekday WWW of the actual
     year; the intensity level is the same as the simple '-c' option.

        * E.g. 'gcal -c*d16sun' displays all fixed dates which occur on
          the 16th Sunday of the actual year.

        * E.g. 'gcal -c*d52sun' displays all fixed dates which occur on
          the 52nd Sunday of the actual year.  If the actual year has no
          52nd Sunday, no fixed date messages are displayed and the
          program is terminated with an error code.  *Note Error Code
          126: x-126-Error-code.

        * E.g. 'gcal -c*d53sun' displays all fixed dates which occur on
          the 53rd Sunday of the actual year.  If the actual year has no
          53rd Sunday, no fixed date messages are displayed and the
          program is terminated with an error code.  *Note Error Code
          126: x-126-Error-code.

        * E.g. 'gcal -c*d99sun' displays all fixed dates which occur on
          the last Sunday(13) (*note Fixed date options-Footnote-13::)
          of the actual year.

'l*dNWWW'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on N'th == '1...51|52|53|99' weekday WWW of
     the actual year; the intensity level is the same as the '-cy'
     option.

        * E.g. 'gcal -cl*d16sun' displays a list of all fixed dates
          which start on the 18th February and end on the 16th Sunday of
          the actual year.

        * E.g. 'gcal -cl*d52sun' displays a list of all fixed dates
          which start on the 18th February and end on the 52nd Sunday of
          the actual year.  If the actual year has no 52nd Sunday, no
          fixed date messages are displayed and the program is
          terminated with an error code.  *Note Error Code 126:
          x-126-Error-code.

        * E.g. 'gcal -cl*d53sun' displays a list of all fixed dates
          which start on the 18th February and end on the 53nd Sunday of
          the actual year.  If the actual year has no 53nd Sunday, no
          fixed date messages are displayed and the program is
          terminated with an error code.  *Note Error Code 126:
          x-126-Error-code.

        * E.g. 'gcal -cl*d99sun' displays a list of all fixed dates
          which start on the 18th February and end on the last
          Sunday(14) (*note Fixed date options-Footnote-14::) of the
          actual year.

'*wN[WWW]'
     Single date of weekday WWW of N'th == '0|1...52|53|99' week of the
     actual year; the intensity level is the same as the simple '-c'
     option.  If no weekday WWW is given, the starting day of the week
     is assumed for the weekday WWW.  *Note Calendar option
     '--starting-day=ARGUMENT': x-starting-day, *note Calendar option
     '--iso-week-number=yes|no': x-iso-week-number, and *note Aspects in
     Internationalization: Internationalization, for more details.

        * E.g. 'gcal -c*w0sun' displays all fixed dates which occur on
          the Sunday of the 52nd respectively 53rd week of the previous
          year.  In case such a Sunday does not exist, no fixed date
          messages are displayed and the program is terminated with an
          error code.  *Note Error Code 126: x-126-Error-code.

        * E.g. 'gcal -c*w16sun' displays all fixed dates which occur on
          the Sunday of the 16th week of the actual year.

        * E.g. 'gcal -c*w52sun' displays all fixed dates which occur on
          the Sunday of the 52nd week of the actual year.  If the actual
          year has no Sunday of the 52nd week, no fixed date messages
          are displayed and the program is terminated with an error
          code.  *Note Error Code 126: x-126-Error-code.

        * E.g. 'gcal -c*w53sun' displays all fixed dates which occur on
          the Sunday of the 53rd week of the actual year.  If the actual
          year has no Sunday of the 53rd week, no fixed date messages
          are displayed and the program is terminated with an error
          code.  *Note Error Code 126: x-126-Error-code.

        * E.g. 'gcal -c*w99sun' displays all fixed dates which occur on
          the last Sunday(15) (*note Fixed date options-Footnote-15::)
          of the actual year.

'l*wN[WWW]'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on weekday WWW of N'th == '0|1...52|53|99'
     week of the actual year; the intensity level is the same as the
     '-cy' option.  If no weekday WWW is given, the starting day of the
     week is assumed for the weekday WWW.  *Note Calendar option
     '--starting-day=ARGUMENT': x-starting-day, *note Calendar option
     '--iso-week-number=yes|no': x-iso-week-number, and *note Aspects in
     Internationalization: Internationalization, for further details.

        * E.g. 'gcal -cl*w0sun' displays a list of all fixed dates which
          start on the Sunday of the 52nd respectively 53rd week of the
          previous year and end on the 16th February.  In case such a
          Sunday does not exist, no fixed date messages are displayed
          and the program is terminated with an error code.  *Note Error
          Code 126: x-126-Error-code.

        * E.g. 'gcal -cl*w16sun' displays a list of all fixed dates
          which start on the 18th February and end on the Sunday of the
          16th week of the actual year.

        * E.g. 'gcal -cl*w52sun' displays a list of all fixed dates
          which start on the 18th February and end on the Sunday of the
          52nd week of the actual year.  If the actual year has no
          Sunday of the 52nd week, no fixed date messages are displayed
          and the program is terminated with an error code.  *Note Error
          Code 126: x-126-Error-code.

        * E.g. 'gcal -cl*w53sun' displays a list of all fixed dates
          which start on the 18th February and end on the Sunday of the
          53rd week of the actual year.  If the actual year has no
          Sunday of the 53rd week, no fixed date messages are displayed
          and the program is terminated with an error code.  *Note Error
          Code 126: x-126-Error-code.

        * E.g. 'gcal -cl*w99sun' displays a list of all fixed dates
          which start on the 18th February and end on the last
          Sunday(16) (*note Fixed date options-Footnote-16::) of the
          actual year.

'@e[[+|-]N]'
     Single date of day N relative to the Easter Sunday's date of the
     actual year; the intensity level is the same as the simple '-c'
     option.

        * E.g. 'gcal -c@e' displays all fixed dates which occur on the
          Easter Sunday's date.

        * E.g. 'gcal -c@e10' respectively 'gcal -c@e+10' displays all
          fixed dates which occur 10 days after the Easter Sunday's
          date.

        * E.g. 'gcal -c@e-10' displays all fixed dates which occur 10
          days before the Easter Sunday's date.

'l@e[[+|-]N]'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on N'th day relative to the Easter Sunday's
     date of the actual year; the intensity level is the same as the
     '-cy' option.

        * E.g. 'gcal -cl@e' displays a list of all fixed dates which
          start on the 18th February and end on the Easter Sunday's
          date.

        * E.g. 'gcal -cl@e10' respectively 'gcal -cl@e+10' displays a
          list of all fixed dates which start on the 18th February and
          end 10 days after the Easter Sunday's date.

        * E.g. 'gcal -cl@e-10' displays a list of all fixed dates which
          start on the 18th February and end 10 days before the Easter
          Sunday's date.

'@e[+|-]NWWW'
     Single date of N'th weekday WWW relative to the Easter Sunday's
     date of the actual year; the intensity level is the same as the
     simple '-c' option.

        * E.g. 'gcal -c@e3fri' respectively 'gcal -c@e+3fri' displays
          all fixed dates which occur on the 3rd Friday after the Easter
          Sunday's date.

        * E.g. 'gcal -c@e-3fri' displays all fixed dates which occur on
          the 3rd Friday before the Easter Sunday's date.

'l@e[+|-]NWWW'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on N'th weekday WWW relative to the Easter
     Sunday's date of the actual year; the intensity level is the same
     as the '-cy' option.

        * E.g. 'gcal -cl@e3fri' respectively 'gcal -cl@e+3fri' displays
          a list of all fixed dates which start on the 18th February and
          end on the 3rd Friday after the Easter Sunday's date.

        * E.g. 'gcal -cl@e-3fri' displays a list of all fixed dates
          which start on the 18th February and end on the 3rd Friday
          before the Easter Sunday's date.

'@t[[+|-]N]'
     Single date of day N relative to today's date of the actual year;
     the intensity level is the same as the simple '-c' option.

        * E.g. 'gcal -c@t' displays all fixed dates which occur on
          today's date (== 'gcal -c').

        * E.g. 'gcal -c@t10' respectively 'gcal -c@t+10' displays all
          fixed dates which occur 10 days after today's date (== 'gcal
          -c10+').

        * E.g. 'gcal -c@t-10' displays all fixed dates which occur 10
          days before today's date (== 'gcal -c10-').

'l@t[[+|-]N]'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on N'th day relative to today's date of the
     actual year; the intensity level is the same as the '-cy' option.

        * E.g. 'gcal -cl@t' displays nothing.

        * E.g. 'gcal -cl@t10' respectively 'gcal -cl@t+10' displays a
          list of all fixed dates which start on the 18th February and
          end 10 days after today's date (== 'gcal -cl10+').

        * E.g. 'gcal -cl@t-10' displays a list of all fixed dates which
          start on the 18th February and end 10 days before today's date
          (== 'gcal -cl10-').

'@t[+|-]NWWW'
     Single date of N'th weekday WWW relative to today's date of the
     actual year; the intensity level is the same as the simple '-c'
     option.

        * E.g. 'gcal -c@t3fri' respectively 'gcal -c@t+3fri' displays
          all fixed dates which occur on the 3rd Friday after today's
          date.

        * E.g. 'gcal -c@t-3fri' displays all fixed dates which occur on
          the 3rd Friday before today's date.

'l@t[+|-]NWWW'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on N'th weekday WWW relative to today's date
     of the actual year; the intensity level is the same as the '-cy'
     option.

        * E.g. 'gcal -cl@t3fri' respectively 'gcal -cl@t+3fri' displays
          a list of all fixed dates which start on the 18th February and
          end on the 3rd Friday after today's date.

        * E.g. 'gcal -cl@t-3fri' displays a list of all fixed dates
          which start on the 18th February and end on the 3rd Friday
          before today's date.

'@DVAR[[+|-]N]'
     Single date of the day N relative to that date of the actual year,
     which is referenced by the date variable DVAR; the intensity level
     is the same as the simple '-c' option.

        * E.g. 'gcal -v a=0422 -c@a' displays all fixed dates which
          occur on the 22nd April.

        * E.g. 'gcal -v a=0422 -c@a10' respectively 'gcal -v a=0422
          -c@a+10' displays all fixed dates which occur 10 days after
          the 22nd April.

        * E.g. 'gcal -v a=0422 -c@a-10' displays all fixed dates which
          occur 10 days before the 22nd April.

'l@DVAR[[+|-]N]'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on the N'th day relative to that date of the
     actual year, which is referenced by the date variable DVAR; the
     intensity level is the same as the '-cy' option.

        * E.g. 'gcal -v a=0422 -cl@a' displays a list of all fixed dates
          which start on the 18th February and end on the 22nd April.

        * E.g. 'gcal -v a=0422 -cl@a10' respectively 'gcal -v a=0422
          -cl@a+10' displays a list of all fixed dates which start on
          the 18th February and end 10 days after the 22nd April.

        * E.g. 'gcal -v a=0422 -cl@a-10' displays a list of all fixed
          dates which start on the 18th February and end 10 days before
          the 22nd April.

'@DVAR[+|-]NWWW'
     Single date of the N'th weekday WWW relative to that date of the
     actual year, which is referenced by the date variable DVAR; the
     intensity level is the same as the simple '-c' option.

        * E.g. 'gcal -v a=0122 -c@a2sat' respectively 'gcal -v a=0122
          -c@a+2sat' displays all fixed dates which occur on the 2nd
          Saturday after the 22nd January.

        * E.g. 'gcal -v a=0122 -c@a-2sat' displays all fixed dates which
          occur on the 2nd Saturday before the 22nd January.

'l@DVAR[+|-]NWWW'
     List dates starting yesterday or tomorrow (depending on the value
     given in N) and ending on the N'th weekday WWW relative to that
     date of the actual year, which is referenced by the date variable
     DVAR; the intensity level is the same as the '-cy' option.

        * E.g. 'gcal -v a=0122 -cl@a2sat' respectively 'gcal -v a=0122
          -cl@a+2sat' displays a list of all fixed dates which start on
          the 2nd Saturday after the 22nd January and end on the 16th
          February.

        * E.g. 'gcal -v a=0122 -cl@a-2sat' displays a list of all fixed
          dates which start on the 2nd Saturday before the 22nd January
          and end on the 16th February.

't|T'
'--tomorrow' long-style option
     List dates related to tomorrow.

        * E.g. 'gcal -ct' displays all fixed dates which occur on the
          18th February (tomorrow).

        * E.g. 'gcal -cdt' displays all fixed dates which occur on the
          17th February (today) and on the 18th February (tomorrow).

'w|W[+|-]'
'--week' long-style option
'--end-of-week' long-style option
'--start-of-week' long-style option
     Display dates related to the week.
     *Note Calendar option '--starting-day=ARGUMENT': x-starting-day.

        * 'w' or '--week' long-style option
          List dates between the _starting day_ of the current week and
          the last day of the current week

             - E.g. 'gcal -cw' displays all fixed dates which occur in
               the whole week the 17th February is part of.

        * 'w+' or '--end-of-week' long-style option
          List dates between the day after the current day of the
          current week and the last day of the current week.

             - E.g. 'gcal -cw+' displays all fixed dates which start on
               the 18th February (tomorrow) and end on the last day of
               the week.

             - E.g. 'gcal -cdw+' displays all fixed dates which start on
               the 17th February (today) and end on the last day of the
               week.

        * 'w-' or '--start-of-week' long-style option
          List dates between the _starting day_ of the current week and
          the day before the current day of the current week

             - E.g. 'gcal -cw-' displays all fixed dates which start on
               the first day of the week and end on the 16th February
               (yesterday).

             - E.g. 'gcal -cdw-' displays all fixed dates which start on
               the first day of the week and end on the 17th February
               (today).

'm|M[+|-]'
'--month' long-style option
'--end-of-month' long-style option
'--start-of-month' long-style option
     Display dates related to the month.

        * 'm' or '--month' long-style option
          List dates between the first day of the current month and the
          last day of the current month.

             - E.g. 'gcal -cm' displays all fixed dates which occur in
               the whole month of February.

        * 'm+' or '--end-of-month' long-style option
          List dates between the day after the current day of the
          current month and the last day of the current month.

             - E.g. 'gcal -cm+' displays all fixed dates which start on
               the 18th February (tomorrow) and end on the last day of
               the month February.

             - E.g. 'gcal -cdm+' displays all fixed dates which start on
               the 17th February (today) and end on the last day of the
               month February.

        * 'm-' or '--start-of-month' long-style option
          List dates between the first day of the current month and the
          day before the current day of the current month.

             - E.g. 'gcal -cm-' displays all fixed dates which start on
               the first day of the month February and end on the 16th
               February (yesterday).

             - E.g. 'gcal -cdm-' displays all fixed dates which start on
               the first day of the month February and end on the 17th
               February (today).

'y|Y[+|-]'
'--year' long-style option
'--end-of-year' long-style option
'--start-of-year' long-style option
     Display dates related to the year.

        * 'y' or '--year' long-style option
          List dates between the first day of the current year and the
          last day of the current year.

             - E.g. 'gcal -cy' displays all fixed dates which occur in
               the whole year.

        * 'y+' or '--end-of-year' long-style option
          List dates between the day after the current day of the
          current year and the last day of the current year.

             - E.g. 'gcal -cy+' displays all fixed dates which start on
               the 18th February (tomorrow) and end on the last day of
               the year.

             - E.g. 'gcal -cdy+' displays all fixed dates which start on
               the 17th February (today) and end on the last day of the
               year.

        * 'y-' or '--start-of-year' long-style option
          List dates between the first day of the current year and the
          day before the current day of the current year.

             - E.g. 'gcal -cy-' displays all fixed dates which start on
               the first day of the year and end on the 16th February
               (yesterday).

             - E.g. 'gcal -cdy-' displays all fixed dates which start on
               the first day of the year and end on the 17th February
               (today).


File: gcal.info,  Node: Fixed date options-Footnotes,  Up: Fixed date options

   (1) Except the date variable E which is internally reserved for the
Easter Sunday's date, so it cannot be assigned or operated therefore.
And except the date variable T which is internally reserved for today's
date, so it likewise cannot be assigned or operated.

   (2) Or another global date variable name which is already defined,
but *no* date given in the 'e|t|DVAR[+|-]N[WWW]', 'MMWWWN', or the
'*d|wN[WWW]' format.

   (3) 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.

   (4) Correct, the '--time-offset' option has multiple modes of
operation that are depending on the context of its use!

   (5) Except Gcal's line break-up characters '~' and '^', so you have
to use '\~' and '\\^' in the PATTERN argument if you want to search
texts which contain these characters.

   (6) This means, exclusive the '--include-today' option respectively
'd' modifier, the '--list-mode' option or the 'l' modifier, and the
'--leap-day=february|march' option.

   (7) Respectively their according long-style options.

   (8) Or their according alias names, like '--today', '--tomorrow'...

   (9) Or their according long-style options.

   (10) 'RC_GROUP_SEP' "" == empty line only.

   (11) Only if the '--alternative-format' option or the 'A' modifier is
not given.

   (12) The 29th February.

   (13) That is either the 51st, 52nd or 53rd Sunday.

   (14) That is either the 51st, 52nd or 53rd Sunday.

   (15) That is either the Sunday of the 51st, 52nd or 53rd week.

   (16) That is either the Sunday of the 51st, 52nd or 53rd week.


File: gcal.info,  Node: Response file,  Next: Actual date modifier,  Prev: Options,  Up: Command line arguments

3.1.2 Response file
-------------------

If a '@FILE' command line argument is given, a "response file" by the
name of FILE will be used, i.e. options and commands are preloaded from
that file.  A response FILE may contain options and commands --which are
preloaded by Gcal--, but *no* references to further response files.  If
such references to further response files are found, they are ignored.
*Note Global option '--response-file=NAME': x-response-file, for hints
how to generate a response file automatically.

  The searching scheme for a response file is the same as that for
resource files, except *no* standard response file is respected.  *Note
File searching mechanism: x-File-searching-mechanism, for more details.
Multiple response files may be given in the command line when Gcal is
started, and they are processed exactly in that order as given, i.e.
strictly sequential.

  Each option and command must be on a single line, i.e. separated by a
real '\n' (newline) character.  A line beginning with a ';' (semicolon)
character in the response file is treated as a remark and will not be
used by Gcal (*note Comment line::).

  Options must be defined before commands.  If a response file contains
any commands, then all further arguments after the '@FILE' option of the
command line are ignored.

For example:

  1. Contents of response file 'file':

          Line     Text
          1        -j
          2        -Cw
          EOF

          $ gcal -i -b 3 @file -s 3 1994

          ==> gcal -i -b 3 -j -Cw -s 3 1994

  2. Contents of response file 'file':

          Line     Text
          1        -j
          2        -Cw
          3        may 1992
          EOF

          $ gcal -i -b 3 @file -s 3 1994

          ==> gcal -i -b 3 -j -Cw may

  3. Contents of response file 'file':

          Line     Text
          1        -j
          2        -Cw
          3        may
          4        1992
          EOF

          $ gcal -i -b 3 @file -s 3 1994

          ==> gcal -i -b 3 -j -Cw may 1992


File: gcal.info,  Node: Actual date modifier,  Next: Commands,  Prev: Response file,  Up: Command line arguments

3.1.3 Actual date modifier
--------------------------

It is allowed to use that date --instead of the actual system date--
which is defined by the '%DATE' command line argument.  This means,
fixed dates can be checked for *any* year and are respected in the same
way, as if they would be fixed dates of the actual year.

  The date must be denoted in one of these formats:

   * 'YYYY[MM[DD|WWWN]]'

   * 'YYYY*d|wN[WWW]'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]'

   * 'MONTH NAME[DD]'

   * 'WEEKDAY NAME[N]'

   * DD

Some examples to this:

     *Please note:*
     The following examples assumes the actual system date is
     *Wednesday, the 17th February 1993* (19930217), weeks start on
     Mondays and ISO week numbers are used!

The 'YYYY[MM[DD|WWWN]]' format:

        * 'gcal %1994' (== YYYY)
          The actual date is set to the date 17th February 1994
          => 19940217.

        * 'gcal %1994Mar'

        * 'gcal %19943'

        * 'gcal %199403' (== YYYYMM)
          The actual date is set to the date 17th March 1994
          => 19940317.

        * 'gcal %1994Mar3'

        * 'gcal %1994033'

        * 'gcal %19940303' (== YYYYMMDD)
          The actual date is set to the date 3rd March 1994 => 19940303.

        * 'gcal %1994MarWed3'

        * 'gcal %199403wed3' (== YYYYMMWWWN)
          The actual date is set to the date 3rd Wednesday in March 1994
          (N == '1...5|9') => 19940316.

        * 'gcal %0'

        * 'gcal %00'

        * 'gcal %000'

        * 'gcal %0000' (== YYYY)
          The actual date remains unchanged => 19930217.

        * 'gcal %0000Mar'

        * 'gcal %00003'

        * 'gcal %000003' (== YYYYMM)
          The actual date is set to the date 17th March 1993
          => 19930317.

        * 'gcal %0000Mar3'

        * 'gcal %0000033'

        * 'gcal %00000303' (== YYYYMMDD)
          The actual date is set to the date 3rd March 1993 => 19930303.

        * 'gcal %0000MarWed3'

        * 'gcal %000003wed3' (== YYYYMMWWWN)
          The actual date is set to the date 3rd Wednesday in March 1993
          (N == '1...5|9') => 19930317.

The 'YYYY*d|wN[WWW]' format:

        * 'gcal %1994*d10' (== 'YYYY*dN')
          The actual date is set to the date 10th absolute day in 1994
          (N == '1...365|366|999') => 19940110.

        * 'gcal %1994*d10sun' (== 'YYYY*dNWWW')
          The actual date is set to the date 10th Sunday in 1994
          (N == '1...51|52|53|99') => 19940306.

        * 'gcal %0*d10' (== 'YYYY*dN')
          The actual date is set to the date 10th absolute day in 1993
          => 19930110.

        * 'gcal %0*d10sun' (== 'YYYY*dNWWW')
          The actual date is set to the date 10th Sunday in 1993
          => 19930307.

        * 'gcal %1994*w10' (== 'YYYY*wN')
          The actual date is set to the date Monday of the 10th week in
          1994
          (N == '0|1...52|53|99') => 19940307.

        * 'gcal %1994*w10sun' (== 'YYYY*wNWWW')
          The actual date is set to the date Sunday of the 10th week in
          1994 => 19940313.

        * 'gcal %0*w10' (== 'YYYY*wN')
          The actual date is set to the date Monday of the 10th week in
          1993 => 19930308.

        * 'gcal %0*w10sun' (== 'YYYY*wNWWW')
          The actual date is set to the date Sunday of the 10th week in
          1993 => 19930314.

The 'YYYY@e|t|DVAR[[+|-]N[WWW]]' format:

        * 'gcal %1994@e' (== 'YYYY@e')
          The actual date is set to the date Easter Sunday 1994
          => 19940403.

        * 'gcal %1994@e10'

        * 'gcal %1994@e+10' (== 'YYYY@e[+]N')
          The actual date is set to the date 10 days after Easter Sunday
          1994 => 19940413.

        * 'gcal %1994@e-10' (== 'YYYY@e-N')
          The actual date is set to the date 10 days before Easter
          Sunday 1994 => 19940324.

        * 'gcal %0@e'

        * 'gcal %00@e'

        * 'gcal %000@e'

        * 'gcal %0000@e' (== 'YYYY@e')
          The actual date is set to the date Easter Sunday 1993
          => 19930411.

        * 'gcal %0@e10'

        * 'gcal %0@e+10' (== 'YYYY@e[|]N')
          The actual date is set to the date 10 days after Easter Sunday
          1993 => 19930421.

        * 'gcal %0@e-10' (== 'YYYY@e-N')
          The actual date is set to the date 10 days before Easter
          Sunday 1993 => 19930401.

        * 'gcal %1994@e3Wed'

        * 'gcal %1994@e+3Wed' (== 'YYYY@e[+]NWWW')
          The actual date is set to the date 3rd Wednesday after Easter
          Sunday 1994 => 19940420.

        * 'gcal %1994@e-3wed' (== 'YYYY@e-NWWW')
          The actual date is set to the date 3rd Wednesday before Easter
          Sunday 1994 => 19940316.

        * 'gcal %0@e3wed'

        * 'gcal %0@e+3wed' (== 'YYYY@e[+]NWWW')
          The actual date is set to the date 3rd Wednesday after Easter
          Sunday 1993 => 19930428.

        * 'gcal %0@e-3we' (== 'YYYY@e-NWWW')
          The actual date is set to the date 3rd Wednesday before Easter
          Sunday 1993 => 19930324.

        * 'gcal %1994@t' (== 'YYYY@t')
          The actual date is set to today's date in 1994 => 199400217.

        * 'gcal %1994@t10'

        * 'gcal %1994@t+10' (== 'YYYY@t[+]N')
          The actual date is set to the date 10 days after today's date
          in 1994 => 19940227.

        * 'gcal %1994@t-10' (== 'YYYY@e-N')
          The actual date is set to the date 10 days before today's date
          in 1994 => 19940207.

        * 'gcal %0@t'

        * 'gcal %00@t'

        * 'gcal %000@t'

        * 'gcal %0000@t' (== 'YYYY@t')
          The actual date is set to today's date => 19930217.

        * 'gcal %0@t10'

        * 'gcal %0@t+10' (== 'YYYY@t[|]N')
          The actual date is set to the date 10 days after today's date
          => 19930227.

        * 'gcal %0@t-10' (== 'YYYY@t-N')
          The actual date is set to the date 10 days before today's date
          => 19930207.

        * 'gcal %1994@t3Wed'

        * 'gcal %1994@t+3Wed' (== 'YYYY@t[+]NWWW')
          The actual date is set to the date 3rd Wednesday after today's
          date in 1994 => 19940309.

        * 'gcal %1994@t-3wed' (== 'YYYY@t-NWWW')
          The actual date is set to the date 3rd Wednesday before
          today's date in 1994 => 19940302.

        * 'gcal %0@t3wed'

        * 'gcal %0@t+3wed' (== 'YYYY@t[+]NWWW')
          The actual date is set to the date 3rd Wednesday after today's
          date => 19930310.

        * 'gcal %0@t-3we' (== 'YYYY@t-NWWW')
          The actual date is set to the date 3rd Wednesday before
          today's date => 19930127.

        * 'gcal -v a=0303 %1994@a' (== 'YYYY@DVAR')
          The actual date is set to the date 3rd March 1994 => 19940303.

        * 'gcal -v a=0303 %1994@a10'

        * 'gcal -v a=0303 %1994@a+10' (== 'YYYY@DVAR[+]N')
          The actual date is set to the date 10 days after 3rd March
          1994 => 19940313.

        * 'gcal -v a=0303 %1994@a-10' (== 'YYYY@DVAR-N')
          The actual date is set to the date 10 days before 3rd March
          1994 => 19940221.

        * 'gcal -v a=0303 %0@a' (== 'YYYY@DVAR')
          The actual date is set to the date 3rd March 1993 => 19930303.

        * 'gcal -v a=0303 %0@a10'

        * 'gcal -v a=0303 %0@a+10' (== 'YYYY@DVAR[+]N')
          The actual date is set to the date 10 days after 3rd March
          1993 => 19930313.

        * 'gcal -v a=0303 %0@a-10' (== 'YYYY@DVAR-N')
          The actual date is set to the date 10 days before 3rd March
          1993 => 19930221.

        * 'gcal -v a=0303 %1994@a3wed'

        * 'gcal -v a=0303 %1994@a+3wed' (== 'YYYY@DVAR[+]NWWW')
          The actual date is set to the date 3rd Wednesday after 3rd
          March 1994 => 19940323.

        * 'gcal -v a=0303 %1994@a-3wed' (== 'YYYY@DVAR-NWWW')
          The actual date is set to the date 3rd Wednesday before 3rd
          March 1994 => 19940216.

        * 'gcal -v a=0303 %0@a3wed'

        * 'gcal -v a=0303 %0@a+3wed' (== 'YYYY@DVAR[+]NWWW')
          The actual date is set to the date 3rd Wednesday after 3rd
          March 1993 => 19930324.

        * 'gcal -v a=0303 %0@a-3wed' (== 'YYYY@DVAR-NWWW')
          The actual date is set to the date 3rd Wednesday before 3rd
          March 1993 => 19930210.

The 'MONTH NAME[DD]' format:

        * 'gcal %April' (== MONTH NAME)
          The actual date is set to the date 17th April 1993
          => 19930417.

        * 'gcal %april3'

        * 'gcal %april03' (== MONTH NAME DD)
          The actual date is set to the date 3rd April 1993 => 19930403.

The 'WEEKDAY NAME[N]' format:

        * 'gcal %Friday' (== WEEKDAY NAME)
          The actual date is set to the date Friday of current week in
          February 1993 => 19930219.

        * 'gcal %Friday2'

        * 'gcal %Friday02' (== WEEKDAY NAME N)
          The actual date is set to the date 2nd Friday in February 1993
          (N == '1...5|9') => 19930212.

The DD format:

        * 'gcal %3'

        * 'gcal %03' (== DD)
          The actual date is set to the date 3rd February 1993
          => 19930203.


File: gcal.info,  Node: Commands,  Prev: Actual date modifier,  Up: Command line arguments

3.1.4 Commands
--------------

* Menu:

* Single commands::        How to use a Single command.
* 3-Month mode commands::  How to use a 3-Month mode command.
* Lists of commands::      How to use a List of commands.
* Ranges of commands::     How to use a Range of commands.

The commands control the periods Gcal respects.  They can be partitioned
into four major classes, namely "single" commands, special "3-Month
mode" commands, "lists" of commands and "ranges" of commands.  Single
commands and special 3-Month mode commands only create *one* calendar
sheet, ranges of commands or list of commands create *more than one*
calendar sheet per program run.  If a list of commands is given, Gcal
works sequentially on each single command given in the list, one by one.
A range of commands is expanded first by Gcal and after expansion is
done, Gcal works sequentially on each single command produced during the
internal expansion step.

  For understanding the notation used in the text below, MM is either a
number, a month name or one of the special 3-Month mode commands '.',
'..', '.+' and '.-'.  No lists or ranges of months or years can be
created in case a special 3-Month mode command is given.

  The range of MM is valid from 1 to 12 or valid from January to
December.  Both notations may be mixed.  Month names may be abbreviated
up to their first three characters.  YYYY is a number.  The range of
YYYY is valid from 1 to 9999.  A range ('MM-MM' or 'YYYY+YYYY' or ...)
must consist of two elements.  A list ('MM,...,MM' or 'YYYY;...;YYYY' or
...) must contain two elements minimum and may have any number of
elements.

Here is a list of all ranges of commands, lists of commands and other
command separator characters:

   * The '-' character is the _range of months_ separator.

   * The ',' character is the _list of months_ separator.

   * The '+' character is the _range of years_ separator.

   * The ';' character is the _list of years_ separator.

   * The '/' character is the _month of year_ separator.

   * The ':' character is the _fiscal year_ separator.


File: gcal.info,  Node: Single commands,  Next: 3-Month mode commands,  Prev: Commands,  Up: Commands

3.1.4.1 Single commands
.......................

'NOTHING'
     Current month of current year, called "single month mode" in the
     further context.

'MONTH NAME'
     Selected month of current year, e.g.:

          gcal may
          gcal OCTOBER
          gcal ja

'YYYY'
     Selected year, called "single year mode" in the further context,
     e.g.:

          gcal 1992

     But there is an exception of this general rule.  If the specified
     year number is less or equal twelve, Gcal assumes that a selected
     month of the current year is wanted.  If you want to have a
     selected year less or equal twelve, call Gcal like this

          gcal 1:6

     or like this

          gcal 6+6

     to obtain the year AD 6.

'MM YYYY'
'MM/YYYY'
     Single month of selected year, e.g.:

          gcal 9 1992
          gcal 9/1992
          gcal Nov 1777
          gcal Nov/1777

':'
     Single fiscal year, starting on the _actual month_ of the _actual
     year_ and ending on month _actual month_-1 of the _actual year_+1,
     called "implicit fiscal year" in the further context, e.g.:

          gcal :

'MM:'
     Single fiscal year, starting on month MM of the _actual year_ and
     ending on month MM-1 of the _actual year_+1, called "explicit
     fiscal year" in the further context, e.g.:

          gcal 6:
          gcal feb:
          gcal NOVEMBER:

':YYYY'
     Single fiscal year, starting on the _actual month_ of year YYYY and
     ending on month _actual month_-1 of year YYYY+1, also called
     "explicit fiscal year" in the further context, e.g.:

          gcal :1999

'MM:YYYY'
     Single fiscal year, starting on month MM of year YYYY and ending at
     month MM-1 of year YYYY+1, called "explicit fiscal year" too in the
     further context, e.g.:

          gcal 7:1999
          gcal oct:1992
          gcal February:1777


File: gcal.info,  Node: 3-Month mode commands,  Next: Lists of commands,  Prev: Single commands,  Up: Commands

3.1.4.2 3-Month mode commands
.............................

'.'
     Previous, actual and next month of the current year, e.g.:

          gcal .

'. YYYY'
     Previous, actual and next month of selected year, e.g.:

          gcal . 1992

'..'
     Actual quarter of the current year, e.g.:

          gcal ..

'.. YYYY'
     Actual quarter of selected year, e.g.:

          gcal .. 1992

'.+'
     Actual and next two months of the current year, e.g.:

          gcal .+

'.+ YYYY'
     Actual and next two months of selected year, e.g.:

          gcal .+ 1992

'.-'
     Actual and previous two months of the current year, e.g.:

          gcal .-

'.- YYYY'
     Actual and previous two months of selected year, e.g.:

          gcal .- 1992


File: gcal.info,  Node: Lists of commands,  Next: Ranges of commands,  Prev: 3-Month mode commands,  Up: Commands

3.1.4.3 Lists of commands
.........................

'MM,...,MM'
     List of specified months of the current year, e.g.:

          gcal 1,5,12
          gcal 3,1,5,3
          gcal june,9,jan

'MM/YYYY,...,MM/YYYY'
     List of months in specified year, e.g.:

          gcal 1/1992,5,12/2001
          gcal june/1991,9/1801,jan

'MM,...,MM YYYY'
     List of specified months of selected year, e.g.:

          gcal 3,7 1999
          gcal 1,dec,july 1777

'YYYY;...;YYYY'
     List of specified years, e.g.:

          gcal 1992;1777;1899

'MM:YYYY;...;MM:YYYY'
     List of specified fiscal years, e.g.:

          gcal 7:1999;8:1992;April:3

*Other valid lists:*

'MM,MM/YYYY,...'
     Mixed list of months consisting of: 'MM MM/YYYY'

          gcal 6,8,3/1999,feb/3,january

'MM:;MM:YYYY;...'
     Mixed list of fiscal years of the given / actual year consisting
     of: 'MM: :YYYY MM:YYYY YYYY'

          gcal 3:;1994;february:1999;:1777;JAN:

'MM:;MM:;...'
     List of fiscal years of the actual year consisting of: 'MM:'

          gcal 3:;august:;DEC:


File: gcal.info,  Node: Ranges of commands,  Prev: Lists of commands,  Up: Commands

3.1.4.4 Ranges of commands
..........................

'MM-MM'
     Range of current months, e.g.:

          gcal 3-7
          gcal 11-8
          gcal MAY-dec
          gcal 12-aug

'MM/YYYY-MM/YYYY'
     Range of months of year, e.g.:

          gcal 3/1991-july/1992
          gcal dec/1994-3
          gcal sep-dec/2000

'MM-MM YYYY'
     Range of specified months of selected year, e.g.:

          gcal 3-7 1999
          gcal nov-3 1777
          gcal aug-dec 1992

'MM-MM YYYY+YYYY'
     Range of specified months of selected years, e.g.:

          gcal 3-7 1999+2001
          gcal nov-3 1777+1600
          gcal aug-dec 1992+1994

'MM YYYY-YYYY'
'MM/YYYY-YYYY'
     Range of specified month of selected years, e.g.:

          gcal AUGUST 1494-1497
          gcal 3/1993-1999
          gcal nov/3-1777

'YYYY+YYYY'
     Range of specified years, e.g.:

          gcal 1992+1994

'MM:YYYY+MM:YYYY'
     Range of specified fiscal years, e.g.:

          gcal 7:1999+8:1992
          gcal aug:1992+july:1999


File: gcal.info,  Node: The GCAL environment variable,  Prev: Command line arguments,  Up: Invoking Gcal

3.2 The 'GCAL' environment variable
===================================

The environment variable 'GCAL' can hold a set of default options for
Gcal (*note Environment Variable 'GCAL': x-GCAL.).  These options are
interpreted first at program start-up, and some can be overwritten by
explicit command line arguments or values found in a '@FILE' response
file.  *Note Command line arguments::, and *note Response file::, for
further information.

For example:

   * for *sh*:
          GCAL="-i @color -b 3"; export GCAL

   * for *csh*:
          setenv GCAL "-i @color -b 3"

   * for *MS-DOS*:
          set GCAL=-i @color -b 3

  On Vax/VMS, the name of the environment variable is 'GCAL_OPT', to
avoid a conflict with the symbol 'GCAL' set for invocation of the
program.

For example:

   * for *VMS*:
          define GCAL_OPT "-i @color -b 3"


File: gcal.info,  Node: Eternal Holidays,  Next: Fixed Dates,  Prev: Invoking Gcal,  Up: Top

4 Eternal Holidays
******************

The _eternal holiday list_ is created only for dates after AD 29.  It is
assumed that the Gregorian Reformation has occurred from 10th till 22nd
March 1924 for all Christian-Orthodox holidays, which are inserted into
the _eternal holiday list_.

  The _eternal holiday list_ can be displayed in different ways:

  If you start Gcal without an explicit (fiscal) date and the _eternal
holiday list_ argument (*note Calendar option
'--holiday-list[=long|short]': x-holiday-list.), e.g.:

     gcal -qfr --holiday-list
     gcal -qfr -n
     gcal -qfr -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 -qbe --holiday-list july
     gcal -qbe -n july
     gcal -qbe -n 7 1993
     gcal -qbe -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).

  If you start Gcal with the _eternal holiday list_ argument and a
simple year (or an explicit fiscal year), e.g.:

     gcal -qbe --holiday-list 1993
     gcal -qbe -n 1993
     gcal -qbe -n july:
     gcal -qbe -n :1993
     gcal -qbe -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 (*note 3-Month mode commands::), e.g.:

     gcal -qbe --holiday-list .
     gcal -qbe -n .
     gcal -qbe -n ..
     gcal -qbe -n .+
     gcal -qbe -n .-

Gcal displays the according three months by using a fixed-style year
calendar sheet, and trailing all holidays of the eternal holiday list
that refer to 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.  *Note Lists of commands::, and *note Ranges of
commands::, for further 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 lead its
date:

*Character*   *Description*
 
'+'           Legal holiday which is valid in the whole country.  Is
              automatically provided with highlighting sequences
              respectively marking characters.
'#'           Legal holiday which is valid in major parts of the whole
              country.  Is automatically provided with highlighting
              sequences respectively marking characters.
'*'           Legal holiday which is valid in minor parts of the whole
              country.  Is not provided with highlighting sequences
              respectively marking characters.
'-'           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.  *Note Calendar option '--cc-holidays=CC[+...]': x-cc-holidays.
For example:

     --cc-holidays=be+fr

causes the inclusion of Belgian and French holidays into the eternal
holiday list.  The inclusion of country specific holidays is not coupled
to Gcal's internationalization (*note Aspects in Internationalization:
Internationalization.).  This means, no country specific holidays are
automatically respected at program start-up for a definite territory or
country.  So it is up to the user to decide which country specific
holidays are included into the eternal holiday list.  *Note The 'GCAL'
environment variable: The GCAL environment variable, for information 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 information of a definite territory or
country is required.  Assuming a business man from Germany proposes to
travel to Italy in November and needs the information which legal
holidays are celebrated there on working days so he is able to plan his
dates.  This can be determined as follows:

     gcal -f /dev/null -q IT -D r -cE nov


File: gcal.info,  Node: Fixed Dates,  Next: Todays Calendar,  Prev: Eternal Holidays,  Up: Top

5 Fixed Dates
*************

* Menu:

* Resource file::           How to use a Resource file.
* Resource file examples::  Examples of Resource file entries.

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 (*note 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.  *Note 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 (*note Calendar option '--blocks=NUMBER': x-blocks.),
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 (*note Actual date modifier::), and on the other hand,
if a command respectively a _list_ or _range_ of commands is used.

For example:

'gcal -qbe -c -n- 1993'
     Lists all fixed dates of entire 1993 in ascending order, and the
     eternal holiday list of entire 1993 in descending order; the
     intensity level is the same as the '-cy' option.

'gcal -c- july:1993'
     Lists all fixed dates of fiscal year --starting in July 1993 and
     ending in June 1994-- in descending order; the intensity level is
     the same as the '-cy' option.

'gcal -qbe -ce july 1993'
     Lists all fixed dates of July 1993 inclusive all eternal holidays
     merged into this list in ascending order; the intensity level is
     the same as the '-cm' option.

'gcal -qbe -c-e -n 1993+1996'
     Lists all fixed dates of entire 1993, 1994, 1995 and 1996 (series
     of years) inclusive all eternal holidays merged into this list in
     descending order, and the eternal holiday list related to all above
     years in ascending order; the intensity level is the same as the
     '-cy' option.

'gcal -cm %19920317'
     Lists all fixed dates of March 1992 in ascending order.

'gcal -qbe %1994@e -n -c'
     Lists all fixed dates of Easter Sunday 1994 in ascending order, and
     the eternal holiday list of entire 1994 in ascending order.


File: gcal.info,  Node: Resource file,  Next: Resource file examples,  Prev: Fixed Dates,  Up: Fixed Dates

5.1 Resource file
=================

* Menu:

* Structure of resource file::    How to write a Resource file.
* Date part of a line::           How to write the Date part.
* Further date part attributes::  What are Further date part attributes?
* Text part of a line::           How to write the Text part.
* Special Texts processed::       What are '%?'... Special Texts?
* Comment line::                  What is a Comment line?
* Include directives::            What are Include directives.
* Date variables::                How Date variables can be used.
* Text variables::                How Text variables can be used.

This section describes how to use a "resource file" that contains fixed
dates and appointments.  The name of the standard resource file is
'HOME/.gcalrc'(1) (*note Resource file-Footnote-1::).

Gcal uses a special file searching mechanism:

  1. The Gcal program scans the file directories which are referenced in
     the environment variable 'GCALPATH' (*note Environment Variable
     'GCALPATH': x-GCALPATH.) to find the standard resource file.  The
     'GCALPATH' environment variable contains a (':') colon-separated(2)
     (*note Resource file-Footnote-2::) list of file directories.  If no
     such environment variable is defined and set, Gcal omits this step.

  2. If the above action fails, Gcal looks for the standard resource
     file in the file directory which is referenced in the environment
     variable 'HOME'.  If no 'HOME' environment variable is defined and
     set, Gcal also omits this step.  *Note Environment Variable 'HOME':
     x-HOME.

  3. If the above action fails, Gcal inspects the _user data_ file
     directory(3) (*note Resource file-Footnote-3::) to find the
     standard resource file.  This file directory is a file directory
     relative to the 'HOME' file directory.  If an environment variable
     'GCAL_USR_DATADIR' is set, Gcal appends the contents of this
     environment variable to the contents of the 'HOME' environment
     variable, and tries to use this file directory instead of using the
     burned-in default name of this file directory (*note Environment
     Variable 'GCAL_USR_DATADIR': x-GCAL_USR_DATADIR.).  If no 'HOME'
     environment variable is defined and set, Gcal of course also omits
     this step.

  4. If all above actions fail, Gcal inspects the _system data_ file
     directory(4) (*note Resource file-Footnote-4::) to find the
     standard resource file.  This file directory is a file directory
     absolute to the _root_/$PREFIX file directory.  If an environment
     variable 'GCAL_SYS_DATADIR' is set, Gcal tries to use this file
     directory instead of using the burned-in default name of this file
     directory (*note Environment Variable 'GCAL_SYS_DATADIR':
     x-GCAL_SYS_DATADIR.).

  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.  *Note Error Code
118: x-118-Error-code, and *note Global option '--debug=abort':
x-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.  *Note Fixed date option
'--resource-file=NAME': x-resource-file.

Annotation:

  An "extended file name" contains one ore more '/' (slash)
characters(5) (*note Resource file-Footnote-5::) 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:

   * In case file NAME is found, Gcal will use it.

   * In case file NAME is not found, Gcal will not use it.

  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:

   * Gcal tries to find this file NAME by using the previously explained
     file searching mechanism.


File: gcal.info,  Node: Resource file-Footnotes,  Up: Resource file

   (1) On MS-DOS, OS/2 and some other operating systems, the name of the
_standard resource file_ is 'HOME/gcalrc' (without a leading '.').

   (2) On MS-DOS, OS/2 and some other operating systems, another
character will be used, e.g. ';' on MS-DOS and OS/2.

   (3) Normally 'HOME/share/gcal'.

   (4) Normally '/usr/local/share/gcal' or '$PREFIX/share/gcal'.

   (5) Operating systems like MS-DOS or OS/2 use the '\' (Backslash)
character for separating a file directory from a file name.


File: gcal.info,  Node: Structure of resource file,  Next: Date part of a line,  Prev: Resource file,  Up: Resource file

5.1.1 Structure of resource file
--------------------------------

First of all, a Gcal resource file is a plain ASCII text file.  This
text file may be created by any text editor or by redirecting the
_standard output channel_ to a file, e.g.:

     $ echo '19930217 Text'>> resource-file <RET>

  A special --but simple-- line structure is required so Gcal is able to
interpret its contents.  Each fixed date entry in a resource file must
be split into two parts, namely a _date part_ and an optional _text
part_ which *must* be separated by *one* "whitespace"(1) (*note
Structure of resource file-Footnote-1::) character minimum.  It is
unnecessary to give a whitespace separator character if no _text part_
is specified.

  A line must always end with a '\n' (newline) character, except it is
the last line of a resource file.  The maximum length of a line is
limited to 'INT_MAX'(2) (*note Structure of resource file-Footnote-2::)
characters.  A newline character is automatically appended to the line
if the _standard output channel_ is directed to a file.  A newline
character is appended to the typed line in a text editor window if it is
completed by pressing the <RET> key.  In case the used text editor does
not generate the newline character in this way, it should be set to this
mode of operation, otherwise this text editor is useless for creating
Gcal resource files.

The line structure of fixed date entries is:

     DATE PART [ _whitespace_ TEXT PART ] _newline_

or more concrete, e.g.:

     YYYY[MM[DD|WWWN]] [ _whitespace_ TEXT ] _newline_

or much more concrete, e.g.:

     19940217 Hi, I'm the text!

Besides fixed date entries, a resource file may contain further entries
like:

Comments...

     ; A remarked line
     ;     A formatted and multi-line \
           remark

Include directives...

     #include <FILE NAME>
     #include "FILE NAME"

Date variable assignments respectively operations...

     DVAR=NOTHING
     DVAR=MMDD
     DVAR=MMWWWN
     DVAR=*dN[WWW]
     DVAR=*wN[WWW]
     DVAR=DVAR[[+|-]N[WWW]]
     DVAR++
     DVAR--
     DVAR+=[+|-]N
     DVAR-=[+|-]N
     DVAR+=NWWW
     DVAR-=NWWW

Text variable assignments respectively operations...

     TVAR=[TEXT]
     TVAR?[COMMAND]
     TVAR:[COMMAND]
     TVAR++
     TVAR--
     TVAR+=[+|-]N
     TVAR-=[+|-]N

Text variable references...

     TVAR

  Text variable references at the beginning of a Gcal resource file line
may only be used if it is ensured that they are expanded to a valid Gcal
resource file line.


File: gcal.info,  Node: Structure of resource file-Footnotes,  Up: Structure of resource file

   (1) For example _Tab_, _Space_, _Form-feed_ and similar characters.

   (2) Normally, this is for example equivalent to a value of 32,767 ==
(2^15)-1 on a 16-Bit machine architecture; to a value of 2,147,483,648
== (2^31)-1 on a 32-Bit machine architecture etc.


File: gcal.info,  Node: Date part of a line,  Next: Further date part attributes,  Prev: Structure of resource file,  Up: Resource file

5.1.2 Date part of a line
-------------------------

The structure of a "date part" --which gives Gcal the information at
which date a fixed date happens-- of a line in the resource file is

*either*: 'YYYY[MM[DD|WWWN]]'

     'YYYY'
          (4 digits), is the year including the century (range
          '0000...9999').  Leading zeroes are required in case the
          defined year is less than '1000' and other components of the
          date part are trailing the year.

     'MM'
          (2 digits or 3 characters), is the month (range '00...12' or
          '99', respectively 'Jan', 'Feb'...).  A given '99' for the
          month means the last month of the year (== December).  Leading
          zeroes are required in case the defined month is less than
          '10' and other components of the date part are trailing the
          month.

     'DD'
          (2 digits), is the day (range '00...31' or '99').  A given
          '99' for the day means the last day of the month.  Leading
          zeroes are required in case the defined day is less than '10'
          and other components of the date part are trailing the day.

     'WWW'
          (2...3 characters), is a short weekday name (range
          'Mon...Sun').

     'N'
          (1 digit), is the N'th weekday WWW of month (range '1...5' or
          '9').

             * N == '1...5'
               N'th weekday WWW of month.

             * N == '9'
               Last weekday WWW of month.

*or*: 'YYYY*d|wN[WWW]'

     'YYYY'
          (4 digits), is the year including the century (range
          '0000...9999').  Leading zeroes are required in case the
          defined year is less than '1000' and other components of the
          date part are trailing the year.

     '*d'
          (2 characters), is the reference to an ordinary date.

     '*w'
          (2 characters), is either the reference to a date of an ISO
          week or the reference to a date of a standard week.

     'N'
          (1...3 digits), is the value in days or in weeks, the fixed
          date occurs.  A given '99' connected with a short weekday name
          means the last weekday WWW of the year.  A given '999'
          connected with '*d' means the last day of a year, i.e. the
          31st December.  If the computed date does not occur in the
          year, i.e. exceeds the year bounds, the fixed date message is
          suppressed.

     'WWW'
          (2...3 characters), is a short weekday name (range
          'Mon...Sun').

*or*: 'YYYY@e|t|DVAR[[+|-]N]'

     'YYYY'
          (4 digits), is the year including the century (range
          '0000...9999').  Leading zeroes are required in case the
          defined year is less than '1000' and other components of the
          date part are trailing the year.

     '@e'
          (2 characters), is the reference to the Easter Sunday's date.

     '@t'
          (2 characters), is the reference to today's date.

     '@DVAR'
          (2 characters), is the reference to a date variable.

     '[+|-]N'
          (1...4 alphanumeric characters), is the optional displacement
          value in days, the fixed date occurs relative to the Easter
          Sunday's date, relative to today's date, or relative to a date
          variables date.  A given '-999' means the first day of a year,
          i.e. the 1st January.  A given '+999' or '999' means the last
          day of a year, i.e. the 31st December.  If the computed date
          does not occur in the year, i.e. exceeds the year bounds, the
          fixed date message is suppressed.

*or*: 'YYYY@e|t|DVAR[+|-]NWWW'

     'YYYY'
          (4 digits), is the year including the century (range
          '0000...9999').  Leading zeroes are required in case the
          defined year is less than '1000' and other components of the
          date part are trailing the year.

     '@e'
          (2 characters), is the reference to the Easter Sunday's date.

     '@t'
          (2 characters), is the reference to today's date.

     '@DVAR'
          (2 characters), is the reference to a date variable.

     '[+|-]NWWW'
          (3...7 alphanumeric characters), is the optional displacement
          value in weekdays, the fixed date occurs relative to the
          Easter Sunday's date, relative to today's date, or relative to
          a date variables date.  A given '-99' means the first weekday
          WWW of the year.  A given '+99' or '99' means the last weekday
          WWW of the year.  If the computed date does not occur in the
          year, i.e. exceeds the year bounds, the fixed date message is
          suppressed.

*Please note:*

   * If YYYY is specified as '0000', '000', '00' or '0':
     The month and day are assumed to be annual events and the _text
     part_ will be displayed for any year.

   * If MM is not defined or specified as '00' or '0':
     The day is assumed to be a monthly event for the specified year and
     the _text part_ will be displayed for any month.

   * If DD is not defined or specified as '00' or '0':
     Each day is assumed to be a daily event for the specified year and
     month and the _text part_ will be displayed for any day.

   * If WWW is specified as a short (2...3 characters) weekday name:
     The given weekday name is assumed to be a weekly event for the
     specified year and month and the _text part_ will be displayed for
     any week.

*Hint:*
Preceding table ease misleading assumption that a fixed date, which
shall be valid for any days of the year, can be defined with a date part
only consisting of a '0'.  But that is only correct in that the
so-defined fixed date is respected in some few fixed date periods only
(*note Coding Scheme::).

  If a fixed date is defined which shall be respected for any days of
the year, it must be designed with a '0*d1#999' date part.  For example,
the same is likewise valid for fixed dates which represent a weekly
event, and that shall be valid during all the year.  Instead of creating
such a fixed date with a '000000WWW' date part (that is likewise
respected in some few fixed date periods only), it should be defined
with a date part like '0*d1WWW#99WWW.7'.  *Note Ranges of days::, and
*note Appearance factor of days::, for further information.


File: gcal.info,  Node: Further date part attributes,  Next: Text part of a line,  Prev: Date part of a line,  Up: Resource file

5.1.3 Further date part attributes
----------------------------------

* Menu:

* Lists of days::              How Lists of days can be used.
* Ranges of days::             How Ranges of days can be used.
* Repetition factor of days::  How to use such a factor.
* Appearance factor of days::  How to use such a factor.

The date part --which is leading a fixed date text of a Gcal resource
file line-- may be provided with further attributes, that are either
specifications of lists of days or ranges of days, which provide the
information at which date a fixed date happens.  More further attributes
are the repetition factor as well as the appearance factor.

  All of those date parts in a Gcal resource file line, which are
structured as follows, may generally be provided with further
attributes:

   * 'YYYYMM...'

   * 'YYYY*d|w...'

   * 'YYYY@e|t|DVAR...'

*Attention:*
If the date part is supplied with further attributes and the year of the
fixed date is not given in a concrete manner, i.e. the year YYYY is set
to zero, such kinds of fixed dates are *only* computed correctly in
simple year bounds --which means during a current year-- and not in
fixed dates shown after the current year has changed, e.g. in *fiscal
years*.


File: gcal.info,  Node: Lists of days,  Next: Ranges of days,  Prev: Further date part attributes,  Up: Further date part attributes

5.1.3.1 Lists of days
.....................

A list of days is used to define recurrent fixed dates and to use only
one line in the resource file for them, instead of using several lines
in a resource file needed for defining these recurrent fixed dates
separately.

  A list of days is specified by a ',' separator character; it must
contain two elements minimum and may have any number of elements.  A
single element of the list may not be set to a zero value and be not
concrete therefore.  (This would not make any sense in this context.)

  Assuming a fixed date shall always occur on the 1st and the 15th day
in every month of the year 1996, e.g. 'Tax returns', one solution would
be on the one hand a fixed date entry in the resource file for the 1st
of the month and another entry for the 15th of the month, which would be
a total of two entries in the resource file for such a fixed date.

  On the other hand, this expense can be reduced to a total of only one
entry in the resource file by using a list of days, which is likewise
valid for the 1st and the 15th day in every month, that is

     19960001,15 Tax returns

The use of lists of days in the date part is permitted as follows:

   * 'YYYYMMDD|WWW|WWWN,[MM]DD|[MM]WWW|[MM]WWWN ...'

   * 'YYYY*d|wN|NWWW,N|NWWW ...'

   * 'YYYY@e|t|DVAR,|[+|-]N[WWW],[+|-]N[WWW] ...'

Some examples to this:

'000001fr3,12,99,mon,apr14,993,julfri3,08fr'
     In every year in January: on the 3rd Friday, on the 12th, on the
     last day of the month and on every Monday.  And in every year: on
     the 14th April, on the 3rd December, on the 3rd Friday in July and
     on every Friday in August.

'199600mon,fr,12'
     In the year 1996 in every month: on every Monday, on every Friday
     and on the 12th.

'0*d1,1fr,999,17mo'
     In every year: on the first day of the year, on the 1st Friday of
     the year, on the last day of the year and on the 17th Monday of the
     year.

'1996*w1fr,1,17mo,99fr'
     In the year 1996: on Friday of the 1st week, on Monday of the first
     week, on Monday of the 17th week and on Friday of the last week.

'0@a,+1,-3,5,+4fr,2fr,-10sa'
     In every year: on the date of the date variable A, one day after
     the date of A, three days before the date of A, five days after the
     date of A, four Fridays after the date of A, two Fridays after the
     date of A and ten Saturdays before the date of A.

'1996@e+1,-3,5,+4fr,2fr,-10sa'
     In the year 1996: one day after the Easter Sunday's date, three
     days before the Easter Sunday's date, five days after the Easter
     Sunday's date, four Fridays after the Easter Sunday's date, two
     Fridays after the Easter Sunday's date and ten Saturdays before the
     Easter Sunday's date.

'1996@t+1,-3,5,+4fr,2fr,-10sa'
     In the year 1996: one day after today's date, three days before
     today's date, five days after today's date, four Fridays after the
     today's date, two Fridays after today's date and ten Saturdays
     before today's date.


File: gcal.info,  Node: Ranges of days,  Next: Repetition factor of days,  Prev: Lists of days,  Up: Further date part attributes

5.1.3.2 Ranges of days
......................

A range of days just as a list of days is used to define recurrent fixed
dates and to use only one line in the resource file for them, instead of
using several lines in a resource file needed for defining these
recurrent fixed dates separately.

  A range of days is specified by a '#' separator character and must
consist of two elements, namely the starting day and the final day.  The
starting day and likewise the final day of the range may not be set to a
zero value and be not concrete therefore.  (This would not make any
sense in this context.)

  Assuming a fixed date shall always occur during the 1st and the 15th
day (inclusive) in every month of the year 1996, e.g. 'Inside work', one
solution would be on the one hand a fixed date entry in the resource
file for the 1st of the month, another one for the 2nd of the month
until the 15th of the month, which would be a total of 15 entries in the
resource file for such a fixed date(1) (*note Ranges of
days-Footnote-1::).

  On the other hand, this expense can be reduced to a total of only one
entry in the resource file by using a range of days, which is likewise
valid for the 1st until the 15th day in every month, that is

     19960001#15 Inside work

The use of ranges of days in the date part is permitted as follows:

   * 'YYYYMMWWW#WWW'

   * 'YYYYMMDD|WWWN#[MM]DD|[MM]WWWN'

   * 'YYYY*d|wN[WWW]#N[WWW]'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]#[+|-]N[WWW]'

  Preceding table shows that the starting and ending day can only be
specified by using date formats of the same type left and right the '#'
separator character.  Thus, it is not explicitly possible to define a
range of days by using different types of date formats, means, fixed
date entries like:

     1996@e+3fr#1012 In the year 1996: every day that appears within the\
                     period of the date 3 Fridays after Easter Sunday's\
                     date until the 12th October.

cannot be defined like this.  But this problem can be solved by using an
inclusive date period '%i[DATE][#[DATE]]' special text for defining the
ending day of the range(2) (*note Ranges of days-Footnote-2::), and the
fixed dates are simply produced until the last day of the year, e.g.:

     1996@e+3fr#+999 In the year 1996: every day that appears within the\
                     period of the date 3 Fridays after Easter Sunday's\
                     date until the 12th October.%i0#19961012

  *Note Inclusive date period '%i[DATE][#[DATE]]' special text:
Inclusive date period, for more details.

Some examples to this:

'199600mon#fr'
     In the year 1996 in every month: every day that appears within the
     day sequence 'mon, tue, wed, thu, fri'.

'000000fr#mon'
     In every year in every month: every day that appears within the day
     sequence 'fri, sat, sun, mon'.

'000001fr3#12'
     In every year in January: every day that appears within the period
     of the 3rd Friday of the month until the 12th of the month.

'00000112#fr3'
     In every year in January: every day that appears within the period
     of the 12th of the month until the 3rd Friday of the month.

'00000112#augfri3'
     In every year: every day that appears within the period of the 12th
     January until the 3rd Friday of August.

'0000sep13#99fr9'
     In every year: every day that appears within the period of the 13th
     September until the last Friday of December.

'0*d1#1fr'
     In every year: every day that appears within the period of the 1st
     day of the year until the 1rd Friday of the year.

'0*d99fr#333'
     In every year: every day that appears within the period of the last
     Friday of the year until the 333rd day of the year.

'1996*w1fr#17mo'
     In the year 1996: every day that appears within the period of the
     Friday of the 1st week until the Monday of the 17th week.

'0@a#+4fr'
     In every year: every day that appears within the period of the date
     of the date variable A until the 4th Friday after the date of the
     date variable A.

'1996@e-3#+9fr'
     In the year 1996: every day that appears within the period of the
     date three days before the Easter Sunday's date until the 9th
     Friday after the date of the Easter Sunday's date.

'1996@t-3#+99fr'
     In the year 1996: every day that appears within the period of the
     date three days before today's date until the last Friday of the
     year.


File: gcal.info,  Node: Ranges of days-Footnotes,  Up: Ranges of days

   (1) Apart from the possibility, that a list of days can be used in
such a case.

   (2) Implicit solution.


File: gcal.info,  Node: Repetition factor of days,  Next: Appearance factor of days,  Prev: Ranges of days,  Up: Further date part attributes

5.1.3.3 Repetition factor of days
.................................

A repetition factor of days is used to define recurrent fixed dates and
to use only one line in the resource file for them, instead of using
several lines in a resource file needed for defining these recurrent
fixed dates separately.

  A repetition factor of days (':N') is specified by a ':' character and
must trail the day field --which must have a concrete value in a date
part of a Gcal resource file and has not been set to a zero value--
respectively either lead or trail an appearance factor of days.  Except
ranges of days or fixed dates which occur only on a definite weekday
like '199600mon Every Monday 1996', such a repetition factor may be
specified in all possible codings of date parts of a Gcal resource file.

  This factor may have values in range '1...999'.  Values greater than
the real difference between the date of the first occurrence of the
fixed date and the last day of the year are always reduced to this real
difference.  In this sense, any value greater '365'(1) (*note Repetition
factor of days-Footnote-1::) means a repetition factor until the last
day of the year.

  Assuming a fixed date shall always occur on the 15th day in every
month of the year 1996 and covers a period of four days (inclusive the
15th itself), e.g. 'Co-workers training', one solution would be on the
one hand a fixed date entry in the resource file for the 15th of the
month and the succeeding three days, which would be a total of four
entries in the resource file for such a fixed date(2) (*note Repetition
factor of days-Footnote-2::).

  On the other hand, this expense can be reduced to a total of only one
entry in the resource file by using a repetition factor of days, which
is likewise valid for the 15th and the three days which succeed the 15th
in every month, namely

     19960015:4 Co-workers training

The use of repetition factors of days in the date part is permitted as
follows:

   * 'YYYYMMDD:N|WWWN:N'

   * 'YYYY*d|wN:N|NWWW:N'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]:N'

   * 'YYYYMMDD:N|WWWN:N,[MM]DD:N|[MM]WWWN:N ...'

   * 'YYYY*d|wN:N|NWWW:N,N:N|NWWW:N ...'

   * 'YYYY@e|t|DVAR:N,|[+|-]N[WWW]:N,[+|-]N[WWW]:N ...'

Some examples to this:

'000001fr3:11'
     In every year in January: every day that appears within the period
     of the 3rd Friday of the month and the succeeding ten days.

'00000112:3'
     In every year in January: every day that appears within the period
     of the 12th of the month and the succeeding two days.

'00000112:3,fr3:5'
     In every year in January: every day that appears within the period
     of the 12th of the month and the succeeding two days, and that
     appears within the period of the 3rd Friday of the month and the
     succeeding four days.

'0*d1:1'
     In every year: every day that appears within the period of the 1st
     day of the year and no succeeding day.

'0*d1:2'
     In every year: every day that appears within the period of the 1st
     day of the year and the succeeding day.

'0*d99fr:333'
     In every year: every day that appears within the period of the last
     Friday of the year and the succeeding 332 days.  Well, in cases a
     fixed date exceeds the year bounds, it will only be produced until
     the last day of the year.

'1996*w1fr:17'
     In the year 1996: every day that appears within the period of the
     Friday of the 1st week and the succeeding 16 days.

'0@a:4'
     In every year: every day that appears within the period of the date
     of the date variable A and the succeeding three days.

'1996@e-3:9'
     In the year 1996: every day that appears within the period of the
     date three days before the Easter Sunday's date and the succeeding
     eight days.

'1996@t-3:9'
     In the year 1996: every day that appears within the period of the
     date three days before today's date and the succeeding eight days.


File: gcal.info,  Node: Repetition factor of days-Footnotes,  Up: Repetition factor of days

   (1) Or '366' in leap years.

   (2) Apart from the possibility, that a list or a range of days can be
used in such a case.


File: gcal.info,  Node: Appearance factor of days,  Prev: Repetition factor of days,  Up: Further date part attributes

5.1.3.4 Appearance factor of days
.................................

An appearance factor of days is used to define a concrete displacement
of recurrent fixed dates.

  An appearance factor of days ('.N') is specified by a '.' character
and must trail the day field --which must have a concrete value in a
date part of a Gcal resource file and has not been set to a zero value--
respectively either lead or trail a repetition factor of days.  Except
fixed dates which occur only on a definite weekday and are not specified
by using a range of days, like '199600mon Every Monday 1996', such an
appearance factor may be specified in all possible codings of date parts
of a Gcal resource file.  This factor may be specified with each single
element of lists of days, but in a range of days, this factor may trail
*only* the final day of the range.  Well, the use of such an appearance
factor is only helpful if it is either given in a range of days, or if
it is given together with a repetition factor.

  This factor may have values in range '1...999'.  Fixed dates will be
ignored if the factor takes values greater than the real difference
between the date of the occurrence of the fixed date and the last day of
the year, respectively the end of the period, for which the fixed dates
shall either be produced or respected.

  Assuming a fixed date shall always occur on the 15th day in every
month of the year 1996 and covers a period of seven days (inclusive the
15th itself), but shall only be respected every third day (i.e. two days
have to be skipped at a time) within this period, e.g.
'Training-college', one solution would be on the one hand a fixed date
entry in the resource file for the 15th of the month, for the 18th and
for the 21st of the month, which would be a total of three entries in
the resource file for such a fixed date(1) (*note Appearance factor of
days-Footnote-1::).

  On the other hand, this expense can be reduced to a total of only one
entry in the resource file by using an appearance factor of days, which
is likewise valid for the 15th, the 18th and the 21st in every month,
namely on the one hand by the use of a repetition factor

     19960015:7.3 Training-college

or on the other hand by the use of a range of days

     19960015#21.3 Training-college

The use of appearance factors of days in the date part is permitted as
follows:

   * 'YYYYMMDD:N.N|DD.N:N'

   * 'YYYYMMWWWN:N.N|WWWN.N:N'

   * 'YYYY*d|wN:N.N|N.N:N'

   * 'YYYY*d|wNWWW:N.N|NWWW.N:N'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]:N.N'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]].N:N'

   * 'YYYYMMDD:N.N|WWWN:N.N,[MM]DD:N.N|[MM]WWWN:N.N ...'

   * 'YYYYMMDD.N:N|WWWN.N:N,[MM]DD:N.N|[MM]WWWN.N:N ...'

   * 'YYYY*d|wN:N.N|NWWW:N.N,N:N.N|NWWW:N.N ...'

   * 'YYYY*d|wN.N:N|NWWW.N:N,N.N:N|NWWW.N:N ...'

   * 'YYYY@e|t|DVAR:N.N,|[+|-]N[WWW]:N.N,[+|-]N[WWW]:N.N ...'

   * 'YYYY@e|t|DVAR.N:N,|[+|.]N[WWW].N:N,[+|.]N[WWW].N:N ...'

   * 'YYYYMMWWW#WWW.N'

   * 'YYYYMMDD|WWWN#[MM]DD|[MM]WWWN.N'

   * 'YYYY*d|wN[WWW]#N[WWW].N'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]#[+|-]N[WWW].N'

Some examples to this:

'000001fr3:11.3'
     In every year in January: every day that appears within the period
     of the 3rd Friday of the month and the succeeding ten days, but
     only every 3rd day within this period (skip two days at a time).

'00000112:3.2'
     In every year in January: every day that appears within the period
     of the 12th of the month and the succeeding two days, but only
     every 2nd day within this period (skip one day at a time).

'00000112:3.2,fr3:5.3'
     In every year in January: every day that appears within the period
     of the 12th of the month and the succeeding two days, but only
     every 2nd day within this period (skip one day at a time), and that
     appears within the period of the 3rd Friday of the month and the
     succeeding four days, but only every 3rd day within this period
     (skip two days at a time).

'0*d1:10.1'
     In every year: every day that appears within the period of the 1st
     day of the year and the succeeding nine days, and this for any day
     within this period (skip zero days at a time).

'0*d1:2.5'
     In every year: every day that appears within the period of the 1st
     day of the year and the succeeding day, but only every 5th day
     within this period (skip four days at a time).  Well, the
     succeeding days (only one in this example) of the starting day (1st
     day of year) are not respected, because the next day resulted by
     the appearance factor exceeds the final day (resulted by the
     repetition factor) of the period.

'0*d99fr:333.61'
     In every year: every day that appears within the period of the last
     Friday of the year and the succeeding 332 days, but only every 61st
     day within this period (skip 60 days at a time).  Well, in cases a
     fixed date exceeds the year bounds, it will only be produced until
     the last day of the year.  No succeeding day (332 in this example)
     of the starting day (last Friday of the year) is respected by
     reason of the displacement value of 60 days, because the next day
     resulted by the appearance factor exceeds the final day (resulted
     by the repetition factor) of the period (the last day of the year).

'1996*w1fr:17.8'
     In the year 1996: every day that appears within the period of the
     Friday of the 1st week and the succeeding 16 days, but only every
     8th day within this period (skip seven days at a time).

'0@a:4.3'
     In every year: every day that appears within the period of the date
     of the date variable A and the succeeding three days, but only
     every 3rd day within this period (skip two days at a time).

'1996@e-3:9.4'
     In the year 1996: every day that appears within the period of the
     date three days before the Easter Sunday's date and the succeeding
     eight days, but only every 4th day within this period (skip three
     days at a time).

'1996@e3#-20sun.15'
     In the year 1996: every day that appears within the period of the
     date three days after the Easter Sunday's date until the 20th
     Sunday before the Easter Sunday's date, but only every 15th day
     within this period (skip 14 days at a time).

'1996@t3#-20sun.15'
     In the year 1996: every day that appears within the period of the
     date three days after today's date until the 20th Sunday before
     today's date, but only every 15th day within this period (skip 14
     days at a time).


File: gcal.info,  Node: Appearance factor of days-Footnotes,  Up: Appearance factor of days

   (1) Apart from the possibility, that a list of days can be used in
such a case.


File: gcal.info,  Node: Text part of a line,  Next: Special Texts processed,  Prev: Further date part attributes,  Up: Resource file

5.1.4 Text part of a line
-------------------------

The "text part" of a line in a resource file can be any text you like.
Indeed, some characters have a special meaning ('%', '$', '~', '^' and
'\') and must be protected should the occasion arise that special
character combinations are formed with them(1) (*note Text part of a
line-Footnote-1::) which might be used only textually.  If the text part
contains characters that are used for highlighting the text or format it
for a printer, or characters with decimal values above 127 in the code
table of the used character set(2) (*note Text part of a
line-Footnote-2::) not produced by Gcal itself, such characters
respectively sequences are displayed by Gcal in an *uninterpreted*
manner!  For that very reason, it can happen that the output of such
characters can potentially create problems with the used screen device
driver software and/or the external pager program, likewise mailing of
such texts by means of electronic mail.

  So-called 'NUL' characters(3) (*note Text part of a line-Footnote-3::)
may also occur in the text part, but they only cause the suppression of
all succeeding characters in the line.  In my opinion, it makes no
perceptible sense to output these 'NUL' characters uninterpreted, so
they are used for remarking purposes only; besides, the 'NUL' characters
would lead to the same problems as already mentioned above.

  A line of the resource file is continued on the next line if a '\-\n'
(backslash-newline) character sequence is found, e.g.:

The line:
     000000Mo Every Monday

and the lines:
     000000Mo \
     Every \
     Monday

produce the same output and are essentially equivalent.

  Furthermore, you can break-up the text of a "long text part" at any
place you like.  The term _long_ means in this context, that the text
displayed by Gcal would override the right text margin of the screen
respectively break-up at that margin.

  Each time a '~' (tilde) character is found in the text part, this
character is replaced by a real '\n' (newline) character.  Such texts
will be displayed by Gcal in a formatted manner at a left margin, this
means, they are lead by a definite number of space characters.

  You may depreciate the special meaning of the '~' (tilde) character
--in case this character itself is needed-- by placing a '\' (backslash)
character before it, e.g. '\~'.  If you need the '\~' characters
themselves, you have to protect the '\' (backslash) character by another
'\' (backslash) character, e.g. '\\~'.

  Each time a '^' (caret) character is found in the text part, this
character is also replaced by a real '\n' (newline) character.  Such
texts will be displayed by Gcal at column 1, this means, they are not
lead by space characters.  The rules for protecting the '^' character
are the same as the rules used for protecting the '~' character.

The resource file 'lbrk-1.rc'

     $ cat lbrk-1.rc
     -| ; Hi, I'm `lbrk-1.rc' and alive now
     -| ;
     -| 0 I know I'm a short text
     -| 0 I hope I'm long enough~here, a line break-up~\
     -| and again~and now for the last time...
     -| 0 I hope I'm also long enough^here, a line break-up\
     -| ~and again^and now for the last time...
     -| 0 Am I another short text? Dunno...

is displayed as follows:

     $ gcal %00000101 --resource-file=./lbrk-1.rc --disable-highlighting
     -|
     -| Fixed date list:
     -|
     -| Sat, Jan   1st 2000: Am I another short text? Dunno...
     -| Sat, Jan   1st 2000: I hope I'm also long enough
     -| here, a line break-up
     -|                      and again
     -| and now for the last time...
     -| Sat, Jan   1st 2000: I hope I'm long enough
     -|                      here, a line break-up
     -|                      and again
     -|                      and now for the last time...
     -| Sat, Jan   1st 2000: I know I'm a short text

  Because _whitespace_ characters are used to separate the date part
from the text part(4) (*note Text part of a line-Footnote-4::), it is
not possible to supply the text part with leading _whitespace_
characters without further ado.  If one or more _whitespace_ characters
shall lead the text part, this can be arranged by protecting the *first*
of these _whitespace_ characters (and that by placing a '\' (backslash)
character before it), e.g. '\ ' if it is a space character.  By means of
such a character sequence, Gcal notices that the text trailing the '\'
character is no longer used for separating purposes, but is member of
the text part.  Gcal skips this specific, marking backslash character
(avoids its output) and processes the rest of the line as usual.

  The following example should be enough to elucidate the above facts.
The resource file 'wspc-1.rc'

     $ cat wspc-1.rc
     -| 0 BANG BANG
     -| 0 bogus
     -| 0         bogomips
     -| 0    \hello world
     -| 0    \ main(){for(;;)fork();}
     -| 0 \     sh $0 & $0 &
     -| 0    \  a  \  b  \\  c  \\\  d
     -| 0    What happens now?\
     -| ~0  \  This!
     -| 0    What happens now?\\
     -| ~0  \  That!

is displayed as follows:

     $ gcal --resource-file=./wspc-1.rc --disable-highlighting
     -|
     -| Fixed date list:
     -|
     -| Wed, Jun  14th 2000:      sh $0 & $0 &
     -| Wed, Jun  14th 2000:   a  \  b  \\  c  \\\  d
     -| Wed, Jun  14th 2000:  main(){for(;;)fork();}
     -| Wed, Jun  14th 2000: BANG BANG
     -| Wed, Jun  14th 2000: What happens now?~0  \  That!
     -| Wed, Jun  14th 2000: What happens now?
     -|                      0  \  This!
     -| Wed, Jun  14th 2000: \hello world
     -| Wed, Jun  14th 2000: bogomips
     -| Wed, Jun  14th 2000: bogus


File: gcal.info,  Node: Text part of a line-Footnotes,  Up: Text part of a line

   (1) Like '%i', '$a'...

   (2) These are potentially non-printable.

   (3) That is the character with the value zero in the code table of
the used character set.

   (4) These are internally skipped and remain undisplayed therefore.


File: gcal.info,  Node: Special Texts processed,  Next: Comment line,  Prev: Text part of a line,  Up: Resource file

5.1.5 '%?'... Special Texts
---------------------------

The text part of a resource file line may be provided with different
special texts which may occur in any(1) (*note Special Texts
processed-Footnote-1::) number and order.  All these texts start with a
'%' (percent) character which may be protected by a leading '\'
(backslash) character if the '%' (percent) character itself is wanted to
be used in the text part, e.g. '\%'.  The '%' character is mostly
trailed by an optional format instruction, (see *note Format
Instruction::, for the detailed description of the format instruction
and its components), and then trailed by a distinguishing mark --which
defines the kind of the special text to be used-- and if it is a letter,
Gcal accepts it *case-sensitive*.

  The purpose of these special texts is mainly to suppress output of
fixed dates in definite cases, either, or to provide them with
particular texts respectively to start external commands.  *Note
Description of all '%?'... Special Texts: Special Texts, for a complete
description of all usable special texts, and *note Summary of all
'%?'... Special Texts: Special Texts Summary, for an according
short-list of them.

For example, the resource file 'speci-1.rc'

     $ cat speci-1.rc
     -| ; I'm veracious very special :)
     -| ;
     -| 0 1. Today is %>1u*K , %>02&*D  %U  %Y !
     -| 0 2. It's the %>03&*N  day of the year.
     -| 0 3. The actual week number is: %k .
     -| 0 4. Currently, it's %t*  o'clock, Mr. %-USER .
     -| 0 5. Hurry up with your work~\
     -|    by reason sunrise is at %o+5158+00738+61,2: .

is displayed as follows (in case today's date is the 4th October 1996):

     $ gcal --resource-file=speci-1.rc -H no -ox
     -|
     -| Mon, Oct   4th 1999: 1. Today is MONDAY, 04th October 1999!
     -|                      2. It's the 277th day of the year.
     -|                      3. The actual week number is: 40.
     -|                      4. Currently, it's 06:53pm o'clock, Mr. esken.
     -|                      5. Hurry up with your work
     -|                         by reason sunrise is at 07:33.


File: gcal.info,  Node: Special Texts processed-Footnotes,  Up: Special Texts processed

   (1) Rational!


File: gcal.info,  Node: Comment line,  Next: Include directives,  Prev: Special Texts processed,  Up: Resource file

5.1.6 Comment line
------------------

A line(1) (*note Comment line-Footnote-1::) beginning with a ';'
(semicolon) character in the resource file is treated as a remark and
will not be used by Gcal!  Any _whitespace_ characters may lead the
remark character.  *Note Text part of a line::, for information how a
'NUL' character can be used for remarking purposes in a text part.

  The following example of the 'remark.rc' resource file --which *only*
consists of remarks-- should be enough to elucidate the above facts:

     $ cat remark.rc
     -| ;00001031 ^\
     -|                         .......^\
     -|                         ;::;::,^\
     -|                         ;::;::;,^\
     -|                        ;;::;;:;;,^\
     -|           .vmnv\%vnv\%,.;;;:::;;:;;,  .,vnmv\%vnn,^\
     -|        vmmmn\%vmmnv\%vnmmnv\%;;;;;;\%nmmmnv\%vnmv\%vmmv^\
     -|      vmmnv\%vmmmnv\%vnmmmmmnv\%;:\%nmmmmmmnv\%vnm\%vnmmmv^\
     -|     vmmnv\%vmmmnv\%vnmmmmmmmmnv\%nmmmmmmmmnv\%vnmm\%vnmmmv^\
     -|    vmmnv\%vmmmnv\%vnmmmmmmmmnv\%vmmmmmmmmmmnv\%vnmv\%vnmmmv^\
     -|   vmmnv\%vmmmnv\%vnmm;mmmmmmnv\%vmmmmmmmm;mmnv\%vnmv\%vnmmmv,^\
     -|  vmmnv\%vmmmnv\%vnmm;' mmmmmnv\%vmmmmmmm;' mmnv\%vnmv\%vnmmmv,^\
     -|  vmmnv\%vmmmnv\%vn;;    mmmmnv\%vmmmmmm;;    nv\%vnmmv\%vnmmmv^\
     -| vmmnv\%vmmmmnv\%v;;      mmmnv\%vmmmmm;;      v\%vnmmmv\%vnmmmv^\
     -| vmmnv\%vmmmmnv\%vnmmmmmmmmm;;      mmmmmmmmmnv\%vnmmmmv\%vnmmmv^\
     -| vmmnv\%vmmmmnv\%vnmmmmmmmmmm;;    mmmmmmmmmmnv\%vnmmmmv\%vnmmmv^\
     -| vmmnv\%vmmmmnv\%vnmmmmmmmmmmnv;,mmmmmmmmmmmmnv\%vn;mmmv\%vnmmmv^\
     -| vmmnv\%vmmm. nv\%vnmmmmmmmmmnv\%;mmmmmmmmmmmnv\%vn; mmmv\%vnmmmv^\
     -| `vmmnv\%vmm,  v\%vnmmmmmmmmmmnv\%nmmmmmmmmmmnv\%v;  mmv\%vnnmmv'^\
     -|  vmmnv\%vmm;,   \%vnmmmmmmmmmnv\%nmmmmmmmmmnv\%;'   mv\%vnmmmmv^\
     -|   vmmnv\%vmm;;,   nmmm;'             mmmm;;'    mv\%vnmmmmv'^\
     -|   `vmmnv\%vmmm;;,.         mmnvv;,            mmv\%vnmmmmv'^\
     -|    `vmmnv\%vmmmmnv\%vnmmmmmmmmnvvnmmmmmmnv\%vnmmmv\%vnmmmmv'^\
     -|      `vmvn\%vmmmmnv\%vnmmmmmmmnvvnmmmmmnv\%vnmmmm\%vnmmmv'^\
     -|          `v\%mmmmmn%:\%vnmnmmmmn\%vnmmmnv%:\%vnmv\%nmv'
     -|
     -| ; A remarked line
     -|       ; Also a remarked line
     -| ;     A                          \
     -|       formatted and multi-line   \
     -|       remark


File: gcal.info,  Node: Comment line-Footnotes,  Up: Comment line

   (1) Physically and logically.


File: gcal.info,  Node: Include directives,  Next: Date variables,  Prev: Comment line,  Up: Resource file

5.1.7 Include directives
------------------------

You may add '#include' directives in a resource file for searching and
loading further resource files(1) (*note Include
directives-Footnote-1::).  An '#include' directive tells Gcal to suspend
reading the current resource file and read one other resource file
before continuing.  The directive is a line in the resource file that
looks like this template:

     #include _whitespace_ ARGUMENT [_whitespace_] _newline_

The ARGUMENT can either be

     "FILE NAME"

or(2) (*note Include directives-Footnote-2::)

     <FILE NAME>

  One _whitespace_ character minimum is required between '#include' and
the ARGUMENT.  The ARGUMENT may be trailed by extra _whitespace_
characters and the line must always end with a '\n' (newline) character,
except it is the last line of a resource file.

Let us inspect a example which is a bit more concrete:

  1. #include "foo/bar"

  2. #include <bar>

  The first '#include' directive tells Gcal to load the file 'bar' in
the file directory 'foo' from the actual file directory.  If this fails,
Gcal tries to load this file by using steps 1...4 of the previously
explained mechanism used for searching files (*note File searching
mechanism: x-File-searching-mechanism.).

  The second '#include' directive tells Gcal to load the file 'bar' from
the user respectively system data file directory by using steps 3...4 of
the previously explained mechanism used for searching files.  It is not
allowed to include files which have a fixed access path starting from
the root file directory by such an '#include' directive like
'#include </file>' or '#include </foo/bar/file>'; just as the
specification of a single or an extended file name containing a
disk/drive specifier(3) (*note Include directives-Footnote-3::), because
the resulting path name(4) (*note Include directives-Footnote-4::) would
not be a valid file name any longer.

  Included files may include other files again.  But the nesting level
of included files is limited on the one hand by the amount of usable
working storage of the computer, and on the other hand by the value
which is given by the operating system respectively the compiler for the
number of files which can be opened simultaneously.  Recursive
includes(5) (*note Include directives-Footnote-5::) or cyclic
includes(6) (*note Include directives-Footnote-6::) are not permitted,
because such backward references would produce an infinite loop in the
program internally!  Gcal recognizes such situations and terminates
immediately with a fatal error.  *Note Error Code 119: x-119-Error-code,
for more information.

  If an included resource file cannot be found and no '--debug=abort'
option is given, processing of the resource file containing the
'#include' continues.


File: gcal.info,  Node: Include directives-Footnotes,  Up: Include directives

   (1) A mechanism similar the method which is used by the C
Preprocessor.

   (2) Thus, a file name which is embraced by '""' or '<>'.

   (3) Even if operating systems like MS-DOS or OS/2 permits such a
disk/drive specification on principle.

   (4) A path name lead by the user respectively system data file
directory name.

   (5) The included file tries to include itself again.

   (6) The included file is included again by another file that occurs
at a deeper place in such a chain.


File: gcal.info,  Node: Date variables,  Next: Text variables,  Prev: Include directives,  Up: Resource file

5.1.8 Date variables
--------------------

Gcal respects _global_ and/or _local_ date variables which may be used
either in the date part of a Gcal resource file line, or which may be
part of a special text in the text part of a Gcal resource file line.
This means, up to *24* user-defined date variables can be set and
referenced during program execution.  *Note Fixed date option
'--date-variable=ARGUMENT': x-date-variable, for more information how
global date variables can be used.

  A date variable name DVAR consists of a single, case-insensitive
letter(1) (*note Date variables-Footnote-1::).  In a definition, this
name is trailed by the assignment operator character '=', and the
numerical values of month MM (or a short, three characters month name,
e.g. 'Jan', 'Feb'...) and day DD, this variable has to store(2) (*note
Date variables-Footnote-2::), e.g.:

     a=1127
     c=a

stores the 27th November into the local date variable A and into the
local date variable C.  You should always remember that date variables
can only be referenced in a line if they are already defined, because
Gcal processes a resource file line by line.

  Only local date variables can store dynamical dates given in the
'MMWWWN', 'DVAR[+|-]N[WWW]' or '*d|wN[WWW]' format, e.g.:

     a=03su2
     b=JunMon9
     c=b-3
     d=c+4Sa
     x=*d10
     y=*d10fri
     z=*w3Su

which means, date variable A stores the date of second Sunday in March
and B stores date of last Monday in June.  The date variable C stores
the date which is three days before the date of the last Monday in June
and this date is set in the date variable D to that date which is four
Saturdays after the date of C.  The date variable X stores the date of
the 10th absolute day of the year (== 10th January).  Y stores the date
of the 10th Friday of the year, and the assignment to Z is the date of
the Sunday which occurs in the 3rd week of the year.

*Caution:*
These kinds of assignments to date variables are *only* computed
correctly in simple year bounds --which means during a current year--
and not in fixed dates shown after the current year has changed, e.g. in
*fiscal years*.

  Date variables which are defined in a resource file are always local
and only respected in this specific file, and that file which is
included by it.  This means for the included file, that *all* local
variables of the caller are visible.  The included file itself may
define its own local variables in its own name-space, which are not
exported to caller on return.  All other definitions of date
variables(3) (*note Date variables-Footnote-3::) are always global.  If
a resource file line contains a reference to a date variable which is
not locally defined in that file, Gcal will try to use the global values
held by this variable.  If this fails because no global definition of
this date variable is given, Gcal will not process this line.  If the
simple '--debug' respectively '--debug=internal' option is given,
informational messages for each undefined date variable will be shown on
the _standard error channel_ (*note Global option '--debug=internal':
x-debug-internal.).  If the '--debug=abort' option is given, the Gcal
program will be aborted with an error code when the first undefined
global date variable reference occurs.  *Note Error Code 113:
x-113-Error-code, and *note Global option '--debug=abort':
x-debug-abort, for further information.

  A local date variable can be deleted.  This means, that this date
variable is no longer valid in its local scope and be undefined
therefore.  So it is possible to use its potentially defined global
value in succeeding lines if this date variable is referenced there.
The following example of the resource file 'dvar-1.rc' elucidates these
facts:

     $ cat dvar-1.rc
     -| ; dvar-1.rc
     -| ;
     -| z=0202
     -| 0@z The local assigned date to `z'
     -| z=
     -| 0@z The global assigned date to `z'
     -| z=0404
     -| 0@z The local assigned date to `z'

So Gcal creates the following output:

     $ gcal %1777 -H no -x -v z=1212 -f ./dvar-1.rc -y
     -|
     -| Sun, Feb   2nd 1777: The local assigned date to `z'
     -| Fri, Apr   4th 1777: The local assigned date to `z'
     -| Fri, Dec  12th 1777: The global assigned date to `z'
     $ gcal %1777 -H no -x -f ./dvar-1.rc -y
     -|
     -| Sun, Feb   2nd 1777: The local assigned date to `z'
     -| Fri, Apr   4th 1777: The local assigned date to `z'

  Only advanced users should apply the '--export-date-variables' option
which causes that the actual incarnation of a local date variable
--which was previously defined in a resource file and not in an included
file-- is being exported to further resource files instead of using its
global value, in case that date variable is not locally defined in that
further resource file.  *Note Include directives::, for more details.

  But be aware, the use of this option could create unwanted results,
because the order of processing the resource files is an important
entity in managing the '--export-date-variables' option, so it is not
recommended to use it.  You, the user, must exactly know what you are
doing when applying this option; *you are expressively warned now!*

Some basic operations can be performed on date variables.  These are:

*Operation*    *Description*
 
'DVAR++'       Simple increment by one day.
'DVAR--'       Simple decrement by one day.
'DVAR+=[+|-]N' Addition of a constant numerical day factor [+|-]N.
'DVAR-=[+|-]N' Subtraction of a constant numerical day factor [+|-]N.
'DVAR+=NWWW'   Addition of N weekdays WWW.
'DVAR-=NWWW'   Subtraction of N weekdays WWW.

  The scope of the operations which are done on a local date variable,
is that resource or include file, where the local date variable is
defined.

  If operations on a global date variable are performed in a resource
file or that file which is included by it, these operations are only
valid in that specific file(4) (*note Date variables-Footnote-4::), not
in further resource files processed.  This means, the initial values of
global date variables are always restored if the resource file changes.

  Please finally note, that each date variable assignment/operation must
be given separately on a single line in the resource file.


File: gcal.info,  Node: Date variables-Footnotes,  Up: Date variables

   (1) Except the date variable E which is internally reserved for the
Easter Sunday's date, so it cannot be assigned or operated therefore.
And except the date variable T which is internally reserved for today's
date, so it likewise cannot be assigned or operated.

   (2) Or the name of another date variable, which is already defined.

   (3) In the command line, environment variable 'GCAL' or response
file.

   (4) They are only done locally.


File: gcal.info,  Node: Text variables,  Prev: Date variables,  Up: Resource file

5.1.9 Text variables
--------------------

Gcal respects _global_ and/or _local_ text variables which may be used
anywhere in a line of a Gcal resource file.  This means, up to *26*
user-defined text variables can be set and referenced during program
execution.  *Note Fixed date option '--text-variable=ARGUMENT':
x-text-variable, for more information how global text variables can be
used.

A text variable name TVAR consists of the '$' prefix and a single,
case-insensitive letter.

A text variable is defined as follows:

   * If the name of a text variable is trailed by the assignment
     operator character '=', all the text which appears at the right
     side of this assignment operator is assigned to this text variable.

   * If the name of a text variable is trailed by the assignment
     operator character '?', all the text which appears at the right
     side of this assignment operator is assumed as an external command
     and executed by Gcal.  The output which is created on the _standard
     output channel_ by the command run is assigned to this text
     variable; and that in an interpreted manner.  This means, Gcal
     interprets all special texts and references to other text variables
     that are contained in this output.  *Note Special Texts
     processed::, for further information.

   * If the name of a text variable is trailed by the assignment
     operator character ':', all the text which appears at the right
     side of this assignment operator is assumed as an external command
     and executed by Gcal.  The output which is created on the _standard
     output channel_ by the command run is assigned to this text
     variable; and that in an uninterpreted manner.  This means, Gcal
     does not interpret any special texts and references to other text
     variables that are contained in this output.  See also *note
     Special Texts processed::, for further details.

  Indeed, Gcal executes external commands only if the
'--execute-command' option is given at program start-up.  *Note Fixed
date option '--execute-command': x-execute-command, for more details.

  The text which appears at the right side of one of the valid
assignment operator characters may reference names of already defined
text variables.  These references are converted to the according textual
values just before the assignment is performed by Gcal.  You should
always remember that text variables can only be referenced in a line if
they are already defined, because Gcal processes a resource file line by
line.  Gcal always expands text variable references recursively until
all sub-references to other text variables are resolved.

  Local text variables are set to an _empty value_ and thus defined in a
special mode in case no text appears at the right side of one of the
valid assignment operator characters.

  If a text variable is referenced, an optional format instruction may
be specified between the '$' prefix and the single letter (here: the
variable name), which makes it possible to modify the representation of
the text (here: the contents) at which the text variable points to.  Let
us assume a resource file by the name of 'tvarf-1.rc' exists with the
following contents:

     $ cat tvarf-1.rc
     -| ; tvarf-1.rc
     -| ;
     -| $a=123
     -| $b=$:010*a
     -| $c=$b
     -| $b=
     -| 0 1. \$c=.$c.
     -| 0 2. \$c=.$:20*c.
     -| 0 3. \$b=.$>1w*b.
     -| 0 4. \$a=.$>5#a.

So Gcal creates the following output:

     $ gcal -Ux --text-variable='$b=XXX YY' --resource-file=./tvarf-1.rc
     -|
     -| 1. $c=.0000000123.
     -| 2. $c=.      0000000123       .
     -| 3. $b=.Xxx Yy.
     -| 4. $a=.  123.

  *Note Format Instruction::, for the detailed description of the format
instruction and its components.

  You may depreciate the special meaning of the '$' prefix character
--in case this character itself is needed in the text-- by placing a '\'
(backslash) character before it, e.g. '\$'.  If you need the '\$'
characters themselves in the text, you have to protect the '\'
(backslash) character by another '\' (backslash) character, e.g. '\\$'.

  External commands are not directly executed by Gcal, they are executed
by means of the command line interpreter of the operating system, the
shell.  As consequence to this, of course the commands have to be
specified according to the syntax conventions of the used shell,
concerning the grouping conventions, list processing conventions,
redirection conventions et cetera!  For example, it is possible that you
have to write '$a?(cat text)' instead of the simple '$a?cat text'.  See
the pertinent literature for more details.

  If the output of external commands, which appears on the _standard
output channel_, is assigned to text variables in an interpreted manner,
this output is internally directed by Gcal into a temporary file.
Thereafter, the contents of the temporary file is transfered to the text
variable and the temporary file is removed.

  If the output of external commands, which appears on the _standard
output channel_, is assigned to text variables in an uninterpreted
manner, this output is internally processed by the Txt2gcal program
first (*note Invoking 'txt2gcal': Invoking txt2gcal.), and then this
output is directed by Gcal into a temporary file.  Thereafter, the
contents of the temporary file is transfered to the text variable and
the temporary file is removed.  In case a 'TXT2GCALPROG' environment
variable (*note Environment Variable 'TXT2GCALPROG': x-TXT2GCALPROG.) is
defined and set with the file name of the executable Txt2gcal program,
Gcal will use this file name for calling Txt2gcal.  Otherwise, the file
name 'txt2gcal' --which is burned-in during the compilation step of the
Gcal program-- is used for calling the Txt2gcal program.  The
'TXT2GCALPROG' environment variable must always be set if the Txt2gcal
program is installed under another name than the standard name
'txt2gcal', otherwise Gcal is unable to execute the Txt2gcal program
automatically!

  If the simple '--debug' respectively '--debug=internal' option is
given at program start-up, informational messages about the executed
command and its _exit code_ will be shown on the _standard error
channel_ (*note Global option '--debug=internal': x-debug-internal.).

  If the '--debug=abort' option is given, the Gcal program will be
aborted with an error code in case an _exit code_ not equal zero
occurred during the execution of the command.  *Note Error Code 2:
x-2-Error-code, and *note Global option '--debug=abort': x-debug-abort,
for further information.

  Here is an example which explains how the output of external commands
can be assigned to text variables.  Supposing there is a resource file
by the name of 'tvarc-1.rc' with the following contents:

     $ cat tvarc-1.rc
     -| %t  $a $>+06*b $>1u*c

This file is used in the resource file 'tvarc-1a.rc' and processed by
Gcal as follows:

     $ cat tvarc-1a.rc
     -| ; tvarc-1a.rc
     -| ;
     -| $a=bonjour
     -| $b=123
     -| $c=bonsoir
     -| $x?cat $f
     -| 0 \$x=---$:30*x---
     -| $y:cat $f
     -| 0 \$y=---$y---
     -| 0 \$y=:::$>1u*y:::
     $ gcal -f tvarc-1a.rc -QUx --exe -r'$f=./tvarc-1.rc'
     -| $x=---    18:54 bonjour +00123 BONSOIR     ---
     -| $y=---%t  $a $>+06*b $>1u*c---
     -| $y=:::%T  $A $>+06*B $>1U*C:::

  Here are some more examples showing how Gcal processes text variables.
Let us assume a resource file by the name of 'tvar-1.rc' exists with the
following contents:

     $ cat tvar-1.rc
     -| ; tvar-1.rc
     -| ;
     -| $a=foo
     -| 0 \$a:1=$a
     -| $c=$a
     -| 0 \$c=$c
     -| $b=$c bar $a
     -| 0 \$b=$b
     -| $a=bar $b baz $a booz
     -| 0 \$a:2=$a
     -| $a=
     -| $b=0 $b $c frozz $a frozz
     -| $b ->That's \$b
     -| 0 \$x='$x' and \$d is undefined: $d...
     -| $a= 0 ~ 1~2~\$3~%n~$c~\
     -| now it's enough!
     -| 0 \$a=---$a---
     -| $a=0 \   \ \\ And this...
     -| $a works too!

So Gcal creates the following output:

     $ gcal %19960101 -H no -x -r '$A=FROBOZZ:$x=' -f ./tvar-1.rc
     -|
     -| Mon, Jan   1st 1996:    \ \\ And this... works too!
     -| Mon, Jan   1st 1996: $a:1=foo
     -| Mon, Jan   1st 1996: $a:2=bar foo bar foo baz foo booz
     -| Mon, Jan   1st 1996: $a=--- 0
     -|                       1
     -|                      2
     -|                      $3
     -|                      01-Jan-1996
     -|                      foo
     -|                      now it's enough!---
     -| Mon, Jan   1st 1996: $b=foo bar foo
     -| Mon, Jan   1st 1996: $c=foo
     -| Mon, Jan   1st 1996: $x='' and $d is undefined: $d...
     -| Mon, Jan   1st 1996: foo bar foo foo frozz FROBOZZ frozz ->That's $b

Or a resource file by the name of 'tvar-2.rc' exists with the following
contents:

     $ cat tvar-2.rc
     -| ; tvar-2.rc
     -| ;
     -| $a=$b foo
     -| $b=0@e
     -| $a bar
     -| $b \$b
     -| 0 \$a:$a
     -| 0 \$b:$b

So Gcal creates the following output:

     $ gcal %19960101 -H no -x -f ./tvar-2.rc
     -|
     -| Mon, Jan   1st 1996: $a:0@e foo
     -| Mon, Jan   1st 1996: $b:0@e
     $ gcal %19960101 -H no -x -f ./tvar-2.rc -y
     -|
     -| Sun, Apr   7th 1996: $b
     -| Sun, Apr   7th 1996: foo bar

  As seen before, it is allowed to store complete (or partial) date
parts (*note Date part of a line::), likewise special texts (*note
'%?'... Special Texts: Special Texts processed.) into text variables or
references to other text variables, which are processed by Gcal after
their expansion.  *Note Description of all '%?'... Special Texts:
Special Texts, for limitations concerning the assignment of special
texts to text variables.

  Text variables which are defined in a resource file are always local
and only respected in this specific file, and that file which is
included by it.  This means for the included file, that *all* local
variables of the caller are visible.  The included file itself may
define its own local variables in its own name-space, which are not
exported to caller on return.  All other definitions of text
variables(1) (*note Text variables-Footnote-1::) are always global.  If
a resource file line contains a reference to a text variable which is
not locally defined in that file, Gcal will try to use the global values
held by this variable.  If this fails because no global definition of
this text variable is given, Gcal keeps the name of this text variable
untouched in this line, except this text variable held an _empty value_.
In such a case, Gcal completely ignores this text variable while
processing and displaying instead of keeping its name untouched in this
line.

  An example to this.  Supposing a resource file by the name of
'tvar-3.rc' exists with the following contents:

     $ cat tvar-3.rc
     -| ; tvar-3.rc
     -| ;
     -| $c=+00+000
     -| $h=
     -| $d=$c$h
     -| 0 %o$d  %s$d
     -| 0 \$c=$c  \$h=$h  \$d=$d  \$x=$x

So Gcal creates the following output:

     $ gcal -QUx -f ./tvar-3.rc
     -| $c=+00+000  $h=  $d=+00+000  $x=$x
     -| 05:57 18:04
     $ gcal -QUx -r '$h=+1000:$x=' -f ./tvar-3.rc
     -| $c=+00+000  $h=+1000  $d=+00+000+1000  $x=
     -| 05:52 18:09

  Only advanced users should apply the '--export-text-variables' option
which causes that the actual incarnation of a local text variable
--which was previously defined in a resource file and not in an included
file-- is being exported to further resource files instead of using its
global value, in case that text variable is not locally defined in that
further resource file.  *Note Include directives::, for more details.

  But be aware, the use of this option could create unwanted results,
because the order of processing the resource files is an important
entity in managing the '--export-text-variables' option, so it is not
recommended to use it.  You, the user, must exactly know what you are
doing when applying this option; *you are expressively warned now!*

Some basic operations can be performed on text variables in case they
contain integer values.  These are:

*Operation*    *Description*
 
'TVAR++'       Simple increment by one.
'TVAR--'       Simple decrement by one.
'TVAR+=[+|-]N' Addition of a constant numerical factor [+|-]N.
'TVAR-=[+|-]N' Subtraction of a constant numerical factor [+|-]N.

  Here is an example showing how Gcal processes text variable
operations.  Let us assume a resource file by the name of 'tvaro-1.rc'
exists with the following contents:

     $ cat tvaro-1.rc
     -| ; tvaro-1.rc
     -| ;
     -| $a=130
     -| $b=2
     -| 0 1. \$b=$b
     -| $b++
     -| 0 2. \$b=$b
     -| $b+=7
     -| 0 3. \$b=$b
     -| $b--
     -| 0 4. \$b=$b
     -| $b-=-5
     -| 0 5. \$b=$b
     -| $b+=123
     -| 0 6. \$b=$b
     -| $b-=$a
     -| 0 7. \$b=$b
     -| $b-=10000
     -| 0 8. \$b=$b
     -| $b+=10000
     -| 0 9. \$b=$b
     -| $b=02
     -| 0 a. \$b=$b
     -| $b++
     -| 0 b. \$b=$b

So Gcal creates the following output:

     $ gcal -QUx -f ./tvaro-1.rc
     -| 1. $b=2
     -| 2. $b=3
     -| 3. $b=10
     -| 4. $b=09
     -| 5. $b=14
     -| 6. $b=137
     -| 7. $b=007
     -| 8. $b=-9993
     -| 9. $b=00007
     -| a. $b=02
     -| b. $b=03

As you can see in the former example, if operations are made like these,
the default behavior of Gcal is to fill with leading zeroes to preserve
a former length of a text variable, in case a carry into one of the next
decimal places has happened and is taken back by an operation at a later
place in the resource file.  But this default behavior can be disabled
respectively changed by using the already above mentioned format
instruction.

  The scope of the definitions which are done on a local text variable,
is that resource or include file, where the local text variable is
defined.

  If a global text variable is redefined in a resource file or that file
which is included by it, these redefinitions are only valid in that
specific file(2) (*note Text variables-Footnote-2::), not in further
resource files processed.  This means, the initial values of global text
variables are always restored if the resource file changes.

  Please finally note, that each text variable assignment/operation must
be given separately on a single line in the resource file.


File: gcal.info,  Node: Text variables-Footnotes,  Up: Text variables

   (1) In the command line, environment variable 'GCAL' or response
file.

   (2) They are only done locally.


File: gcal.info,  Node: Resource file examples,  Prev: Resource file,  Up: Fixed Dates

5.2 Resource file examples
==========================

Here are some examples of problem oriented resource files which might be
useful to get a deeper impression about the attributes of Gcal's fixed
date feature.

  Let us begin with a common example, the resource file 'common.rc':

     $ cat common.rc
     -| ; common.rc, a common example of a resource file.
     -| ;
     -| 19940715 Local time: %t  --> Dentist at 10:00
     -| 00000921 My %B1962  birthday%i1952#2062
     -| 0000093 Gregorian~Reformation\~is %y1752  years ago
     -| 0000Sep03 Gregorian~Reformation\~is %y1752 years ago
     -| 0 Every day in every month in every year
     -| 0000 Every day in every month in every year
     -| 00000000 Every day in every month in every year
     -| 199400fri        Every Friday in 1994
     -| 000007mo3 Every third Monday~in July every year less 1980%i#1979
     -| 0000@e-10 Easter Sunday-10 days every year
     -| 0@e-10 Easter Sunday-10 days every year
     -| 0000@e+10 Easter Sunday+10 days every year
     -| a=1127
     -| 0@a+20 20 days after date of date variable `a'
     -| a=*W10FR
     -| 0@a-1 The Thursday of the 10th week every year
     -| 0@a   The Friday of the 10th week every year
     -| 0@a1  The Saturday of the 10th week every year
     -| 1995*d10    The 10th absolute day in 1995
     -| 1995*d99tue The last Tuesday in 1995
     -| 0*w99su The Sunday of the last week every year
     -| ;
     -| ; Next entry is respected by ALL fixed date period modifiers.
     -| ;
     -| 1994*d1sun#99SUN.7 Each Sunday in 1994
     -| ;
     -| ; Day of Prayer & Repentance is Wednesday before the Sunday,
     -| ;   which is before the 1st Advent's Sunday.
     -| ;
     -| a=1225
     -| a=a-5sun
     -| 0@a-4 Day of Prayer & Repentance
     -| ; or
     -| 0@a-1wed Day of Prayer & Repentance

  And here is a resource file by the name of 'demo-1.rc', used to detect
all Fridays the 13th of a year:

     $ cat demo-1.rc
     -| ; demo-1.rc
     -| ;
     -| $a=Friday the 13th%i0000
     -| $b=#0000
     -| $c=fri2
     -| $d=fri3
     -| 00000113 $a01$c$b01$c
     -| 00000113 $a01$d$b01$d
     -| 00000213 $a02$c$b02$c
     -| 00000213 $a02$d$b02$d
     -| 00000313 $a03$c$b03$c
     -| 00000313 $a03$d$b03$d
     -| 00000413 $a04$c$b04$c
     -| 00000413 $a04$d$b04$d
     -| 00000513 $a05$c$b05$c
     -| 00000513 $a05$d$b05$d
     -| 00000613 $a06$c$b06$c
     -| 00000613 $a06$d$b06$d
     -| 00000713 $a07$c$b07$c
     -| 00000713 $a07$d$b07$d
     -| 00000813 $a08$c$b08$c
     -| 00000813 $a08$d$b08$d
     -| 00000913 $a09$c$b09$c
     -| 00000913 $a09$d$b09$d
     -| 00001013 $a10$c$b10$c
     -| 00001013 $a10$d$b10$d
     -| 00001113 $a11$c$b11$c
     -| 00001113 $a11$d$b11$d
     -| 00001213 $a12$c$b12$c
     -| 00001213 $a12$d$b12$d

The result for the years 1996...2002 is as follows:

     $ gcal -H no -u -x -f ./demo-1.rc 1996+2002
     -|
     -| Fri, Sep  13th 1996: Friday the 13th
     -| Fri, Dec  13th 1996: Friday the 13th
     -|
     -| Fri, Jun  13th 1997: Friday the 13th
     -|
     -| Fri, Feb  13th 1998: Friday the 13th
     -| Fri, Mar  13th 1998: Friday the 13th
     -| Fri, Nov  13th 1998: Friday the 13th
     -|
     -| Fri, Aug  13th 1999: Friday the 13th
     -|
     -| Fri, Oct  13th 2000: Friday the 13th
     -|
     -| Fri, Apr  13th 2001: Friday the 13th
     -| Fri, Jul  13th 2001: Friday the 13th
     -|
     -| Fri, Sep  13th 2002: Friday the 13th
     -| Fri, Dec  13th 2002: Friday the 13th

  Or a bit shorter version of the resource file 'demo-1.rc' by the name
of 'demo-2.rc', likewise used to detect all Fridays the 13th of a year,
and that by using the fact, that a Friday the 13th only occurs if the
first day of a month is a Sunday:

     $ cat demo-2.rc
     -| ; demo-2.rc
     -| ;
     -| $a=%n+12 is a Friday%i0000
     -| $b=#0000
     -| $c=sun1
     -| 00000101 $a01$c$b01$c
     -| 00000201 $a02$c$b02$c
     -| 00000301 $a03$c$b03$c
     -| 00000401 $a04$c$b04$c
     -| 00000501 $a05$c$b05$c
     -| 00000601 $a06$c$b06$c
     -| 00000701 $a07$c$b07$c
     -| 00000801 $a08$c$b08$c
     -| 00000901 $a09$c$b09$c
     -| 00001001 $a10$c$b10$c
     -| 00001101 $a11$c$b11$c
     -| 00001201 $a12$c$b12$c

The result for the years 1996...2002 is as follows:

     $ gcal -H no -u -x -f ./demo-2.rc 1996+2002
     -|
     -| Sun, Sep   1st 1996: 13-Sep-1996 is a Friday
     -| Sun, Dec   1st 1996: 13-Dec-1996 is a Friday
     -|
     -| Sun, Jun   1st 1997: 13-Jun-1997 is a Friday
     -|
     -| Sun, Feb   1st 1998: 13-Feb-1998 is a Friday
     -| Sun, Mar   1st 1998: 13-Mar-1998 is a Friday
     -| Sun, Nov   1st 1998: 13-Nov-1998 is a Friday
     -|
     -| Sun, Aug   1st 1999: 13-Aug-1999 is a Friday
     -|
     -| Sun, Oct   1st 2000: 13-Oct-2000 is a Friday
     -|
     -| Sun, Apr   1st 2001: 13-Apr-2001 is a Friday
     -| Sun, Jul   1st 2001: 13-Jul-2001 is a Friday
     -|
     -| Sun, Sep   1st 2002: 13-Sep-2002 is a Friday
     -| Sun, Dec   1st 2002: 13-Dec-2002 is a Friday

Of course, preceding textual expense for the purpose of detecting all
Fridays the 13th of a year can be dramatically reduced by simply using
of

     0*d1fri#99fri.7 Friday the 13th%i00000013#00000013

in the resource file 'demo-1.rc', respectively,

     0*d1sun#99sun.7 %n+12 is a Friday%i00000001#00000001

in the 'demo-2.rc' resource file.

On the one hand, preceding _one-liners_ reduce the coding expense quite
considerably --from 28 respectively 15 lines to 1 line in each case--,
but on the other hand, this partly increases the checking expense of
these _one-liners_ considerably and result in a longer program run-time
therefore.  Both _one-liners_ produce about 52 internal productions
respectively effective fixed date entries of themselves for each year
checked by Gcal, at which the 'demo-1.rc' and 'demo-2.rc' resource files
cause 24 respectively 12 effective fixed date entries only.
  And here is a resource file by the name of 'demo-3.rc', used to detect
all working-days of any month:

     $ cat demo-3.rc
     -| ; demo-3.rc
     -| ;
     -| $a=%VWork day
     -| $c=%i#0000$b99
     -| a=$bmon1
     -| 0@a#+4 $a
     -| a=$btue1
     -| 0@a#+3 $a
     -| a=$bwed1
     -| 0@a#+2 $a
     -| a=$bthu1
     -| 0@a#+1 $a
     -| a=$bfri1
     -| 0@a $a
     -| a=$bmon2
     -| 0@a#+4 $a
     -| a=$bmon3
     -| 0@a#+4 $a
     -| a=$bmon4
     -| 0@a#+4 $a$c
     -| a=$bmon9
     -| 0@a#+4 $a$c

Respectively a bit shorter version of the resource file 'demo-3.rc':

     ; demo-3.rc
     ;
     $a=%VWork day
     $c=%i#0000$b99
     0000$bmon1:5 $a
     0000$btue1:4 $a
     0000$bwed1:3 $a
     0000$bthu1:2 $a
     0000$bfri1:1 $a
     0000$bmon2:5 $a
     0000$bmon3:5 $a
     0000$bmon4:5 $a$c
     0000$bmon9:5 $a$c

And a resource file by the name of 'include.rc' exists which is only
used to include one given resource file:

     $ cat include.rc
     -| #include "$f"

Then the result for the month August 1996 is as follows:

     $ gcal -H no -u -x -r '$b=08:$f=demo-3.rc' -f ./include.rc Aug 1996
     -|
     -| Thu, Aug   1st 1996: Work day
     -| Fri, Aug   2nd 1996: Work day
     -| Mon, Aug   5th 1996: Work day
     -| Tue, Aug   6th 1996: Work day
     -| Wed, Aug   7th 1996: Work day
     -| Thu, Aug   8th 1996: Work day
     -| Fri, Aug   9th 1996: Work day
     -| Mon, Aug  12th 1996: Work day
     -| Tue, Aug  13th 1996: Work day
     -| Wed, Aug  14th 1996: Work day
     -| Thu, Aug  15th 1996: Work day
     -| Fri, Aug  16th 1996: Work day
     -| Mon, Aug  19th 1996: Work day
     -| Tue, Aug  20th 1996: Work day
     -| Wed, Aug  21st 1996: Work day
     -| Thu, Aug  22nd 1996: Work day
     -| Fri, Aug  23rd 1996: Work day
     -| Mon, Aug  26th 1996: Work day
     -| Tue, Aug  27th 1996: Work day
     -| Wed, Aug  28th 1996: Work day
     -| Thu, Aug  29th 1996: Work day
     -| Fri, Aug  30th 1996: Work day

And of course, the preceding textual expense for the purpose of
detecting all work days of any month can be dramatically reduced by
simply using of

     00000001#0099 %V%rWork day

in the resource file 'demo-3.rc'.

  And next the resource file by the name of 'sun-1.rc' which detects the
actual local time, the approximate time of sunrise and sunset, day and
night length of two geographic locations:

     $ cat sun-1.rc
     -| ; sun-1.rc, comparison of sunrise / sunset, day length and night
     -| ; length of two locations, namely:  Muenster.DE / Bangkok.TH
     -| ; All references are based on Muenster.DE !
     -| ;
     -| ; Common definitions
     -| $p=0*d1#999
     -| $v=%2%4 for that places local time
     -| $z=actual local time in
     -| ; Definitions for winter time
     -| $a=%e#1980 %e0@a#0@b-1
     -| $x=Sun:~%o$c,$w rise, %s$c,$w set, %u$c,$w day, %z$c,$w night~$l
     -| ; Winter time in Germany == CEWT/GMT-1 (+60 minutes)
     -| $w=+60
     -| ; Starting date of winter time in Germany
     -| b=10sun9
     -| ; Definitions for summer time (daylight-saving time)
     -| $b=%e#1980 %i0@a#0@b-1
     -| $y=Sun:~%o$c,$s rise, %s$c,$s set, %u$c,$s day, %z$c,$s night~$l
     -| ; Summer time in Germany == CEST/GMT-2 (+120 minutes)
     -| $s=+120
     -| ; Starting date of summer time in Germany
     -| a=03sun9
     -| ; Geographic co-ordinate and name of the location Muenster, Germany
     -| $c=+5158+00738+61
     -| $l=%1Muenster
     -| ; Muenster's local time sunrise etc. for that places local time
     -| $p $a $x$v
     -| $p $b $y$v
     -| ; Muenster's actual local time
     -| 0 $a %1%@$w %2 $z $l
     -| 0 $b %1%@$s %2 $z $l
     -| ; Geographic co-ordinate and name of the location Bangkok, Thailand
     -| $c=+1345+10031+10
     -| $l=%3Bangkok%4-time converted to $l's%2 local time
     -| ; Bangkok's sunrise etc. based on Muenster's local time
     -| $p $a $x
     -| $p $b $y
     -| ; Bangkok's local time == WAST/GMT-7 (+420 minutes)
     -| $t=+420
     -| $w=$t
     -| ; Bangkok's actual local time
     -| $l=%3Bangkok
     -| 0 $a %3%@$t %4 $z $l
     -| 0 $b %3%@$t %4 $z $l
     -| ; Bangkok's sunrise etc. for that places local time
     -| $l=$l$v
     -| $p $x

The result for the 12th September 1999 is as follows:

     $ gcal -fsun-1.rc -Ux -Hno
     -|
     -| 18:53/12-Sep-1999 actual local time in Muenster
     -| 23:53/12-Sep-1999 actual local time in Bangkok
     -| Sun:
     -| 01:06rise, 13:22set, 12h16'day, 11h44'night
     -| Bangkok-time converted to Muenster's local time
     -| Sun:
     -| 06:06rise, 18:22set, 12h16'day, 11h44'night
     -| Bangkok for that places local time
     -| Sun:
     -| 06:56rise, 19:54set, 12h58'day, 11h02'night
     -| Muenster for that places local time

  The next example is the resource file 'redir-1.rc' which demonstrates
the use of the shell command '%![ARGUMENT]' special text:

     $ cat redir-1.rc
     -| ; redir.rc, run shell command $c and redirect it to $f
     -| ;
     -| $p=0*d1#999
     -| $c=$p %!$c
     -| $g=|txt2gcal - $p
     -| ;
     -| $c $g>$f

The result of succeeding call of Gcal, to which you can also add the
'--debug=all' option for a better understanding of the execution
methods, is as follows:

     $ gcal --exe -QUx -f./redir-1.rc+XX -r'$f=XX:$c=echo $f' -#'0 %!rm $f'
     -| XX

  And finally a resource file by the name of 'swtim-1.rc' which produces
fixed date messages reminding Daylight Saving that are valid since 1981
for the Federal Republic of Germany(1) (*note Resource file
examples-Footnote-1::).

     $ cat swtim-1.rc
     -| ; swtim-1.rc, daylight-saving time BRD
     -| ;
     -| $a=daylight-saving time starts Sunday
     -| ;
     -| a=03sun9
     -| 0@a-2#+2 Summer $a~+1 hrs. (02:00 --> 03:00 h.)%i1981
     -| ;
     -| a=09sun9
     -| 0@a-2#+2 Winter $a~-1 hrs. (03:00 --> 02:00 h.)%i1981#1995
     -| ;
     -| a=10sun9
     -| 0@a-2#+2 Winter $a~-1 hrs. (03:00 --> 02:00 h.)%i1996

The result for the year 1998 is as follows:

     $ gcal %1998 -Hno -xy -f ./swtim-1.rc
     -|
     -| Fri, Mar  27th 1998: Summer daylight-saving time starts Sunday
     -|                      +1 hrs. (02:00 --> 03:00 h.)
     -| Sat, Mar  28th 1998: Summer daylight-saving time starts Sunday
     -|                      +1 hrs. (02:00 --> 03:00 h.)
     -| Sun, Mar  29th 1998: Summer daylight-saving time starts Sunday
     -|                      +1 hrs. (02:00 --> 03:00 h.)
     -| Mon, Mar  30th 1998: Summer daylight-saving time starts Sunday
     -|                      +1 hrs. (02:00 --> 03:00 h.)
     -| Tue, Mar  31st 1998: Summer daylight-saving time starts Sunday
     -|                      +1 hrs. (02:00 --> 03:00 h.)
     -| Fri, Oct  23rd 1998: Winter daylight-saving time starts Sunday
     -|                      -1 hrs. (03:00 --> 02:00 h.)
     -| Sat, Oct  24th 1998: Winter daylight-saving time starts Sunday
     -|                      -1 hrs. (03:00 --> 02:00 h.)
     -| Sun, Oct  25th 1998: Winter daylight-saving time starts Sunday
     -|                      -1 hrs. (03:00 --> 02:00 h.)
     -| Mon, Oct  26th 1998: Winter daylight-saving time starts Sunday
     -|                      -1 hrs. (03:00 --> 02:00 h.)
     -| Tue, Oct  27th 1998: Winter daylight-saving time starts Sunday
     -|                      -1 hrs. (03:00 --> 02:00 h.)


File: gcal.info,  Node: Resource file examples-Footnotes,  Up: Resource file examples

   (1) Two days before adaptation till two days after adaptation.


File: gcal.info,  Node: Todays Calendar,  Next: Gcal Utilities,  Prev: Fixed Dates,  Up: Top

Appendix A Genesis of the Gregorian Calendar
********************************************

The nowadays calendar was first formulated in several inaccurate
variations by the Romans based on methods developed by the Babylonians
and Egyptians.  The aim of all these calendars was to harmonize the
cycles of the Moon and the Sun.  During Julius Caesar's reign, January
was falling in autumn so he ordered Sosigenes to make changes to the
calendar.  He added 90 days to the year 46 BC to make up for the
seasonal drift and adjusted the lengths of the months similarly as we
know them to be today.  He introduced the leap year by adding one day to
February every four years.  For the present, the leap year regulation
was made in the way that all four years after the 23rd day in February a
leap day was laid in, so the 24th February occurred twice.  The use of
the leap year was an improvement but not entirely accurate.

  But in the later years, the leap rule was used in the wrong way so
that the errors are corrected by emperor Augustus in the year 8 BC.  A
curious sequel happened on this occasion.  Because Augustus reacted with
great jealousy to all things previously made and propagated by Julius
Caesar, he did not like Caesar's name in the calendar, namely the
today's month of *July*.  Offhandedly he ordered to name another month
to himself and so the month name *August* arose.  Furthermore, Augustus
did not tolerate the fact that his month of birth (the August) was
shorter than Caesar's month in the sense of the periodical sequence of
months with 30 and 31 days.  Consequently, the month of August got 31
days, too.  Due to this modification, the number of days in February
were reduced to 28 and 29 days, respectively, so the 29th February was
designed to be the leap day now.

  This calendar is well known under the term "Julian calendar" and is
based on a plain solar year.  The nominal length of a solar year
(respectively a so-called tropical year) is 365 days, 5 hours, 48
minutes, and 46 seconds.  One 366-day year every four years equates to
an average Julian year of 365 days and 6 hours, consequently to 365.25
days.  This means, every four years, an error of 44 minutes, 56 seconds
was accumulated by this kind of calendar calculation.  Because of this
counting method, the length of the years becomes a bit too long, by more
than 11 minutes.

  By the 16th century, the vernal equinox occurred around March 11,
rather than March 21, by reason of an accumulated error of ten days.
The feast of Easter shifted away more and more from the habitual vernal
date, which must have always been celebrated on an earlier date.  So
Pope Gregory XIII introduced the new style calendar in 1582.  Thursday,
the 4th October 1582, was followed by Friday, the 15th October, by
suppressing the ten days between both dates.  Moreover, he ordained that
years ending in hundreds should not be leap years unless they are
divisible by 400.  Incidentally, the Gregorian reform compensates by 72
hours (3 days) every 400 years.  The actual excess accumulated is 74
hours, 53 minutes and 20 seconds.  The error of 2 hours, 53 minutes and
20 seconds every 400 years accumulates to one day in about 3300 years.
Thereby, the Gregorian year has an average length of 365.2425 days.

  But this "Gregorian calendar" was accepted very slowly by others.
Catholic countries adopted the Gregorian calendar almost immediately.
Most Protestant countries on the Continent adopted the new calendar
around 1700.  England and the American colonies changed in 1752, by act
of Parliament.  Orthodox Christian countries adopted the Gregorian
calendar later.  Russia was the last European country to do so, after
the communist revolution of 1917.  As a result, the former U.S.S.R.
celebrated the October Revolution (happened on October 25th, 1917) in
the old style calendar on November 7th.

  The era of a world wide uniform calendar is already part of history
today.  The Iran returned to the traditional Mohammedan lunar calendar
in 1979 after removal of the Shah reign.  There are some efforts to
improve our currently valid Gregorian calendar.  Its disadvantages are
the reason why an appointed day is not always on the same week day.
Besides, the month lengths are not equal and the holidays, which have
relations to the feast of Easter, are moved within the calendar from one
year to another.  A very sophisticated suggestion was proposed by the
United Nations, but the international establishment of this suggestions
has failed, since it was resisted by some countries as well as the
churches.


File: gcal.info,  Node: Gcal Utilities,  Next: Internationalization,  Prev: Todays Calendar,  Up: Top

Appendix B Gcal Utilities
*************************

* Menu:

* Invoking tcal::      How to run 'tcal' and a summary of its options.
* Invoking txt2gcal::  How to run 'txt2gcal' and a summary of its options.
* Invoking gcal2txt::  How to run 'gcal2txt' and a summary of its options.

Three small utility programs are part of the Gcal 4.1 package.  The Tcal
program runs the Gcal program with the date set one day ahead.  The
Txt2gcal program creates a verbatim Gcal resource file from a text file,
and in contrast to this, the Gcal2txt program creates a verbatim text
file from a Gcal resource file.


File: gcal.info,  Node: Invoking tcal,  Next: Invoking txt2gcal,  Prev: Gcal Utilities,  Up: Gcal Utilities

B.1 Invoking 'tcal'
===================

The Tcal program runs the Gcal program with the date of tomorrow's
day(1) (*note Invoking tcal-Footnote-1::).  Its arguments are as
follows:

     tcal [--help | --version] | [--shift=[+|-]NUMBER] [ARGUMENT...]

All given ARGUMENTS are passed unmodified to the Gcal program.  If the
Gcal program shall be called with another date than tomorrow's date,
this desired date can be selected by using the '--shift=[+|-]NUMBER'
option, in which '[+|-]NUMBER' is the distance of days the desired date
is distant from the actual system date (==today).  (Works only for
Gregorian years.)  The '--shift' option must be given before all other
ARGUMENTS that are passed to the Gcal program.

  In case a 'GCALPROG' environment variable (*note Environment Variable
'GCALPROG': x-GCALPROG.) is defined and set with the file name of the
executable Gcal program, Tcal will use this file name for calling Gcal.
Otherwise, the file name 'gcal' --which is burned-in during the
compilation step of the Tcal program-- is used for calling the Gcal
program.  The 'GCALPROG' environment variable must always be set if the
Gcal program is installed under another name than the standard name
'gcal', otherwise Tcal is unable to execute the Gcal program
automatically!  An exit status of 0 means all processing is successfully
done, any other value means an error has occurred.

The program accepts the following options:

'--help'
     Print a usage message listing all available options, then exit
     successfully.

'--version'
     Print the version number, then exit successfully.

'--shift=[+|-]NUMBER'
     Define the displacement in '[+|-]NUMBER' days the desired date is
     distant from the actual date.


File: gcal.info,  Node: Invoking tcal-Footnotes,  Up: Invoking tcal

   (1) This is equivalent the '--shift=1' option.


File: gcal.info,  Node: Invoking txt2gcal,  Next: Invoking gcal2txt,  Prev: Invoking tcal,  Up: Gcal Utilities

B.2 Invoking 'txt2gcal'
=======================

The Txt2gcal program creates a verbatim Gcal resource file from a text
file.  Its arguments are as follows:

     txt2gcal [--help | --version] | [TEXT-FILE|-] [DATE-PART]

If no TEXT-FILE argument is given or/but a single '-' character, the
program reads and processes all input received from the _standard input
channel_.  If no DATE-PART argument is given, Txt2gcal creates a '0' for
the date part.  All results are always shown on the _standard output
channel_.  An exit status of 0 means all processing is successfully
done, any other value means an error has occurred.

The program accepts the following options:

'--help'
     Print a usage message listing all available options, then exit
     successfully.

'--version'
     Print the version number, then exit successfully.

  Here comes an example how to use Txt2gcal.  Let us suppose there is a
text file by the name of 'tdemo-1.txt' with the following contents:

     $ cat tdemo-1.txt
     -|         Hi friends,
     -|
     -| I'm the demo text containing funny characters and character
     -| sequences like ~~ \~ % %% $a $1 %%%\
     -| %\ %s %%foo %bar \%Baz \\~ \~\ and so on...
     -| I'm be anxious how I'll be transformed by `txt2gcal'.
     -|

and Txt2gcal processes this file, redirecting the output to
'tdemo-1.rc':

     $ txt2gcal tdemo-1.txt 0*d1#999 > tdemo-1.rc
     $ cat tdemo-1.rc
     -| 0*d1#999 \        Hi friends,~\
     -| ~\
     -| I'm the demo text containing funny characters and character~\
     -| sequences like \~\~ \\~ % %% \$a $1 %%%\ ~\
     -| %\ \%s %\%foo \%bar \\%Baz \\\~ \\~\ and so on...~\
     -| I'm be anxious how I'll be transformed by `txt2gcal'.~\

then Txt2gcal has now created a new Gcal resource file 'tdemo-1.rc' from
the text file 'tdemo-1.txt'.  Let us finally see, how Gcal will
interpret this new resource file:

     $ gcal %19960101 -H no -Ax -f ./tdemo-1.rc
     -|
     -| Mon, Jan   1st 1996:
     -|         Hi friends,
     -|
     -| I'm the demo text containing funny characters and character
     -| sequences like ~~ \~ % %% $a $1 %%%\
     -| %\ %s %%foo %bar \%Baz \\~ \~\ and so on...
     -| I'm be anxious how I'll be transformed by `txt2gcal'.
     -|


File: gcal.info,  Node: Invoking gcal2txt,  Prev: Invoking txt2gcal,  Up: Gcal Utilities

B.3 Invoking 'gcal2txt'
=======================

The Gcal2txt program creates a verbatim text file from a Gcal resource
file.  Its arguments are as follows:

     gcal2txt [--help | --version] | [RESOURCE-FILE|-]

If no RESOURCE-FILE argument is given or/but a single '-' character, the
program reads and processes all input received from the _standard input
channel_.  All results are always shown on the _standard output
channel_.  An exit status of 0 means all processing is successfully
done, any other value means an error has occurred.

  The sense and purpose of Gcal2txt is to retrieve all additional texts,
which are put into the output by means of the Txt2gcal program.

The program accepts the following options:

'--help'
     Print a usage message listing all available options, then exit
     successfully.

'--version'
     Print the version number, then exit successfully.

  Here comes an example how to use Gcal2txt.  For that purpose, let us
use the resource file 'tdemo-1.rc' of the previous section (*note
Invoking 'txt2gcal': Invoking txt2gcal.), which was created by means of
the Txt2gcal program from a text file and which looks like this:

     $ txt2gcal tdemo-1.txt 0*d1#999 > tdemo-1.rc
     $ cat tdemo-1.rc
     -| 0*d1#999 \        Hi friends,~\
     -| ~\
     -| I'm the demo text containing funny characters and character~\
     -| sequences like \~\~ \\~ % %% \$a $1 %%%\ ~\
     -| %\ \%s %\%foo \%bar \\%Baz \\\~ \\~\ and so on...~\
     -| I'm be anxious how I'll be transformed by `txt2gcal'.~\

Now let us see, how this resource file will be processed by Gcal2txt:

     $ gcal2txt tdemo-1.rc
     -|         Hi friends,
     -|
     -| I'm the demo text containing funny characters and character
     -| sequences like ~~ \~ % %% $a $1 %%%\
     -| %\ %s %%foo %bar \%Baz \\~ \~\ and so on...
     -| I'm be anxious how I'll be transformed by `txt2gcal'.


File: gcal.info,  Node: Internationalization,  Next: Metasymbols,  Prev: Gcal Utilities,  Up: Top

Appendix C Aspects in Internationalization
******************************************

Starting with version 2.00, Gcal is able to display message texts using
any native languages instead of using the English language only, because
parts of the GNU 'gettext' package are integrated into the Software.
*Note Introduction: (gettext)Top, for more details.

  By default, Gcal displays all message texts using the English native
language in case no other native language is wanted.  A so-called
_message catalog_ is read by Gcal at run-time if message texts from
another native language are required.  Gcal 4.1 supports the following
native languages:

*Native Language*        *Language Code*
 
English                  'en'
German                   'de'
French                   'fr'
Dutch                    'nl'
Polish                   'pl'
Russian                  'ru'
Swedish                  'sv'

It is only necessary to set one of the environment variables(1) (*note
Internationalization-Footnote-1::):

1.  'LANGUAGE'
2.  'LC_ALL'
3.  'LC_MESSAGES'
4.  'LANG'

with a language code to select another native language instead of the
English native language.

  Normally, users only have to set the 'LANG' environment variable to
tell Gcal the native language to use at run-time level.  Presuming users
want to run Gcal using the German native language for displaying message
texts, they merely have to execute 'setenv LANG de' (in 'csh') or
'export LANG; LANG=de' (in 'sh') at the shell prompt.  Of course they
could even do this from their '.login' or '.profile' file.  *Note The
User's View: (gettext)Users, for more details.

  As shown above, a simple setting of 'de' in the environment variable
'LANG' is sufficient to enable German message texts.  'de' is the
two-letter language code for the German language defined in the
ISO-639:1988, and is called "simple language code information" in the
further context.  Other language codes can be taken from this
ISO-document(2) (*note Internationalization-Footnote-2::).

  Because Gcal as calendar program must also comply the specifics of a
used native language concerning the ordering of day, month and year (and
further things) of a displayed date, the period of Gregorian
Reformation, the type of week number and the representation of calendar
sheets, these criteria are likewise bound to the language code(3) (*note
Internationalization-Footnote-3::).

A 'en' language code causes the following internal defaults of above
criteria:

   * U.S. American date format

   * Gregorian Reformation has occurred 1752

   * Week starts on Sunday

   * Standard week numbers

   * Representation of calendar sheet

             September 1994
          Su Mo Tu We Th Fr Sa
                       1  2  3
           4  5  6  7  8  9 10
          11 12 13 14 15 16 17
          18 19 20 21 22 23 24
          25 26 27 28 29 30

And a 'de' language code(4) (*note Internationalization-Footnote-4::)
causes the following internal defaults:

   * German date format

   * Gregorian Reformation has occurred 1582

   * Week starts on Monday

   * ISO-8601:1988 week numbers

   * Representation of calendar sheet

          September 1994

          Monday          5 12 19 26
          Tuesday         6 13 20 27
          Wednesday       7 14 21 28
          Thursday     1  8 15 22 29
          Friday       2  9 16 23 30
          Saturday     3 10 17 24
          Sunday       4 11 18 25

  Remember, all these internal defaults are modifiable by the options
'--date-format', '--gregorian-reform', '--starting-day',
'--iso-week-number' and '--type'.

  If no language code is detected, Gcal takes the internal defaults of
the 'en' language code(5) (*note Internationalization-Footnote-5::).

  If a language code is specified for which no _message catalog_ is
installed, Gcal takes the internal defaults of the 'de' language code,
but displays the message texts using the English native language.
Actually, this behavior seems to me the most proper solution in such a
case.  The English native language is spoken all over the world unlike
the German or other native languages, so it is wise to use it here.  But
the other criteria bound to the English native language are so special
for users of other native languages, that it is wise to use the criteria
taken for internal defaults of the 'de' language code, because most
European countries (taken as standard) essentially use them.

  Now British users will certainly ask whether they could use their date
format as an internal default(6) (*note
Internationalization-Footnote-6::).  The answer to this is a simple
'yes', nevertheless, these users have to set the environment variable
'LANG' with an "extended language code information" instead of a simple
language code information.

The usual template of an extended language code information is as
follows:

   * For XPG syntax (X/Open Portability Guide):
          LANGUAGE[_TERRITORY][.CODESET][@MODIFIER]

   * For CEN syntax (Comite' Europe'n de Normalisation):
          LANGUAGE[_TERRITORY][+AUDIENCE][+SPECIAL][,SPONSOR][_REVISION]

  Both syntaxes contain the LANGUAGE and TERRITORY components, which are
used by Gcal to select the native language and the other criteria.  The
LANGUAGE component is equivalent to the simple language code information
and the TERRITORY component is a two-letter territory or country code as
defined by the ISO-3166 like 'GB' for Great Britain or 'US' for the
U.S.A.  See the pertinent literature for more details.  So British users
only have to set the 'LANG' environment variable with a 'en_GB'
contents, and after that, they can use the British date format as an
internal default.


File: gcal.info,  Node: Internationalization-Footnotes,  Up: Internationalization

   (1) Listed in decreasing priority as they are respected.

   (2) For example 'fr' for French, 'es' for Spanish...

   (3) Strictly speaking, an extended language code information.

   (4) Or other language codes, for which a _message catalog_ will be
created and distributed in future.

   (5) Or to be more precise, of the extended language code information
'en_US'.

   (6) All other internal defaults of the simple 'en' language code
information just meet their criteria.


File: gcal.info,  Node: Metasymbols,  Next: Regular Expressions,  Prev: Internationalization,  Up: Top

Appendix D Metasymbols
**********************

Within this document, the following _metasyntactic_ conventions will be
used when discussing command line options, commands, arguments and
templates:

'N'
     Argument is not optional and N must be a valid number.

'e|t|DVAR'
     Argument is not optional and must be a single alphabetic character.

'$TVAR'
     Argument is not optional and must be a single alphabetic character,
     that is lead by a '$' character.

'[TEXT]'
     Argument is optional and TEXT is a valid string of text.

'[AB]'
     Arguments are optional, any number may be used in any order, e.g.:

          NOTHING, A, B, AB, BA ...

'{AB}'
     Arguments are not optional, minimum one up to any number may be
     used in any order, e.g.:

          A, B, AB, BA ...

'[A|B]'
     Arguments are optional, select either A or B, but not both.

'A|B'
     Arguments are not optional, select either A or B, but not both.

'[A[B]]'
     Arguments are optional, select either A or AB, but not B.

'[A|B[C]]'
     Arguments are optional, select A or B or AC or BC, but not C.

'[A|BC]'
     Arguments are optional, select either AC or BC, but not A or B or
     C.

'[A]|[B]'
     Argument _lists_ are optional, select either list A or list B, but
     not both.

'[...]'
     Additional arguments/files may be specified and are optional.


File: gcal.info,  Node: Regular Expressions,  Next: Regexp Summary,  Prev: Metasymbols,  Up: Top

Appendix E Regular Expressions
******************************

* Menu:

* Regexp Usage::      How to Use Regular Expressions.
* Regexp Operators::  Regular Expression Operators.

This appendix is derived from the 'gawk-3.0.0' and 'regex-0.12' manuals.

  A "regular expression", or "regexp", is a way of describing a set of
strings.  The simplest regular expression is a sequence of letters,
numbers, or both.  Such a regexp matches any string that contains that
sequence.  Thus, the regexp 'foo' matches any string containing 'foo'.
Other kinds of regular expressions let you specify more complicated
classes of strings.

  Gcal uses exactly one of the following regular expression programming
libraries respectively methods, and that in the decreasing priority how
it is chosen at configuration time, or better, compile time of the
software:

*No.**Function*                                             *Symbol*
 
1.   GNU 're_compile_pattern()' and 'regex.h'               'GNU-REGEX'
2.   POSIX 'regcomp()' and 'regex.h'                        'POSIX-REGEX'
3.   BSD 're_comp()'                                        'BSD-REGEX'
4.   System V 'regcmp()'                                    'SysV-REGEX'
5.   Henry Spencer V8 'regcomp()' and 'regexp.h'            'V8-REGEX'
6.   Pattern matching is supported, but without             'NO-REGEX'
     metacharacters

Try 'gcal --version' for detecting the kind of regular expression
programming library respectively method that is burned in your Gcal
program!


File: gcal.info,  Node: Regexp Usage,  Next: Regexp Operators,  Prev: Regular Expressions,  Up: Regular Expressions

E.1 How to Use Regular Expressions
==================================

A regular expression can be used as a pattern if Gcal's
'--filter-text=PATTERN' option is specified at program start-up.

  *Note Fixed date option '--filter-text=PATTERN': x-filter-text, for
more details.

  Then the regular expression is tested against the entire, completely
expanded text of each *valid* fixed date, and the fixed date is only
displayed in case the pattern matches the text(1) (*note Regexp
Usage-Footnote-1::).


File: gcal.info,  Node: Regexp Usage-Footnotes,  Up: Regexp Usage

   (1) Normally, it only needs to match some part of the text in order
to succeed.


File: gcal.info,  Node: Regexp Operators,  Prev: Regexp Usage,  Up: Regular Expressions

E.2 Regular Expression Operators
================================

You can combine regular expressions with the following characters,
called "regular expression operators", or "metacharacters", to increase
the power and versatility of regular expressions.

  Here is a table of these metacharacters.  All characters that are not
listed in the table stand for themselves.

'\'
     This is used to suppress the special meaning of a character when
     matching.  For example:

          \$

     matches the character '$'.

'^'
     This matches the beginning of a string.  For example:

          ^@chapter

     matches the '@chapter' at the beginning of a string, and can be
     used to identify chapter beginnings in Texinfo source files.  The
     '^' is known as an "anchor", since it anchors the pattern to
     matching only at the beginning of the string.

'$'
     This is similar to '^', but it matches only at the end of a string.
     For example:

          p$

     matches a string that ends with a 'p'.  The '$' is also an anchor.

'.'
     The period, or dot, matches any single character.  For example:

          .P

     matches any single character followed by a 'P' in a string.  Using
     concatenation we can make a regular expression like 'U.A', which
     matches any three-character sequence that begins with 'U' and ends
     with 'A'.

'[...]'
     This is called a "character list".  It matches any _one_ of the
     characters that are enclosed in the square brackets.  For example:

          [MVX]

     matches any one of the characters 'M', 'V', or 'X' in a string.

     Ranges of characters are indicated by using a hyphen between the
     beginning and ending characters, and enclosing the whole thing in
     brackets.  For example:

          [0-9]

     matches any digit.  Multiple ranges are allowed.  E.g., the list
     '[A-Za-z0-9]' is a common way to express the idea of "all
     alphanumeric characters."

     To include one of the characters '\', ']', '-' or '^' in a
     character list, put a '\' in front of it.  For example:

          [d\]]

     matches either 'd', or ']'.

     "Character classes" are a new feature introduced in the POSIX
     standard.  A character class 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.  For example, the
     notion of what is an alphabetic character differs in the U.S.A. and
     in France.

     A character class is only valid in a regexp _inside_ the brackets
     of a character list.  Character classes consist of '[:', a keyword
     denoting the class, and ':]'.  Here are the character classes
     defined by the POSIX standard:

     '[:alnum:]'
          Alphanumeric characters.

     '[:alpha:]'
          Alphabetic characters.

     '[:blank:]'
          Space and tab characters.

     '[:cntrl:]'
          Control characters.

     '[:digit:]'
          Numeric characters.

     '[:graph:]'
          Characters that are printable and are also visible(1) (*note
          Regexp Operators-Footnote-1::).

     '[:lower:]'
          Lower-case alphabetic characters.

     '[:print:]'
          Printable characters(2) (*note Regexp Operators-Footnote-2::).

     '[:punct:]'
          Punctuation characters(3) (*note Regexp
          Operators-Footnote-3::).

     '[:space:]'
          Space characters(4) (*note Regexp Operators-Footnote-4::).

     '[:upper:]'
          Upper-case alphabetic characters.

     '[:xdigit:]'
          Characters that are hexadecimal digits.

     For example, before the POSIX standard, to match alphanumeric
     characters, you had to write '[A-Za-z0-9]'.  If your character set
     had other alphabetic characters in it, this would not match them.
     With the POSIX character classes, you can write '[[:alnum:]]', and
     this will match _all_ the alphabetic and numeric characters in your
     character set.

     Two additional special sequences can appear in character lists.
     These apply to non-ASCII character sets, which can have single
     symbols (called "collating elements") that are represented with
     more than one character, as well as several characters that are
     equivalent for collating, or sorting, purposes.  (E.g., in French,
     a plain 'e' and a grave-accented 'e`' are equivalent.)

     Collating Symbols
          A "collating symbol" is a multi-character collating element
          enclosed in '[.' and '.]'.  For example, if 'ch' is a
          collating element, then '[[.ch.]]' is a regexp that matches
          this collating element, while '[ch]' is a regexp that matches
          either 'c' or 'h'.

     Equivalence Classes
          An "equivalence class" is a list of equivalent characters
          enclosed in '[=' and '=]'.  Thus, '[[=ee`=]]' is a regexp that
          matches either 'e' or 'e`'.

     These features are very valuable in non-English speaking locales.

     *Caution:*
     The library functions that Gcal uses for regular expression
     matching currently only recognize POSIX character classes
     (possibly); they do not recognize collating symbols or equivalence
     classes.

'[^ ...]'
     This is a "negated character list" respectively "complemented
     character list".  The first character after the '[' _must_ be a
     '^'.  It matches any characters _except_ those in the square
     brackets.  For example:

          [^0-9]

     matches any character that is not a digit.

'|'
     This is the "alternation operator", and it is used to specify
     alternatives.  For example:

          ^P|[0-9]

     matches any string that matches either '^P' or '[0-9]'.  This means
     it matches any string that starts with 'P' or contains a digit.

     The alternation applies to the largest possible regexps on either
     side.  In other words, '|' has the lowest precedence of all the
     regular expression operators.

'(...)'
     Parentheses are used for grouping in regular expressions as in
     arithmetic.  They can be used to concatenate regular expressions
     containing the alternation operator, '|'.  For example,
     '@(samp|code)\{[^}]+\}' matches both '@code{foo}' and '@samp{bar}'.
     (These are Texinfo formatting control sequences.)

'*'
     This symbol means that the preceding regular expression is to be
     repeated as many times as necessary to find a match.  For example:

          ph*

     applies the '*' symbol to the preceding 'h' and looks for matches
     of one 'p' followed by any number of 'h's.  This will also match
     just 'p' if no 'h's are present.

     The '*' repeats the _smallest_ possible preceding expression.  (Use
     parentheses if you wish to repeat a larger expression.)  It finds
     as many repetitions as possible.  For example:

          gcal --filter-text='\(c[ad][ad]*r x\)' -f sample.rc -y

     prints every fixed date in 'sample.rc' containing a fixed date text
     of the form '(car x)', '(cdr x)', '(cadr x)', and so on.  Notice
     the escaping of the parentheses by preceding them with backslashes.

'+'
     This symbol is similar to '*', but the preceding expression must be
     matched at least once.  This means that:

          wh+y

     would match 'why' and 'whhy' but not 'wy', whereas 'wh*y' would
     match all three of these strings.  This is a simpler way of writing
     the last '*' example:

          gcal --filter-text='\(c[ad]+r x\)' -f sample.rc -y

'?'
     This symbol is similar to '*', but the preceding expression can be
     matched either once or not at all.  For example:

          fe?d

     will match 'fed' and 'fd', but nothing else.

'{N}'
'{N,}'
'{N,M}'
     One or two numbers inside braces denote an "interval expression"
     which is available in the POSIX standard.  If there is one number
     in the braces, the preceding regexp is repeated N times.  If there
     are two numbers separated by a comma, the preceding regexp is
     repeated N to M times.  If there is one number followed by a comma,
     then the preceding regexp is repeated at least N times.

     'wh{3}y'
          matches 'whhhy' but not 'why' or 'whhhhy'.

     'wh{3,5}y'
          matches 'whhhy' or 'whhhhy' or 'whhhhhy', only.

     'wh{2,}y'
          matches 'whhy' or 'whhhy', and so on.

  GNU software that deals with regular expressions provides a number of
additional regexp operators.  These operators are described here.

  Most of the additional operators are for dealing with word matching.
For our purposes, a "word" is a sequence of one or more letters, digits,
or underscores ('_').

'\w'
     This operator matches any word-constituent character, i.e. any
     letter, digit, or underscore.  Think of it as a short-hand for
     '[A-Za-z0-9_]' or '[[:alnum:]_]'.

'\W'
     This operator matches any character that is not word-constituent.
     Think of it as a short-hand for '[^A-Za-z0-9_]' or '[^[:alnum:]_]'.

'\<'
     This operator matches the empty string at the beginning of a word.
     For example, '\<away' matches 'away', but not 'stowaway'.

'\>'
     This operator matches the empty string at the end of a word.  For
     example, 'stow\>' matches 'stow', but not 'stowaway'.

'\b'
     This operator matches the empty string at either the beginning or
     the end of a word (the word *b*oundary).  For example, '\bballs?\b'
     matches either 'ball' or 'balls' as a separate word.

'\B'
     This operator matches the empty string within a word.  In other
     words, '\B' matches the empty string that occurs between two
     word-constituent characters.  For example, '\Brat\B' matches
     'crate', but it does not match 'dirty rat'.  '\B' is essentially
     the opposite of '\b'.

  There are two other operators that work on buffers.  In Emacs, a
"buffer" is, naturally, an Emacs buffer.  For other programs, the regexp
library routines that Gcal uses consider the entire string to be matched
as the buffer(5) (*note Regexp Operators-Footnote-5::).

  For Gcal, since '^' and '$' always work in terms of the beginning and
end of strings, these operators do not add any new capabilities.  They
are provided for compatibility with other GNU software.

'\`'
     This operator matches the empty string at the beginning of the
     buffer.

'\''
     This operator matches the empty string at the end of the buffer.

  In regular expressions, the '*', '+', and '?' operators, as well as
the braces '{' and '}', have the highest precedence, followed by
concatenation, and finally by '|'.  As in arithmetic, parentheses can
change how operators are grouped.

  Case is normally significant in regular expressions, both when
matching ordinary characters (i.e. not metacharacters), and inside
character sets.  Thus a 'w' in a regular expression matches only a
lower-case 'w' and not an upper-case 'W'.

  The simplest way to do a case-independent match is to use a character
list: '[Ww]'.  However, this can be cumbersome if you need to use it
often; and unfortunately, it can make the regular expressions harder to
read.  Supplying a want, Gcal offers the '--ignore-case' option which
ignores all case distinctions in both the regular expression and the
completely expanded text of each *valid* fixed date.  *Note Fixed date
option '--ignore-case': x-ignore-case.


File: gcal.info,  Node: Regexp Operators-Footnotes,  Up: Regexp Operators

   (1) A space is printable, but not visible, while an 'a' is both.

   (2) Characters that are not control characters.

   (3) Characters that are not letter, digits, control characters, or
space characters.

   (4) Such as Space, Tab, and Form-feed, to name a few.

   (5) That is the _text part_ of a Gcal resource file line.


File: gcal.info,  Node: Regexp Summary,  Next: Special Texts,  Prev: Regular Expressions,  Up: Top

Appendix F Summary of all Regular Expressions
*********************************************

Regular expressions are based on POSIX EREs (Extended Regular
Expressions).  Regexps are composed of characters.  Here is a short-list
of them all:

'C'
     matches the character C (assuming C is none of the characters
     listed below).

'\C'
     matches the literal character C.

'.'
     matches any character.

'^'
     matches the beginning of a string.

'$'
     matches the end of a string.

'[ABC...]'
     matches any of the characters ABC... (character list).

'[[:KEYWORD:]]'
     matches any character in the character class KEYWORD.  Allowable
     classes are 'alnum', 'alpha', 'blank', 'cntrl', 'digit', 'graph',
     'lower', 'print', 'punct', 'space', 'upper', and 'xdigit'.

'[[.ELEMENT.]]'
     matches the multi-character collating ELEMENT.  Gcal does not
     currently support collating symbols.

'[[=LIST=]]'
     matches any of the equivalent characters in LIST.  Gcal does not
     currently support equivalence classes.

'[^ABC...]'
     matches any character except ABC... (negated resp. complemented
     character list).

'R1|R2'
     matches either R1 or R2 (alternation).

'R1R2'
     matches R1, and then R2 (concatenation).

'R+'
     matches one or more R's.

'R*'
     matches zero or more R's.

'R?'
     matches zero or one R's.

'(R)'
     matches R (grouping).

'R{N}'
'R{N,}'
'R{N,M}'
     matches at least N, N to any number, or N to M occurrences of R
     (interval expressions).

'\b'
     matches the empty string at either the beginning or the end of a
     word.

'\B'
     matches the empty string within a word.

'\<'
     matches the empty string at the beginning of a word.

'\>'
     matches the empty string at the end of a word.

'\w'
     matches any word-constituent character (alphanumeric characters and
     the underscore).

'\W'
     matches any character that is not word-constituent.

'\`'
     matches the empty string at the beginning of a buffer(1) (*note
     Regexp Summary-Footnote-1::).

'\''
     matches the empty string at the end of a buffer.


File: gcal.info,  Node: Regexp Summary-Footnotes,  Up: Regexp Summary

   (1) The same as a _text part_ of a resource file line in Gcal.


File: gcal.info,  Node: Special Texts,  Next: Special Texts Summary,  Prev: Regexp Summary,  Up: Top

Appendix G '%?'... Special Texts
********************************

* Menu:

* Exclusions::     How to Exclude dates.
* Replacements::   How to Replace texts.
* Shell Command::  How to run a Shell Command.

The '%?'... special texts which can be used in the text part of a Gcal
resource file line can coarsely be separated into three categories.  So
there are special texts used for suppression output of fixed dates in
definite cases.  Others are replaced by particular texts or cause the
shell to start external commands.  *Note '%?'... Special Texts: Special
Texts processed, for a general description of the special texts which
may be used in the text part of a Gcal resource file line.

  Some of these special texts may have an optional format instruction
(called FORMAT in the further context), which affects the representation
of an expanded special text.  *Note Format Instruction::, for the
detailed description of the format instruction and its components.  A
possibly specified FORMAT within special texts which may not have a
format instruction is ignored by Gcal and not displayed in output.

  But Gcal is also able to represent such special texts in a special way
by using a format instruction, and that by using an indirect method.
For displaying, you simply assign the special text exclusively to a text
variable which contains a format instruction.  Nevertheless, it is
important to note that the field width component of the format
instruction is chosen in the way that it refers to the assigned contents
of the text variable, if the format instruction has a fixed format
component.  The contents assigned to the text variable is only the
special text, and not its expanded result.  Gcal has to proceed like
that, because the special text which is hidden in the text variable
could not be used (here: displayed) only for a definite date, but
possibly also for several dates, and that adjusted to each date it is
referenced.  Thus exists a special text in the text variable which has a
definite length, and a format instruction also exists, whose field width
component has to affect the expanded result of the special text.
Indeed, Gcal does not know at the moment when the assignment of the
special text to the text variable is made, of which length the expanded
result will be, because this expansion is made at a much later phase in
the program execution.  So, in such a case, the field width component of
a format instruction should have the length of the special text minimum,
otherwise it is crippled and expanded respectively displayed incorrectly
by the internal methods which effect the expansion.

  Of course, not all possibilities concerning the representation --which
are offered by the format instruction-- are listed here for those
special texts those expanded representation may be affected by an
optional FORMAT instruction, but only some few exemplary.

  And some of these special texts may also have an optional simple or
special date argument (called DATE in the further context) or another
argument (called ARGUMENT in the further context).  The DATE argument
must be given in one of the following date formats in case a special
text is directly trailed by it:

   * 'YYYY[MM[DD|WWWN]]'

   * 'YYYY*d|wN[WWW]'

   * 'YYYY@e|t|DVAR[[+|-]N[WWW]]'

  Special texts that may have a DATE argument *must* always be trailed
by a _whitespace_ character which is removed in output, no matter
whether DATE was given or not!

  *Note Summary of all '%?'... Special Texts: Special Texts Summary, for
a short-list of all applicable special texts.


File: gcal.info,  Node: Exclusions,  Next: Replacements,  Prev: Special Texts,  Up: Special Texts

G.1 '%?'... special texts for date exclusion
============================================

* Menu:

* Exclusions with date argument::
* Exclusions without any argument::

'%?'... special texts used for exclusion of points of time or periods of
dates are very useful if they are used together with ranges of days
(*note Ranges of days::).  The complete special text is always
suppressed in output in case the fixed date text must be displayed.


File: gcal.info,  Node: Exclusions with date argument,  Next: Exclusions without any argument,  Prev: Exclusions,  Up: Exclusions

G.1.1 Exclusions with date argument '%?[DATE]' special texts
------------------------------------------------------------

* Menu:

* Inclusive date period::
* Exclusive date period::

First of all, an "inclusive date" period '%?[DATE]' special text can be
specified with the effect, that only those fixed dates are respected and
displayed which are part of this period.  And the specification of an
"exclusive date" period '%?[DATE]' special text has the effect, that
only those fixed dates are respected and displayed which are not part of
this period.

  Cleverly combined, these special texts offer very effective filtration
capabilities used for the definition of special periods in a highly
flexible manner, for example:

     0*d1#999 Every day of year: from January...August except April\
              %i00001#00008 %e00004#00004
     ;
     0*d1#999 Every day of year: from 1991...1993 and from 1996\
              except February 1992 and all September\
              %i1991#1993 %i1996# %e19922#19922 %e00009#00009


File: gcal.info,  Node: Inclusive date period,  Next: Exclusive date period,  Prev: Exclusions with date argument,  Up: Exclusions with date argument

G.1.1.1 Inclusive date period '%i[DATE][#[DATE]]' special text
..............................................................

'%i[DATE][#[DATE]]' references an inclusive date period, i.e. all dates
which are part of the specified period are valid and are displayed.  Of
course this means, that all fixed dates which are not part of this
period (not covered by it) are invalid and remain undisplayed therefore.

  The first specified date defines the "starting date" of the fixed
date, i.e. the first date the fixed date may occur.  For the starting
date, the following rules concerning definite omission values are valid,
elucidated by using the 'YYYY[MM[DD|WWWN]]' date format:

   * If YYYY is set to '0000', the current year is assumed for the year.

   * If MM is not given, then '01' (==January) is assumed for the month.

   * If MM is set to '00', the current month is assumed for the month,
     and the December is assumed in case MM is set to '99'.

   * If DD|WWW is not given, then '01' is assumed for the day.

   * If DD is set to '00', the current day is assumed for the day, and
     the last day of the month MM is assumed in case DD is set to '99'.

   * If the N field is given (range '1...5' or '9'), then a WWW field
     must also be specified.

  The second specified date defines the "ending date" of the fixed date,
i.e. the last date the fixed date may occur.  For the ending date, the
following rules concerning definite omission values are valid, likewise
elucidated by using the 'YYYY[MM[DD|WWWN]]' date format:

   * If YYYY is set to '0000', the current year is assumed for the year.

   * If MM is not given, then '12' (==December) is assumed for the
     month.

   * If MM is set to '00', the current month is assumed for the month,
     and the December is assumed in case MM is set to '99'.

   * If DD|WWW is not given, the last day of the month MM is assumed for
     the day.

   * If DD is set to '00', the current day is assumed for the day, and
     the last day of the month MM is assumed in case DD is set to '99'.

   * If the N field is given (range '1...5' or '9'), then a WWW field
     must also be specified.

  The preceding rules are analogously valid for the other permitted date
formats.

  If the starting date, which is encoded in the '%i...' special text, is
later the ending date, the '%i...' special text will be ignored.

  In case neither the starting date nor the ending date is specified,
means only '%i' is given, the implicit period 1st January 1...31st
December 9999 (00010101...99991231) will be used.

  If only the starting date is specified, means either '%iDATE' or
'%iDATE#' is given, the implicit ending date 31st December 9999
(99991231) will be used.

  In case only the ending date is specified, means '%i#DATE' is given,
the implicit starting date 1st January 1 (00010101) will be used.

  For example:

     0d*1#999 Every day of year: only April and July\
              %i00004#00004 %i00007#00007
     ;
     0*d1#999 Every day of year: from January...October\
              %i#000010
     ;
     0*d1#999 Every day of year: from August 1990\
              %i19908
     ;
     0*d1#999 Every day of year: from August...December\
              %i00008
     ;
     0*d1#999 Every day of year: only today%i0@t#0@t


File: gcal.info,  Node: Exclusive date period,  Prev: Inclusive date period,  Up: Exclusions with date argument

G.1.1.2 Exclusive date period '%e[DATE][#[DATE]]' special text
..............................................................

'%e[DATE][#[DATE]]' references an exclusive date period, i.e. all dates
which are part of the specified period are invalid and remain
undisplayed therefore.  Of course this means, that all fixed dates which
are not part of this period (not covered by it) are valid and are
displayed.

  The first specified date defines the starting date of the fixed date,
i.e. the first date the fixed date may occur.  For the starting date,
the following rules concerning definite omission values are valid,
elucidated by using the 'YYYY[MM[DD|WWWN]]' date format:

   * If YYYY is set to '0000', the current year is assumed for the year.

   * If MM is not given, then '01' (==January) is assumed for the month.

   * If MM is set to '00', the current month is assumed for the month,
     and the December is assumed in case MM is set to '99'.

   * If DD|WWW is not given, then '01' is assumed for the day.

   * If DD is set to '00', the current day is assumed for the day, and
     the last day of the month MM is assumed in case DD is set to '99'.

   * If the N field is given (range '1...5' or '9'), then a WWW field
     must also be specified.

  The second specified date defines the ending date of the fixed date,
i.e. the last date the fixed date may occur.  For the ending date, the
following rules concerning definite omission values are valid, likewise
elucidated by using the 'YYYY[MM[DD|WWWN]]' date format:

   * If YYYY is set to '0000', the current year is assumed for the year.

   * If MM is not given, then '12' (==December) is assumed for the
     month.

   * If MM is set to '00', the current month is assumed for the month,
     and the December is assumed in case MM is set to '99'.

   * If DD|WWW is not given, the last day of the month MM is assumed for
     the day.

   * If DD is set to '00', the current day is assumed for the day, and
     the last day of the month MM is assumed in case DD is set to '99'.

   * If the N field is given (range '1...5' or '9'), then a WWW field
     must also be specified.

  The preceding rules are analogously valid for the other permitted date
formats.

  If the starting date, which is encoded in the '%e...' special text, is
later the ending date, the '%e...' special text will be ignored.

  In case neither the starting date nor the ending date is specified,
means only '%e' is given, the implicit period 1st January 1...31st
December 9999 (00010101...99991231) will be used.

  If only the starting date is specified, means either '%eDATE' or
'%eDATE#' is given, the implicit ending date 31st December 9999
(99991231) will be used.

  In case only the ending date is specified, means '%e#DATE' is given,
the implicit starting date 1st January 1 (00010101) will be used.

  For example:

     0d*1#999 Every day of year: except April and July\
             %e00004#00004 %e00007#00007
     ;
     0*d1#999 Every day of year: except January...October\
              %e#000010
     ;
     0*d1#999 Every day of year: until July 1990\
              %e19908
     ;
     0*d1#999 Every day of year: except August...December\
              %e00008
     ;
     0*d1#999 Every day of year: except today%e0@t#0@t


File: gcal.info,  Node: Exclusions without any argument,  Prev: Exclusions with date argument,  Up: Exclusions

G.1.2 Exclusions without any argument '%?' special texts
--------------------------------------------------------

* Menu:

* Inclusive day period::
* Exclusive day period::

First of all, an "inclusive day" period '%?' special text can be
specified with the effect, that only those fixed dates are respected and
displayed which are part of this period.  And the specification of an
"exclusive day" period '%?' special text has the effect, that only those
fixed dates are respected and displayed which are not part of this
period.

  Cleverly combined, these special texts also offer very effective
filtration capabilities used for the definition of very special periods.

  For example:

     0*d1#999 Every day of year: all Mondays...Fridays\
              except Wednesdays and all legal holidays\
              %r%F%V
     ;
     00001001#9999 Every day in last quarter of year: all holidays\
                   which are not on a Sunday%x %P


File: gcal.info,  Node: Inclusive day period,  Next: Exclusive day period,  Prev: Exclusions without any argument,  Up: Exclusions without any argument

G.1.2.1 Inclusive day period '%?' special texts
...............................................

The following inclusive day periods '%?' special texts are respected, at
which _inclusive_ is meant for the period which is not excluded.

'%v'
     Excludes fixed date in case it is not listed as legal holiday in
     the _eternal holiday list_.

'%x'
     Excludes fixed date in case it is neither listed as legal holiday
     nor memorial day in the _eternal holiday list_.

'%a'
     Excludes fixed date in case it is no Monday.

'%c'
     Excludes fixed date in case it is no Tuesday.

'%f'
     Excludes fixed date in case it is no Wednesday.

'%g'
     Excludes fixed date in case it is no Thursday.

'%h'
     Excludes fixed date in case it is no Friday.

'%l'
     Excludes fixed date in case it is no Saturday.

'%p'
     Excludes fixed date in case it is no Sunday.

'%q'
     Excludes fixed date in case it is no Monday...Thursday.

'%r'
     Excludes fixed date in case it is no Monday...Friday.


File: gcal.info,  Node: Exclusive day period,  Prev: Inclusive day period,  Up: Exclusions without any argument

G.1.2.2 Exclusive day period '%?' special texts
...............................................

The following exclusive day periods '%?' special texts are respected, at
which _exclusive_ is meant for the period which is excluded.

'%V'
     Excludes fixed date in case it is listed as legal holiday in the
     _eternal holiday list_.

'%X'
     Excludes fixed date in case it is either listed as legal holiday or
     memorial day in the _eternal holiday list_.

'%A'
     Excludes fixed date in case it is a Monday.

'%C'
     Excludes fixed date in case it is a Tuesday.

'%F'
     Excludes fixed date in case it is a Wednesday.

'%G'
     Excludes fixed date in case it is a Thursday.

'%H'
     Excludes fixed date in case it is a Friday.

'%L'
     Excludes fixed date in case it is a Saturday.

'%P'
     Excludes fixed date in case it is a Sunday.

'%Q'
     Excludes fixed date in case it is a Monday...Thursday.

'%R'
     Excludes fixed date in case it is a Monday...Friday.


File: gcal.info,  Node: Replacements,  Next: Shell Command,  Prev: Exclusions,  Up: Special Texts

G.2 '%?'... special texts for text replacement
==============================================

* Menu:

* Replacements with date argument::
* Replacements with other argument::
* Replacements without any argument::

'%?'... special texts which are replaced by particular texts at program
run-time causes the interspersing of data into the fixed date text,
which quality is essentially depending on the command line arguments
given for running the program.  The complete special text is always
replaced accordingly in output if the fixed date text must be displayed.

  Cleverly combined, these special texts also offer very effective
mechanisms used for the definition of particular texts in a highly
flexible manner, for example:

     0*d1#999 Every day of year: Today is %K, the %n (%N)


File: gcal.info,  Node: Replacements with date argument,  Next: Replacements with other argument,  Prev: Replacements,  Up: Replacements

G.2.1 Replacements with date argument '%?[DATE]' special texts
--------------------------------------------------------------

* Menu:

* Weekday name::
* Weekday number::
* Day-of-year number::
* Day number::
* Week number::
* Month name::
* Month number::
* Year number::
* Moon phase::
* Biorhythm::
* Difference value::

Apart from different representations of a weekday name, it is possible
to create its weekday number.  Likewise, the current day-of-year number,
the day number, the week number, the month name, the month number, the
year number, the Moon phase, the biorhythm, and some useful difference
values can be produced.

  For the DATE argument these '%?[DATE]' special text may have, the
following rules concerning definite omission values are valid,
elucidated by using the 'YYYY[MM[DD|WWWN]]' date format(1) (*note
Replacements with date argument-Footnote-1::):

   * If YYYY... is not given (==*no* date encoded), the current year is
     assumed for the date.

   * If YYYY is set to '0000', the current year is assumed for the year.

   * If MM is not given or set to '00', the current month is assumed for
     the month, and the December is assumed in case MM is set to '99'.

   * If DD|WWW is not given or set to '00', the current day is assumed
     for the day, and the last day of the month is assumed in case DD is
     set to '99'.

   * If the N field is given (range '1...5' or '9'), then a WWW field
     must also be specified.


File: gcal.info,  Node: Replacements with date argument-Footnotes,  Up: Replacements with date argument

   (1) The succeeding rules are analogously valid for the other
permitted date formats.


File: gcal.info,  Node: Weekday name,  Next: Weekday number,  Prev: Replacements with date argument,  Up: Replacements with date argument

G.2.1.1 Weekday name '%[FORMAT]K[DATE]' special text
....................................................

'%K[DATE]'
     Is replaced by the complete *weekday name* of the current day,
     e.g.:

          The text 'Today is %K , the %n' will be expanded to
          ==> 'Today is Monday, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996.

'%>3#K[DATE]'
     Is replaced by the 3-letter *weekday name* of the current day,
     e.g.:

          The text 'Today is %>3#K0@t+1 , the %n+1' will be expanded to
          ==> 'Today is Tue, the 11-Jun-1996', in case the actual system
          date is the 10th June 1996.

'%>2#K[DATE]'
     Is replaced by the 2-letter *weekday name* of the current day,
     e.g.:

          The text 'Today is %>2#K , the %n' will be expanded to
          ==> 'Today is Mo, the 10-Jun-1996', in case the actual system
          date is the 10th June 1996.


File: gcal.info,  Node: Weekday number,  Next: Day-of-year number,  Prev: Weekday name,  Up: Replacements with date argument

G.2.1.2 Weekday number '%[FORMAT]?[DATE]' special texts
.......................................................

The following weekday number '%[FORMAT]?[DATE]' special texts are
respected, e.g.:

'%W[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'Monday==1...Sunday==7' counting method, e.g.:

          The text 'Today is weekday %W , the %n' will be expanded to
          ==> 'Today is weekday 1, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996.

'%>1&*W[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the
     'Monday==1...Sunday==7' counting method, e.g.:

          The text 'Today is weekday %>1&*W0@t+1 , the %n+1' will be
          expanded to
          ==> 'Today is weekday 2nd, the 11-Jun-1996', in case the
          actual system date is the 10th June 1996.

'%E[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'Monday==0...Sunday==6' counting method, e.g.:

          The text 'Today is weekday %E , the %n' will be expanded to
          ==> 'Today is weekday 0, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996.

'%>1&*E[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the
     'Monday==0...Sunday==6' counting method, e.g.:

          The text 'Today is weekday %>1&*E , the %n' will be expanded
          to
          ==> 'Today is weekday 0th, the 10-Jun-1996', in case the
          actual system date is the 10th June 1996.

'%I[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'Sunday==1...Saturday==7' counting method,
     e.g.:

          The text 'Today is weekday %I , the %n' will be expanded to
          ==> 'Today is weekday 2, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996.

'%>1&*I[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the
     'Sunday==1...Saturday==7' counting method, e.g.:

          The text 'Today is weekday %>1&*I , the %n' will be expanded
          to
          ==> 'Today is weekday 2nd, the 10-Jun-1996', in case the
          actual system date is the 10th June 1996.

'%J[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'Sunday==0...Saturday==6' counting method,
     e.g.:

          The text 'Today is weekday %J , the %n' will be expanded to
          ==> 'Today is weekday 1, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996.

'%>1&*J[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the
     'Sunday==0...Saturday==6' counting method, e.g.:

          The text 'Today is weekday %>1&*J , the %n' will be expanded
          to
          ==> 'Today is weekday 1st, the 10-Jun-1996', in case the
          actual system date is the 10th June 1996.

'%S[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'STARTING DAY OF WEEK==1...ENDING DAY OF
     WEEK==7' counting method (*note Calendar option
     '--starting-day=ARGUMENT': x-starting-day.), e.g.:

          The text 'Today is weekday %S , the %n' will be expanded to
          ==> 'Today is weekday 4, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996 and Friday (==5) is the
          starting day of week.

'%>1&*S[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the 'STARTING
     DAY OF WEEK==1...ENDING DAY OF WEEK==7' counting method (*note
     Calendar option '--starting-day=ARGUMENT': x-starting-day.), e.g.:

          The text 'Today is weekday %>1&*S , the %n' will be expanded
          to
          ==> 'Today is weekday 4th, the 10-Jun-1996', in case the
          actual system date is the 10th June 1996 and Friday (==5) is
          the starting day of week.

'%T[DATE]'
     Is replaced by the *weekday number* of the current day, and which
     is determined by the 'STARTING DAY OF WEEK==0...ENDING DAY OF
     WEEK==6' counting method (*note Calendar option
     '--starting-day=ARGUMENT': x-starting-day.), e.g.:

          The text 'Today is weekday %T , the %n' will be expanded to
          ==> 'Today is weekday 3, the 10-Jun-1996', in case the actual
          system date is the 10th June 1996 and Friday (==5) is the
          starting day of week.

'%>1&*T[DATE]'
     Is replaced by the *weekday number* with trailing Ordinal Number
     suffix of the current day, and which is determined by the 'STARTING
     DAY OF WEEK==0...ENDING DAY OF WEEK==6' counting method (*note
     Calendar option '--starting-day=ARGUMENT': x-starting-day.), e.g.:

          The text 'Today is weekday %>1&*T , the %n' will be expanded
          to
          ==> 'Today is weekday 3rd, the 10-Jun-1996', in case the
          actual system date is the 10th June 1996 and Friday (==5) is
          the starting day of week.


File: gcal.info,  Node: Day-of-year number,  Next: Day number,  Prev: Weekday number,  Up: Replacements with date argument

G.2.1.3 Day-of-year number '%[FORMAT]N[DATE]' special text
..........................................................

'%N[DATE]'
     Is replaced by the *day-of-year number* of the current day of year,
     e.g.:

          The text 'Day %N  of year, the %n' will be expanded to
          ==> 'Day 53 of year, the 22-Feb-1996', in case the actual
          system date is the 22nd February 1996.

'%>03*N[DATE]'
     Is replaced by the 3-digit *day-of-year number* with leading zeroes
     of the current day of year, e.g.:

          The text 'Day %>03*N0@t-1  of year, the %n-1' will be expanded
          to
          ==> 'Day 052 of year, the 21-Feb-1996', in case the actual
          system date is the 22nd February 1996.

'%>1&*N[DATE]'
     Is replaced by the *day-of-year number* with trailing Ordinal
     Number suffix of the current day of year, e.g.:

          The text 'Day %>1&*N  of year, the %n' will be expanded to
          ==> 'Day 53rd of year, the 22-Feb-1996', in case the actual
          system date is the 22nd February 1996.

'%>03&*N[DATE]'
     Is replaced by the 3-digit *day-of-year number* with leading zeroes
     and trailing Ordinal Number suffix of the current day of year,
     e.g.:

          The text 'Day %>03&*N  of year, the %n' will be expanded to
          ==> 'Day 053rd of year, the 22-Feb-1996', in case the actual
          system date is the 22nd February 1996.


File: gcal.info,  Node: Day number,  Next: Week number,  Prev: Day-of-year number,  Up: Replacements with date argument

G.2.1.4 Day number '%[FORMAT]D[DATE]' special text
..................................................

'%D[DATE]'
     Is replaced by the *day number* of the current day of month, e.g.:

          The text 'Day %D , %n' will be expanded to
          ==> 'Day 2, 02-Feb-1996', in case the actual system date is
          the 2nd February 1996.

'%>02*D[DATE]'
     Is replaced by the 2-digit *day number* with leading zero of the
     current day of month, e.g.:

          The text 'Day %>02*D0@t-1 , %n-1' will be expanded to
          ==> 'Day 01, 01-Feb-1996', in case the actual system date is
          the 2nd February 1996.

'%>1&*D[DATE]'
     Is replaced by the *day number* with trailing Ordinal Number suffix
     of the current day of month, e.g.:

          The text 'Day %>1&*D , %n' will be expanded to
          ==> 'Day 2nd, 02-Feb-1996', in case the actual system date is
          the 2nd February 1996.

'%>02&*D[DATE]'
     Is replaced by the 2-digit *day number* with leading zero and
     trailing Ordinal Number suffix of the current day of month, e.g.:

          The text 'Day %>02&*D , %n' will be expanded to
          ==> 'Day 02nd, 02-Feb-1996', in case the actual system date is
          the 2nd February 1996.


File: gcal.info,  Node: Week number,  Next: Month name,  Prev: Day number,  Up: Replacements with date argument

G.2.1.5 Week number '%k[DATE]' special text
...........................................

'%k[DATE]'
     Is replaced by either the 2-digit *ISO week number* or the
     *standard week number* with leading zero, or a 4-alphanumeric
     character text of the current week of year
     (see *note Calendar option '--starting-day=ARGUMENT':
     x-starting-day, *note Calendar option '--iso-week-number=yes|no':
     x-iso-week-number, and *note Aspects in Internationalization:
     Internationalization, for further details), e.g.:

          The text 'Today is %K  of week %k' will be expanded to
          ==> 'Today is Monday of week 24', in case the actual system
          date is the 10th June 1996.


File: gcal.info,  Node: Month name,  Next: Month number,  Prev: Week number,  Up: Replacements with date argument

G.2.1.6 Month name '%[FORMAT]U[DATE]' special text
..................................................

'%U[DATE]'
     Is replaced by the complete *month name* of the current month of
     year, e.g.:

          The text 'Today is %U , %n' will be expanded to
          ==> 'Today is June, 10-Jun-1996', in case the actual system
          date is the 10th June 1996.

'%>3#U[DATE]'
     Is replaced by the 3-letter *month name* of the current month of
     year, e.g.:

          The text 'Today is %>3#U19961010 , %n' will be expanded to
          ==> 'Today is Oct, 10-Jun-1996', in case the actual system
          date is the 10th June 1996.


File: gcal.info,  Node: Month number,  Next: Year number,  Prev: Month name,  Up: Replacements with date argument

G.2.1.7 Month number '%[FORMAT]M[DATE]' special text
....................................................

'%M[DATE]'
     Is replaced by the *month number* of the current month of year,
     e.g.:

          The text 'Month %M , %n' will be expanded to
          ==> 'Month 2, 22-Feb-1996', in case the actual system date is
          the 22nd February 1996.

'%>02*M[DATE]'
     Is replaced by the 2-digit *month number* with leading zero of the
     current month of year, e.g.:

          The text 'Month %>02*M000001 , %n' will be expanded to
          ==> 'Month 01, 22-Feb-1996', in case the actual system date is
          the 22nd February 1996.

'%>1&*M[DATE]'
     Is replaced by the *month number* with trailing Ordinal Number
     suffix of the current month of year, e.g.:

          The text 'Month %>1&*M , %n' will be expanded to
          ==> 'Month 2nd, 22-Feb-1996', in case the actual system date
          is the 22nd February 1996.

'%>02&*M[DATE]'
     Is replaced by the 2-digit *month number* with leading zero and
     trailing Ordinal Number suffix of the current month of year, e.g.:

          The text 'Month %>02&*M , %n' will be expanded to
          ==> 'Month 02nd, 22-Feb-1996', in case the actual system date
          is the 22nd February 1996.


File: gcal.info,  Node: Year number,  Next: Moon phase,  Prev: Month number,  Up: Replacements with date argument

G.2.1.8 Year number '%[FORMAT]Y[DATE]' special text
...................................................

'%Y[DATE]'
     Is replaced by the *year number* of the current year, e.g.:

          The text 'Year %Y , %n' will be expanded to
          ==> 'Year 933, 22-Feb-0933', in case the actual system date is
          the 22nd February 933.

'%>04*Y[DATE]'
     Is replaced by the 4-digit *complete year number* with leading
     zeroes of the current year, e.g.:

          The text 'Year %>04*Y0015 , %n' will be expanded to
          ==> 'Year 0015, 22-Feb-0933', in case the actual system date
          is the 22nd February 933.


File: gcal.info,  Node: Moon phase,  Next: Biorhythm,  Prev: Year number,  Up: Replacements with date argument

G.2.1.9 Moon phase '%[FORMAT]?[DATE]' special texts
...................................................

Gcal uses a very simple algorithm for detecting the Moon phase, which
computes approximate values only.  The Moon phase is always calculated
for 0 o'clock Universal time (UTC/GMT).  *Note Calendar option
'--time-offset=ARGUMENT': x-time-offset, how to change the base time for
which the astronomical functions are calculated.  The following Moon
phase '%[FORMAT]?[DATE]' special texts are respected:

'%O[DATE]'
     Is replaced by the *Moon phase text* of the current day of year,
     e.g.:

          The text 'Moon phase %O , %n' will be expanded to
          ==> 'Moon phase 94%+, 22-Dec-1996', in case the actual system
          date is the 22nd December 1996.

     The constructed Moon phase text consists of a percent value, which
     informs about the illuminated fraction of the Moon's disk, and a
     trailing sign that tells something about the state of the Moon.  A
     trailing '+' sign indicates a waxing Moon, a '-' sign a waning
     Moon, a '@' sign indicates the Full Moon phase, and a '!' sign the
     New Moon phase.

'%>03*O[DATE]'
     Is replaced by the 3-digit *Moon phase text* with leading zeroes of
     the current day of year, e.g.:

          The text 'Moon phase %>03*O0@t+1 , %n+1' will be expanded to
          ==> 'Moon phase 098%+, 23-Dec-1996', in case the actual system
          date is the 22nd December 1996.

     The constructed Moon phase text consists of a percent value, which
     informs about the illuminated fraction of the Moon's disk, and a
     trailing sign that tells something about the state of the Moon.  A
     trailing '+' sign indicates a waxing Moon, a '-' sign a waning
     Moon, a '@' sign indicates the Full Moon phase, and a '!' sign the
     New Moon phase.

'%Z[DATE]'
     Is replaced by the *Moon phase text graphics* of the current day of
     year, e.g.:

          The text 'Date %n %Z  --- Moon phase %>03*O ~Text' will be
          expanded to
          ==> 'Date 08-Mar-1995 '
          ==> '           (       @@@@@@'
          ==> '      (              @@@@@@@@@'
          ==> '    (                @@@@@@@@@@@'
          ==> '  (                   @@@@@@@@@@@@'
          ==> ' (                    @@@@@@@@@@@@@'
          ==> '(                      @@@@@@@@@@@@@'
          ==> '(                      @@@@@@@@@@@@@'
          ==> ' (                    @@@@@@@@@@@@@'
          ==> '  (                   @@@@@@@@@@@@'
          ==> '   (                  @@@@@@@@@@@'
          ==> '      (             @@@@@@@@@'
          ==> '           (        @@@@@@@ --- Moon phase 041%+'
          ==> 'Text', in case the actual system date is the 8th March
          1995.

     *Note Fixed date option '--moonimage-lines=NUMBER':
     x-moonimage-lines, how to change the size of a Moon phase text
     graphics.

     A possibly specified FORMAT within this special text is ignored by
     Gcal.


File: gcal.info,  Node: Biorhythm,  Next: Difference value,  Prev: Moon phase,  Up: Replacements with date argument

G.2.1.10 Biorhythm '%?[DATE]' special texts
...........................................

Gcal is able to create a "biorhythm" for any specified date of birth.
The created text shows the three standard biorhythm cycles, and that are
the 28 day emotional cycle, the 33 day intellectual cycle, and the 23
day physical cycle.  The emotional cycle governs sensibility, nerves,
moodiness, and creative ability.  The intellectual cycle reflects
intelligence, memory, mental alertness, and reasoning power.  The
physical cycle represents physical strength, endurance, energy and
resistance.  All cycles start in the zero point at the date of birth and
swing like sine curves between their positive and negative maximum
values.  The periods above the zero point show the days of full vitality
and efficiency while the periods below the zero point indicate days of
reduced efficiency.  The biorhythm is implemented for entertaining
purposes only!  It is up to the user to interpret the biorhythm texts.

  Gcal counts "critical" days, "positive" likewise "negative" days.
Critical days are those days 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.  Positive
days are those days 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.  Negative days are those days 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.

  The following biorhythm '%?[DATE]' special texts are respected:

'%,[DATE]'
     Is replaced by the *biorhythm text* of the current day of year,
     e.g.:

          The text '%,19620921' will be expanded to
          ==> '1! 0+ 0- , Emo=+022%- Int=-091%+ Phy=-014%-', in case the
          actual system date is the 12th December 1996.

     The preceding example shows the calculated biorhythm expressed as a
     series of values for a person born in 1962, September 21st.  The
     constructed text consists of two parts, and that is on the one hand
     a triplet of total values which indicate the critical, positive and
     negative day.  And on the other hand a triplet of values which
     indicate the emotional, intellectual and physical cycle.

     In the first triplet of total values, a '!' suffix means a critical
     day, a '+' indicates a positive day, and a '-' suffix marks a
     negative day.

     In the second triplet of values, each single cycle percent value
     consists of a leading positive or negative sign that tells
     something about the distance of this value to the zero point, and a
     trailing character that tells something about the state of each
     cycle.  A trailing '+' character marks a waxing phase, a '-' suffix
     means a waning phase, and a '@' indicates the maximum value of a
     phase.

'%;[DATE]'
     Is replaced by the *biorhythm text graphics* of the current day of
     year, e.g.:

          The text '%;19620921' will be expanded to
          ==> '0-  I               P 1   E                +0', in case
          the actual system date is the 12th December 1996.

     The preceding example shows the calculated biorhythm expressed as a
     text graphics line for a person born in 1962, September 21st.  The
     constructed line is a bar with a negative and positive axis of
     adjustable length (*note Fixed date option
     '--biorhythm-axis=NUMBER': x-biorhythm-axis.), which left margin is
     represented by the total value of the negative days (the '0-' in
     this case), and which right margin is represented by the total
     value of the positive days (the '+0' in this case).  The zero point
     of the co-ordinate is represented by the total value of the
     critical days, which is the '1' in this case.  The emotional,
     intellectual and the physical phase value is accordingly placed in
     scaled manner on this bar, and that by using the initial letter of
     the cycle in each case ('E', 'I' and 'P').  Coincidental phase
     values are marked by a '@' character.


File: gcal.info,  Node: Difference value,  Prev: Biorhythm,  Up: Replacements with date argument

G.2.1.11 Difference value '%[FORMAT]?[DATE]' special texts
..........................................................

The following difference value '%[FORMAT]?[DATE]' special texts are
respected:

'%yDATE'
     Is replaced by a *year difference value*, e.g.:

          The text 'Sylvester 1912 is %y1912  years ago' will be
          expanded to
          ==> 'Sylvester 1912 is -82 years ago', in case the year of the
          actual system date is 1994.

'%B[DATE]'
     Is replaced by an *age value*, e.g.:

          The text 'My %B1962  birthday%i1952#2062' will be expanded to
          ==> 'My 32 birthday', in case the year of the actual system
          date is 1994.

     Those age values are only displayed, if the computation of an age
     value is greater zero.  The fixed date warning in preceding example
     is displayed only in case the current year is greater than 1952 and
     less than 2062.

'%>1&*B[DATE]'
     Is replaced by an *age value* with trailing Ordinal Number suffix,
     e.g.:

          The text 'My %>1&*B1962  birthday%i1952#2062' will be expanded
          to
          ==> 'My 32nd birthday', in case the year of the actual system
          date is 1994.

     Those age values are only displayed, if the computation of an age
     value is greater zero.  The fixed date warning in preceding example
     is displayed only in case the current year is greater than 1952 and
     less than 2062.


File: gcal.info,  Node: Replacements with other argument,  Next: Replacements without any argument,  Prev: Replacements with date argument,  Up: Replacements

G.2.2 Replacements with other argument '%[FORMAT]?[ARGUMENT]' special texts
---------------------------------------------------------------------------

* Menu:

* Actual clocktime::
* Textual date::
* Julian day number::
* Geographical distance and course angle::
* Sun data::
* Moon data::
* Contents of Environment variable::

Apart from different representations of the actual system time, a fixed
format date text can be created.  Moreover, it is possible to produce a
day number, which bears the Julian date as base date and which can be
deferred if needed.  Furthermore, the approximate distance and the
course angle between two geographic point locations, and different Sun
and Moon oriented data and times for at pleasure any geographical
location can be created.  It is also possible to display the contents of
environment variables in the fixed date text.

  For the ARGUMENT these '%?[ARGUMENT]' special texts may have, no
special rules concerning definite omission values are valid.


File: gcal.info,  Node: Actual clocktime,  Next: Textual date,  Prev: Replacements with other argument,  Up: Replacements with other argument

G.2.2.1 Actual clocktime '%[FORMAT]?[ARGUMENT]' special texts
.............................................................

Gcal is able to represent the actual clocktime as local/zone time and as
Universal time (UTC/GMT), and additionally the RFC-822(1) (*note Actual
clocktime-Footnote-1::) style numerical Universal time timezone offset
value and the actual numerical local time timezone offset value.  *Note
Actual local time '%t[ARGUMENT]' special text: x-Actual-local-time, for
the detailed description of all components of the ARGUMENT, which may
trail the actual clocktime '%[FORMAT]?[ARGUMENT]' special texts.  All
actual clocktime '%[FORMAT]?[ARGUMENT]' special texts *must* always be
trailed by a _whitespace_ character which is removed in output!  The
following actual clocktime '%[FORMAT]?[ARGUMENT]' special texts are
respected:

'%t[ARGUMENT]'

     '%t[*][[+|-]MMMM|HH:[MM]]' references the *actual local time*,
     which is displayed by using the 'HH:MM' output format, e.g.:

          The text 'Local time: %t  --> Dentist at 10:00' will be
          expanded to
          ==> 'Local time: 07:32 --> Dentist at 10:00', in case the
          actual local time value is 07:32 o'clock ('HH:MM').

     If only '%t' is specified, the local time value will implicitly be
     displayed by using the _24-hours_ format.  For displaying using the
     _12-hours_ format, add a '*' character directly behind '%t', e.g.
     '%t*'.

     A displacement value may trail the '%t' special text, which has to
     be specified either by using the '[+|-]MMMM' format or the
     '[+|-]HH:[MM]' format.  '[+|-]MMMM' adds respectively subtracts the
     specified amount of minutes MMMM from the local time value (range
     '0...9999'), while '[+|-]HH:[MM]' adds respectively subtracts the
     given amount of hours HH (range '0...99') and minutes MM (range
     '0...59') from the local time value.  The displacement value is
     always added to the local time value in case it is specified
     without a '+|-' sign.  In case Gcal is unable to compute the actual
     local time in 'HH:MM' format by reason of a misspecified ARGUMENT,
     a '??:??' text will be created instead of the actual local time in
     'HH:MM' format.

          The text 'Local time: %t-3:  --> Dentist at 10:00' will be
          expanded to
          ==> 'Local time: 04:32 --> Dentist at 10:00', in case the
          actual local time value is 07:32 o'clock ('HH:MM').

'%[FORMAT]'[ARGUMENT]'

     '%[FORMAT]'[[+|-]MMMM|HH:[MM]]' references the *actual local time
     in minutes since midnight*, which is displayed by using the M[M...]
     output format, e.g.:

          The text 'Local time: %'  --> Dentist at 10:00' will be
          expanded to
          ==> 'Local time: 452 --> Dentist at 10:00', in case the actual
          local time value is 07:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual local time in M[M...]
     format by reason of a misspecified ARGUMENT, a '??' text will be
     created instead of the actual local time in M[M...] format.

'%[FORMAT]_[ARGUMENT]'

     '%[FORMAT]_[*][[+|-]MMMM|HH:[MM]]' references the *actual local
     time hour*, which is displayed by using the H[H...] output format,
     e.g.:

          The text 'Local time hour: %_-1:' will be expanded to
          ==> 'Local time hour: 6' in case the actual local time value
          is 07:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual local time hour by
     reason of a misspecified ARGUMENT, a '??' text will be created
     instead of the actual local time hour H[H...].

'%[FORMAT]?[ARGUMENT]'

     '%[FORMAT]?[[+|-]MMMM|HH:[MM]]' references the *actual local time
     minute*, which is displayed by using the M[M...] output format,
     e.g.:

          The text 'Local time minute: %>04*?+:2' will be expanded to
          ==> 'Local time minute: 0034' in case the actual local time
          value is 07:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual local time minute by
     reason of a misspecified ARGUMENT, a '??' text will be created
     instead of the actual local time minute M[M...].

'%[FORMAT]{[ARGUMENT]'

     '%[FORMAT]{[[+|-]MMMM|HH:[MM]]' references the *actual local time
     12-hour format suffix*, which is displayed as 'am|pm', e.g.:

          The text 'Local time suffix: %{' will be expanded to
          ==> 'Local time suffix: am' in case the actual local time
          value is 07:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual local time 12-hour
     format suffix by reason of a misspecified ARGUMENT, a '??' text
     will be created instead of the actual local time 12-hour format
     suffix 'am|pm'.

'%@[ARGUMENT]'

     '%@[*][[+|-]MMMM|HH:[MM]]' references the *actual Universal time*
     (UTC/GMT), which is displayed by using the 'HH:MM/DATE' output
     format, e.g.:

          The text 'Universal time: %@*-3.' will be expanded to
          ==> 'Universal time: 03:32am/15-Feb-1999', in case the actual
          date is the 15th February 1999 and the actual Universal time
          value is 06:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual Universal time in
     'HH:MM/DATE' format by reason of a misspecified ARGUMENT, a
     '??:??/??-???-????' text will be created instead of the actual
     Universal time in 'HH:MM/DATE' format.

'%[FORMAT]`[ARGUMENT]'

     '%[FORMAT]`[[+|-]MMMM|HH:[MM]]' references the *actual Universal
     time in minutes since midnight*, which is displayed by using the
     'M[M...]/DATE' output format, e.g.:

          The text 'Universal time: %>06*`-3:' will be expanded to
          ==> 'Universal time: 000212/15-Feb-1999' in case the actual
          date is the 15th February 1999 and the actual Universal time
          value is 06:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual Universal time in
     'M[M...]/DATE' format by reason of a misspecified ARGUMENT, a
     '??/??-???-????' text will be created instead of the actual
     Universal time in 'M[M...]/DATE' format.

'%[FORMAT].[ARGUMENT]'

     '%[FORMAT].[*][[+|-]MMMM|HH:[MM]]' references the *actual Universal
     time hour*, which is displayed by using the H[H...] output format,
     e.g.:

          The text 'Universal time hour: %.-1:' will be expanded to
          ==> 'Universal time hour: 5' in case the actual Universal time
          value is 06:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual Universal time hour by
     reason of a misspecified ARGUMENT, a '??' text will be created
     instead of the actual Universal time hour H[H...].

'%[FORMAT]/[ARGUMENT]'

     '%[FORMAT]/[[+|-]MMMM|HH:[MM]]' references the *actual Universal
     time minute*, which is displayed by using the M[M...] output
     format, e.g.:

          The text 'Universal time minute: %>04*/+:2' will be expanded
          to
          ==> 'Universal time minute: 0034' in case the actual Universal
          time value is 06:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual Universal time minute
     by reason of a misspecified ARGUMENT, a '??' text will be created
     instead of the actual Universal time minute M[M...].

'%[FORMAT]}[ARGUMENT]'

     '%[FORMAT]}[[+|-]MMMM|HH:[MM]]' references the *actual Universal
     time 12-hour format suffix*, which is displayed as 'am|pm', e.g.:

          The text 'Universal time suffix: %>1w*}+10:' will be expanded
          to
          ==> 'Universal time suffix: Pm' in case the actual Universal
          time value is 06:32 o'clock ('HH:MM').

     In case Gcal is unable to compute the actual Universal time 12-hour
     format suffix by reason of a misspecified ARGUMENT, a '??' text
     will be created instead of the actual Universal time 12-hour format
     suffix 'am|pm'.

'%"[ARGUMENT]'

     '%"[[+|-]MMMM|HH:[MM]]' references the RFC-822 style *numerical
     Universal time timezone offset value*, which is displayed by using
     the '+|-HHMM' output format, e.g.:

          The text 'Universal time timezone offset value: %"-90' will be
          expanded to
          ==> 'Universal time timezone offset value: -0130', at which
          calculations are always based on the timezone of the Universal
          time UTC/GMT.

     In case Gcal is unable to compute the numerical Universal time
     timezone offset value by reason of a misspecified ARGUMENT, a
     '+????' text will be created instead of the numerical Universal
     time timezone offset value '+|-HHMM'.

'%=[ARGUMENT]'

     '%=[[+|-]MMMM|HH:[MM]]' references the RFC-822 style *actual
     numerical local time timezone offset value*, which is displayed by
     using the '+|-HHMM' output format, e.g.:

          The text 'Local time timezone offset value CET: %=-10' will be
          expanded to
          ==> 'Local time timezone offset value CET: +0050', in case the
          actual timezone is equal the Central European (winter)time
          CEWT/CET ('+HHMM').  Calculations are always based on the
          timezone of the local time.

     In case Gcal is unable to compute the actual numerical local time
     timezone offset value by reason of a misspecified ARGUMENT, a
     '+????' text will be created instead of the actual numerical local
     time timezone offset value '+|-HHMM'.


File: gcal.info,  Node: Actual clocktime-Footnotes,  Up: Actual clocktime

   (1) RFC is the abbreviation of 'Request for Comments'.


File: gcal.info,  Node: Textual date,  Next: Julian day number,  Prev: Actual clocktime,  Up: Replacements with other argument

G.2.2.2 Textual date '%n[ARGUMENT]' special text
................................................

'%n[[+|-]N]' references the current respectively queried *day number*
relative to the current date '+/-' N days and is replaced by a *date
text* by using the fixed '%>02*D-%>3#U-%>04*Y' format, e.g.:

     The resource file line '1962Sep21 10000 days old: %n+10000' will be
     expanded to
     ==> '10000 days old: 06-Feb-1990', in case you call Gcal with the
     simple '-c' option and the command 'sep 1962' (*note Single command
     'MM YYYY': x-mm-yyyy.).


File: gcal.info,  Node: Julian day number,  Next: Geographical distance and course angle,  Prev: Textual date,  Up: Replacements with other argument

G.2.2.3 Julian day number '%[FORMAT]j[ARGUMENT]' special text
.............................................................

'%[FORMAT]j[[+|-]N]' references the current respectively queried *Julian
day number* relative to the actual system date (==today).  This day
number is based on the date 1st January 4713 BCE --which is the starting
day zero of a consecutive day counting used in astronomical
computations-- and is known as the Julian Date (J.D.).  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.  Here, Gcal does not
evaluate the timezone returned by the systems date function.  For that
reason, this day number is represented without a time fraction on the
supposition that the day has already changed at noon.  If you do not
like the feature that the day displayed has already changed at noon, you
can decrease the resulting Julian day number of that special text always
by one, e.g. '%j-1'.

  For example:

     The resource file line '0 Julian day %j since 01-Jan-4713 BCE' will
     be expanded to
     ==> 'Julian day 2437929 since 01-Jan-4713 BCE', in case you call
     Gcal with the '-c %19620921' option and no command.

  If the '%[FORMAT]j' text is directly trailed by an unsigned number,
this number is always subtracted from the real Julian day number.  So
you are able to work with any quantities referenced, e.g.:

     The resource file line '0 Julian day %j2415021 since 01-Jan-1900'
     will be expanded to
     ==> 'Julian day 4 since 01-Jan-1900', in case you call Gcal with
     the '-c %19000105' option and no command.


File: gcal.info,  Node: Geographical distance and course angle,  Next: Sun data,  Prev: Julian day number,  Up: Replacements with other argument

G.2.2.4 Geographical distance and course angle '%[FORMAT]bARGUMENT' special text
................................................................................

'%[FORMAT]b[*][MODE]ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
references either the approximate *air line distance* or the approximate
*course angle (true track)*(1) (*note Geographical distance and course
angle-Footnote-1::) between any of two geographic point locations.  The
selection, which value has to be calculated by using this special text
is done by specifying the MODE part of the preceding argument.
Actually, exactly three different modes can be used that are represented
by the '0'...'2' characters:

*Mode*      *Description*
 
'0'         Calculates the air line distance between
            ISO-6709:1983-CO-ORDINATE-1 and
            ISO-6709:1983-CO-ORDINATE-2.  The calculated air line
            distance value is displayed in kilometers by default.  A
            '*' character directly before this mode character causes
            Gcal to display the distance value for another quantity,
            and that in "statute miles"; where one statute mile is
            equal to 1.609344 kilometer.  If Gcal is unable to compute
            the approximate distance between the two geographic point
            locations by reason of a misspecified ARGUMENT, a '??' text
            will be created instead of the distance value.
 
'1'         Calculates the course angle (true track) between
            ISO-6709:1983-CO-ORDINATE-1 and
            ISO-6709:1983-CO-ORDINATE-2.  The calculated course angle
            value is displayed in degrees and arcminutes by default.
            The course angle is measured clockwise relative to the
            geographic, true North (not the magnetic North as shown by
            a compass), where angle values for the North direction are
            both denoted as 0 degree and 360 degree.  A '*' character
            directly before this mode character causes Gcal to display
            the course angle value using another style; and that in
            decimal degrees.  If Gcal is unable to compute the
            approximate course angle between the two geographic point
            locations by reason of a misspecified ARGUMENT, a '???d??''
            text will be created instead of the course angle value.
 
'2'         Like mode '1', but the course angle (true track) between
            ISO-6709:1983-CO-ORDINATE-2 and ISO-6709:1983-CO-ORDINATE-1
            is calculated.

  If no MODE is given, Gcal automatically uses that mode, which is
enabled by the mode character '0'.  If a mode character is given that is
not according to one of the '0'...'2' characters, Gcal also
automatically uses that mode, which is enabled by the mode character
'0'.

  After the optional style and mode characters, the latitude and
longitude of the geographic co-ordinates follows, for which the
calculations must be made.  They must be conform the ISO-6709:1983
standard representation of latitude and longitude for geographic point
locations.  The two co-ordinates have to be separated by a '/'
termination character from each other.

  *Note Arguments of the Sun oriented special texts: x-Sun-arguments,
for the detailed description of the components of the ISO-6709:1983
standard representation of latitude and longitude for geographic point
locations.

  For example:

     The text 'Distance Paris-Tokyo: %b+4852+00220/+3542+13946 km' will
     be expanded to
     ==> 'Distance Paris-Tokyo: 9746km'.

     The text 'Distance Paris-Tokyo: %b*0+4852+00220/+3542+13946 ms'
     will be expanded to
     ==> 'Distance Paris-Tokyo: 6056ms'.

     The text 'Course angle Paris-Tokyo: %b1+4852+00220/+3542+13946'
     will be expanded to
     ==> 'Course angle Paris-Tokyo: 033d22''.

     The text 'Course angle Tokyo-Paris: %b*2+4852+00220/+3542+13946'
     will be expanded to
     ==> 'Course angle Tokyo-Paris: 333.548'.

  While praying, people of Islamic faith always turn their heads into
the direction of Makkah, Saudi-Arabia.  Now by means of Gcal, these
people can easily find out for their respective location, where they
have to turn to, and that by:

     %b1ISO-6709:1983-CO-ORDINATE-1/+212516+0394929

where ISO-6709:1983-CO-ORDINATE-1 is simply replaced by the co-ordinate
of the respective location.

  *Note Fixed date option '--precise': x-precise, how to obtain a more
precise representation of the values that are caused by this special
text.

  This special text *must* always be trailed by a _whitespace_ character
which is removed in output!


File: gcal.info,  Node: Geographical distance and course angle-Footnotes,  Up: Geographical distance and course angle

   (1) 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 "meridian" (longitude), or to exactly the same
latitude.


File: gcal.info,  Node: Sun data,  Next: Moon data,  Prev: Geographical distance and course angle,  Up: Replacements with other argument

G.2.2.5 Sun data '%[FORMAT]?ARGUMENT' special texts
...................................................

'%[FORMAT]o[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate time of *sunrise* by default,
'%[FORMAT]s[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate time of *sunset* by default,
'%[FORMAT]u[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate period of *visibility* of the Sun (solar day
length) by default,
'%[FORMAT]z[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate period of *non-visibility* of the Sun (solar
night length) by default.

  All these special texts can be used for at pleasure any geographic
point location, i.e. it is possible to determine different astronomical
values for any location on the globe, and that for at pleasure any
clocktime with a resolution of a single minute within the period of the
years AD 1 until AD 9999, that is respected by Gcal.

  The selection which value has to be calculated by these special texts
is done by specifying the MODE part of the preceding argument.
Actually, exactly 54 different modes can be used that are represented by
the '0'...'9', 'a'...'z' and 'A'...'R' characters, and which create
different kind of results that are depending on the special text used.
First of all, here is a table in which all usable modes are described
and explained sufficiently.  You can also see from this table, which Sun
oriented special text or texts are corresponding to which mode, i.e.
cause the determination of an astronomical value as it is described in
the table:

*Mode*  *Special      *Description*
        text*
 
'0'     'o', 's'      Calculates the approximate midnight time of the
                      Sun.  The astronomical midnight time of the Sun is
                      at that clocktime, when the Sun holds an "azimuth"
                      (horizontal angular distance between the vertical
                      circle, that passes the Sun, and the North point)
                      of either precisely 0 degrees of precisely 180
                      degrees ("noon line"), which depends on the season
                      and the geographical location.  At that clocktime,
                      the Sun is close its "lowest culmination point",
                      i.e. close the lowest point below or above the
                      horizontal plane the Sun transits during this day.
 
'1'     'o', 's'      Calculates the approximate noon time of the Sun.
                      The astronomical noon time of the Sun is at that
                      clocktime, when the Sun holds an azimuth of either
                      precisely 180 degrees of precisely 0 degrees (noon
                      line), which depends on the season and the
                      geographical location.  At that clocktime, the Sun
                      is close its "highest culmination point", i.e.
                      close the highest point above or below the
                      horizontal plane the Sun transits during this day.
                      People of Islamic faith normally pray for the
                      second time on the day during the period, which is
                      between the astronomical noon time of the Sun (or
                      some minutes later) and the Islamic prayer time by
                      the name of "Asr".  These people commonly use the
                      term "Zuhr" for this prayer time.  The timing of
                      Asr depends on the length of the shadow cast by a
                      vertical pole ("gnomon").  According to the Shafi
                      school of jurisprudence, Asr begins when the
                      length of the shadow of a vertical pole exceeds
                      the length of the pole.  According to the Hanafi
                      school of jurisprudence, Asr begins when the
                      length of the shadow exceeds twice the length of
                      the vertical pole.  In both cases, the minimum
                      length of the shadow at astronomical noon time of
                      the Sun is subtracted from the length of the
                      shadow before comparing it with the length of the
                      pole.
                      *Note Islamic Asr-1 prayer time: x-Sun-asr-1, and
                      *note Islamic Asr-2 prayer time: x-Sun-asr-2, for
                      further details.
 
'2'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 0 degrees
                      on a "mathematical-geocentric" horizon in the
                      morning; thus rising.  A mathematical horizon is a
                      purely geometrically-built horizon which
                      disregards the phenomenon of refraction as it
                      arises in reality by the influence of the Earth's
                      atmosphere.  A geocentrical horizon is the
                      horizontal plane that passes through the Earth's
                      center, orthogonal to the observer's local
                      vertical.  In the further context, the shorter
                      term _mathematical horizon_ is used which actually
                      means the mathematical-geocentric horizon.
 
'2'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 0 degrees
                      on a mathematical horizon in the evening; thus
                      setting.
 
'2'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 0
                      degrees on a mathematical horizon; thus is
                      visible.
 
'2'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 0
                      degrees on a mathematical horizon; thus is
                      non-visible.
 
'3'     'o'           Calculates the approximate time when the upper
                      limb of the Sun passes a reference altitude of 0
                      degrees on a mathematical horizon in the morning;
                      thus rising.  The above mentioned reference
                      altitude is computed from the value of the Sun's
                      semidiameter as it appear at that clocktime.  If
                      the reference altitude that is referring to the
                      Sun's upper limb is converted to a reference
                      altitude that is referring to the Sun's center,
                      this results in a value of about 16 arcminutes
                      below the geocentric horizon.
 
'3'     's'           Calculates the approximate time when the upper
                      limb of the Sun passes a reference altitude of 0
                      degrees on a mathematical horizon in the evening;
                      thus setting.  The above mentioned reference
                      altitude is computed from the value of the Sun's
                      semidiameter as it appear at that clocktime.
 
'3'     'u'           Calculates the approximate period while the upper
                      limb of the Sun is above a reference altitude of 0
                      degrees on a mathematical horizon; thus is
                      visible.
 
'3'     'z'           Calculates the approximate period while the upper
                      limb of the Sun is below a reference altitude of 0
                      degrees on a mathematical horizon; thus is
                      non-visible.
 
'4'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 34
                      arcminutes below the geocentric horizon in the
                      morning; thus rising.  The phenomenon of
                      refraction is already respected in this as it
                      arises in reality by the influence of the Earth's
                      atmosphere, and that with the standard value of 34
                      arcminutes, which can indirectly be changed by
                      using the '--atmosphere' option.
                      *note Fixed dates option '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere,
                      how to change the base data of the atmosphere, so
                      that the atmospheric conditions as defined by it
                      are used to calculate the amount of refraction.
 
'4'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 34
                      arcminutes below the geocentric horizon in the
                      evening; thus setting.  The phenomenon of
                      refraction is already respected in this as it
                      arises in reality by the influence of the Earth's
                      atmosphere, and that with the standard value of 34
                      arcminutes, which can indirectly be changed by
                      using the '--atmosphere' option.
 
'4'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 34
                      arcminutes below the geocentric horizon; thus is
                      visible.
 
'4'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 34
                      arcminutes below the geocentric horizon; thus is
                      non-visible.
 
'5'     'o'           Calculates the approximate time when the upper
                      limb of the Sun passes a reference altitude of 34
                      arcminutes below the geocentric horizon in the
                      morning; thus rising.  This kind of rise time
                      calculation is done according to the standard
                      calculation method as it is commonly used
                      internationally.  The phenomenon of refraction is
                      already respected in this as it arises in reality
                      by the influence of the Earth's atmosphere, and
                      that with the standard value of 34 arcminutes,
                      which can indirectly be changed by using the
                      '--atmosphere' option.
                      *note Fixed dates option '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere,
                      how to change the base data of the atmosphere, so
                      that the atmospheric conditions as defined by it
                      are used to calculate the amount of refraction.
                      The above mentioned reference altitude is computed
                      from the respective values of the Sun's
                      semidiameter and (standard) refraction as they
                      appear at that clocktime.  If the reference
                      altitude that is referring to the Sun's upper limb
                      is converted to a reference altitude that is
                      referring to the Sun's center, this results in a
                      value of about 50 arcminutes below the geocentric
                      horizon.
 
'5'     's'           Calculates the approximate time when the upper
                      limb of the Sun passes a reference altitude of 34
                      arcminutes below the geocentric horizon in the
                      evening; thus setting.  This kind of set time
                      calculation is done according to the standard
                      calculation method as it is commonly used
                      internationally.  The phenomenon of refraction is
                      already respected in this as it arises in reality
                      by the influence of the Earth's atmosphere, and
                      that with the standard value of 34 arcminutes,
                      which can indirectly be changed by using the
                      '--atmosphere' option.  The above mentioned
                      reference altitude is computed from the respective
                      values of the Sun's semidiameter and (standard)
                      refraction as they appear at that clocktime.
                      People of Islamic faith normally pray for the
                      second-last time on the day at this clocktime, or
                      some minutes later.  These people commonly use the
                      term "Maghrib" for this prayer time.
 
'5'     'u'           Calculates the approximate period while the upper
                      limb of the Sun is above a reference altitude of
                      34 arcminutes below the geocentric horizon; thus
                      is visible.  This kind of visibility period
                      calculation is done according to the standard
                      calculation method as it is commonly used
                      internationally.
 
'5'     'z'           Calculates the approximate period while the upper
                      limb of the Sun is above a reference altitude of
                      34 arcminutes below the geocentric horizon; thus
                      is non-visible.  This kind of non-visibility
                      period calculation is done according to the
                      standard calculation method as it is commonly used
                      internationally.
 
'6'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 6 degrees
                      below a mathematical horizon in the morning; thus
                      the beginning of "civil twilight".  The scattered
                      light of the Sun that is remaining at the
                      beginning of the civil twilight phase is in
                      general not yet sufficient for reading outside
                      without artificial illumination.
 
'6'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 6 degrees
                      below a mathematical horizon in the evening; thus
                      the ending of civil twilight.
 
'6'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 6
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      above -6 degrees.
 
'6'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 6
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      below -6 degrees.
 
'7'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 12 degrees
                      below a mathematical horizon in the morning; thus
                      the beginning of "nautical twilight".  The
                      scattered light of the Sun that is remaining at
                      the beginning of the nautical twilight phase is in
                      general not yet sufficient for navigation using a
                      sea horizon.
 
'7'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 12 degrees
                      below a mathematical horizon in the evening; thus
                      the ending of nautical twilight.
 
'7'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 12
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      above -12 degrees.
 
'7'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 12
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      below -12 degrees.
 
'8'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 15 degrees
                      below a mathematical horizon in the morning; thus
                      the beginning of "amateur-astronomical twilight".
                      The scattered light of the Sun that is remaining
                      at the beginning of the amateur-astronomical
                      twilight phase is in general yet so faint that
                      most astronomical observations can be made.
 
'8'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 15 degrees
                      below a mathematical horizon in the evening; thus
                      the ending of amateur-astronomical twilight.
 
'8'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 15
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      above -15 degrees.
 
'8'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 15
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      below -15 degrees.
 
'8'     'o'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 18 degrees
                      below a mathematical horizon in the morning; thus
                      the beginning of "astronomical twilight".  No
                      appreciable scattered sunlight is remaining at the
                      beginning of the astronomical twilight phase, the
                      sky is completely dark yet.  People of Islamic
                      faith normally pray for the first time on the day
                      during the period, which is between this clocktime
                      and the time of standard sunrise.  These people
                      commonly use the term "Fajr" for this prayer time.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'9'     's'           Calculates the approximate time when the center of
                      the Sun passes a reference altitude of 18 degrees
                      below a mathematical horizon in the evening; thus
                      the ending of astronomical twilight.  People of
                      Islamic faith normally pray for the last time on
                      the day at this clocktime, or some minutes later.
                      These people commonly use the term "Isha" for this
                      prayer time.
 
'9'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude of 18
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      above -18 degrees.
 
'9'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude of 18
                      degrees below a mathematical horizon; thus the
                      period, while the center of the Sun is always
                      below -18 degrees.
 
'a'     'o', 's'      Calculates the approximate "topocentric", apparent
                      "elevation" of the Sun, thus the vertical angular
                      distance between the Sun's center and the horizon,
                      in degrees and arcminutes as it happen at civil
                      midnight time.  Results with a negative sign
                      signify that the Sun's center is below the horizon
                      at the moment, and results with a positive sign
                      mean that the momentary center of the Sun is above
                      the horizon.  Observations of celestial objects
                      that are done from the surface of the Earth yield
                      in topocentrically based data.  The locations of
                      the celestial bodies are often at another place if
                      the data is topocentrically determined instead of
                      determine it "geocentrically", i.e. at the
                      fictitious center of the Earth.  This is mainly
                      caused by the refraction, which raises a celestial
                      body to another location as it is been in reality.
                      Because the terrestrial globe flattens towards the
                      pole caps and therefore cannot be taken as an
                      ideally shaped sphere, the individual Earth radius
                      between the observer's location and the center of
                      the Earth also affects the computation of
                      topocentrically based data.
 
'b'     'o', 's'      Calculates the approximate topocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at civil midnight time.
 
'c'     'o', 's'      Calculates the approximate topocentric, apparent
                      "declination" of the Sun, thus the vertical
                      angular distance between the Sun's center and the
                      celestial equator, in degrees and arcminutes as it
                      happen at civil midnight time.  Results with a
                      negative sign signify that the Sun's center is
                      below the celestial equator at the moment, and
                      results with a positive sign mean that the
                      momentary center of the Sun is below the celestial
                      equator.
 
'd'     'o', 's'      Calculates the approximate topocentric, apparent
                      "ecliptic longitude" of the Sun, thus the
                      horizontal angular distance between the Sun's
                      center and the vernal equinox point on the
                      "ecliptic" (the zodiacal line or Sun's orbit), in
                      degrees and arcminutes as it happen at civil
                      midnight time.
 
'e'     'o', 's'      Calculates the approximate topocentric, apparent
                      "right ascension" of the Sun, thus the horizontal
                      angular distance between the Sun's center and the
                      hour circle that passes through the vernal equinox
                      point on the ecliptic, as time value in hours and
                      minutes as it happen at civil midnight time.
 
'f'     'o', 's'      Calculates the approximate topocentric, apparent
                      distance of the Sun from the Earth in
                      "astronomical units" as it happen at civil
                      midnight time.  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.
 
'g'     'o', 's'      Calculates the approximate topocentric, apparent
                      "horizontal parallax" of the Sun in degrees and
                      arcminutes as it happen at civil midnight time.
                      The horizontal parallax of the Sun specifies the
                      diameter of the Earth as it is seen from the
                      surface of the Sun.
 
'h'     'o', 's'      Calculates the approximate topocentric, apparent
                      semidiameter of the Sun in degrees and arcminutes
                      as it happen at civil midnight time.
 
'i'     'o', 's'      Calculates the approximate refraction of the
                      Earth's atmosphere in degrees and arcminutes as it
                      happen at civil midnight time.
 
'j'     'o', 's'      Calculates the approximate geocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at civil midnight time.  Results with a
                      negative sign signify that the Sun's center is
                      below the horizon at the moment, and results with
                      a positive sign mean that the momentary center of
                      the Sun is above the horizon.
 
'k'     'o', 's'      Calculates the approximate geocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at civil midnight time.
 
'l'     'o', 's'      Calculates the approximate geocentric, apparent
                      declination of the Sun in degrees and arcminutes
                      as it happen at civil midnight time.  Results with
                      a negative sign signify that the Sun's center is
                      below the celestial equator at the moment, and
                      results with a positive sign mean that the
                      momentary center of the Sun is above the celestial
                      equator.
 
'm'     'o', 's'      Calculates the approximate geocentric, apparent
                      ecliptic longitude of the Sun in degrees and
                      arcminutes as it happen at civil midnight time.
 
'n'     'o', 's'      Calculates the approximate geocentric, apparent
                      right ascension of the Sun as time value in hours
                      and minutes as it happen at civil midnight time.
 
'o'     'o', 's'      Calculates the approximate geocentric, apparent
                      distance of the Sun from the Earth in astronomical
                      units as it happen at civil midnight time.
 
'p'     'o', 's'      Calculates the approximate geocentric, apparent
                      horizontal parallax of the Sun in degrees and
                      arcminutes as it happen at civil midnight time.
 
'q'     'o', 's'      Calculates the approximate geocentric, apparent
                      semidiameter of the Sun in degrees and arcminutes
                      as it happen at civil midnight time.
 
'r'     'o', 's'      Calculates the approximate "delta-t" in seconds as
                      it happen at civil midnight time.  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'.
 
's'     'o', 's'      Calculates the approximate, apparent location
                      oriented "sidereal time" (local sidereal time
                      (LAST), also known as _local star time_) in hours
                      and minutes as it happen at civil midnight time.
                      A "star day" is the period between two consecutive
                      upper culminations of the vernal equinox point on
                      the ecliptic in the meridian of the observer's
                      location.  Therefore, the local "star time" is 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.
 
't'     'o', 's'      Outputs the base time as time value in hours and
                      minutes, for which the dynamical, i.e. depending
                      on the respective clocktime, astronomical data and
                      times of the Sun are calculated.  Without a given
                      '--time-offset=ARGUMENT' option, the astronomical
                      data and times of the Sun are always calculated
                      for 0 o'clock Universal time (UTC/GMT).
                      *Note Calendar option '--time-offset=ARGUMENT': x-time-offset,
                      for further details.
 
'u'     'o', 's'      Calculates the approximate Julian date in days as
                      it happen at civil midnight time.
                      *Note Julian day number::, for further information
                      about the Julian date.
 
'v'     'o', 's'      Calculates the approximate "Julian Ephemeris
                      date", thus a Julian date that is corrected by
                      _delta-t_, in days as it happen at civil midnight
                      time.
 
'w'     'o', 's'      Calculates the approximate difference between
                      "true solar time" and "mean solar time" as time
                      value in hours and minutes as it happen at civil
                      midnight time.  This so-called "equation of time"
                      is a correction to be added to the true solar time
                      --as read on a sundial-- to obtain the mean solar
                      time.  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).  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.  So, this difference in time is a
                      consequence of the ellipticity and tilt of the
                      Earth's orbit, causing the irregular apparent
                      movement of the Sun across the sky.
 
'x'     'o', 's'      Calculates the difference of the approximate
                      topocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      civil midnight time.  Results with a negative sign
                      signify that the momentary center of the Sun is at
                      an elevation that is below the momentary elevation
                      of the Moon's center; thus the Sun is lower than
                      the Moon.  Results with a positive sign signify
                      that the momentary center of the Sun is at an
                      elevation that is above the momentary elevation of
                      the Moon's center; thus the Sun is higher than the
                      Moon.
 
'y'     'o', 's'      Calculates the difference of the approximate
                      topocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      civil midnight time.  The result specifies the
                      horizontal angular distance, by which the
                      momentary center of the Sun is distant from the
                      momentary Moon's center, and that measured at the
                      vertical circles that pass the Sun and the North
                      point and the Moon and the North point.  Results
                      with a negative sign signify that the Moon is to
                      the right (clockwise) of the Sun if one looks to
                      the Sun -- or alternatively expressed, that the
                      Sun is to the left (anti-clockwise) of the Moon.
                      Results with a positive sign signify that the Moon
                      is to the left (anti-clockwise) of the Sun if one
                      looks to the Sun -- or alternatively expressed,
                      that the Sun is to the right (clockwise) of the
                      Moon.
 
'z'     'o', 's'      Calculates the difference of the approximate
                      geocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      civil midnight time.
 
'A'     'o', 's'      Calculates the difference of the approximate
                      geocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      civil midnight time.
 
'B'     'o'           Calculates the difference of the approximate
                      topocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard rise time of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'B'     's'           Calculates the difference of the approximate
                      topocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard set time of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'C'     'o'           Calculates the difference of the approximate
                      topocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard rise time of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'C'     's'           Calculates the difference of the approximate
                      topocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard set time of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'D'     'o'           Calculates the difference of the approximate
                      geocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard rise time of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'D'     's'           Calculates the difference of the approximate
                      geocentric, apparent elevation of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard set time of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'E'     'o'           Calculates the difference of the approximate
                      geocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard rise time of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'E'     's'           Calculates the difference of the approximate
                      geocentric, apparent azimuth of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, in degrees and arcminutes as it happen at
                      standard set time of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'F'     'o', 's'      Calculates the difference of the approximate
                      astronomical midnight times of Sun and Moon
                      (delta), at which the Sun is used as the reference
                      point, as time value in hours and minutes as it
                      happen at astronomical midnight time of the Sun.
                      Results with a negative sign signify that the
                      astronomical midnight time of the Sun is earlier
                      than the astronomical midnight time of the Moon;
                      thus the solar midnight is before the lunar
                      midnight.  Results with a positive sign signify
                      that the astronomical midnight time of the Sun is
                      later than the astronomical midnight time of the
                      Moon; thus the solar midnight is after the lunar
                      midnight.
                      *Note Astronomical midnight time of the Sun: x-Sun-midnight,
                      and
                      *note Astronomical midnight time of the Moon: x-Moon-midnight,
                      for further details.
 
'G'     'o', 's'      Calculates the difference of the approximate
                      astronomical noon times of Sun and Moon (delta),
                      at which the Sun is used as the reference point,
                      as time value in hours and minutes as it happen at
                      astronomical noon time of the Sun.  Results with a
                      negative sign signify that the astronomical noon
                      time of the Sun is earlier than the astronomical
                      noon time of the Moon; thus the solar noon is
                      before the lunar noon.  Results with a positive
                      sign signify that the astronomical noon time of
                      the Sun is later than the astronomical noon time
                      of the Moon; thus the solar noon is after the
                      lunar noon.
                      *Note Astronomical noon time of the Sun: x-Sun-noon,
                      and
                      *note Astronomical noon time of the Moon: x-Moon-noon,
                      for further details.
 
'H'     'o'           Calculates the difference of the approximate
                      standard rise times of Sun and Moon (delta), at
                      which the Sun is used as the reference point, as
                      time value in hours and minutes as it happen at
                      standard rise time of the Sun.  Results with a
                      negative sign signify that the standard rise time
                      of the Sun is earlier than the standard rise time
                      of the Moon; thus the sunrise is before the
                      moonrise.  Results with a positive sign signify
                      that the standard rise time of the Sun is later
                      than the standard rise time of the Moon; thus the
                      sunrise is after the moonrise.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      and
                      *note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'H'     's'           Calculates the difference of the approximate
                      standard set times of Sun and Moon (delta), at
                      which the Sun is used as the reference point, as
                      time value in hours and minutes as it happen at
                      standard set time of the Sun.  Results with a
                      negative sign signify that the standard set time
                      of the Sun is earlier than the standard set time
                      of the Moon; thus the sunset is before the
                      moonset.  Results with a positive sign signify
                      that the standard set time of the Sun is later
                      than the standard set time of the Moon; thus the
                      sunset is after the moonset.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      and
                      *note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'I'     'o', 's'      Calculates the approximate topocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at astronomical midnight time of the Sun
                      (topocentric "midnight height").
                      *Note Astronomical midnight time of the Sun: x-Sun-midnight,
                      for further details.
 
'J'     'o', 's'      Calculates the approximate topocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at astronomical midnight time of the Sun
                      (topocentric "midnight height").
                      *Note Astronomical noon time of the Sun: x-Sun-noon,
                      for further details.
 
'K'     'o'           Calculates the approximate topocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at standard rise time of the Sun
                      (topocentric "rise height").
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'K'     's'           Calculates the approximate topocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at standard set time of the Sun
                      (topocentric "set height").
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'L'     'o'           Calculates the approximate topocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at standard rise time of the Sun
                      (topocentric "rise azimuth").  The horizontal
                      angular distance between the topocentric rise
                      azimuth and the East direction is also known as
                      the topocentric "morning width" of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'L'     's'           Calculates the approximate topocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at standard set time of the Sun
                      (topocentric "set azimuth").  The horizontal
                      angular distance between the topocentric set
                      azimuth and the West direction is also known as
                      the topocentric "evening width" of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'M'     'o', 's'      Calculates the approximate geocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at astronomical midnight time of the Sun
                      (geocentric "midnight height").
                      *Note Astronomical midnight time of the Sun: x-Sun-midnight,
                      for further details.
 
'N'     'o', 's'      Calculates the approximate geocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at astronomical midnight time of the Sun
                      (geocentric "midnight height").
                      *Note Astronomical noon time of the Sun: x-Sun-noon,
                      for further details.
 
'O'     'o'           Calculates the approximate geocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at standard rise time of the Sun
                      (geocentric "rise height").
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'O'     's'           Calculates the approximate geocentric, apparent
                      elevation of the Sun in degrees and arcminutes as
                      it happen at standard set time of the Sun
                      (geocentric "set height").
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'P'     'o'           Calculates the approximate geocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at standard rise time of the Sun
                      (geocentric "rise azimuth").  The horizontal
                      angular distance between the geocentric rise
                      azimuth and the East direction is also known as
                      the geocentric "morning width" of the Sun.
                      *Note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'P'     's'           Calculates the approximate geocentric, apparent
                      azimuth of the Sun in degrees and arcminutes as it
                      happen at standard set time of the Sun (geocentric
                      "set azimuth").  The horizontal angular distance
                      between the geocentric set azimuth and the West
                      direction is also known as the geocentric "evening
                      width" of the Sun.
                      *Note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'Q'     'o'           Calculates the approximate time when the length of
                      the shadow cast by a vertical pole in the forenoon
                      is *equal* the length of the pole.  Nevertheless,
                      the minimum length of the shadow is subtracted
                      from the length of the shadow before comparing it
                      with the length of the pole.
                      *Note Fixed dates option '--adjust-value=ARGUMENT': x-adjust-value,
                      how to change the shadow length factor.
 
'Q'     's'           Calculates the approximate time when the length of
                      the shadow cast by a vertical pole in the
                      afternoon is *equal* the length of the pole.
                      Nevertheless, the minimum length of the shadow is
                      subtracted from the length of the shadow before
                      comparing it with the length of the pole.  People
                      of Islamic faith, and that the people holding the
                      _Shafi_ school of jurisprudence, normally pray for
                      the third time on the day at this clocktime, or
                      some minutes later.  These people commonly use the
                      term "Asr" for this prayer time.
                      *Note Astronomical noon time of the Sun: x-Sun-noon,
                      for more information.  And note
                      *note Fixed dates option '--adjust-value=ARGUMENT': x-adjust-value,
                      how to change the shadow length factor.
 
'Q'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude, at which
                      the length of the shadow cast by a vertical pole
                      is of single or shorter length than the pole
                      itself.
 
'Q'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude, at which
                      a vertical pole either casts no shadow anymore, or
                      casts a shadow that is longer than the single
                      length of the pole itself.
 
'R'     'o'           Calculates the approximate time when the length of
                      the shadow cast by a vertical pole at forenoon is
                      *twice* the length of the pole.  Nevertheless, the
                      minimum length of the shadow is subtracted from
                      the length of the shadow before comparing it with
                      the length of the pole.
                      *Note Fixed dates option '--adjust-value=ARGUMENT': x-adjust-value,
                      how to change the shadow length factor.
 
'R'     's'           Calculates the approximate time when the length of
                      the shadow cast by a vertical pole in the
                      afternoon is *twice* the length of the pole.
                      Nevertheless, the minimum length of the shadow is
                      subtracted from the length of the shadow before
                      comparing it with the length of the pole.  People
                      of Islamic faith, and that the people holding the
                      _Hanafi_ school of jurisprudence, normally pray
                      for the third time on the day at this clocktime,
                      or some minutes later.  These people commonly use
                      the term "Asr" for this prayer time.
                      *Note Astronomical noon time of the Sun: x-Sun-noon,
                      for more information.  And note
                      *note Fixed dates option '--adjust-value=ARGUMENT': x-adjust-value,
                      how to change the shadow length factor.
 
'R'     'u'           Calculates the approximate period while the center
                      of the Sun is above a reference altitude, at which
                      the length of the shadow cast by a vertical pole
                      is of double or shorter length than the pole
                      itself.
 
'R'     'z'           Calculates the approximate period while the center
                      of the Sun is below a reference altitude, at which
                      a vertical pole either casts no shadow anymore, or
                      casts a shadow that is longer than twice the
                      length of the pole itself.

  If no MODE is given, Gcal automatically uses that mode, which is
enabled by the mode character '5'.  If a mode character is given that is
not according to one of the '0'...'9', 'a'...'z' and 'A'...'R'
characters, Gcal also automatically uses that mode, which is enabled by
the mode character '5'.

  Gcal represents the Sun oriented special texts depending on the
selected mode using the following types and styles:

  1. Unsigned decimal based rational number value
     Unsigned decimal based rational number values are represented using
     the 'N.N...' format by default.  A '*' character that is directly
     given before some mode characters causes Gcal to represent the
     value for another quantity.  For the mode characters, which

       a. cause the calculation of Earth/Sun or Earth/Moon distances,
          the calculated distance is represented in kilometers.

       b. cause the calculation of phase angles of the Moon, the
          calculated phase angle is represented as a phase value in
          percents.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  2. Signed decimal based rational number value
     Signed decimal based rational number values are represented using
     the '+|-N.N...' format by default.  A '*' character that is
     directly given before a mode character causes Gcal not to represent
     such values using another style.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  3. Clocktime value
     Clocktime values are represented in hours and minutes, and that in
     the 'HH:MM' _24-hour_ format by default.  A '*' character that is
     directly given before a mode character causes Gcal to represent the
     clocktime value using the _12-hour_ format, thus to provide it with
     a time suffix.  *Note Actual local time '%t[ARGUMENT]' special
     text: x-Actual-local-time, for more details about the above
     mentioned time value template.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations:

        * In case Gcal is unable to compute the approximate clocktime by
          reason of a misspecified ARGUMENT, a '??:??' text will be
          created instead of the clocktime text.

        * In case Gcal calculates an approximate clocktime that refers
          to a previous or next day, or Gcal is unable to calculate a
          clocktime because the event calculated does not occur during
          this day, a '**:**' text will be created instead of the
          clocktime text.

        * In case Gcal is unable to calculate an approximate clocktime
          because the reference point of the astronomical object, thus
          either the center or the upper limb of the Sun's or the Moon's
          disk, is always above the respective reference altitude, a
          '++:++' text will be created instead of the clocktime text.

        * In case Gcal is unable to calculate an approximate clocktime
          because the reference point of the astronomical object, thus
          either the center or the upper limb of the Sun's or the Moon's
          disk, is always below the respective reference altitude, a
          '--:--' text will be created instead of the clocktime text.

  4. Unsigned time value
     Unsigned time values, which mostly denote a period or interval of
     time, are represented in hours and minutes using the 'HHhMM''
     format by default.  A '*' character that is directly given before a
     mode character causes Gcal to represent the time value using
     another style, and that in decimal hours, i.e. in the 'HH.H...'
     format.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  5. Signed time value
     Signed time values, which mostly denote a period or interval of
     time, are represented in hours and minutes using the '+|-HHhMM''
     format by default.  A '*' character that is directly given before a
     mode character causes Gcal to represent the time value using
     another style, and that in decimal hours, i.e. in the '+|-HH.H...'
     format.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  6. Unsigned angular value
     Unsigned angular values are represented in degrees and arcminutes
     using the 'DDDdMM'' format by default.  A '*' character that is
     directly given before a mode character causes Gcal to represent the
     angular value using another style, and that in decimal degrees,
     i.e. in the 'DDD.D...' format.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  7. Signed angular value
     Signed angular values are represented in degrees and arcminutes
     using the '+|-DDDdMM'' format by default.  A '*' character that is
     directly given before a mode character causes Gcal to represent the
     angular value using another style, and that in decimal degrees,
     i.e. in the '+|-DDD.D...' format.

     If definite events happen, Gcal displays special event oriented
     texts instead of using the previously described representations.
     *Note Event texts of the Sun oriented special texts:
     x-Sun-event-texts, where you can find the event oriented texts that
     are created for clocktime values, which are schematically and
     analogously used for the type of representation as it is described
     here.

  After the optional style and mode characters, the latitude and
longitude of the geographic co-ordinates follows, for which the
calculations must be made.  They must be conform the ISO-6709:1983
standard representation of latitude and longitude for geographic point
locations, so that the co-ordinate has to be declared like this:

   * Latitude ('+' for North and on the equator, '-' for South of the
     equator.)

     '+|-DD[.DD]'
          Degrees (2 digits), and optionally decimal degrees

     '+|-DDMM[.MM]'
          Degrees (2 digits), arcminutes (2 digits), and optionally
          decimal minutes

     '+|-DDMMSS[.SS]'
          Degrees (2 digits), arcminutes (2 digits), arcseconds (2
          digits), and optionally decimal seconds

   * Longitude ('+' for East and on the prime meridian (Greenwich), '-'
     for West of Greenwich and up to the 180th meridian.)

     '+|-DDD[.DD]'
          Degrees (3 digits), and optionally decimal degrees

     '+|-DDDMM[.MM]'
          Degrees (3 digits), arcminutes (2 digits), and optionally
          decimal minutes

     '+|-DDDMMSS[.SS]'
          Degrees (3 digits), arcminutes (2 digits), arcseconds (2
          digits), and optionally decimal seconds

   * Optionally, the relative height in meters above the sea level ('+'
     for heights above and on the sea level, '-' for heights below the
     sea level.)

     '[+|-N[N[N[N]]]]'
          Height in meters (integer number) in range '-9999'...'+9999'
          (1...4 digits)

  All components of the co-ordinates must have leadings zeroes in case
they have less digits than the templates shown above.  Declared decimal
seconds are not respected by Gcal.  Heights which have a negative sign
remain unrespected if Gcal determinates Sun and Moon data and times,
respectively.  In such a case, Gcal always uses the height '+0'.
Latitude and longitude co-ordinates, and the height of the observer's
location are connected without any separating characters, like
'+40-075+61', '+401213.1-0750015.1' or '+40.20361-075.00417+0061'.  See
the pertinent literature for more details.

  A time value '[+|-]MMMM|HH:[MM]', which is separated by a ','
character, may trail the co-ordinate.  Such a time value informs Gcal,
about how many minutes MMMM respectively hours HH and minutes MM the
geographic location is displaced from Universal time (UTC/GMT).  This
time displacement value defines the timezone, which is actually valid
for this location.  If summer- and wintertimes are respected for the
location, you should include that change in time into the timezone value
for the period in which the summertime is valid, by which the clock is
put on during the summertime period -- such a change is either
subtracted from the timezone value for locations West of the prime
meridian (Greenwich), or it is added for locations East of the prime
meridian, because Gcal is actually unable to perform such operations
automatically!  *Note Actual local time '%t[ARGUMENT]' special text:
x-Actual-local-time, for more details about the above mentioned time
value template.  If no time displacement value is specified for a given
co-ordinate, Gcal assumes a time displacement value of '0', which is
equal to the actual Universal time (UTC/GMT).

  The following table informs you about which type of representation is
caused by a mode.  The previously defined numbering scheme, as it has
been used for the introduction of the types of representations, is used
as key value in the column that holds the type of representation.  The
table also contains a column that shows whether a mode enables dynamical
values, i.e. values that are depending on the respective clocktime (if
you use the '--time-offset=ARGUMENT' option, you can change the
respective clocktime that is used for calculating such values).  In a
next table column, it is listed whether the given co-ordinate of the
location influences the determination of a value, and the last column of
the table gives you the information whether a given timezone value
affects the values determination:

*Mode*  *Representation        *Dynamical*    *Co-ordinate*  *Timezone*
        Type*
 
'0'     3                      No             Yes            Yes
'1'     3                      No             Yes            Yes
'2'     3 or 4                 No             Yes            Yes
'3'     3 or 4                 No             Yes            Yes
'4'     3 or 4                 No             Yes            Yes
'5'     3 or 4                 No             Yes            Yes
'6'     3 or 4                 No             Yes            Yes
'7'     3 or 4                 No             Yes            Yes
'8'     3 or 4                 No             Yes            Yes
'9'     3 or 4                 No             Yes            Yes
'a'     7                      Yes            Yes            Yes
'b'     6                      Yes            Yes            Yes
'c'     7                      Yes            Yes            Yes
'd'     6                      Yes            Yes            Yes
'e'     4                      Yes            Yes            Yes
'f'     1 or 1a                Yes            Yes            Yes
'g'     6                      Yes            Yes            Yes
'h'     6                      Yes            Yes            Yes
'i'     6                      Yes            No             No
'j'     7                      Yes            Yes            Yes
'k'     6                      Yes            Yes            Yes
'l'     7                      Yes            Yes            Yes
'm'     6                      Yes            Yes            Yes
'n'     4                      Yes            Yes            Yes
'o'     1 or 1a                Yes            Yes            Yes
'p'     6                      Yes            Yes            Yes
'q'     6                      Yes            Yes            Yes
'r'     2                      Yes            No             No
's'     3                      Yes            Yes            Yes
't'     3                      Yes            No             No
'u'     1                      Yes            No             No
'v'     1                      Yes            No             No
'w'     5                      Yes            No             Yes
'x'     7                      Yes            Yes            Yes
'y'     7                      Yes            Yes            Yes
'z'     7                      Yes            Yes            Yes
'A'     7                      Yes            Yes            Yes
'B'     7                      No             Yes            Yes
'C'     7                      No             Yes            Yes
'D'     7                      No             Yes            Yes
'E'     7                      No             Yes            Yes
'F'     5                      No             Yes            Yes
'G'     5                      No             Yes            Yes
'H'     5                      No             Yes            Yes
'I'     7                      No             Yes            Yes
'J'     7                      No             Yes            Yes
'K'     7                      No             Yes            Yes
'L'     6                      No             Yes            Yes
'M'     7                      No             Yes            Yes
'N'     7                      No             Yes            Yes
'O'     7                      No             Yes            Yes
'P'     6                      No             Yes            Yes
'Q'     3 or 4                 No             Yes            Yes
'R'     3 or 4                 No             Yes            Yes

And now some examples to these special texts:

     The text 'Sunrise at %o+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Sunrise at 05:16 in MS, BRD', in case the actual system date
     is the 1st June 1998.

     The text 'Sunset at %s*5+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Sunset at 09:39pm in MS, BRD', in case the actual system date
     is the 1st June 1998.

     The text 'Sun visible %u5+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Sun visible 16h24' in MS, BRD', in case the actual system date
     is the 1st June 1998.

     The text 'Sun non-visible %z*+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Sun non-visible 7.607 in MS, BRD', in case the actual system
     date is the 1st June 1998.

     The text 'Sun azimuth 0 o'clock=%s*a+5158+00738,120  in MS, BRD'
     will be expanded to
     ==> 'Sun azimuth 0 o'clock=339d16' in MS, BRD', in case the actual
     system date is the 1st June 1998.

     The text 'Equation of time %ot+00+000=%o*w+00+000,120  BRD' will be
     expanded to
     ==> 'Equation of time +16h00'=+00h02'13.201" BRD', in case you call
     Gcal with the '--time-offset=16:' and '--precise' options and the
     actual system date is the 1st June 1998.

     The text 'Julian date at %ot+00+000 =%ou+00+000' will be expanded
     to
     ==> 'Julian date at +10h15'=2450965.927', in case you call Gcal
     with the '--time-offset=10:15' option and the actual system date is
     the 1st June 1998.

  Here is a list that reports about the used reference systems in a
short manner, describes other aspects that are unmentioned now, and
informs about the lacks and limitations that are existing for the Sun
oriented special texts:

   * All astronomical calculations are based on methods that use
     --astronomically seen-- low-precision elements, which of course is
     shown in the precision of the results that are caused by them.
     Nevertheless in most cases, these results can be treated as more as
     sufficiently precise if one measures their practical use.

   * All azimuth and elevation values are always referring to the center
     of the respective astronomical object, except the case, it is
     stated otherwise.

   * The base point of azimuth values, right ascension values and other
     ecliptic co-ordinate values is always measured clockwise relative
     to the geographical, true North (not the magnetic North as shown by
     a compass), where angular values for the North direction are both
     denoted as 0 degree and 360 degree.

   * All topocentrically based azimuth and elevation values are always
     corrected by the amount of atmospheric refraction.  Such a kind of
     correction is always done if the center of the respective
     astronomical object is above 2 degrees below the horizon.

   * Generally, the rise and set times of the Sun cannot be precisely
     predicted, because depending on unpredictable atmospheric
     conditions, i.e. the local weather conditions as they appear during
     these times change the amount of atmospheric refraction at the
     horizon, so that the precalculated rise and set times may
     throughout be in error by a minute or more.

   * The accuracy of rise and set computations decreases again at high
     latitudes, i.e. within in the solar Arctic Circle.  There, small
     variations in atmospheric refraction can change the time of sunrise
     or sunset by many minutes, since the Sun intersects the horizon at
     a very shallow angle.  For the same reason, at high latitudes, the
     effects of observer height and local topography are magnified and
     can substantially change the times of the phenomena actually
     observed, or even whether the phenomena are observed to occur at
     all.

   * The short explanations that are given to the different twilight
     phases all assume the model of ideal atmospheric conditions by
     default.  It is obvious that these explanations all become
     meaningless if other conditions occur in reality, like a cloudy sky
     or a badly polluted atmosphere.

*Please also note the following references:*

   * *Note Fixed dates option '--precise': x-precise, how to obtain a
     more precise representation of the values which are cause by these
     special texts.

   * And note *note Calendar option '--time-offset=ARGUMENT':
     x-time-offset, how to change the clocktime, for which the
     dynamical, i.e. depending on the respective clocktime, Sun oriented
     special texts are calculated.

   * Likewise, see *note Fixed dates option '--cycle-end=ARGUMENT':
     x-cycle-end, how the dynamical, i.e. depending on the respective
     clocktime, Sun oriented special texts are calculated for a series
     of clocktimes for the current day.

   * And also note *note Fixed dates option '--adjust-value=ARGUMENT':
     x-adjust-value, how to change the reference altitude that is used
     to calculate the rise and set times, as well as the shadow length
     factor.

   * Furthermore, see *note Fixed dates option
     '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere, how to
     change the base data of the atmosphere that influences the
     calculation of the Sun oriented special texts.

   * And last, note *note Fixed dates option '--limit': x-limit, how to
     limit the rise and set times of the Sun to the actual day.

  All Sun oriented special texts *must* always be trailed by a
_whitespace_ character which is removed in output!


File: gcal.info,  Node: Moon data,  Next: Contents of Environment variable,  Prev: Sun data,  Up: Replacements with other argument

G.2.2.6 Moon data '%[FORMAT]?ARGUMENT' special texts
....................................................

'%[FORMAT]([*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate time of *moonrise* by default,
'%[FORMAT])[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate time of *moonset* by default,
'%[FORMAT][[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate period of *visibility* of the Moon (lunar day
length) by default,
'%[FORMAT]][*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
references the approximate period of *non-visibility* of the Moon (lunar
night length) by default.

  All these special texts can be used for at pleasure any geographic
point location, i.e. it is possible to determine different astronomical
values for any location on the globe, and that for at pleasure any
clocktime with a resolution of a single minute within the period of the
years AD 1 until AD 9999, that is respected by Gcal.

  The selection which value has to be calculated by these special texts
is done by specifying the MODE part of the preceding argument.
Actually, exactly 61 different modes can be used that are represented by
the '0'...'9', 'a'...'z' and 'A'...'Y' characters, and which create
different kind of results that are depending on the special text used.
First of all, here is a table in which all usable modes are described
and explained sufficiently.  You can also see from this table, which
Moon oriented special text or texts are corresponding to which mode,
i.e. cause the determination of an astronomical value as it is described
in the table:

*Mode*  *Special      *Description*
        text*
 
'0'     '(', ')'      Calculates the approximate midnight time of the
                      Moon.  The astronomical midnight time of the Moon
                      is at that clocktime, when the Moon holds an
                      "azimuth" (horizontal angular distance between the
                      vertical circle, that passes the Moon, and the
                      North point) of either precisely 0 degrees of
                      precisely 180 degrees, which depends on the season
                      and the geographical location.  At that clocktime,
                      the Moon is close its "lowest culmination point",
                      i.e. close the lowest point below or above the
                      horizontal plane the Moon transits during this
                      day.  Nevertheless, there is exactly one day
                      during a "synodic month" (or lunation) --i.e. the
                      mean time between two consecutive "conjunctions"
                      (or New Moon phases)-- at which no lunar midnight
                      happens, because the Moon revolves the Earth
                      within 24 hours and 50 minutes on the average --
                      which also means, that the Moon rises on the
                      average 50 minutes later each day.
 
'1'     '(', ')'      Calculates the approximate noon time of the Moon.
                      The astronomical noon time of the Moon is at that
                      clocktime, when the Moon holds an azimuth of
                      either precisely 180 degrees of precisely 0
                      degrees, which depends on the season and the
                      geographical location.  At that clocktime, the
                      Moon is close its "highest culmination point",
                      i.e. close the highest point above or below the
                      horizontal plane the Moon transits during this
                      day.  Nevertheless, there is exactly one day
                      during a synodic month at which no lunar noon
                      happens.
 
'2'     '('           Calculates the approximate time when the center of
                      the Moon passes a reference altitude which is
                      between about 54 and 61 arcminutes above a
                      "mathematical-geocentric" horizon before lunar
                      noon time; thus rising.  A mathematical horizon is
                      a purely geometrically-built horizon which
                      disregards the phenomenon of refraction as it
                      arises in reality by the influence of the Earth's
                      atmosphere.  A geocentrical horizon is the
                      horizontal plane that passes through the Earth's
                      center, orthogonal to the observer's local
                      vertical.  In the further context, the shorter
                      term _mathematical horizon_ is used which actually
                      means the mathematical-geocentric horizon.  The
                      above mentioned reference altitude is computed
                      from the value of the Moon's parallax as it appear
                      at that clocktime.  Nevertheless, there is exactly
                      one day during a synodic month at which no such
                      moonrise happens.
 
'2'     ')'           Calculates the approximate time when the center of
                      the Moon passes a reference altitude which is
                      between about 54 and 61 arcminutes above a
                      mathematical horizon after lunar noon time; thus
                      setting.  The above mentioned reference altitude
                      is computed from the value of the Moon's parallax
                      as it appear at that clocktime.  Nevertheless,
                      there is exactly one day during a synodic month at
                      which no such moonset happens.
 
'2'     '['           Calculates the approximate period while the center
                      of the Moon is above a reference altitude which is
                      between about 54 and 61 arcminutes above a
                      mathematical horizon; thus is visible.
 
'2'     ']'           Calculates the approximate period while the center
                      of the Moon is below a reference altitude which is
                      between about 54 and 61 arcminutes above a
                      mathematical horizon; thus is non-visible.
 
'3'     '('           Calculates the approximate time when the upper
                      limb of the Moon passes a reference altitude which
                      is between about 54 and 61 arcminutes above a
                      mathematical horizon before lunar noon time; thus
                      rising.  The above mentioned reference altitude is
                      computed from the respective values of the Moon's
                      semidiameter and Moon's parallax as they appear at
                      that clocktime.  If the reference altitude that is
                      referring to the Moon's upper limb is converted to
                      a reference altitude that is referring to the
                      Moon's center, this results in a value which is
                      between about 39 and 44 arcminutes above the
                      geocentric horizon.  Nevertheless, there is
                      exactly one day during a synodic month at which no
                      such moonrise happens.
 
'3'     ')'           Calculates the approximate time when the upper
                      limb of the Moon passes a reference altitude which
                      is between about 54 and 61 arcminutes above a
                      mathematical horizon after lunar noon time; thus
                      setting.  The above mentioned reference altitude
                      is computed from the respective values of the
                      Moon's semidiameter and Moon's parallax as they
                      appear at that clocktime.  Nevertheless, there is
                      exactly one day during a synodic month at which no
                      such moonset happens.
 
'3'     '['           Calculates the approximate period while the upper
                      limb of the Moon is above a reference altitude
                      which is between about 54 and 61 arcminutes above
                      a mathematical horizon; thus is visible.
 
'3'     ']'           Calculates the approximate period while the upper
                      limb of the Moon is below a reference altitude
                      which is between about 54 and 61 arcminutes above
                      a mathematical horizon; thus is non-visible.
 
'4'     '('           Calculates the approximate time when the center of
                      the Moon passes a reference altitude which is
                      between about 20 and 27 arcminutes above the
                      geocentric horizon before lunar noon time; thus
                      rising.  The phenomenon of refraction is already
                      respected in this as it arises in reality by the
                      influence of the Earth's atmosphere, and that with
                      the standard value of 34 arcminutes, which can
                      indirectly be changed by using the '--atmosphere'
                      option.
                      *note Fixed dates option '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere,
                      how to change the base data of the atmosphere, so
                      that the atmospheric conditions as defined by it
                      are used to calculate the amount of refraction.
                      The above mentioned reference altitude is computed
                      from the respective values of the Moon's parallax
                      and (standard) refraction as they appear at that
                      clocktime.  Nevertheless, there is exactly one day
                      during a synodic month at which no such moonrise
                      happens.
 
'4'     ')'           Calculates the approximate time when the center of
                      the Moon passes a reference altitude which is
                      between about 20 and 27 arcminutes above the
                      geocentric horizon after lunar noon time; thus
                      setting.  The phenomenon of refraction is already
                      respected in this as it arises in reality by the
                      influence of the Earth's atmosphere, and that with
                      the standard value of 34 arcminutes, which can
                      indirectly be changed by using the '--atmosphere'
                      option.  The above mentioned reference altitude is
                      computed from the respective values of the Moon's
                      parallax and (standard) refraction as they appear
                      at that clocktime.  Nevertheless, there is exactly
                      one day during a synodic month at which no such
                      moonset happens.
 
'4'     '['           Calculates the approximate period while the center
                      of the Moon is above a reference altitude which is
                      between about 20 and 27 arcminutes above the
                      geocentric horizon; thus is visible.
 
'4'     ']'           Calculates the approximate period while the center
                      of the Moon is below a reference altitude which is
                      between about 20 and 27 arcminutes above the
                      geocentric horizon; thus is non-visible.
 
'5'     '('           Calculates the approximate time when the upper
                      limb of the Moon passes a reference altitude which
                      is between about 20 and 27 arcminutes above the
                      geocentric horizon before lunar noon time; thus
                      rising.  This kind of rise time calculation is
                      done according to the standard calculation method
                      as it is commonly used internationally.  The
                      phenomenon of refraction is already respected in
                      this as it arises in reality by the influence of
                      the Earth's atmosphere, and that with the standard
                      value of 34 arcminutes, which can indirectly be
                      changed by using the '--atmosphere' option.
                      *note Fixed dates option '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere,
                      how to change the base data of the atmosphere, so
                      that the atmospheric conditions as defined by it
                      are used to calculate the amount of refraction.
                      The above mentioned reference altitude is computed
                      from the respective values of the Moon's
                      semidiameter, Moon's parallax and (standard)
                      refraction as they appear at that clocktime.  If
                      the reference altitude that is referring to the
                      Moon's upper limb is converted to a reference
                      altitude that is referring to the Moon's center,
                      this results in a value which is between about 5
                      and 10 arcminutes above the geocentric horizon.
                      Nevertheless, there is exactly one day during a
                      synodic month at which no such moonrise happens.
 
'5'     ')'           Calculates the approximate time at which the upper
                      limb of the Moon passes a reference altitude which
                      is between about 20 and 27 arcminutes above the
                      geocentric horizon after lunar noon time; thus
                      setting.  This kind of set time calculation is
                      done according to the standard calculation method
                      as it is commonly used internationally.  The
                      phenomenon of refraction is already respected in
                      this as it arises in reality by the influence of
                      the Earth's atmosphere, and that with the standard
                      value of 34 arcminutes, which can indirectly be
                      changed by using the '--atmosphere' option.  The
                      above mentioned reference altitude is computed
                      from the respective values of the Moon's
                      semidiameter, Moon's parallax and (standard)
                      refraction as they appear at that clocktime.
                      Nevertheless, there is exactly one day during a
                      synodic month at which no such moonset happens.
 
'5'     '['           Calculates the approximate period while the upper
                      limb of the Moon is above a reference altitude
                      which is between about 20 and 27 arcminutes above
                      the geocentric horizon; thus is visible.  This
                      kind of visibility period calculation is done
                      according to the standard calculation method as it
                      is commonly used internationally.
 
'5'     ']'           Calculates the approximate period while the upper
                      limb of the Moon is below a reference altitude
                      which is between about 20 and 27 arcminutes above
                      the geocentric horizon; thus is non-visible.  This
                      kind of non-visibility period calculation is done
                      according to the standard calculation method as it
                      is commonly used internationally.
 
'6'     '(', ')'      Calculates the approximate "topocentric", apparent
                      "horizontal parallax" of the Moon in degrees and
                      arcminutes as it happen at civil midnight time.
                      The Moon's parallax states the diameter of the
                      Earth as it is seen from the surface of the Moon.
                      Observations of celestial objects that are done
                      from the surface of the Earth yield in
                      topocentrically based data.  The locations of the
                      celestial bodies are often at another place if the
                      data is topocentrically determined instead of
                      determine it "geocentrically", i.e. at the
                      fictitious center of the Earth.  This is mainly
                      caused by the refraction, which raises a celestial
                      body to another location as it is been in reality.
                      Because the terrestrial globe flattens towards the
                      pole caps and therefore cannot be taken as an
                      ideally shaped sphere, the individual Earth radius
                      between the observer's location and the center of
                      the Earth also affects the computation of
                      topocentrically based data.
 
'7'     '(', ')'      Calculates the approximate topocentric, apparent
                      semidiameter of the Moon in degrees and arcminutes
                      as it happen at civil midnight time.
 
'8'     '(', ')'      Calculates the approximate topocentric, apparent
                      brightness of the Moon in "magnitude units" as it
                      happen at civil midnight time.  The magnitude
                      (Latin term 'magnitudo', abbreviated m) is used to
                      define the brightness of a star, and is a
                      non-metrical value.  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.
 
'9'     '(', ')'      Calculates the approximate topocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at civil midnight time.
 
'a'     '(', ')'      Calculates the approximate topocentric, apparent
                      "elevation" of the Moon, thus the vertical angular
                      distance between the Moon's center and the
                      horizon, in degrees and arcminutes as it happen at
                      civil midnight time.  Results with a negative sign
                      signify that the Moon's center is below the
                      horizon at the moment, and results with a positive
                      sign mean that the momentary center of the Moon is
                      above the horizon.
 
'b'     '(', ')'      Calculates the approximate topocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at civil midnight time.
 
'c'     '(', ')'      Calculates the approximate topocentric, apparent
                      "declination" of the Moon, thus the vertical
                      angular distance between the Moon's center and the
                      celestial equator, in degrees and arcminutes as it
                      happen at civil midnight time.  Results with a
                      negative sign signify that the Moon's center is
                      below the celestial equator at the moment, and
                      results with a positive sign mean that the
                      momentary center of the Moon is above the
                      celestial equator.
 
'd'     '(', ')'      Calculates the approximate topocentric, apparent
                      "ecliptic longitude" of the Moon, thus the
                      horizontal angular distance between the Moon's
                      center and the vernal equinox point on the
                      "ecliptic" (the zodiacal line or Sun's orbit), in
                      degrees and arcminutes as it happen at civil
                      midnight time.
 
'e'     '(', ')'      Calculates the approximate topocentric, apparent
                      "ecliptic latitude" of the Moon, thus the vertical
                      angular distance between the Moon's center and the
                      ecliptic (zodiacal line/Sun's orbit), in degrees
                      and arcminutes as it happen at civil midnight
                      time.  Results with a negative sign signify that
                      the Moon's center is North of the ecliptic at the
                      moment, and results with a positive sign mean that
                      the momentary center of the Moon is South of the
                      ecliptic.
 
'f'     '(', ')'      Calculates the approximate topocentric, apparent
                      "right ascension" of the Moon, thus the horizontal
                      angular distance between the Moon's center and the
                      hour circle that passes through the vernal equinox
                      point on the ecliptic, as time value in hours and
                      minutes as it happen at civil midnight time.
 
'g'     '(', ')'      Calculates the approximate topocentric, apparent
                      distance of the Moon from the Earth in mean "Earth
                      equator radii" as it happen at civil midnight
                      time.  The mean radius of Earth at the equator is
                      about 6,378.137 kilometer.
 
'h'     '(', ')'      Calculates the approximate topocentric, apparent
                      "elongation" of the Moon, thus the horizontal
                      angular distance between the Moon's center and the
                      Sun's center, in degrees and arcminutes as it
                      happen at civil midnight time.
 
'i'     '(', ')'      Calculates the approximate refraction of the
                      Earth's atmosphere in degrees and arcminutes as it
                      happen at civil midnight time.
 
'j'     '(', ')'      Calculates the approximate geocentric, apparent
                      horizontal parallax of the Moon in degrees and
                      arcminutes as it happen at civil midnight time.
 
'k'     '(', ')'      Calculates the approximate geocentric, apparent
                      semidiameter of the Moon in degrees and arcminutes
                      as it happen at civil midnight time.
 
'l'     '(', ')'      Calculates the approximate geocentric, apparent
                      brightness of the Moon in magnitude units as it
                      happen at civil midnight time.
 
'm'     '(', ')'      Calculates the approximate geocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at civil midnight time.
 
'n'     '(', ')'      Calculates the approximate geocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at civil midnight time.  Results with a
                      negative sign signify that the Moon's center is
                      below the horizon at the moment, and results with
                      a positive sign mean that the momentary center of
                      the Moon is above the horizon.
 
'o'     '(', ')'      Calculates the approximate geocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at civil midnight time.
 
'p'     '(', ')'      Calculates the approximate geocentric, apparent
                      declination of the Moon in degrees and arcminutes
                      as it happen at civil midnight time.  Results with
                      a negative sign signify that the Moon's center is
                      below the celestial equator at the moment, and
                      results with a positive sign mean that the
                      momentary center of the Moon is above the
                      celestial equator.
 
'q'     '(', ')'      Calculates the approximate geocentric, apparent
                      ecliptic longitude of the Moon in degrees and
                      arcminutes as it happen at civil midnight time.
 
'r'     '(', ')'      Calculates the approximate geocentric, apparent
                      ecliptic latitude of the Moon in degrees and
                      arcminutes as it happen at civil midnight time.
                      Results with a negative sign signify that the
                      Moon's center is North of the ecliptic at the
                      moment, and results with a positive sign mean that
                      the momentary center of the Moon is South of the
                      ecliptic.
 
's'     '(', ')'      Calculates the approximate geocentric, apparent
                      right ascension of the Moon as time value in hours
                      and minutes as it happen at civil midnight time.
 
't'     '(', ')'      Calculates the approximate geocentric, apparent
                      distance of the Moon from the Earth in mean Earth
                      equator radii as it happen at civil midnight time.
 
'u'     '(', ')'      Calculates the approximate geocentric, apparent
                      elongation of the Moon in degrees and arcminutes
                      as it happen at civil midnight time.
 
'v'     '(', ')'      Calculates the approximate "delta-t" in seconds as
                      it happen at civil midnight time.  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'.
 
'w'     '(', ')'      Calculates the approximate, apparent location
                      oriented "sidereal time" (local sidereal time
                      (LAST), also known as _local star time_) in hours
                      and minutes as it happen at civil midnight time.
                      A "star day" is the period between two consecutive
                      upper culminations of the vernal equinox point on
                      the ecliptic in the meridian of the observer's
                      location.  Therefore, the local "star time" is 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.
 
'x'     '(', ')'      Outputs the base time as time value in hours and
                      minutes, for which the dynamical, i.e. depending
                      on the respective clocktime, astronomical data and
                      times of the Moon are calculated.  Without a given
                      '--time-offset=ARGUMENT' option, the astronomical
                      data and times of the Moon are always calculated
                      for 0 o'clock Universal time (UTC/GMT).
                      *Note Calendar option '--time-offset=ARGUMENT': x-time-offset,
                      for further details.
 
'y'     '(', ')'      Calculates the approximate Julian date in days as
                      it happen at civil midnight time.
                      *Note Julian day number::, for further information
                      about the Julian date.
 
'z'     '(', ')'      Calculates the approximate "Julian Ephemeris
                      date", thus a Julian date that is corrected by
                      _delta-t_, in days as it happen at civil midnight
                      time.
 
'A'     '(', ')'      Calculates the difference of the approximate
                      topocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at civil midnight time.  Results with a
                      negative sign signify that the momentary center of
                      the Moon is at an elevation that is below the
                      momentary elevation of the Sun's center; thus the
                      Moon is lower than the Sun.  Results with a
                      positive sign signify that the momentary center of
                      the Moon is at an elevation that is above the
                      momentary elevation of the Sun's center; thus the
                      Moon is higher than the Sun.
 
'B'     '(', ')'      Calculates the difference of the approximate
                      topocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at civil midnight time.  The result
                      specifies the horizontal angular distance, by
                      which the momentary center of the Moon is distant
                      from the momentary Sun's center, and that measured
                      at the vertical circles that pass the Moon and the
                      North point and the Sun and the North point.
                      Results with a negative sign signify that the Sun
                      is to the right (clockwise) of the Moon if one
                      looks to the Moon -- or alternatively expressed,
                      that the Moon is to the left (anti-clockwise) of
                      the Sun.  Results with a positive sign signify
                      that the Sun is to the left (anti-clockwise) of
                      the Moon if one looks to the Moon -- or
                      alternatively expressed, that the Moon is to the
                      right (clockwise) of the Sun.
 
'C'     '(', ')'      Calculates the difference of the approximate
                      geocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at civil midnight time.
 
'D'     '(', ')'      Calculates the difference of the approximate
                      geocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at civil midnight time.
 
'E'     '('           Calculates the difference of the approximate
                      topocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard rise time of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'E'     ')'           Calculates the difference of the approximate
                      topocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard set time of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'F'     '('           Calculates the difference of the approximate
                      topocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard rise time of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'F'     ')'           Calculates the difference of the approximate
                      topocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard set time of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'G'     '('           Calculates the difference of the approximate
                      geocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard rise time of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'G'     ')'           Calculates the difference of the approximate
                      geocentric, apparent elevation of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard set time of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'H'     '('           Calculates the difference of the approximate
                      geocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard rise time of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'H'     ')'           Calculates the difference of the approximate
                      geocentric, apparent azimuth of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, in degrees and arcminutes as it
                      happen at standard set time of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'I'     '(', ')'      Calculates the difference of the approximate
                      astronomical midnight times of Moon and Sun
                      (delta), at which the Moon is used as the
                      reference point, as time value in hours and
                      minutes as it happen at astronomical midnight time
                      of the Moon.  Results with a negative sign signify
                      that the astronomical midnight time of the Moon is
                      earlier than the astronomical midnight time of the
                      Sun; thus the lunar midnight is before the solar
                      midnight.  Results with a positive sign signify
                      that the astronomical midnight time of the Moon is
                      later than the astronomical midnight time of the
                      Sun; thus the lunar midnight is after the solar
                      midnight.
                      *Note Astronomical midnight time of the Moon: x-Moon-midnight,
                      and
                      *note Astronomical midnight time of the Sun: x-Sun-midnight,
                      for further details.
 
'J'     '(', ')'      Calculates the difference of the approximate
                      astronomical noon times of Moon and Sun (delta),
                      at which the Moon is used as the reference point,
                      as time value in hours and minutes as it happen at
                      astronomical noon time of the Moon.  Results with
                      a negative sign signify that the astronomical noon
                      time of the Moon is earlier than the astronomical
                      noon time of the Sun; thus the lunar noon is
                      before the solar noon.  Results with a positive
                      sign signify that the astronomical noon time of
                      the Moon is later than the astronomical noon time
                      of the Sun; thus the lunar noon is after the solar
                      noon.
                      *Note Astronomical noon time of the Moon: x-Moon-noon,
                      and
                      *note Astronomical noon time of the Sun: x-Sun-noon,
                      for further details.
 
'K'     '('           Calculates the difference of the approximate
                      standard rise times of Moon and Sun (delta), at
                      which the Moon is used as the reference point, as
                      time value in hours and minutes as it happen at
                      standard rise time of the Moon.  Results with a
                      negative sign signify that the standard rise time
                      of the Moon is earlier than the standard rise time
                      of the Sun; thus the moonrise is before the
                      sunrise.  Results with a positive sign signify
                      that the standard rise time of the Moon is later
                      than the standard rise time of the Sun; thus the
                      moonrise is after the sunrise.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      and
                      *note Standard rise time of the Sun: x-Sun-standard-rise,
                      for further details.
 
'K'     ')'           Calculates the difference of the approximate
                      standard set times of Moon and Sun (delta), at
                      which the Moon is used as the reference point, as
                      time value in hours and minutes as it happen at
                      standard set time of the Moon.  Results with a
                      negative sign signify that the standard set time
                      of the Moon is earlier than the standard set time
                      of the Sun; thus the moonset is before the sunset.
                      Results with a positive sign signify that the
                      standard set time of the Moon is later than the
                      standard set time of the Sun; thus the moonset is
                      after the sunset.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      and
                      *note Standard set time of the Sun: x-Sun-standard-set,
                      for further details.
 
'L'     '(', ')'      Calculates the approximate topocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at astronomical midnight time of the
                      Moon (topocentric "midnight height").
                      *Note Astronomical midnight time of the Moon: x-Moon-midnight,
                      for further details.
 
'M'     '(', ')'      Calculates the approximate topocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at astronomical midnight time of the Moon
                      (topocentric "midnight phase angle").
                      *Note Astronomical midnight time of the Moon: x-Moon-midnight,
                      for further details.
 
'N'     '(', ')'      Calculates the approximate topocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at astronomical noon time of the Moon
                      (topocentric "noon height").
                      *Note Astronomical noon time of the Moon: x-Moon-noon,
                      for further details.
 
'O'     '(', ')'      Calculates the approximate topocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at astronomical noon time of the Moon
                      (topocentric "noon phase angle").
                      *Note Astronomical noon time of the Moon: x-Moon-noon,
                      for further details.
 
'P'     '('           Calculates the approximate topocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at standard rise time of the Moon
                      (topocentric "rise height").
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'P'     ')'           Calculates the approximate topocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at standard set time of the Moon
                      (topocentric "set height").
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'Q'     '('           Calculates the approximate topocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at standard rise time of the Moon
                      (topocentric "rise azimuth").  The horizontal
                      angular distance between the topocentric rise
                      azimuth and the East direction is also known as
                      the topocentric "rise width" of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'Q'     ')'           Calculates the approximate topocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at standard set time of the Moon
                      (topocentric "set azimuth").  The horizontal
                      angular distance between the topocentric set
                      azimuth and the West direction is also known as
                      the topocentric "set width" of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'R'     '('           Calculates the approximate topocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at standard rise time of the Moon
                      (topocentric "rise phase angle").
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'R'     ')'           Calculates the approximate topocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at standard set time of the Moon
                      (topocentric "set phase angle").
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'S'     '(', ')'      Calculates the approximate geocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at astronomical midnight time of the
                      Moon (geocentric "midnight height").
                      *Note Astronomical midnight time of the Moon: x-Moon-midnight,
                      for further details.
 
'T'     '(', ')'      Calculates the approximate geocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at astronomical midnight time of the Moon
                      (geocentric "midnight phase angle").
                      *Note Astronomical midnight time of the Moon: x-Moon-midnight,
                      for further details.
 
'U'     '(', ')'      Calculates the approximate geocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at astronomical noon time of the Moon
                      (geocentric "noon height").
                      *Note Astronomical noon time of the Moon: x-Moon-noon,
                      for further details.
 
'V'     '(', ')'      Calculates the approximate geocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at astronomical noon time of the Moon
                      (geocentric "noon phase angle").
                      *Note Astronomical noon time of the Moon: x-Moon-noon,
                      for further details.
 
'W'     '('           Calculates the approximate geocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at standard rise time of the Moon
                      (geocentric "rise height").
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'W'     ')'           Calculates the approximate geocentric, apparent
                      elevation of the Moon in degrees and arcminutes as
                      it happen at standard set time of the Moon
                      (geocentric "set height").
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'X'     '('           Calculates the approximate geocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at standard rise time of the Moon
                      (geocentric "rise azimuth").  The horizontal
                      angular distance between the geocentric rise
                      azimuth and the East direction is also known as
                      the geocentric "rise width" of the Moon.
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'X'     ')'           Calculates the approximate geocentric, apparent
                      azimuth of the Moon in degrees and arcminutes as
                      it happen at standard set time of the Moon
                      (geocentric "set azimuth").  The horizontal
                      angular distance between the geocentric set
                      azimuth and the West direction is also known as
                      the geocentric "set width" of the Moon.
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.
 
'Y'     '('           Calculates the approximate geocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at standard rise time of the Moon
                      (geocentric "rise phase angle").
                      *Note Standard rise time of the Moon: x-Moon-standard-rise,
                      for further details.
 
'Y'     ')'           Calculates the approximate geocentric, apparent
                      phase angle of the Moon in range 0.0...1.0 as it
                      happen at standard set time of the Moon
                      (geocentric "set phase angle").
                      *Note Standard set time of the Moon: x-Moon-standard-set,
                      for further details.

  If no MODE is given, Gcal automatically uses that mode, which is
enabled by the mode character '5'.  If a mode character is given that is
not according to one of the '0'...'9', 'a'...'z' and 'A'...'Y'
characters, Gcal also automatically uses that mode, which is enabled by
the mode character '5'.

  Depending on the selected mode, Gcal represents the Moon oriented
special texts using the same types and styles as they are used by the
Sun oriented special texts, these are analogously valid!  *Note
Representation of the Sun oriented special texts: x-Sun-representation,
for the detailed description of the different types of representation
used by the Sun oriented special texts, which are likewise valid for the
Moon oriented special texts.

  The ARGUMENT the Moon oriented special texts must have is exactly
equivalent the argument the Sun oriented special texts must have!  *Note
Arguments of the Sun oriented special texts: x-Sun-arguments, for the
detailed description of the components of the ARGUMENT which also has to
be given to the Moon oriented special texts.

  The following table informs you about which type of representation is
caused by a mode.  The previously defined numbering scheme, as it has
been used for the introduction of the types of representation, is used
as key value in the column that holds the type of representation.  The
table also contains a column that shows whether a mode enables dynamical
values, i.e. values that are depending on the respective clocktime (if
you use the '--time-offset=ARGUMENT' option, you can change the
respective clocktime that is used for calculating such values).  In a
next table column, it is listed whether the given co-ordinate of the
location influences the determination of a value, and the last column of
the table gives you the information whether a given timezone value
affects the values determination:

*Mode*  *Representation        *Dynamical*    *Co-ordinate*  *Timezone*
        Type*
 
'0'     3                      No             Yes            Yes
'1'     3                      No             Yes            Yes
'2'     3 or 4                 No             Yes            Yes
'3'     3 or 4                 No             Yes            Yes
'4'     3 or 4                 No             Yes            Yes
'5'     3 or 4                 No             Yes            Yes
'6'     6                      Yes            Yes            Yes
'7'     6                      Yes            Yes            Yes
'8'     2                      Yes            Yes            Yes
'9'     1 or 1b                Yes            Yes            Yes
'a'     7                      Yes            Yes            Yes
'b'     6                      Yes            Yes            Yes
'c'     7                      Yes            Yes            Yes
'd'     6                      Yes            Yes            Yes
'e'     7                      Yes            Yes            Yes
'f'     4                      Yes            Yes            Yes
'g'     1 or 1a                Yes            Yes            Yes
'h'     6                      Yes            Yes            Yes
'i'     6                      Yes            No             No
'j'     6                      Yes            Yes            Yes
'k'     6                      Yes            Yes            Yes
'l'     2                      Yes            Yes            Yes
'm'     1 or 1b                Yes            Yes            Yes
'n'     7                      Yes            Yes            Yes
'o'     6                      Yes            Yes            Yes
'p'     7                      Yes            Yes            Yes
'q'     6                      Yes            Yes            Yes
'r'     7                      Yes            Yes            Yes
's'     4                      Yes            Yes            Yes
't'     1 or 1a                Yes            Yes            Yes
'u'     6                      Yes            Yes            Yes
'v'     2                      Yes            No             No
'w'     3                      Yes            Yes            Yes
'x'     3                      Yes            No             No
'y'     1                      Yes            No             No
'z'     1                      Yes            No             No
'A'     7                      Yes            Yes            Yes
'B'     7                      Yes            Yes            Yes
'C'     7                      Yes            Yes            Yes
'D'     7                      Yes            Yes            Yes
'E'     7                      No             Yes            Yes
'F'     7                      No             Yes            Yes
'G'     7                      No             Yes            Yes
'H'     7                      No             Yes            Yes
'I'     5                      No             Yes            Yes
'J'     5                      No             Yes            Yes
'K'     5                      No             Yes            Yes
'L'     7                      No             Yes            Yes
'M'     1 or 1b                No             Yes            Yes
'N'     7                      No             Yes            Yes
'O'     1 or 1b                No             Yes            Yes
'P'     7                      No             Yes            Yes
'Q'     6                      No             Yes            Yes
'R'     1 or 1b                No             Yes            Yes
'S'     7                      No             Yes            Yes
'T'     1 or 1b                No             Yes            Yes
'U'     7                      No             Yes            Yes
'V'     1 or 1b                No             Yes            Yes
'W'     7                      No             Yes            Yes
'X'     6                      No             Yes            Yes
'Y'     1 or 1b                No             Yes            Yes

And now some examples to these special texts:

     The text 'Moonrise at %(+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Moonrise at 12:21 in MS, BRD', in case the actual system date
     is the 1st June 1998.

     The text 'Moonset at %)*5+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Moonset at 01:53am in MS, BRD', in case the actual system date
     is the 1st June 1998.

     The text 'Moon visible %[5+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Moon visible 13h32' in MS, BRD', in case the actual system
     date is the 1st June 1998.

     The text 'Moon non-visible %]*+5158+00738,120  in MS, BRD' will be
     expanded to
     ==> 'Moon non-visible 10.469 in MS, BRD', in case the actual system
     date is the 1st June 1998.

     The text 'Moon azimuth 0 o'clock=%(*a+5158+00738,120  in MS, BRD'
     will be expanded to
     ==> 'Moon azimuth 0 o'clock=267d37' in MS, BRD', in case the actual
     system date is the 1st June 1998.

     The text 'Moonphase %(x+00+000 =%(*m+5158+00738,120 % in MS, BRD'
     will be expanded to
     ==> 'Moonphase +16h00'=45.248% in MS, BRD', in case you call Gcal
     with the '--time-offset=16:' option and the actual system date is
     the 1st June 1998.

     The text 'Julian date at %(x+00+000 =%(y+00+000' will be expanded
     to
     ==> 'Julian date at +10h15'=2450965.927', in case you call Gcal
     with the '--time-offset=10:15' option and the actual system date is
     the 1st June 1998.

  Here is a list that reports about the used reference systems in a
short manner, describes other aspects that are unmentioned now, and
informs about the lacks and limitations that are existing for the Moon
oriented special texts:

   * All astronomical calculations are based on methods that use
     --astronomically seen-- low-precision elements, which of course is
     shown in the precision of the results that are caused by them.
     Nevertheless in most cases, these results can be treated as more as
     sufficiently precise if one measures their practical use.

   * All azimuth and elevation values are always referring to the center
     of the respective astronomical object, except the case, it is
     stated otherwise.

   * The base point of azimuth values, right ascension values and other
     ecliptic co-ordinate values is always measured clockwise relative
     to the geographical, true North (not the magnetic North as shown by
     a compass), where angular values for the North direction are both
     denoted as 0 degree and 360 degree.

   * All topocentrically based azimuth and elevation values are always
     corrected by the amount of atmospheric refraction.  Such a kind of
     correction is always done if the center of the respective
     astronomical object is above 2 degrees below the horizon.

   * Generally, the rise and set times of the Moon cannot be precisely
     predicted, because depending on unpredictable atmospheric
     conditions, i.e. the local weather conditions as they appear during
     these times change the amount of atmospheric refraction at the
     horizon, so that the precalculated rise and set times may
     throughout be in error by a minute or more.

   * The accuracy of rise and set computations decreases again at high
     latitudes, i.e. within in the lunar Arctic Circle.  There, small
     variations in atmospheric refraction can change the time of
     moonrise or moonset by many minutes, since the Moon intersects the
     horizon at a very shallow angle.  For the same reason, at high
     latitudes, the effects of observer height and local topography are
     magnified and can substantially change the times of the phenomena
     actually observed, or even whether the phenomena are observed to
     occur at all.

   * It is possible that calculations, which are done for locations
     within the lunar Arctic Circle, sometimes result in the wrongly
     **.** text instead of the more precisely ++:++ or -:- texts that
     are used for marking special events.  Unfortunately, therefore,
     then the reason why the Moon does not rise or set is no longer
     clearly evident, respectively, it is possible to get the false
     suggestion that the reason for non-rising or non-setting of the
     Moon is caused by just the one day within a synodic month, at which
     the Moon does not rise or set anyhow.  Unfortunately, it is just
     only obvious *that* the Moon does not rise or set during this day.

*Please also note the following references:*

   * *Note Fixed dates option '--precise': x-precise, how to obtain a
     more precise representation of the values which are cause by these
     special texts.

   * And note *note Calendar option '--time-offset=ARGUMENT':
     x-time-offset, how to change the clocktime, for which the
     dynamical, i.e. depending on the respective clocktime, Moon
     oriented special texts are calculated.

   * Likewise, see *note Fixed dates option '--cycle-end=ARGUMENT':
     x-cycle-end, how the dynamical, i.e. depending on the respective
     clocktime, Moon oriented special texts are calculated for a series
     of clocktimes for the current day.

   * Furthermore, see *note Fixed dates option
     '--adjust-value=ARGUMENT': x-adjust-value, how to change the
     reference altitude that is used to calculate the rise and set
     times.

   * And last, note *note Fixed dates option
     '--atmosphere=AIR-PRESSURE[,TEMPERATURE]': x-atmosphere, how to
     change the base data of the atmosphere that affects the calculation
     of the Moon oriented special texts.

  All Moon oriented special texts *must* always be trailed by a
_whitespace_ character which is removed in output!


File: gcal.info,  Node: Contents of Environment variable,  Prev: Moon data,  Up: Replacements with other argument

G.2.2.7 Environment variable '%[FORMAT]-[ARGUMENT]' special text
................................................................

'%[FORMAT]-[ARGUMENT]' references the contents of an *environment
variable*, e.g.:

     The text 'I am `%-USER '-user' will be expanded to
     ==> 'I am `guest'-user', in case you logged-in as guest on your
     system.

  This special text *must* always be trailed by a _whitespace_ character
which is removed in output!


File: gcal.info,  Node: Replacements without any argument,  Prev: Replacements with other argument,  Up: Replacements

G.2.3 Replacements without any argument '%?' special texts
----------------------------------------------------------

* Menu:

* Other difference values::
* Highlighting::

Apart from further useful difference values, the text of a fixed date
can be provided with different texts used for highlighting.


File: gcal.info,  Node: Other difference values,  Next: Highlighting,  Prev: Replacements without any argument,  Up: Replacements without any argument

G.2.3.1 Difference value '%[FORMAT]?' special texts
...................................................

The use of the other difference values as listed here is to calculate
distance values between two dates.  In case these special texts are
directly lead by a '-' character, e.g. '-%d', Gcal switches the sign of
the computed value.

  You may depreciate the special meaning of the '-' character --in case
this character itself is needed-- by placing a '\' (backslash) character
before it, e.g. '\-'.  If you need the '\-' characters themselves, you
have to protect the '\' (backslash) character by another '\' (backslash)
character, e.g. '\\-'.

  The following other difference values '%[FORMAT]?' special texts are
respected:

'%d'
     Specifies the current respectively queried *day* relative to the
     actual system date (==today), e.g.:

          The resource file line '0 %d days gone' will be expanded to
          ==> '-10 days gone', in case you call Gcal with the '-c10-'
          option and no command.

'%w'
     Specifies the current respectively queried *week* relative to the
     actual system date (==today).  Started weeks are counted as
     complete weeks.

'%m'
     Specifies the current respectively queried *month* relative to the
     actual system date (==today).  Started months are counted as
     complete months.

'%y'
     Specifies the current respectively queried *year* relative to the
     actual system date (==today).  Started years are counted as
     complete years.  This special text *must* always be trailed by a
     _whitespace_ character which is removed in output!

  An example:

  Supposing, the actual system date is the 4th September 1999.  To
calculate, how many days, weeks, months and years are between the actual
system date and the birthday of a person, who is born on 21st September
1962, Gcal can be called as follows:

     $ gcal -f/dev/null -Ux -u -#'19620921 %y %m %w %d~' 1962
     -|
     -| -37 -444 -1928 -13497
     -|
     $ gcal -f/dev/null -Ux -u -#'19620921 \\-%y \-%m %w -%d~' 1962
     -|
     -| \--37 --444 -1928 13497
     -|
     $ gcal -f/dev/null -Ux -u -#'00000904 %y %m %w %d~' %19620921 1999
     -|
     -| 37 444 1928 13497
     -|
     $ gcal -f/dev/null -Ux -u -#'00000904 %y %B19620921' %19620921 1962
     -|
     -| 37 36

Please do not confound the relative year number '%[FORMAT]y' special
text with the age value '%B' special text (*note Age value
'%[FORMAT]B[DATE]' special text: x-Age-value.).  The '%y' special text
counts started years as complete years, while the '%B' special text does
not.


File: gcal.info,  Node: Highlighting,  Prev: Other difference values,  Up: Replacements without any argument

G.2.3.2 Highlighting '%?' special texts
.......................................

The following highlighting '%?' special texts are respected:

'%1'
     '%1' is replaced by the starting highlighting sequence respectively
     the starting marking character that is used for highlighting the
     actual day (*note Global option '--highlighting=TEXT':
     x-highlighting.).  This attains, that all succeeding text of the
     line after this special text is displayed in the same way as the
     highlighted respectively marked actual day.  '%1' is used together
     with the '%2' special text, which turns off this enabled
     highlighting sequence respectively produces the ending marking
     character.  If a '%1' text is not succeeded by a '%2' text on the
     line, Gcal automatically inserts such a '%2' text at the end of the
     line.

     For example:

          Only %1THIS%2 word is highlighted in this line.
          %1This text is highlighted up to%2 here.
          All from %1here up to the end of the line is highlighted.

'%2'
     '%2' is replaced by the ending highlighting sequence respectively
     the ending marking character that is used for highlighting the
     actual day.  This attains, that a possibly active highlighting
     according to the actual day is turned off respectively an ending
     marking character is produced.  '%2' is used together with the '%1'
     special text.  The '%2' text has no affect if no preceding '%1'
     text was found on the line.

'%3'
     '%3' is replaced by the starting highlighting sequence respectively
     the starting marking character that is used for highlighting a
     holiday, (*note Global option '--highlighting=TEXT':
     x-highlighting.).  This attains, that all succeeding text of the
     line after this special text is displayed in the same way as the
     highlighted respectively marked holiday.  '%3' is used together
     with the '%4' special text, which turns off this enabled
     highlighting sequence respectively produces the ending marking
     character.  If a '%3' text is not succeeded by a '%4' text on the
     line, Gcal automatically inserts such a '%4' text at the end of the
     line.

     For example:

          Only %3THIS%4 word is highlighted in this line.
          %3This text is highlighted up to%4 here.
          All from %3here up to the end of the line is highlighted.

'%4'
     '%4' is replaced by the ending highlighting sequence respectively
     the ending marking character that is used for highlighting a
     holiday.  This attains, that a possibly active highlighting
     according to a holiday is turned off respectively an ending marking
     character is produced.  '%4' is used together with the '%3' special
     text.  The '%4' text has no affect if no preceding '%3' text was
     found on the line.

'%5'
     '%5' is replaced by the starting highlighting sequence respectively
     the starting marking character that is used for highlighting the
     actual day if a fixed date is on today's date, (*note Global option
     '--highlighting=TEXT': x-highlighting.).  This attains, that all
     succeeding text of the line after this special text is displayed in
     the same way as the highlighted respectively marked actual day.
     '%5' is used together with the '%6' special text, which turns off
     this enabled highlighting sequence respectively produces the ending
     marking character.  If a '%5' text is not succeeded by a '%6' text
     on the line, Gcal automatically inserts such a '%6' text at the end
     of the line.

'%6'
     '%6' is replaced by the ending highlighting sequence respectively
     the ending marking character that is used for highlighting the
     actual day if a fixed date is on today's date.  This attains, that
     a possibly active highlighting according to the actual day is
     turned off respectively an ending marking character is produced.
     '%6' is used together with the '%5' special text.  The '%6' text
     has no affect if no preceding '%5' text was found on the line.

'%7'
     '%7' is replaced by the starting highlighting sequence respectively
     the starting marking character that is used for highlighting a
     holiday if a fixed date is on a legal holiday date, (*note Global
     option '--highlighting=TEXT': x-highlighting.).  This attains, that
     all succeeding text of the line after this special text is
     displayed in the same way as the highlighted respectively marked
     holiday.  '%7' is used together with the '%8' special text, which
     turns off this enabled highlighting sequence respectively produces
     the ending marking character.  If a '%7' text is not succeeded by a
     '%8' text on the line, Gcal automatically inserts such a '%8' text
     at the end of the line.

'%8'
     '%8' is replaced by the ending highlighting sequence respectively
     the ending marking character that is used for highlighting a
     holiday if a fixed date is on a legal holiday date.  This attains,
     that a possibly active highlighting according to a holiday is
     turned off respectively an ending marking character is produced.
     '%8' is used together with the '%7' special text.  The '%8' text
     has no affect if no preceding '%7' text was found on the line.

'%9'
     '%9' is replaced by the starting highlighting sequence respectively
     the starting marking character that is used for highlighting the
     actual day if a fixed date is on today's date; otherwise '%9' is
     replaced by the starting highlighting sequence respectively the
     starting marking character that is used for highlighting a holiday
     if a fixed date is on a legal holiday date, (*note Global option
     '--highlighting=TEXT': x-highlighting.).  This attains, that all
     succeeding text of the line after this special text is displayed in
     the same way as the highlighted respectively marked actual day or
     holiday.  '%9' is used together with the '%0' special text, which
     turns off this enabled highlighting sequence respectively produces
     the ending marking character.  If a '%9' text is not succeeded by a
     '%0' text on the line, Gcal automatically inserts such a '%0' text
     at the end of the line.

'%0'
     '%0' is replaced by the ending highlighting sequence respectively
     the ending marking character that is used for highlighting the
     actual day if a fixed date is on today's date; otherwise '%0' is
     replaced by the ending highlighting sequence respectively the
     ending marking character that is used for highlighting a holiday if
     a fixed date is on a legal holiday date.  This attains, that a
     possibly active highlighting according to today's date or a holiday
     is turned off respectively an ending marking character is produced.
     '%0' is used together with the '%9' special text.  The '%0' text
     has no affect if no preceding '%9' text was found on the line.


File: gcal.info,  Node: Shell Command,  Prev: Replacements,  Up: Special Texts

G.3 Shell command '%![ARGUMENT]' special text
=============================================

The ARGUMENT which trails '%!' until the end of the line, is passed to
the shell as a command for further processing.  But before, all text
variable references and '%?'... special texts for replacing particular
texts which are given in ARGUMENT are interpreted by Gcal.  *Note Text
variables::, and *note '%?'... special texts for text replacement:
Replacements..  All leading text before the '%!' special text is
processed by Gcal as usual.  If the simple '--debug' respectively
'--debug=internal' option is given at program start-up, informational
messages about the executed command and its _exit code_ will be shown on
the _standard error channel_ (*note Global option '--debug=internal':
x-debug-internal.).

  If the '--debug=abort' option is given, the Gcal program will be
aborted with an error code in case an _exit code_ not equal zero has
occurred during the execution of the command.  *Note Error Code 2:
x-2-Error-code, and *note Global option '--debug=abort': x-debug-abort,
for further information.

  Use the '--execute-command' option if you want to execute all
'%![ARGUMENT]' special texts by the shell instead of seeing them
textually only.  *Note Fixed date option '--execute-command':
x-execute-command, for more details.


File: gcal.info,  Node: Special Texts Summary,  Next: Obsolete Special Texts,  Prev: Special Texts,  Up: Top

Appendix H Summary of all '%?'... Special Texts
***********************************************

Here is a short-list of all '%?'... special texts which can be used in
the text part of Gcal resource file line.  Of course, not all
possibilities concerning the representation --which are offered by the
format instruction-- are listed here for those special texts which
expanded representation may be modified by an optional FORMAT, but only
some few exemplary.  *Note Format Instruction::, for further details.

'%i[DATE][#[DATE]]'
     Exclusion of all non-inclusive date periods

'%e[DATE][#[DATE]]'
     Exclusion of all exclusive date periods

'%?' Inclusive day period

     '%v'
          Exclusion of all non-legal holidays

     '%x'
          Exclusion of all non-holidays

     '%a'
          Exclusion of all non-Mondays

     '%c'
          Exclusion of all non-Tuesdays

     '%f'
          Exclusion of all non-Wednesdays

     '%g'
          Exclusion of all non-Thursdays

     '%h'
          Exclusion of all non-Fridays

     '%l'
          Exclusion of all non-Saturdays

     '%p'
          Exclusion of all non-Sundays

     '%q'
          Exclusion of all non-Mondays...Thursdays

     '%r'
          Exclusion of all non-Mondays...Fridays

'%?' Exclusive day period

     '%V'
          Exclusion of all legal holidays

     '%X'
          Exclusion of all holidays

     '%A'
          Exclusion of all Mondays

     '%C'
          Exclusion of all Tuesdays

     '%F'
          Exclusion of all Wednesdays

     '%G'
          Exclusion of all Thursdays

     '%H'
          Exclusion of all Fridays

     '%L'
          Exclusion of all Saturdays

     '%P'
          Exclusion of all Sundays

     '%Q'
          Exclusion of all Mondays...Thursdays

     '%R'
          Exclusion of all Mondays...Fridays

'%[FORMAT]K[DATE]' weekday name

     '%K[DATE]'
          Complete weekday name

     '%>3#K[DATE]'
          3-Letter weekday name

     '%>2#K[DATE]'
          2-Letter weekday name

'%[FORMAT]?[DATE]' weekday number

     '%W[DATE]'
          Weekday number, Mon==1...Sun==7

     '%>1&*W[DATE]'
          Weekday number, Mon==1...Sun==7, Ordinal Number suffix

     '%E[DATE]'
          Weekday number, Mon==0...Sun==6

     '%>1&*E[DATE]'
          Weekday number, Mon==0...Sun==6, Ordinal Number suffix

     '%I[DATE]'
          Weekday number, Sun==1...Sat==7

     '%>1&*I[DATE]'
          Weekday number, Sun==1...Sat==7, Ordinal Number suffix

     '%J[DATE]'
          Weekday number, Sun==0...Sat==6

     '%>1&*J[DATE]'
          Weekday number, Sun==0...Sat==6, Ordinal Number suffix

     '%S[DATE]'
          Weekday number, STARTING DAY OF WEEK==1

     '%>1&*S[DATE]'
          Weekday number, STARTING DAY OF WEEK==1, Ordinal Number suffix

     '%T[DATE]'
          Weekday number, STARTING DAY OF WEEK==0

     '%>1&*T[DATE]'
          Weekday number, STARTING DAY OF WEEK==0, Ordinal Number suffix

'%[FORMAT]N[DATE]' day number

     '%N[DATE]'
          Day-of-year number

     '%>03*N[DATE]'
          Day-of-year number, 3-digits with leading zeroes

     '%>1&*N[DATE]'
          Day-of-year number, Ordinal Number suffix

     '%>03&*N[DATE]'
          Day-of-year number, 3-digits with leading zeroes, Ordinal
          Number suffix

'%[FORMAT]D[DATE]' day number

     '%D[DATE]'
          Day number

     '%>02*D[DATE]'
          Day number, 2-digits with leading zero

     '%>1&*D[DATE]'
          Day number, Ordinal Number suffix

     '%>02&*D[DATE]'
          Day number, 2-digits with leading zero, Ordinal Number suffix

'%k[DATE]'
     ISO week number or standard week number, either 2-digits with
     leading zero, or 4-alphanumeric characters text

'%[FORMAT]U[DATE]' month name

     '%U[DATE]'
          Complete month name

     '%>3#U[DATE]'
          3-Letter month name

'%[FORMAT]M[DATE]' month

     '%M[DATE]'
          Month number

     '%>02*M[DATE]'
          Month number, 2-digits with leading zero

     '%>1&*M[DATE]'
          Month number, Ordinal Number suffix

     '%>02&*M[DATE]'
          Month number, 2-digits with leading zero, Ordinal Number
          suffix

'%[FORMAT]Y[DATE]' year number

     '%Y[DATE]'
          Year number

     '%>04*Y[DATE]'
          Complete year number, 4-digits with leading zeroes

'%[FORMAT]?[DATE]' Moon phase

     '%O[DATE]'
          Moon phase text

     '%>03*O[DATE]'
          Moon phase text, 3-digits with leading zeroes

     '%Z[DATE]'
          Moon phase text graphics

'%?[DATE]' biorhythm

     '%,[DATE]'
          Biorhythm text (series of values)

     '%;[DATE]'
          Biorhythm text graphics (bar)

'%[FORMAT]?[DATE]' difference value

     '%yDATE'
          Relative year number

     '%b[DATE]'
          Age value (birthday)

     '%B[DATE]'
          Age value (birthday), Ordinal Number suffix

'%[FORMAT]?[ARGUMENT]' actual clocktime

     '%t[*][[+|-]MMMM|HH:[MM]]'
          Actual local time in 'HH:MM' format

     '%[FORMAT]'[[+|-]MMMM|HH:[MM]]'
          Actual local time in M[M...] format

     '%[FORMAT]_[*][[+|-]MMMM|HH:[MM]]'
          Actual local time hour in H[H...] format

     '%[FORMAT]?[[+|-]MMMM|HH:[MM]]'
          Actual local time minute in M[M...] format

     '%[FORMAT]{[[+|-]MMMM|HH:[MM]]'
          Actual local time 12-hour format suffix

     '%@[*][[+|-]MMMM|HH:[MM]]'
          Actual Universal time in 'HH:MM/DATE' format

     '%[FORMAT]`[[+|-]MMMM|HH:[MM]]'
          Actual Universal time in 'M[M...]/DATE' format

     '%[FORMAT].[*][[+|-]MMMM|HH:[MM]]'
          Actual Universal time hour in H[H...] format

     '%[FORMAT]/[[+|-]MMMM|HH:[MM]]'
          Actual Universal time minute in M[M...] format

     '%[FORMAT]}[[+|-]MMMM|HH:[MM]]'
          Actual Universal time 12-hour format suffix

     '%"[[+|-]MMMM|HH:[MM]]'
          Numerical Universal time timezone offset value

     '%=[[+|-]MMMM|HH:[MM]]'
          Actual numerical local time timezone offset value

'%n[[+|-]N]'
     Textual date in fixed '%>02*D-%>3#U-%>04*Y' format

'%[FORMAT]j[[+|-]N]'
     Julian day number

'%[FORMAT]b[*][MODE]ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2' geographical distance and course angle

     '%b0ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
          Geographical distance (air line distance) in kilometers

     '%b*0ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
          Geographical distance (air line distance) in statute miles

     '%b1ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-COORDINATE-2'
          Course angle (true track) between ISO-6709:1983-CO-ORDINATE-1
          and ISO-6709:1983-CO-ORDINATE-2 in degrees and arcminutes

     '%b*1ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
          Course angle (true track) between ISO-6709:1983-CO-ORDINATE-1
          and ISO-6709:1983-CO-ORDINATE-2 in decimal degrees

     '%b2ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
          Course angle (true track) between ISO-6709:1983-CO-ORDINATE-2
          and ISO-6709:1983-CO-ORDINATE-1 in degrees and arcminutes

     '%b*2ISO-6709:1983-CO-ORDINATE-1/ISO-6709:1983-CO-ORDINATE-2'
          Course angle (true track) between ISO-6709:1983-CO-ORDINATE-2
          and ISO-6709:1983-CO-ORDINATE-1 in decimal degrees

'%[FORMAT]?[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]' Sun data

     '%o0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Sun's astronomical midnight time in 'HH:MM' _24-hours_ format

     '%o*0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Sun's astronomical midnight time in 'HH:MM' _12-hours_ format
          with time suffix

     '%o1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Sun's astronomical noon time in 'HH:MM' _24-hours_ format

     '%o*1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Sun's astronomical noon time in 'HH:MM' _12-hours_ format with
          time suffix

     '%o2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Sun's center in 'HH:MM' _24-hours_
          format

     '%o*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Sun's center in 'HH:MM' _12-hours_
          format with time suffix

     '%s2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Sun's center in 'HH:MM' _24-hours_
          format

     '%o*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Sun's center in 'HH:MM' _12-hours_
          format with time suffix

     '%u2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Sun's center above reference
          altitude, in hours and minutes in 'HHhMM'' format

     '%u*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Sun's center above reference
          altitude, in decimal hours in 'HH.H...' format

     '%z2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Sun's center below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%z*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Sun's center below
          reference altitude, in decimal hours in 'HH.H...' format

     '%o3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Sun's upper limb in 'HH:MM'
          _24-hours_ format

     '%o*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Sun's upper limb in 'HH:MM'
          _12-hours_ format with time suffix

     '%s3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Sun's upper limb in 'HH:MM' _24-hours_
          format

     '%s*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Sun's upper limb in 'HH:MM' _12-hours_
          format with time suffix

     '%u3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Sun's upper limb above
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%u*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Sun's upper limb above
          reference altitude, in decimal hours in 'HH.H...' format

     '%z3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Sun's upper limb below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%z*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Sun's upper limb below
          reference altitude, in decimal hours in 'HH.H...' format

     '%o4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Rise time of Sun's center in 'HH:MM' _24-hours_ format

     '%o*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Rise time of Sun's center in 'HH:MM' _12-hours_ format with
          time suffix

     '%s4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Set time of Sun's center in 'HH:MM' _24-hours_ format

     '%s*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Set time of Sun's center in 'HH:MM' _12-hours_ format with
          time suffix

     '%u4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of visibility, Sun's center above reference altitude,
          in hours and minutes in 'HHhMM'' format

     '%u*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of visibility, Sun's center above reference altitude,
          in decimal hours in 'HH.H...' format

     '%z4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of non-visibility, Sun's center below reference
          altitude, in hours and minutes in 'HHhMM'' format

     '%z*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of non-visibility, Sun's center below reference
          altitude, in decimal hours in 'HH.H...' format

     '%o5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard rise time of Sun's upper limb in 'HH:MM' _24-hours_
          format

     '%o*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard rise time of Sun's upper limb in 'HH:MM' _12-hours_
          format with time suffix

     '%s5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard set time of Sun's upper limb in 'HH:MM' _24-hours_
          format

     '%s*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard set time of Sun's upper limb in 'HH:MM' _12-hours_
          format with time suffix

     '%u5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard visibility, Sun's upper limb above
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%u*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard visibility, Sun's upper limb above
          reference altitude, in decimal hours in 'HH.H...' format

     '%z5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard non-visibility, Sun's upper limb below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%z*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard non-visibility, Sun's upper limb below
          reference altitude, in decimal hours in 'HH.H...' format

     '%o6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of civil twilight in the morning in 'HH:MM'
          _24-hours_ format

     '%o*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of civil twilight in the morning in 'HH:MM'
          _12-hours_ format with time suffix

     '%s6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of civil twilight in the evening in 'HH:MM'
          _24-hours_ format

     '%s*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of civil twilight in the evening in 'HH:MM'
          _12-hours_ format with time suffix

     '%u6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of civil
          twilight in hours and minutes in 'HHhMM'' format

     '%u*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of civil
          twilight in decimal hours in 'HH.H...' format

     '%z6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of civil
          twilight in hours and minutes in 'HHhMM'' format

     '%z*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of civil
          twilight in decimal hours in 'HH.H...' format

     '%o7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of nautical twilight in the morning in 'HH:MM'
          _24-hours_ format

     '%o*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of nautical twilight in the morning in 'HH:MM'
          _12-hours_ format with time suffix

     '%s7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of nautical twilight in the evening in 'HH:MM'
          _24-hours_ format

     '%s*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of nautical twilight in the evening in 'HH:MM'
          _12-hours_ format with time suffix

     '%u7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of nautical
          twilight in hours and minutes in 'HHhMM'' format

     '%u*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of nautical
          twilight in decimal hours in 'HH.H...' format

     '%z7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of nautical
          twilight in hours and minutes in 'HHhMM'' format

     '%z*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of nautical
          twilight in decimal hours in 'HH.H...' format

     '%o8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of amateur-astronomical twilight in the morning in
          'HH:MM' _24-hours_ format

     '%o*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of amateur-astronomical twilight in the morning in
          'HH:MM' _12-hours_ format with time suffix

     '%s8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of amateur-astronomical twilight in the evening in
          'HH:MM' _24-hours_ format

     '%s*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of amateur-astronomical twilight in the evening in
          'HH:MM' _12-hours_ format with time suffix

     '%u8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of
          amateur-astronomical twilight in hours and minutes in 'HHhMM''
          format

     '%u*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of
          amateur-astronomical twilight in decimal hours in 'HH.H...'
          format

     '%z8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of
          amateur-astronomical twilight in hours and minutes in 'HHhMM''
          format

     '%z*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of
          amateur-astronomical twilight in decimal hours in 'HH.H...'
          format

     '%o9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of astronomical twilight in the morning in 'HH:MM'
          _24-hours_ format

     '%o*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Begin time of astronomical twilight in the morning in 'HH:MM'
          _12-hours_ format with time suffix

     '%s9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of astronomical twilight in the evening in 'HH:MM'
          _24-hours_ format

     '%s*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          End time of astronomical twilight in the evening in 'HH:MM'
          _12-hours_ format with time suffix

     '%u9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of
          astronomical twilight in hours and minutes in 'HHhMM'' format

     '%u*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center above reference altitude of
          astronomical twilight in decimal hours in 'HH.H...' format

     '%z9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of
          astronomical twilight in hours and minutes in 'HHhMM'' format

     '%z*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of Sun's center below reference altitude of
          astronomical twilight in decimal hours in 'HH.H...' format

     '%oaISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%saISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%o*aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun in decimal degrees in
          '+|-DDD.D...' format

     '%obISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sbISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun in degrees and arcminutes in
          'DDDdMM'' format

     '%o*bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun in decimal degrees in 'DDD.D...'
          format

     '%ocISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%scISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric declination of Sun in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%o*cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric declination of Sun in decimal degrees in
          '+|-DDD.D...' format

     '%odISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sdISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic longitude of Sun in degrees and
          arcminutes in 'DDDdMM'' format

     '%o*dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic longitude of Sun in decimal degrees in
          'DDD.D...' format

     '%oeISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%seISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric right ascension of Sun as time value in hours and
          minutes in 'HHhMM'' format

     '%o*eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric right ascension of Sun as time value in decimal
          hours in 'HH.H...' format

     '%ofISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sfISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric distance of Sun in astronomical units in 'N.N...'
          format

     '%o*fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric distance of Sun in kilometers in 'N.N...' format

     '%ogISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sgISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric horizontal parallax of Sun in degrees and
          arcminutes in 'DDDdMM'' format

     '%o*gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric horizontal parallax of Sun in decimal degrees in
          'DDD.D...' format

     '%ohISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%shISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric semidiameter of Sun in degrees and arcminutes in
          'DDDdMM'' format

     '%o*hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric semidiameter of Sun in decimal degrees in
          'DDD.D...' format

     '%oiISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%siISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Atmospheric refraction in degrees and arcminutes in 'DDDdMM''
          format

     '%o*iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Atmospheric refraction in decimal degrees in 'DDD.D...' format

     '%ojISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sjISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%o*jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun in decimal degrees in
          '+|-DDD.D...' format

     '%okISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%skISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun in degrees and arcminutes in
          'DDDdMM'' format

     '%o*kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun in decimal degrees in 'DDD.D...'
          format

     '%olISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%slISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric declination of Sun in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%o*lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric declination of Sun in decimal degrees in
          '+|-DDD.D...' format

     '%omISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%smISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic longitude of Sun in degrees and arcminutes
          in 'DDDdMM'' format

     '%o*mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic longitude of Sun in decimal degrees in
          'DDD.D...' format

     '%onISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%snISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric right ascension of Sun as time value in hours and
          minutes in 'HHhMM'' format

     '%o*nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric right ascension of Sun as time value in decimal
          hours in 'HH.H...' format

     '%ooISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%soISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric distance of Sun in astronomical units in 'N.N...'
          format

     '%o*oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric distance of Sun in kilometers in 'N.N...' format

     '%opISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%spISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric horizontal parallax of Sun in degrees and
          arcminutes in 'DDDdMM'' format

     '%o*pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric horizontal parallax of Sun in decimal degrees in
          'DDD.D...' format

     '%oqISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sqISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric semidiameter of Sun in degrees and arcminutes in
          'DDDdMM'' format

     '%o*qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric semidiameter of Sun in decimal degrees in
          'DDD.D...' format

     '%orISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%srISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%o*rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta-t in seconds in '+|-N.N...' format

     '%osISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%ssISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Local sidereal time in 'HH:MM' _24-hours_ format

     '%o*sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Local sidereal time in 'HH:MM' _12-hours_ format with time
          suffix

     '%otISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%stISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Base time as time value in hours and minutes in 'HHhMM''
          format

     '%o*tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Base time as time value in decimal hours in 'HH.H...' format

     '%ouISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%suISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%o*uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Julian date in days in 'N.N...' format

     '%ovISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%svISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%o*vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Julian Ephemeris date in days in 'N.N...' format

     '%owISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%swISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Equation of time as time value in hours and minutes in
          '+|-HHhMM'' format

     '%o*wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Equation of time as time value in decimal hours in
          '+|-HH.H...' format

     '%oxISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sxISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%o*xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon in decimal degrees in
          '+|-DDD.D...' format

     '%oyISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%syISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%o*yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon in decimal degrees in
          '+|-DDD.D...' format

     '%ozISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%szISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%o*zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon in decimal degrees in
          '+|-DDD.D...' format

     '%oAISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sAISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon in degrees and arcminutes
          in '+|-DDDdMM'' format

     '%o*AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon in decimal degrees in
          '+|-DDD.D...' format

     '%oBISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon at standard sunrise
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon at standard sunrise
          time in decimal degrees in '+|-DDD.D...' format

     '%sBISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon at standard sunset
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%s*BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Sun/Moon at standard sunset
          time in decimal degrees in '+|-DDD.D...' format

     '%oCISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon at standard sunrise time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon at standard sunrise time
          in decimal degrees in '+|-DDD.D...' format

     '%sCISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon at standard sunset time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%s*CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Sun/Moon at standard sunset time
          in decimal degrees in '+|-DDD.D...' format

     '%oDISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon at standard sunrise
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon at standard sunrise
          time in decimal degrees in '+|-DDD.D...' format

     '%sDISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon at standard sunset time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%s*DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Sun/Moon at standard sunset time
          in decimal degrees in '+|-DDD.D...' format

     '%oEISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon at standard sunrise time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon at standard sunrise time
          in decimal degrees in '+|-DDD.D...' format

     '%sEISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon at standard sunset time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%s*EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Sun/Moon at standard sunset time
          in decimal degrees in '+|-DDD.D...' format

     '%oFISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sFISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical midnight time of Sun/Moon as time value in
          hours and minutes in '+|-HHhMM'' format

     '%o*FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical midnight time of Sun/Moon as time value in
          decimal hours in '+|-HH.H...' format

     '%oGISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sGISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical noon of Sun/Moon as time value in hours and
          minutes in '+|-HHhMM'' format

     '%o*GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical noon of Sun/Moon as time value in decimal
          hours in '+|-HH.H...' format

     '%oHISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time of standard rise of Sun/Moon at standard sunrise
          time as time value in hours and minutes in '+|-HHhMM'' format

     '%o*HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time of standard rise of Sun/Moon at standard sunrise
          time as time value in decimal hours in '+|-HH.H...' format

     '%sHISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time of standard set of Sun/Moon at standard sunset time
          as time value in hours and minutes in '+|-HHhMM'' format

     '%s*HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time of standard set of Sun/Moon at standard sunset time
          as time value in decimal hours in '+|-HH.H...' format

     '%oIISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sIISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at Sun's astronomical midnight
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at Sun's astronomical midnight
          time in decimal degrees in '+|-DDD.D...' format

     '%oJISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sJISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at Sun's astronomical noon time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at Sun's astronomical noon time
          in decimal degrees in '+|-DDD.D...' format

     '%oKISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at standard sunrise time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%o*KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at standard sunrise time in
          decimal degrees in '+|-DDD.D...' format

     '%sKISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at standard sunset time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%s*KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Sun at standard sunset time in
          decimal degrees in '+|-DDD.D...' format

     '%oLISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun at standard sunrise time in degrees
          and arcminutes in 'DDDdMM'' format

     '%o*LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun at standard sunrise time in decimal
          degrees in 'DDD.D...' format

     '%sLISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun at standard sunset time in degrees
          and arcminutes in 'DDDdMM'' format

     '%s*LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Sun at standard sunset time in decimal
          degrees in 'DDD.D...' format

     '%oMISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sMISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at Sun's astronomical midnight
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%o*MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at Sun's astronomical midnight
          time in decimal degrees in '+|-DDD.D...' format

     '%oNISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%sNISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at Sun's astronomical noon time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%o*NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%s*NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at Sun's astronomical noon time in
          decimal degrees in '+|-DDD.D...' format

     '%oOISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at standard sunrise time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%o*OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at standard sunrise time in
          decimal degrees in '+|-DDD.D...' format

     '%sOISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at standard sunset time in degrees
          and arcminutes in '+|-DDDdMM'' format

     '%s*OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Sun at standard sunset time in decimal
          degrees in '+|-DDD.D...' format

     '%oPISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun at standard sunrise time in degrees
          and arcminutes in 'DDDdMM'' format

     '%o*PISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun at standard sunrise time in decimal
          degrees in 'DDD.D...' format

     '%sPISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun at standard sunset time in degrees
          and arcminutes in 'DDDdMM'' format

     '%s*PISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Sun at standard sunset time in decimal
          degrees in 'DDD.D...' format

     '%oQISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Single shadow length time in the forenoon in 'HH:MM'
          _24-hours_ format

     '%o*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Single shadow length time in the forenoon in 'HH:MM'
          _12-hours_ format with time suffix

     '%sQISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Single shadow length time in the afternoon in 'HH:MM'
          _24-hours_ format

     '%s*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Single shadow length time in the afternoon in 'HH:MM'
          _12-hours_ format with time suffix

     '%uQISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of single or shorter shadow length in hours and minutes
          in 'HHhMM'' format

     '%u*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of single or shorter shadow length in decimal hours in
          'HH.H...' format

     '%zQISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of longer than single shadow length in hours and
          minutes in 'HHhMM'' format

     '%z*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of longer than single shadow length in decimal hours in
          'HH.H...' format

     '%oRISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Double shadow length time in the forenoon in 'HH:MM'
          _24-hours_ format

     '%o*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Double shadow length time in the forenoon in 'HH:MM'
          _12-hours_ format with time suffix

     '%sRISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Double shadow length time in the afternoon in 'HH:MM'
          _24-hours_ format

     '%s*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Double shadow length time in the afternoon in 'HH:MM'
          _12-hours_ format with time suffix

     '%uRISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of double or shorter shadow length in hours and minutes
          in 'HHhMM'' format

     '%u*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of double or shorter shadow length in decimal hours in
          'HH.H...' format

     '%zRISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of longer than double shadow length in hours and
          minutes in 'HHhMM'' format

     '%z*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of longer than double shadow length in decimal hours in
          'HH.H...' format

'%[FORMAT]?[*][MODE]ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]' Moon data

     '%(0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Moon's astronomical midnight time in 'HH:MM' _24-hours_ format

     '%(*0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*0ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Moon's astronomical midnight time in 'HH:MM' _12-hours_ format
          with time suffix

     '%(1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Moon's astronomical noon time in 'HH:MM' _24-hours_ format

     '%(*1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*1ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Moon's astronomical noon time in 'HH:MM' _12-hours_ format
          with time suffix

     '%(2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Moon's center in 'HH:MM' _24-hours_
          format

     '%(*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Moon's center in 'HH:MM' _12-hours_
          format with time suffix

     '%)2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Moon's center in 'HH:MM' _24-hours_
          format

     '%(*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Moon's center in 'HH:MM' _12-hours_
          format with time suffix

     '%[2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Moon's center above
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%[*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Moon's center above
          reference altitude, in decimal hours in 'HH.H...' format

     '%]2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Moon's center below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%]*2ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Moon's center below
          reference altitude, in decimal hours in 'HH.H...' format

     '%(3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Moon's upper limb in 'HH:MM'
          _24-hours_ format

     '%(*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical rise time of Moon's upper limb in 'HH:MM'
          _12-hours_ format with time suffix

     '%)3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Moon's upper limb in 'HH:MM'
          _24-hours_ format

     '%)*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geometrical set time of Moon's upper limb in 'HH:MM'
          _12-hours_ format with time suffix

     '%[3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Moon's upper limb above
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%[*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical visibility, Moon's upper limb above
          reference altitude, in decimal hours in 'HH.H...' format

     '%]3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Moon's upper limb below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%]*3ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of geometrical non-visibility, Moon's upper limb below
          reference altitude, in decimal hours in 'HH.H...' format

     '%(4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Rise time of Moon's center in 'HH:MM' _24-hours_ format

     '%(*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Rise time of Moon's center in 'HH:MM' _12-hours_ format with
          time suffix

     '%)4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Set time of Moon's center in 'HH:MM' _24-hours_ format

     '%)*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Set time of Moon's center in 'HH:MM' _12-hours_ format with
          time suffix

     '%[4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of visibility, Moon's center above reference altitude,
          in hours and minutes in 'HHhMM'' format

     '%[*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of visibility, Moon's center above reference altitude,
          in decimal hours in 'HH.H...' format

     '%]4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of non-visibility, Moon's center below reference
          altitude, in hours and minutes in 'HHhMM'' format

     '%]*4ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of non-visibility, Moon's center below reference
          altitude, in decimal hours in 'HH.H...' format

     '%(5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard rise time of Moon's upper limb in 'HH:MM' _24-hours_
          format

     '%(*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard rise time of Moon's upper limb in 'HH:MM' _12-hours_
          format with time suffix

     '%)5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard set time of Moon's upper limb in 'HH:MM' _24-hours_
          format

     '%)*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Standard set time of Moon's upper limb in 'HH:MM' _12-hours_
          format with time suffix

     '%[5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard visibility, Moon's upper limb above
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%[*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard visibility, Moon's upper limb above
          reference altitude, in decimal hours in 'HH.H...' format

     '%]5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard non-visibility, Moon's upper limb below
          reference altitude, in hours and minutes in 'HHhMM'' format

     '%]*5ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Period of standard non-visibility, Moon's upper limb below
          reference altitude, in decimal hours in 'HH.H...' format

     '%(6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric horizontal parallax of Moon in degrees and
          arcminutes in 'DDDdMM'' format

     '%(*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*6ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric horizontal parallax of Moon in decimal degrees in
          'DDD.D...' format

     '%(7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric semidiameter of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*7ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric semidiameter of Moon in decimal degrees in
          'DDD.D...' format

     '%(8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%(*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*8ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric brightness of Moon in magnitude units in
          '+|-N.N...' format

     '%(9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon in range 0.0...1.0 in 'N.N...'
          format

     '%(*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*9ISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon as percent value in range
          0.0...100.0 in 'N.N...' format

     '%(aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%(*aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*aISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*bISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon in decimal degrees in 'DDD.D...'
          format

     '%(cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric declination of Moon in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%(*cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*cISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric declination of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic longitude of Moon in degrees and
          arcminutes in 'DDDdMM'' format

     '%(*dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*dISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic longitude of Moon in decimal degrees in
          'DDD.D...' format

     '%(eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic latitude of Moon in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%(*eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*eISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric ecliptic latitude of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric right ascension of Moon as time value in hours and
          minutes in 'HHhMM'' format

     '%(*fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*fISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric right ascension of Moon as time value in decimal
          hours in 'HH.H...' format

     '%(gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric distance of Moon in mean Earth equator radii in
          'N.N...' format

     '%(*gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*gISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric distance of Moon in kilometers in 'N.N...' format

     '%(hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elongation of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*hISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elongation of Moon in decimal degrees in
          'DDD.D...' format

     '%(iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Atmospheric refraction in degrees and arcminutes in 'DDDdMM''
          format

     '%(*iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*iISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Atmospheric refraction in decimal degrees in 'DDD.D...' format

     '%(jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric horizontal parallax of Moon in degrees and
          arcminutes in 'DDDdMM'' format

     '%(*jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*jISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric horizontal parallax of Moon in decimal degrees in
          'DDD.D...' format

     '%(kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric semidiameter of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*kISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric semidiameter of Moon in decimal degrees in
          'DDD.D...' format

     '%(lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%(*lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*lISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric brightness of Moon in magnitude units in
          '+|-N.N...' format

     '%(mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon in range 0.0...1.0 in 'N.N...'
          format

     '%(*mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*mISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon as percent value in range
          0.0...100.0 in 'N.N...' format

     '%(nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%(*nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*nISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*oISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon in decimal degrees in 'DDD.D...'
          format

     '%(pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric declination of Moon in degrees and arcminutes in
          '+|-DDDdMM'' format

     '%(*pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*pISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric declination of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic longitude of Moon in degrees and
          arcminutes in 'DDDdMM'' format

     '%(*qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*qISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic longitude of Moon in decimal degrees in
          'DDD.D...' format

     '%(rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic latitude of Moon in degrees and arcminutes
          in '+|-DDDdMM'' format

     '%(*rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*rISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric ecliptic latitude of Moon in decimal degrees in
          '+|-DDD.D...' format

     '%(sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric right ascension of Moon as time value in hours and
          minutes in 'HHhMM'' format

     '%(*sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*sISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric right ascension of Moon as time value in decimal
          hours in 'HH.H...' format

     '%(tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric distance of Moon in mean Earth equator radii in
          'N.N...' format

     '%(*tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*tISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric distance of Moon in kilometers in 'N.N...' format

     '%(uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elongation of Moon in degrees and arcminutes in
          'DDDdMM'' format

     '%(*uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*uISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elongation of Moon in decimal degrees in 'DDD.D...'
          format

     '%(vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%(*vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*vISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta-t in seconds in '+|-N.N...' format

     '%(wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Local sidereal time in 'HH:MM' _24-hours_ format

     '%(*wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*wISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Local sidereal time in 'HH:MM' _12-hours_ format with time
          suffix

     '%(xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Base time as time value in hours and minutes in 'HHhMM''
          format

     '%(*xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*xISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Base time as time value in decimal hours in 'HH.H...' format

     '%(yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%(*yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*yISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Julian date in days in 'N.N...' format

     '%(zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%(*zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*zISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Julian Ephemeris date in days in 'N.N...' format

     '%(AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%(*AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*AISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun in decimal degrees in
          '+|-DDD.D...' format

     '%(BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%(*BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*BISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun in decimal degrees in
          '+|-DDD.D...' format

     '%(CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun in degrees and
          arcminutes in '+|-DDDdMM'' format

     '%(*CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*CISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun in decimal degrees in
          '+|-DDD.D...' format

     '%(DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun in degrees and arcminutes
          in '+|-DDDdMM'' format

     '%(*DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*DISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun in decimal degrees in
          '+|-DDD.D...' format

     '%(EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun at standard moonrise
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun at standard moonrise
          time in decimal degrees in '+|-DDD.D...' format

     '%)EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun at standard moonset
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%)*EISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric elevation of Moon/Sun at standard moonset
          time in decimal degrees in '+|-DDD.D...' format

     '%(FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun at standard moonrise
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun at standard moonrise
          time in decimal degrees in '+|-DDD.D...' format

     '%)FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun at standard moonset time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%)*FISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta topocentric azimuth of Moon/Sun at standard moonset time
          in decimal degrees in '+|-DDD.D...' format

     '%(GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun at standard moonrise
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun at standard moonrise
          time in decimal degrees in '+|-DDD.D...' format

     '%)GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun at standard moonset
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%)*GISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric elevation of Moon/Sun at standard moonset
          time in decimal degrees in '+|-DDD.D...' format

     '%(HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun at standard moonrise time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun at standard moonrise time
          in decimal degrees in '+|-DDD.D...' format

     '%)HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun at standard moonset time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%)*HISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta geocentric azimuth of Moon/Sun at standard moonset time
          in decimal degrees in '+|-DDD.D...' format

     '%(IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical midnight time of Moon/Sun as time value in
          hours and minutes in '+|-HHhMM'' format

     '%(*IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*IISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical midnight time of Moon/Sun as time value in
          decimal hours in '+|-HH.H...' format

     '%(JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical noon time of Moon/Sun as time value in
          hours and minutes in '+|-HHhMM'' format

     '%(*JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*JISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta astronomical noon time of Moon/Sun as time value in
          decimal hours in '+|-HH.H...' format

     '%(KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time standard rise of Moon/Sun at standard moonrise time
          as time value in hours and minutes in '+|-HHhMM'' format

     '%(*KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time standard rise of Moon/Sun at standard moonrise time
          as time value in decimal hours in '+|-HH.H...' format

     '%)KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time standard set of of Moon/Sun at standard moonset
          time as time value in hours and minutes in '+|-HHhMM'' format

     '%)*KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Delta time standard set of of Moon/Sun at standard moonset
          time as time value in decimal hours in '+|-HH.H...' format

     '%(LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at Moon's astronomical midnight
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*LISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at Moon's astronomical midnight
          time in decimal degrees in '+|-DDD.D...' format

     '%(MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at Moon's astronomical
          midnight time in range 0.0...1.0 in 'N.N...' format

     '%(*MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*MISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at Moon's astronomical
          midnight time as percent value in range 0.0...100.0 in
          'N.N...' format

     '%(NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at Moon's astronomical noon time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*NISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at Moon's astronomical noon time
          in decimal degrees in '+|-DDD.D...' format

     '%(OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at Moon's astronomical noon
          time in range 0.0...1.0 in 'N.N...' format

     '%(*OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*OISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at Moon's astronomical noon
          time as percent value in range 0.0...100.0 in 'N.N...' format

     '%(KISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at standard moonrise time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%(*PISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at standard moonrise time in
          decimal degrees in '+|-DDD.D...' format

     '%)PISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at standard moonset time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%)*PISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric elevation of Moon at standard moonset time in
          decimal degrees in '+|-DDD.D...' format

     '%(QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon at standard moonrise time in
          degrees and arcminutes in 'DDDdMM'' format

     '%(*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon at standard moonrise time in
          decimal degrees in 'DDD.D...' format

     '%)QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon at standard moonset time in
          degrees and arcminutes in 'DDDdMM'' format

     '%)*QISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric azimuth of Moon at standard moonset time in
          decimal degrees in 'DDD.D...' format

     '%(RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at standard moonrise time in
          range 0.0...1.0 in 'N.N...' format

     '%(*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at standard moonrise time as
          percent value in range 0.0...100.0 in 'N.N...' format

     '%)RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at standard moonset time in
          range 0.0...1.0 in 'N.N...' format

     '%)*RISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Topocentric phase angle of Moon at standard moonset time as
          percent value in range 0.0...100.0 in 'N.N...' format

     '%(SISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)SISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at Moon's astronomical midnight
          time in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*SISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*SISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at Moon's astronomical midnight
          time in decimal degrees in '+|-DDD.D...' format

     '%(TISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)TISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at Moon's astronomical midnight
          time in range 0.0...1.0 in 'N.N...' format

     '%(*TISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*TISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at Moon's astronomical midnight
          time as percent value in range 0.0...100.0 in 'N.N...' format

     '%(UISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)UISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at Moon's astronomical noon time
          in degrees and arcminutes in '+|-DDDdMM'' format

     '%(*UISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*UISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at Moon's astronomical noon time
          in decimal degrees in '+|-DDD.D...' format

     '%(VISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)VISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at Moon's astronomical noon
          time in range 0.0...1.0 in 'N.N...' format

     '%(*VISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
     '%)*VISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at Moon's astronomical noon
          time as percent value in range 0.0...100.0 in 'N.N...' format

     '%(WISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at standard moonrise time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%(*WISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at standard moonrise time in
          decimal degrees in '+|-DDD.D...' format

     '%)WISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at standard moonset time in
          degrees and arcminutes in '+|-DDDdMM'' format

     '%)*WISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric elevation of Moon at standard moonset time in
          decimal degrees in '+|-DDD.D...' format

     '%(XISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon at standard moonrise time in
          degrees and arcminutes in 'DDDdMM'' format

     '%(*XISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon at standard moonrise time in
          decimal degrees in 'DDD.D...' format

     '%)XISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon at standard moonset time in degrees
          and arcminutes in 'DDDdMM'' format

     '%)*XISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric azimuth of Moon at standard moonset time in decimal
          degrees in 'DDD.D...' format

     '%(YISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at standard moonrise time in
          range 0.0...1.0 in 'N.N...' format

     '%(*YISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at standard moonrise time as
          percent value in range 0.0...100.0 in 'N.N...' format

     '%)YISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at standard moonset time in
          range 0.0...1.0 in 'N.N...' format

     '%)*YISO-6709:1983-CO-ORDINATE[,[+|-]MMMM|HH:[MM]]'
          Geocentric phase angle of Moon at standard moonset time as
          percent value in range 0.0...100.0 in 'N.N...' format

'%[FORMAT]-[ARGUMENT]'
     Contents of environment variable

'%[FORMAT]?' difference value

     '%d'
          Relative day number

     '%w'
          Relative week number

     '%m'
          Relative month number

     '%y'
          Relative year number

'%?' highlighting

     '%1'
          Start of highlighting sequence 1

     '%2'
          End of highlighting sequence 1

     '%3'
          Start of highlighting sequence 2

     '%4'
          End of highlighting sequence 2

     '%5'
          Start of highlighting sequence 1 if a fixed date is on today's
          date

     '%6'
          End of highlighting sequence 1 if a fixed date is on today's
          date

     '%7'
          Start of highlighting sequence 2 if a fixed date is on a legal
          holiday date

     '%8'
          End of highlighting sequence 2 if a fixed date is on a legal
          holiday date

     '%9'
          Start of highlighting sequence 1 if a fixed date is on today's
          date, otherwise start of highlighting sequence 2 if a fixed
          date is on a legal holiday date

     '%0'
          End of highlighting sequence 1 if a fixed date is on today's
          date, otherwise end of highlighting sequence 2 if a fixed date
          is on a legal holiday date

'%![ARGUMENT]'
     Shell executes ARGUMENT as a command


File: gcal.info,  Node: Obsolete Special Texts,  Next: Format Instruction,  Prev: Special Texts Summary,  Up: Top

Appendix I Obsolete Special Texts and Format Elements
*****************************************************

* Menu:

* Table of Obsolete Special Texts::
* Table of Obsolete Date Format Elements::
* Table of Obsolete Date Formats::

Because Gcal 4.1 is able to represent most special texts which may occur
in the text part of a resource file line (*note Description of all
'%?'... Special Texts: Special Texts.), and most of the format elements
as they may be used in the date format text of the '--date-format' *Note
Calendar option '--date-format=de|us|gb|TEXT': x-date-format, by using a
format instruction, some of them --mainly introduced in the Gcal
versions 2.20 and 2.40-- are obsolete now.  The following complete
tables of all these obsolete special texts respectively format elements
with their new representation, as used by Gcal 4.1 now, show the changes
made.


File: gcal.info,  Node: Table of Obsolete Special Texts,  Next: Table of Obsolete Date Format Elements,  Prev: Obsolete Special Texts,  Up: Obsolete Special Texts

I.1 Table of Obsolete Special Texts
===================================

This table opposes all obsolete special texts as they may be used in the
text part of a resource file line (*note Description of all '%?'...
Special Texts: Special Texts.), and their new representation, as used by
Gcal 4.1 now:

*Symbolic name*                             *Old-style*       *New-style*
 
%complete weekday name                      '%o'          ==  '%K'
%3-letter weekday name                      '%O'          ==  '%>3#K'
%2-letter weekday name                      '%K'          ==  '%>2#K'
%weekday number (Mon=1...Sun=7)             '%S'          ==  '%W'
%weekday number (Mon=1...Sun=7) ONS         '%I'          ==  '%>1&*W'
%weekday number (Mon=0...Sun=6) ONS         '%J'          ==  '%>1&*E'
%weekday number (Sun=1...Sat=7)             '%('          ==  '%I'
%weekday number (Sun=1...Sat=7) ONS         '%<'          ==  '%>1&*I'
%weekday number (Sun=0...Sat=6)             '%)'          ==  '%J'
%weekday number (Sun=0...Sat=6) ONS         '%>'          ==  '%>1&*J'
%weekday number (Mon=1...Sun=7) FLX         '%['          ==  '%S'
%weekday number (Mon=1...Sun=7) FLX ONS     '%{'          ==  '%>1&*S'
%weekday number (Mon=0...Sun=6) FLX         '%]'          ==  '%T'
%weekday number (Mon=0...Sun=6) FLX ONS     '%}'          ==  '%>1&*T'
%day-of-year number                         '%+'          ==  '%N'
%day-of-year number +LZ                     '%*'          ==  '%>03*N'
%day-of-year number ONS                     '%&'          ==  '%>1&*N'
%day-of-year number +LZ ONS                 '%#'          ==  '%>03&*N'
%day number +LZ                             '%N'          ==  '%>02*D'
%day number ONS                             '%s'          ==  '%>1&*D'
%day number +LZ ONS                         '%u'          ==  '%>02&*D'
%complete month name                        '%M'          ==  '%U'
%3-letter month name                        '%T'          ==  '%>3#U'
%month number                               '%U'          ==  '%M'
%month number +LZ                           '%W'          ==  '%>02*M'
%month number ONS                           '%z'          ==  '%>1&*M'
%month number +LZ ONS                       '%Z'          ==  '%>02&*M'
%complete year number +LZ                   '%='          ==  '%>04*Y'
%age value (birthday) number                '%b'          ==  '%B'
%age value (birthday) number ONS            '%B'          ==  '%>1&*B'
%moon phase                                 '%-'          ==  '%O'
%moon phase +LZ                             '%_'          ==  '%>03*O'
%moon phase text graphics image             '%:'          ==  '%Z'

Legend:

+LZ  ==   With leading zero(es)
FLX  ==   Flexible starting day of week
          (*note Calendar option '--starting-day=ARGUMENT': x-starting-day.)
ONS  ==   With Ordinal Number suffix


File: gcal.info,  Node: Table of Obsolete Date Format Elements,  Next: Table of Obsolete Date Formats,  Prev: Table of Obsolete Special Texts,  Up: Obsolete Special Texts

I.2 Table of Obsolete Date Format Elements
==========================================

This table opposes all obsolete date format elements as they may be used
in the date format text of the '--date-format' option (*note Calendar
option '--date-format=de|us|gb|TEXT': x-date-format.), and their new
representation, as used by Gcal 4.1 now:

*Symbolic name*                      *Old-style*       *New-style*
 
%day number                          '%d'          ==  '%>02*D'
%day number +LS                      '%D'          ==  '%>2*D'
%day number +LZ ONS                  '%u'          ==  '%02&*D'
%day number +LS ONS                  '%U'          ==  '%>2&*D'
%complete month name                 '%B'          ==  '%U'
%3-letter month name                 '%b'          ==  '%<3#U'
%month number +LZ                    '%m'          ==  '%>02*M'
%month number +LS                    '%M'          ==  '%>2*M'
%complete year number +LZ            '%y'          ==  '%>04*Y'
%complete year number +LZ            '%Y'          ==  '%>4*Y'
%last-2-digits year number +LZ       '%z'          ==  '%>02#Y'
%last-2-digits year number +LS       '%Z'          ==  '%>2#Y'
%complete weekday name               '%A'          ==  '%K'
%3-letter weekday name               '%W'          ==  '%<3#K'
%2-letter weekday name               '%w'          ==  '%<2#K'

Legend:

+LZ  ==   With leading zero(es)
+LS  ==   With leading space(s)
ONS  ==   With Ordinal Number suffix


File: gcal.info,  Node: Table of Obsolete Date Formats,  Prev: Table of Obsolete Date Format Elements,  Up: Obsolete Special Texts

I.3 Table of Obsolete Date Formats
==================================

This table opposes all obsolete date format texts as they may be used in
the fixed defaults of the country specific date formats of the
'--date-format' option for German users, U.S. american users and users
in Great Britain (*note Calendar option '--date-format=de|us|gb|TEXT':
x-date-format.), and their new representation, as used by Gcal 4.1 now:

*CC*    *Old-style*                *New-style*
 
DE      '%w, %1%D%2 %b %y'     ==  '%<2#K, %1%>2*D%2 %<3#U %>04*Y'
US      '%W, %b %1%U%2 %y'     ==  '%<3#K, %<3#U %1%>2&*D%2 %>04*Y'
GB      '%W, %1%U%2 %b %y'     ==  '%<3#K, %1%>2&*D%2 %<3#U %>04*Y'


File: gcal.info,  Node: Format Instruction,  Next: Coding Scheme,  Prev: Obsolete Special Texts,  Up: Top

Appendix J Format Instruction
*****************************

Gcal 4.1 is able to represent text variables, special texts and date
formats especially in a very comfortable and uniform manner by using a
format instruction.

  Here comes the description of the format instruction components, now
called FORMAT in the further context.  In general, the template of a
format instruction is:

     ALIGNMENT [SIGN] [ZERO] WIDTH [STYLE] [SUFFIX] FORMAT

  If a FORMAT of above mentioned template is used, its components must
be specified in the above mentioned order, at which the definition of
the components embraced by '[ ]' is of course optional.  The single
components of the format instruction are assembled as follows:

*Character* *Description of the components*
 
            ALIGNMENT group (exactly one member must be defined):
'<'         Field contents is placed at the left margin of the field by
            using the width WIDTH
':'         Field contents is placed in centered manner in the field by
            using the width WIDTH
'>'         Field contents is placed at the right margin of the field
            by using the width WIDTH
 
            SIGN (may be defined):
'+'         Numerical value is provided with leading sign
 
            ZERO (may be defined):
'0'         Numerical value is filled with leading zero(es)
 
            WIDTH (must be defined):
N           Field has the width N (actual range 1...256).
 
            STYLE group (exactly one member may be defined):
'u'         Field contents is converted to upper-case letters
'l'         Field contents is converted to lower-case letters
'w'         Field contents is converted to capitalized words
 
            SUFFIX (may be defined):
'&'         Numerical value is provided with an Ordinal Number suffix
 
            FORMAT group (exactly one member must be defined):
'*'         Field contents is not cut after position WIDTH
'#'         Field contents is cut after position WIDTH

  If a given WIDTH component is greater 256 but less than 999, a field
width of 256 is assumed.  But if a given WIDTH component is zero, this
interrupts the interpretation phase of Gcal so that the complete FORMAT
is not interpreted anymore and is therefore displayed respectively
assigned as is.  The same happens if a component is misspelled, given in
wrong order, or one of the required components is unspecified.

  Furthermore, a STYLE component may be specified case-independently.
*Note Calendar option '--translate-string=TEXT': x-translate-string, for
further annotations how the STYLE component is used correctly.


File: gcal.info,  Node: Coding Scheme,  Next: Environment Variables,  Prev: Format Instruction,  Up: Top

Appendix K Coding Scheme
************************

* Menu:

* Coding Scheme Table 1::
* Coding Scheme Table 2::

The following coding scheme tables explain the relations between the
_date part_ (YYYY...) of a resource file line and the modifiers, the
short-style option '-c|C[]' --which is used for enabling the fixed date
feature-- respectively the '--period-of-fixed-dates=ARGUMENT' long-style
option may have, i.e. they point out all possible correspondences.  This
is necessary because Gcal does not respect all entries found in a
resource file if a _fixed date_ argument is given, it respects only
those entries which have a definite relation to the _fixed date_
argument to avoid the output of redundant information!  *Note Fixed
dates option '--period-of-fixed-dates=ARGUMENT':
x-period-of-fixed-dates, for further details.

In the _date part_ YYYY...:

YYYY
     represents any year number ('0001...9999').

MM
     represents any month number ('01...12' or '99') respectively any
     textual short month name with length of 3 characters ('Jan',
     'Feb'...).

DD
     represents any day number ('01...28', '29', '30', '31' or '99').

WWW
     represents any textual short weekday name with length of 2...3
     characters ('Mon...Sun').

?
     represents any case-insensitive single letter.

N
     represents any positive integer number (one or more digits).


File: gcal.info,  Node: Coding Scheme Table 1,  Next: Coding Scheme Table 2,  Prev: Coding Scheme,  Up: Coding Scheme

K.1 Coding Scheme Table 1
=========================

This table opposes all possible encode variations of a date given in the
_date part_ of resource file with all fitting modifiers of the
short-style option '-c|C[]'.

*Please note:*
The '-c', '-ct', '-cNd', '-c*d|wN[WWW]', '-c@?[[+|-]N[WWW]]', '-cMMDD'
and '-cMMWWWN' options respect *all* encode variations of the _date
part_!

*Date part*               *Short-style option '-c|C[]'*
 
'00000000'                '-cN+|-'
'000000DD'                '-cNw|+|-', '-cw[+|-]', '-cm[+|-]'
'0000MM00'                '-cN+|-'
'0000MMDD'                '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'YYYY0000'                '-cN+|-'
'YYYY00DD'                '-cNw|+|-', '-cw[+|-]', '-cm[+|-]'
'YYYYMM00'                '-cN+|-'
'YYYYMMDD'                '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'000000WWWN'              '-cNw|+|-', '-cw[+|-]', '-cm[+|-]'
'0000MMWWWN'              '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'YYYY00WWWN'              '-cNw|+|-', '-cw[+|-]', '-cm[+|-]'
'YYYYMMWWWN'              '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'0000*dN[WWW]'            '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'YYYY*dN[WWW]'            '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'0000*wN[WWW]'            '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'YYYY*wN[WWW]'            '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'0000@?[+|-]N[WWW]'       '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'
'YYYY@?[+|-]N[WWW]'       '-cNw|+|-', '-cw[+|-]', '-cm[+|-]',
                          '-cy[+|-]', '-clNd|w|+|-', '-cl*d|wN[WWW]',
                          '-cl@?[[+|-]N[WWW]]', '-clMMDD', '-clMMWWWN'


File: gcal.info,  Node: Coding Scheme Table 2,  Prev: Coding Scheme Table 1,  Up: Coding Scheme

K.2 Coding Scheme Table 2
=========================

This table opposes all fitting modifiers of the short-style option
'-c|C[]' with all possible encode variations of a date given in the
_date part_ of resource file.

*Short-style option       *Date part*
'-c|C[]'*
 
'-c'
'-ct'
'-cNd|+|-'
'-cMMDD'
'-cMMWWWN'
'-c*d|wN[WWW]'
'-c@?[[+|-]N[WWW]]'       '00000000', '0000MM00', 'YYYY0000',
                          'YYYYMM00', '000000DD', '0000MMDD',
                          'YYYY00DD', 'YYYYMMDD', '000000WWWN',
                          '0000MMWWWN', 'YYYY00WWWN', 'YYYYMMWWWN',
                          '0000*dN', '0000*dNWWW', 'YYYY*dN',
                          'YYYY*dNWWW', '0000*wN', '0000*wNWWW',
                          'YYYY*wN', 'YYYY*wNWWW', '0000@?[+|-]N',
                          '0000@?[+|-]NWWW', 'YYYY@?[+|-]N',
                          'YYYY@?[+|-]NWWW'
'-cNw'
'-cw[+|-]'                '000000DD', '0000MMDD', 'YYYY00DD',
                          'YYYYMMDD', '000000WWWN', '0000MMWWWN',
                          'YYYY00WWWN', 'YYYYMMWWWN', '0000*dN',
                          '0000*dNWWW', 'YYYY*dN', 'YYYY*dNWWW',
                          '0000*wN', '0000*wNWWW', 'YYYY*wN',
                          'YYYY*wNWWW', '0000@?[+|-]N',
                          '0000@?[+|-]NWWW', 'YYYY@?[+|-]N',
                          'YYYY@?[+|-]NWWW'
'-cm[+|-]'                '000000DD', '0000MMDD', 'YYYY00DD',
                          'YYYYMMDD', '000000WWWN', '0000MMWWWN',
                          'YYYY00WWWN', 'YYYYMMWWWN', '0000*dN',
                          '0000*dNWWW', 'YYYY*dN', 'YYYY*dNWWW',
                          '0000*wN', '0000*wNWWW', 'YYYY*wN',
                          'YYYY*wNWWW', '0000@?[+|-]N',
                          '0000@?[+|-]NWWW', 'YYYY@?[+|-]N',
                          'YYYY@?[+|-]NWWW'
'-cy[+|-]'
'-clNd|w|+|-'
'-clMMDD'
'-clMMWWWN'
'-cl*d|wN[WWW]'
'-cl@?[[+|-]N[WWW]]'      '0000MMDD', 'YYYYMMDD', '0000MMWWWN',
                          'YYYYMMWWWN', '0000*dN', '0000*dNWWW',
                          'YYYY*dN', 'YYYY*dNWWW', '0000*wN',
                          '0000*wNWWW', 'YYYY*wN', 'YYYY*wNWWW',
                          '0000@?[+|-]N', '0000@?[+|-]NWWW',
                          'YYYY@?[+|-]N', 'YYYY@?[+|-]NWWW'


File: gcal.info,  Node: Environment Variables,  Next: Error Codes,  Prev: Coding Scheme,  Up: Top

Appendix L Environment Variables
********************************

Here is a table of all environment variables which are used by Gcal:

'GCAL'
'GCAL_OPT'
     Flags which are passed to the Gcal program automatically.

'GCAL_COLUMNS'
'COLUMNS'
     Sets the number of columns on the screen.  Takes precedence over
     the number of columns specified by the 'TERM' environment variable
     or the system itself.

'GCAL_DATE_FORMAT'
     Contains the date format text which defines the ordering of a
     displayed date.  Takes precedence over the default date format
     text.

'GCAL_LINES'
'LINES'
     Sets the number of lines on the screen.  Takes precedence over the
     number of lines specified by the 'TERM' environment variable or the
     system itself.

'GCAL_SYS_DATADIR'
     Name of a file directory absolute to the _root_/$PREFIX file
     directory, where the system-administrator stores common, _public
     access_ resource files (dates files).

'GCAL_USR_DATADIR'
     Name of a file directory relative to the 'HOME' file directory,
     where the user stores personal, respectively _private access_
     resource files (dates files).  Takes precedence over
     'GCAL_SYS_DATADIR'.

'GCALANSI'
     If defined or set, ANSI escape highlighting sequences are used
     respectively substituted by default if no other highlighting
     sequences are defined by command line option or found in the
     Termcap library.

'GCALPATH'
     (':') colon-separated list of file directories which are searched
     to find the '.gcalrc' file.  Takes precedence over 'HOME',
     'GCAL_USR_DATADIR' and 'GCAL_SYS_DATADIR'.

'GCALPROG'
     Contains the file name of the executable Gcal program that is used
     by the Tcal program to call the Gcal program.  Takes precedence
     over the file name 'gcal' which is burned-in during the compilation
     step of the Tcal program.  The 'GCALPROG' environment variable must
     always be set if the Gcal program is installed under another name
     than the standard name 'gcal', otherwise Tcal is unable to execute
     the Gcal program automatically!

'HOME'
     Name of the user's home file directory.  This is used to find the
     '.gcalrc' file.  Takes precedence over 'GCAL_USR_DATADIR' and
     'GCAL_SYS_DATADIR'.

'LANGUAGE'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over 'LC_ALL', 'LC_MESSAGES'
     and 'LANG'.

'LC_ALL'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over 'LC_MESSAGES' and
     'LANG'.

'LC_MESSAGES'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.  Takes precedence over 'LANG'.

'LANG'
     The national language and other cultural-specific conventions used
     by Gcal at run-time.

'LOGNAME'
     The eMail address which is used if the mailing option is wanted.
     *Note Global option '--mail[=ADDRESS]': x-mail, for more details.

'MAILPROG'
     Name of the mailer program which is used if the mailing option is
     wanted.  Takes precedence over the file name 'mail' which is
     burned-in during the compilation step of the Gcal program.  *Note
     Global option '--mail[=ADDRESS]': x-mail, for more details.

'MAILTO'
     The eMail address which is used if the mailing option is wanted.
     Takes precedence over 'USER' and 'LOGNAME'.  *Note Global option
     '--mail[=ADDRESS]': x-mail, for more details.

'PAGER'
     Name of the _external pager_ program which is used if the paging
     option is wanted.  *Note Global option '--pager': x-pager, for more
     details.

'PATH'
     (':') colon-separated list of file directories which are searched
     to find the _external pager_ program.  *Note Global option
     '--pager': x-pager, for more details.

'TERM'
     The type of terminal on which the Gcal program is being run.

'TXT2GCALPROG'
     Contains the file name of the executable Txt2gcal program that is
     used by the Gcal program to call the Txt2gcal program.  Takes
     precedence over the file name 'txt2gcal' which is burned-in during
     the compilation step of the Gcal program.  The 'TXT2GCALPROG'
     environment variable must always be set if the Txt2gcal program is
     installed under another name than the standard name 'txt2gcal',
     otherwise Gcal is unable to execute the Txt2gcal program
     automatically!  *Note Text variables::, for further details.

'TZ'
     The timezone information which is added to the date text of sent
     eMails, created response files and created shell script files.

'USER'
     The eMail address which is used if the mailing option is wanted.
     Takes precedence over 'LOGNAME'.  *Note Global option
     '--mail[=ADDRESS]': x-mail, for more details.


File: gcal.info,  Node: Error Codes,  Next: Glossary,  Prev: Environment Variables,  Up: Top

Appendix M Error Codes
**********************

Gcal produces the following _exit codes_:

'127'
     Request for help screen, software license or program version
     (adjustable).

'126'
     Invalid command line argument / option.

'125'
     Year out of range for computing the Easter Sunday's date.

'124'
     Virtual memory exhausted.

'123'
     Invalid date part in resource file or in include file.

'122'
     Invalid month field entry in resource file or in include file.

'121'
     Invalid day field entry in resource file or in include file.

'120'
     Malformed _#include_ statement in resource file or in include file.

'119'
     Illegal recursive/cyclic _#include_ statement in resource file or
     in include file.

'118'
     Resource file or include file not found.

'117'
     Invalid N'th weekday field (only '1...5' or '9' valid).

'116'
     Missing _whitespace_ separator character between _date part_ and
     _text part_.

'115'
     Response file respectively shell script cannot be written.

'114'
     Invalid date variable operation.

'113'
     Referenced date variable undefined.

'112'
     Invalid date value assigned to date variable.

'111'
     Sending output to eMail address failed.

'110'
     Internal error, C function pipe(), fork(), exec*() or unlink()
     failed.

'109'
     Error reading resource, include respectively response file.

'108'
     Illegal character found in response file.

'107'
     Internal error, invalid value for the size of an internal table
     occurred.

'106'
     Invalid date format text specified.

'105'
     Invalid text variable definition.

'104'
     Invalid regular expression search pattern specified.

'3'
     Program aborted by signal.

'2'
     _Exit code_ not equal zero returned by external command.

'1'
     Activated '-c|C[]', '-f|F NAME[+...]' or '-# LINE' option caused no
     output of resource file entries.

'0'
     Normal program termination.


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

Appendix N 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:

[index]
* Menu:

* %DATE:                                 Actual date modifier.
                                                             (line    6)
* -# LINE:                               Fixed date options. (line  520)
* -*dN:                                  Fixed date options. (line  901)
* -*dNWWW:                               Fixed date options. (line 1037)
* -*wN[WWW]:                             Fixed date options. (line 1089)
* --adjust-value=ARGUMENT:               Fixed date options. (line  125)
* --alternative-format:                  Fixed date options. (line  684)
* --astronomical-holidays:               Calendar options.   (line   48)
* --atmosphere=AIR-PRESSURE[,TEMPERATURE]: Fixed date options.
                                                             (line  152)
* --bahai-holidays:                      Calendar options.   (line   57)
* --bahai-months:                        Calendar options.   (line 1204)
* --biorhythm-axis=NUMBER:               Fixed date options. (line  623)
* --blocks=1:                            Calendar options.   (line 1392)
* --blocks=12:                           Calendar options.   (line 1412)
* --blocks=2:                            Calendar options.   (line 1396)
* --blocks=3:                            Calendar options.   (line 1400)
* --blocks=4:                            Calendar options.   (line 1404)
* --blocks=6:                            Calendar options.   (line 1408)
* --blocks=NUMBER:                       Calendar options.   (line 1384)
* --calendar-dates=both:                 Calendar options.   (line 1428)
* --calendar-dates=special:              Calendar options.   (line 1422)
* --calendar-dates=special|both:         Calendar options.   (line 1416)
* --cc-holidays=CC[_TT][+...]:           Calendar options.   (line  141)
* --celtic-holidays:                     Calendar options.   (line   61)
* --chinese-flexible-holidays:           Calendar options.   (line   67)
* --chinese-flexible-months:             Calendar options.   (line 1210)
* --chinese-holidays:                    Calendar options.   (line   75)
* --chinese-months:                      Calendar options.   (line 1217)
* --christian-holidays:                  Calendar options.   (line   82)
* --coptic-months:                       Calendar options.   (line 1223)
* --copyleft:                            Common options.     (line   33)
* --copyright:                           Common options.     (line   33)
* --cycle-end=ARGUMENT:                  Fixed date options. (line  225)
* --cycle-step=ARGUMENT:                 Fixed date options. (line  291)
* --date-format=de|us|gb|TEXT:           Calendar options.   (line 1627)
* --date-variable=ARGUMENT:              Fixed date options. (line    8)
* --debug=abort:                         Global options.     (line   42)
* --debug=all:                           Global options.     (line   39)
* --debug=handled:                       Global options.     (line   31)
* --debug=internal:                      Global options.     (line   27)
* --debug=unhandled:                     Global options.     (line   35)
* --debug[=internal|handled|unhandled|all|abort]: Global options.
                                                             (line   24)
* --descending-fixed-dates=long:         Fixed date options. (line  467)
* --descending-fixed-dates=short:        Fixed date options. (line  450)
* --descending-fixed-dates[=short|long]: Fixed date options. (line  435)
* --descending-holiday-list=long:        Calendar options.   (line   24)
* --descending-holiday-list=short:       Calendar options.   (line   35)
* --descending-holiday-list[=long|short]: Calendar options.  (line    9)
* --disable-highlighting:                Global options.     (line  102)
* --end-of-month:                        Fixed date options. (line 1397)
* --end-of-week:                         Fixed date options. (line 1349)
* --end-of-week <1>:                     Fixed date options. (line 1360)
* --end-of-year:                         Fixed date options. (line 1434)
* --ethiopic-months:                     Calendar options.   (line 1228)
* --exclude-fixed-dates-list-title:      Fixed date options. (line  815)
* --exclude-holiday-list-title:          Calendar options.   (line   45)
* --execute-command:                     Fixed date options. (line  353)
* --exit-status-help-non-zero:           Common options.     (line   41)
* --export-date-variables:               Fixed date options. (line   28)
* --export-date-variables <1>:           Date variables.     (line  104)
* --export-text-variables:               Fixed date options. (line  121)
* --export-text-variables <1>:           Text variables.     (line  279)
* --filter-day=ARGUMENT:                 Fixed date options. (line  365)
* --filter-period=ARGUMENT:              Fixed date options. (line  380)
* --filter-text=PATTERN:                 Fixed date options. (line  398)
* --fixed-dates=both:                    Calendar options.   (line 1464)
* --fixed-dates=special:                 Calendar options.   (line 1458)
* --fixed-dates=special|both:            Calendar options.   (line 1451)
* --force-highlighting:                  Global options.     (line   91)
* --french-revolutionary-months:         Calendar options.   (line 1233)
* --gregorian-reform=1582|1700|1752|1753|ARGUMENT: Calendar options.
                                                             (line 1563)
* --grouping-text[=TEXT]:                Fixed date options. (line  709)
* --heading-text=TEXT:                   Fixed date options. (line  818)
* --hebrew-holidays:                     Calendar options.   (line   86)
* --hebrew-months:                       Calendar options.   (line 1238)
* --help:                                Common options.     (line    9)
* --help <1>:                            Invoking tcal.      (line   35)
* --help <2>:                            Invoking txt2gcal.  (line   21)
* --help <3>:                            Invoking gcal2txt.  (line   23)
* --here=LINE:                           Fixed date options. (line  520)
* --highlighting=no:                     Global options.     (line  102)
* --highlighting=TEXT:                   Global options.     (line  107)
* --highlighting=yes:                    Global options.     (line   91)
* --holiday-dates=both:                  Calendar options.   (line 1446)
* --holiday-dates=special:               Calendar options.   (line 1440)
* --holiday-dates=special|both:          Calendar options.   (line 1433)
* --holiday-list=long:                   Calendar options.   (line   18)
* --holiday-list=short:                  Calendar options.   (line   30)
* --holiday-list[=long|short]:           Calendar options.   (line    9)
* --ignore-case:                         Fixed date options. (line  422)
* --include-consecutive-number:          Fixed date options. (line  859)
* --include-holidays=long:               Fixed date options. (line  699)
* --include-holidays=short:              Fixed date options. (line  704)
* --include-resource-file-name:          Fixed date options. (line  675)
* --include-today:                       Fixed date options. (line  884)
* --include-week-number:                 Fixed date options. (line  765)
* --indian-civil-months:                 Calendar options.   (line 1243)
* --islamic-civil-holidays:              Calendar options.   (line   89)
* --islamic-civil-months:                Calendar options.   (line 1248)
* --iso-week-number=no:                  Calendar options.   (line 1372)
* --iso-week-number=yes:                 Calendar options.   (line 1361)
* --iso-week-number=yes|no:              Calendar options.   (line 1354)
* --japanese-flexible-holidays:          Calendar options.   (line   94)
* --japanese-flexible-months:            Calendar options.   (line 1255)
* --japanese-holidays:                   Calendar options.   (line  101)
* --japanese-months:                     Calendar options.   (line 1262)
* --leap-day=february:                   Fixed date options. (line  873)
* --leap-day=february|march:             Fixed date options. (line  869)
* --leap-day=march:                      Fixed date options. (line  878)
* --license:                             Common options.     (line   33)
* --limit:                               Fixed date options. (line  173)
* --list-mode:                           Fixed date options. (line  890)
* --list-of-fixed-dates=long:            Fixed date options. (line  459)
* --list-of-fixed-dates=short:           Fixed date options. (line  441)
* --list-of-fixed-dates[=short|long]:    Fixed date options. (line  435)
* --long-help=?:                         Common options.     (line   25)
* --long-help[=ARGUMENT]:                Common options.     (line   16)
* --mail[=ADDRESS]:                      Global options.     (line  189)
* --month:                               Fixed date options. (line 1390)
* --moonimage-lines=NUMBER:              Fixed date options. (line  652)
* --multicultural-new-year-holidays:     Calendar options.   (line  107)
* --old-armenic-months:                  Calendar options.   (line 1268)
* --old-egyptic-months:                  Calendar options.   (line 1273)
* --omit-multiple-date-part:             Fixed date options. (line  773)
* --orthodox-calendar:                   Calendar options.   (line 1320)
* --orthodox-new-holidays:               Calendar options.   (line  113)
* --orthodox-old-holidays:               Calendar options.   (line  119)
* --pager:                               Global options.     (line   48)
* --period-of-fixed-dates=ARGUMENT:      Fixed date options. (line  898)
* --persian-jalaali-holidays:            Calendar options.   (line  125)
* --persian-jalaali-months:              Calendar options.   (line 1278)
* --precise:                             Fixed date options. (line  341)
* --resource-file=NAME[+...]:            Fixed date options. (line  475)
* --response-file=NAME:                  Global options.     (line    8)
* --revert-match:                        Fixed date options. (line  427)
* --shell-script=NAME:                   Global options.     (line   15)
* --shift=[+|-]NUMBER:                   Invoking tcal.      (line   42)
* --start-of-month:                      Fixed date options. (line 1409)
* --start-of-week:                       Fixed date options. (line 1349)
* --start-of-week <1>:                   Fixed date options. (line 1372)
* --start-of-year:                       Fixed date options. (line 1446)
* --starting-day=ARGUMENT:               Calendar options.   (line 1469)
* --suppress-calendar:                   Calendar options.   (line 1380)
* --suppress-date-part:                  Fixed date options. (line  795)
* --suppress-fixed-dates-list-separator: Fixed date options. (line  785)
* --suppress-holiday-list-separator:     Calendar options.   (line   40)
* --suppress-text-part:                  Fixed date options. (line  805)
* --text-variable=ARGUMENT:              Fixed date options. (line   33)
* --time-offset=ARGUMENT:                Calendar options.   (line 1491)
* --today:                               Fixed date options. (line  435)
* --today <1>:                           Fixed date options. (line  441)
* --tomorrow:                            Fixed date options. (line 1337)
* --transform-year=ARGUMENT:             Calendar options.   (line 1542)
* --translate-string=TEXT:               Calendar options.   (line 1732)
* --type=special|standard:               Calendar options.   (line 1286)
* --usage=?:                             Common options.     (line   25)
* --usage[=ARGUMENT]:                    Common options.     (line   16)
* --version:                             Common options.     (line   37)
* --version <1>:                         Invoking tcal.      (line   39)
* --version <2>:                         Invoking txt2gcal.  (line   25)
* --version <3>:                         Invoking gcal2txt.  (line   27)
* --week:                                Fixed date options. (line 1349)
* --week <1>:                            Fixed date options. (line 1353)
* --with-week-number:                    Calendar options.   (line 1347)
* --year:                                Fixed date options. (line 1427)
* --zero-dates-only:                     Fixed date options. (line  863)
* --zodical-marker-holidays:             Calendar options.   (line  132)
* -?:                                    Common options.     (line    9)
* -??:                                   Common options.     (line   16)
* -@DVAR[+|-]NWWW:                       Fixed date options. (line 1309)
* -@DVAR[[+|-]N]:                        Fixed date options. (line 1277)
* -@e[+|-]NWWW:                          Fixed date options. (line 1196)
* -@e[[+|-]N]:                           Fixed date options. (line 1163)
* -@t[+|-]NWWW:                          Fixed date options. (line 1251)
* -@t[[+|-]N]:                           Fixed date options. (line 1222)
* -a:                                    Fixed date options. (line  675)
* -A:                                    Fixed date options. (line  684)
* -b 1:                                  Calendar options.   (line 1392)
* -b 12:                                 Calendar options.   (line 1412)
* -b 2:                                  Calendar options.   (line 1396)
* -b 3:                                  Calendar options.   (line 1400)
* -b 4:                                  Calendar options.   (line 1404)
* -b 6:                                  Calendar options.   (line 1408)
* -b NUMBER:                             Calendar options.   (line 1384)
* -c:                                    Fixed date options. (line  441)
* -C:                                    Fixed date options. (line  459)
* -c*dN:                                 Fixed date options. (line  901)
* -c*dNWWW:                              Fixed date options. (line 1037)
* -c*wN[WWW]:                            Fixed date options. (line 1089)
* -c-:                                   Fixed date options. (line  450)
* -C-:                                   Fixed date options. (line  467)
* -c@DVAR[+|-]NWWW:                      Fixed date options. (line 1309)
* -c@DVAR[[+|-]N]:                       Fixed date options. (line 1277)
* -c@e[+|-]NWWW:                         Fixed date options. (line 1196)
* -c@e[[+|-]N]:                          Fixed date options. (line 1163)
* -c@t[+|-]NWWW:                         Fixed date options. (line 1251)
* -c@t[[+|-]N]:                          Fixed date options. (line 1222)
* -ca:                                   Fixed date options. (line  675)
* -cA:                                   Fixed date options. (line  684)
* -cd:                                   Fixed date options. (line  884)
* -ce:                                   Fixed date options. (line  699)
* -cE:                                   Fixed date options. (line  704)
* -cg[TEXT]:                             Fixed date options. (line  709)
* -cJ:                                   Fixed date options. (line  805)
* -ck:                                   Fixed date options. (line  765)
* -cl:                                   Fixed date options. (line  890)
* -cl*dN:                                Fixed date options. (line  914)
* -cl*dNWWW:                             Fixed date options. (line 1060)
* -cl*wN[WWW]:                           Fixed date options. (line 1123)
* -cl@DVAR[+|-]NWWW:                     Fixed date options. (line 1321)
* -cl@DVAR[[+|-]N]:                      Fixed date options. (line 1292)
* -cl@e[+|-]NWWW:                        Fixed date options. (line 1208)
* -cl@e[[+|-]N]:                         Fixed date options. (line 1178)
* -cl@t[+|-]NWWW:                        Fixed date options. (line 1263)
* -cl@t[[+|-]N]:                         Fixed date options. (line 1236)
* -clMMDD:                               Fixed date options. (line 1001)
* -clMMWWWN:                             Fixed date options. (line 1023)
* -clN+|-:                               Fixed date options. (line  933)
* -clNd:                                 Fixed date options. (line  914)
* -clNw:                                 Fixed date options. (line  976)
* -cm:                                   Fixed date options. (line 1390)
* -cm+:                                  Fixed date options. (line 1397)
* -cm-:                                  Fixed date options. (line 1409)
* -cMMDD:                                Fixed date options. (line  994)
* -cMMWWWN:                              Fixed date options. (line 1012)
* -cN+|-:                                Fixed date options. (line  923)
* -cNd:                                  Fixed date options. (line  901)
* -cNw:                                  Fixed date options. (line  946)
* -co:                                   Fixed date options. (line  773)
* -cQ:                                   Fixed date options. (line  785)
* -ct:                                   Fixed date options. (line 1337)
* -cT:                                   Fixed date options. (line 1337)
* -cU:                                   Fixed date options. (line  795)
* -cw:                                   Fixed date options. (line 1353)
* -cw+:                                  Fixed date options. (line 1360)
* -cw-:                                  Fixed date options. (line 1372)
* -cx:                                   Fixed date options. (line  815)
* -cy:                                   Fixed date options. (line 1427)
* -cy+:                                  Fixed date options. (line 1434)
* -cy-:                                  Fixed date options. (line 1446)
* -cz:                                   Fixed date options. (line  859)
* -cZ:                                   Fixed date options. (line  863)
* -c[m|M[+|-]]:                          Fixed date options. (line 1387)
* -c[t|T]:                               Fixed date options. (line 1337)
* -c[w|W[+|-]]:                          Fixed date options. (line 1349)
* -c[y|Y[+|-]]:                          Fixed date options. (line 1424)
* -c|C[-]:                               Fixed date options. (line  435)
* -d:                                    Fixed date options. (line  884)
* -D ARGUMENT:                           Fixed date options. (line  365)
* -e:                                    Fixed date options. (line  699)
* -E:                                    Fixed date options. (line  704)
* -f|F NAME[+...]:                       Fixed date options. (line  475)
* -G:                                    Calendar options.   (line   40)
* -g[TEXT]:                              Fixed date options. (line  709)
* -h:                                    Common options.     (line    9)
* -H no:                                 Global options.     (line  102)
* -H TEXT:                               Global options.     (line  107)
* -H yes:                                Global options.     (line   91)
* -hh:                                   Common options.     (line   16)
* -i:                                    Calendar options.   (line 1286)
* -I PATTERN:                            Fixed date options. (line  398)
* -i[-]:                                 Calendar options.   (line 1286)
* -j:                                    Calendar options.   (line 1422)
* -J:                                    Fixed date options. (line  805)
* -jb:                                   Calendar options.   (line 1428)
* -jc:                                   Calendar options.   (line 1458)
* -jcb:                                  Calendar options.   (line 1464)
* -jc[b]:                                Calendar options.   (line 1451)
* -jn:                                   Calendar options.   (line 1440)
* -jnb:                                  Calendar options.   (line 1446)
* -jn[b]:                                Calendar options.   (line 1433)
* -j[b]:                                 Calendar options.   (line 1416)
* -K:                                    Calendar options.   (line 1347)
* -k:                                    Fixed date options. (line  765)
* -L:                                    Common options.     (line   33)
* -l:                                    Fixed date options. (line  890)
* -l*dN:                                 Fixed date options. (line  914)
* -l*dNWWW:                              Fixed date options. (line 1060)
* -l*wN[WWW]:                            Fixed date options. (line 1123)
* -l@DVAR[+|-]NWWW:                      Fixed date options. (line 1321)
* -l@DVAR[[+|-]N]:                       Fixed date options. (line 1292)
* -l@e[+|-]NWWW:                         Fixed date options. (line 1208)
* -l@e[[+|-]N]:                          Fixed date options. (line 1178)
* -l@t[+|-]NWWW:                         Fixed date options. (line 1263)
* -l@t[[+|-]N]:                          Fixed date options. (line 1236)
* -lMMDD:                                Fixed date options. (line 1001)
* -lMMWWWN:                              Fixed date options. (line 1023)
* -lN+|-:                                Fixed date options. (line  933)
* -lNd:                                  Fixed date options. (line  914)
* -lNw:                                  Fixed date options. (line  976)
* -m:                                    Fixed date options. (line 1387)
* -M:                                    Fixed date options. (line 1387)
* -m <1>:                                Fixed date options. (line 1390)
* -m+:                                   Fixed date options. (line 1397)
* -m-:                                   Fixed date options. (line 1409)
* -m[+|-]]:                              Fixed date options. (line 1387)
* -M[+|-]]:                              Fixed date options. (line 1387)
* -m|M[+|-]]:                            Fixed date options. (line 1387)
* -n:                                    Calendar options.   (line   18)
* -N:                                    Calendar options.   (line   30)
* -n-:                                   Calendar options.   (line   24)
* -N-:                                   Calendar options.   (line   35)
* -n|N[-]:                               Calendar options.   (line    9)
* -O:                                    Calendar options.   (line 1320)
* -o:                                    Fixed date options. (line  773)
* -p:                                    Global options.     (line   48)
* -P ARGUMENT:                           Fixed date options. (line  380)
* -Q:                                    Fixed date options. (line  785)
* -q CC[_TT][+...]:                      Calendar options.   (line  141)
* -r ARGUMENT:                           Fixed date options. (line   33)
* -R NAME:                               Global options.     (line    8)
* -s ARGUMENT:                           Calendar options.   (line 1469)
* -S NAME:                               Global options.     (line   15)
* -t:                                    Fixed date options. (line 1337)
* -T:                                    Fixed date options. (line 1337)
* -u:                                    Calendar options.   (line 1380)
* -U:                                    Fixed date options. (line  795)
* -V:                                    Common options.     (line   37)
* -v ARGUMENT:                           Fixed date options. (line    8)
* -w:                                    Fixed date options. (line 1349)
* -W:                                    Fixed date options. (line 1349)
* -w <1>:                                Fixed date options. (line 1353)
* -w+:                                   Fixed date options. (line 1360)
* -w-:                                   Fixed date options. (line 1372)
* -w[+|-]]:                              Fixed date options. (line 1349)
* -W[+|-]]:                              Fixed date options. (line 1349)
* -w|W[+|-]]:                            Fixed date options. (line 1349)
* -X:                                    Calendar options.   (line   45)
* -y:                                    Fixed date options. (line 1424)
* -Y:                                    Fixed date options. (line 1424)
* -y <1>:                                Fixed date options. (line 1427)
* -y+:                                   Fixed date options. (line 1434)
* -y-:                                   Fixed date options. (line 1446)
* -y[+|-]]:                              Fixed date options. (line 1424)
* -Y[+|-]]:                              Fixed date options. (line 1424)
* -y|Y[+|-]]:                            Fixed date options. (line 1424)
* -z:                                    Fixed date options. (line  859)
* -Z:                                    Fixed date options. (line  863)
* @FILE:                                 Response file.      (line    6)
* Command, .:                            3-Month mode commands.
                                                             (line    7)
* Command, . YYYY:                       3-Month mode commands.
                                                             (line   12)
* Command, .+:                           3-Month mode commands.
                                                             (line   27)
* Command, .+ YYYY:                      3-Month mode commands.
                                                             (line   32)
* Command, .-:                           3-Month mode commands.
                                                             (line   37)
* Command, .- YYYY:                      3-Month mode commands.
                                                             (line   42)
* Command, ..:                           3-Month mode commands.
                                                             (line   17)
* Command, .. YYYY:                      3-Month mode commands.
                                                             (line   22)
* Command, ::                            Single commands.    (line   46)
* Command, :YYYY:                        Single commands.    (line   62)
* Command, MM YYYY:                      Single commands.    (line   38)
* Command, MM YYYY-YYYY:                 Ranges of commands. (line   37)
* Command, MM,...,MM:                    Lists of commands.  (line    7)
* Command, MM,...,MM YYYY:               Lists of commands.  (line   20)
* Command, MM,MM/YYYY,...:               Lists of commands.  (line   38)
* Command, MM-MM:                        Ranges of commands. (line    7)
* Command, MM-MM YYYY:                   Ranges of commands. (line   22)
* Command, MM-MM YYYY+YYYY:              Ranges of commands. (line   29)
* Command, MM/YYYY:                      Single commands.    (line   38)
* Command, MM/YYYY,...,MM/YYYY:          Lists of commands.  (line   14)
* Command, MM/YYYY-MM/YYYY:              Ranges of commands. (line   15)
* Command, MM/YYYY-YYYY:                 Ranges of commands. (line   37)
* Command, MM::                          Single commands.    (line   53)
* Command, MM:;MM:;...:                  Lists of commands.  (line   49)
* Command, MM:;MM:YYYY;...:              Lists of commands.  (line   43)
* Command, MM:YYYY:                      Single commands.    (line   69)
* Command, MM:YYYY+MM:YYYY:              Ranges of commands. (line   49)
* Command, MM:YYYY;...;MM:YYYY:          Lists of commands.  (line   31)
* Command, MONTH NAME:                   Single commands.    (line   11)
* Command, NOTHING:                      Single commands.    (line    7)
* Command, YYYY:                         Single commands.    (line   18)
* Command, YYYY+YYYY:                    Ranges of commands. (line   44)
* Command, YYYY;...;YYYY:                Lists of commands.  (line   26)


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

Environment Variable Index
**************************

Here is an alphabetical list of the environment variables checked by
Gcal:

[index]
* Menu:

* COLUMNS:                               Global options.     (line   70)
* COLUMNS <1>:                           Environment Variables.
                                                             (line   14)
* GCAL:                                  Global options.     (line    8)
* GCAL <1>:                              Global options.     (line   15)
* GCAL <2>:                              The GCAL environment variable.
                                                             (line    6)
* GCAL <3>:                              Environment Variables.
                                                             (line   10)
* GCALANSI:                              Global options.     (line  182)
* GCALANSI <1>:                          Environment Variables.
                                                             (line   41)
* GCALPATH:                              Resource file.      (line   25)
* GCALPATH <1>:                          Environment Variables.
                                                             (line   47)
* GCALPROG:                              Invoking tcal.      (line   21)
* GCALPROG <1>:                          Environment Variables.
                                                             (line   52)
* GCAL_COLUMNS:                          Global options.     (line   65)
* GCAL_COLUMNS <1>:                      Environment Variables.
                                                             (line   14)
* GCAL_DATE_FORMAT:                      Calendar options.   (line 1658)
* GCAL_DATE_FORMAT <1>:                  Environment Variables.
                                                             (line   19)
* GCAL_LINES:                            Global options.     (line   65)
* GCAL_LINES <1>:                        Environment Variables.
                                                             (line   25)
* GCAL_OPT:                              The GCAL environment variable.
                                                             (line   24)
* GCAL_OPT <1>:                          Environment Variables.
                                                             (line   10)
* GCAL_SYS_DATADIR:                      Resource file.      (line   50)
* GCAL_SYS_DATADIR <1>:                  Environment Variables.
                                                             (line   30)
* GCAL_USR_DATADIR:                      Resource file.      (line   38)
* GCAL_USR_DATADIR <1>:                  Environment Variables.
                                                             (line   35)
* HOME:                                  Fixed date options. (line  488)
* HOME <1>:                              Resource file.      (line   32)
* HOME <2>:                              Environment Variables.
                                                             (line   61)
* LANG:                                  Internationalization.
                                                             (line   34)
* LANG <1>:                              Internationalization.
                                                             (line  122)
* LANG <2>:                              Environment Variables.
                                                             (line   80)
* LANGUAGE:                              Internationalization.
                                                             (line   31)
* LANGUAGE <1>:                          Environment Variables.
                                                             (line   66)
* LC_ALL:                                Internationalization.
                                                             (line   32)
* LC_ALL <1>:                            Environment Variables.
                                                             (line   71)
* LC_MESSAGES:                           Internationalization.
                                                             (line   33)
* LC_MESSAGES <1>:                       Environment Variables.
                                                             (line   76)
* LINES:                                 Global options.     (line   70)
* LINES <1>:                             Environment Variables.
                                                             (line   25)
* LOGNAME:                               Global options.     (line  207)
* LOGNAME <1>:                           Environment Variables.
                                                             (line   84)
* MAILPROG:                              Global options.     (line  229)
* MAILPROG <1>:                          Environment Variables.
                                                             (line   88)
* MAILTO:                                Global options.     (line  197)
* MAILTO <1>:                            Environment Variables.
                                                             (line   94)
* PAGER:                                 Global options.     (line   48)
* PAGER <1>:                             Environment Variables.
                                                             (line   99)
* PATH:                                  Global options.     (line   53)
* PATH <1>:                              Environment Variables.
                                                             (line  104)
* TERM:                                  Global options.     (line   75)
* TERM <1>:                              Environment Variables.
                                                             (line  109)
* TXT2GCALPROG:                          Text variables.     (line  112)
* TXT2GCALPROG <1>:                      Environment Variables.
                                                             (line  112)
* TZ:                                    Environment Variables.
                                                             (line  122)
* USER:                                  Global options.     (line  202)
* USER <1>:                              Environment Variables.
                                                             (line  126)


File: gcal.info,  Node: Table Index,  Next: GNU Free Documentation License,  Prev: Variable Index,  Up: Top

Table Index
***********

Here is an alphabetical list of the most import tables, summaries and
other general views that can be found in this manual:

[index]
* Menu:

* Actual date modifier, date formats:    Actual date modifier.
                                                             (line   11)
* Co-ordinate, ISO-6709:1983:            Sun data.           (line 1033)
* Coding scheme 1, date part:            Coding Scheme Table 1.
                                                             (line    6)
* Coding scheme 2, date part:            Coding Scheme Table 2.
                                                             (line    6)
* Country specific holidays:             Calendar options.   (line  164)
* Date format elements, obsolete individual: Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date format text, format elements and character replacement instructions: Calendar options.
                                                             (line 1684)
* Date formats of actual date modifier:  Actual date modifier.
                                                             (line   11)
* Date formats, obsolete fixed:          Table of Obsolete Date Formats.
                                                             (line    6)
* Date part, coding scheme 1:            Coding Scheme Table 1.
                                                             (line    6)
* Date part, coding scheme 2:            Coding Scheme Table 2.
                                                             (line    6)
* Date variables, operations:            Date variables.     (line  117)
* Entries in resource file:              Structure of resource file.
                                                             (line   44)
* Environment variables:                 Environment Variables.
                                                             (line    6)
* Error codes:                           Error Codes.        (line    6)
* Eternal holiday list, marking characters used: Eternal Holidays.
                                                             (line   69)
* Event oriented texts of Moon data and times, special: Sun data.
                                                             (line  939)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  939)
* Exit codes:                            Error Codes.        (line    6)
* Fixed date, line structure:            Structure of resource file.
                                                             (line   32)
* Format elements and character replacement instructions in date format text: Calendar options.
                                                             (line 1684)
* Format Instruction:                    Format Instruction. (line    6)
* Geographical distance and course angle, modes: Geographical distance and course angle.
                                                             (line   16)
* Glossary:                              Glossary.           (line    6)
* GNU long-style options:                Options.            (line   36)
* Holidays, country specific:            Calendar options.   (line  164)
* ISO-6709:1983 co-ordinate:             Sun data.           (line 1033)
* Line structure of fixed date:          Structure of resource file.
                                                             (line   32)
* Long-style options, GNU:               Options.            (line   36)
* Marking characters used in eternal holiday list: Eternal Holidays.
                                                             (line   69)
* Metasymbols, used:                     Metasymbols.        (line    6)
* Modes, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   16)
* Modes, Moon oriented special texts:    Moon data.          (line   35)
* Modes, Sun oriented special texts:     Sun data.           (line   35)
* Moon data and times, special event oriented texts: Sun data.
                                                             (line  939)
* Moon oriented special texts, modes:    Moon data.          (line   35)
* Moon oriented special texts, representation types: Moon data.
                                                             (line  841)
* Native language, selection:            Internationalization.
                                                             (line   27)
* Native languages, supported:           Internationalization.
                                                             (line   11)
* Obsolete fixed date formats:           Table of Obsolete Date Formats.
                                                             (line    6)
* Obsolete individual date format elements: Table of Obsolete Date Format Elements.
                                                             (line    6)
* Obsolete special texts:                Table of Obsolete Special Texts.
                                                             (line    6)
* Operations on date variables:          Date variables.     (line  117)
* Operations on text variables:          Text variables.     (line  292)
* Regular expression programming libraries, supported: Regular Expressions.
                                                             (line   20)
* Regular expressions:                   Regexp Summary.     (line    6)
* Representation types of the Moon oriented special texts: Moon data.
                                                             (line  841)
* Representation types of the Sun oriented special texts: Sun data.
                                                             (line 1110)
* Resource file, entries:                Structure of resource file.
                                                             (line   44)
* Run-time error codes:                  Error Codes.        (line    6)
* Selection of native language:          Internationalization.
                                                             (line   27)
* Short-style options, traditional:      Options.            (line   61)
* Special event oriented texts, Moon data and times: Sun data.
                                                             (line  939)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  939)
* Special texts:                         Special Texts Summary.
                                                             (line    6)
* Special texts, obsolete:               Table of Obsolete Special Texts.
                                                             (line    6)
* Sun data and times, special event oriented texts: Sun data.
                                                             (line  939)
* Sun oriented special texts, modes:     Sun data.           (line   35)
* Sun oriented special texts, representation types: Sun data.
                                                             (line 1110)
* Supported native languages:            Internationalization.
                                                             (line   11)
* Supported regular expression programming libraries: Regular Expressions.
                                                             (line   20)
* Text variables, operations:            Text variables.     (line  292)
* Traditional short-style options:       Options.            (line   61)
* Used metasymbols:                      Metasymbols.        (line    6)


File: gcal.info,  Node: GNU Free Documentation License,  Next: Concept Index,  Prev: Table Index,  Up: Top

Appendix O GNU Free Documentation License
*****************************************

                     Version 1.3, 3 November 2008

     Copyright (C) 2000, 2001, 2002, 2007, 2008, 2010, 2011, 2013
     Free Software Foundation, Inc.
     <http://fsf.org/>

     Everyone is permitted to copy and distribute verbatim copies
     of this license document, but changing it is not allowed.

  0. PREAMBLE

     The purpose of this License is to make a manual, textbook, or other
     functional and useful document "free" in the sense of freedom: to
     assure everyone the effective freedom to copy and redistribute it,
     with or without modifying it, either commercially or
     noncommercially.  Secondarily, this License preserves for the
     author and publisher a way to get credit for their work, while not
     being considered responsible for modifications made by others.

     This License is a kind of "copyleft", which means that derivative
     works of the document must themselves be free in the same sense.
     It complements the GNU General Public License, which is a copyleft
     license designed for free software.

     We have designed this License in order to use it for manuals for
     free software, because free software needs free documentation: a
     free program should come with manuals providing the same freedoms
     that the software does.  But this License is not limited to
     software manuals; it can be used for any textual work, regardless
     of subject matter or whether it is published as a printed book.  We
     recommend this License principally for works whose purpose is
     instruction or reference.

  1. APPLICABILITY AND DEFINITIONS

     This License applies to any manual or other work, in any medium,
     that contains a notice placed by the copyright holder saying it can
     be distributed under the terms of this License.  Such a notice
     grants a world-wide, royalty-free license, unlimited in duration,
     to use that work under the conditions stated herein.  The
     "Document", below, refers to any such manual or work.  Any member
     of the public is a licensee, and is addressed as "you".  You accept
     the license if you copy, modify or distribute the work in a way
     requiring permission under copyright law.

     A "Modified Version" of the Document means any work containing the
     Document or a portion of it, either copied verbatim, or with
     modifications and/or translated into another language.

     A "Secondary Section" is a named appendix or a front-matter section
     of the Document that deals exclusively with the relationship of the
     publishers or authors of the Document to the Document's overall
     subject (or to related matters) and contains nothing that could
     fall directly within that overall subject.  (Thus, if the Document
     is in part a textbook of mathematics, a Secondary Section may not
     explain any mathematics.)  The relationship could be a matter of
     historical connection with the subject or with related matters, or
     of legal, commercial, philosophical, ethical or political position
     regarding them.

     The "Invariant Sections" are certain Secondary Sections whose
     titles are designated, as being those of Invariant Sections, in the
     notice that says that the Document is released under this License.
     If a section does not fit the above definition of Secondary then it
     is not allowed to be designated as Invariant.  The Document may
     contain zero Invariant Sections.  If the Document does not identify
     any Invariant Sections then there are none.

     The "Cover Texts" are certain short passages of text that are
     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
     that says that the Document is released under this License.  A
     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
     be at most 25 words.

     A "Transparent" copy of the Document means a machine-readable copy,
     represented in a format whose specification is available to the
     general public, that is suitable for revising the document
     straightforwardly with generic text editors or (for images composed
     of pixels) generic paint programs or (for drawings) some widely
     available drawing editor, and that is suitable for input to text
     formatters or for automatic translation to a variety of formats
     suitable for input to text formatters.  A copy made in an otherwise
     Transparent file format whose markup, or absence of markup, has
     been arranged to thwart or discourage subsequent modification by
     readers is not Transparent.  An image format is not Transparent if
     used for any substantial amount of text.  A copy that is not
     "Transparent" is called "Opaque".

     Examples of suitable formats for Transparent copies include plain
     ASCII without markup, Texinfo input format, LaTeX input format,
     SGML or XML using a publicly available DTD, and standard-conforming
     simple HTML, PostScript or PDF designed for human modification.
     Examples of transparent image formats include PNG, XCF and JPG.
     Opaque formats include proprietary formats that can be read and
     edited only by proprietary word processors, SGML or XML for which
     the DTD and/or processing tools are not generally available, and
     the machine-generated HTML, PostScript or PDF produced by some word
     processors for output purposes only.

     The "Title Page" means, for a printed book, the title page itself,
     plus such following pages as are needed to hold, legibly, the
     material this License requires to appear in the title page.  For
     works in formats which do not have any title page as such, "Title
     Page" means the text near the most prominent appearance of the
     work's title, preceding the beginning of the body of the text.

     The "publisher" means any person or entity that distributes copies
     of the Document to the public.

     A section "Entitled XYZ" means a named subunit of the Document
     whose title either is precisely XYZ or contains XYZ in parentheses
     following text that translates XYZ in another language.  (Here XYZ
     stands for a specific section name mentioned below, such as
     "Acknowledgements", "Dedications", "Endorsements", or "History".)
     To "Preserve the Title" of such a section when you modify the
     Document means that it remains a section "Entitled XYZ" according
     to this definition.

     The Document may include Warranty Disclaimers next to the notice
     which states that this License applies to the Document.  These
     Warranty Disclaimers are considered to be included by reference in
     this License, but only as regards disclaiming warranties: any other
     implication that these Warranty Disclaimers may have is void and
     has no effect on the meaning of this License.

  2. VERBATIM COPYING

     You may copy and distribute the Document in any medium, either
     commercially or noncommercially, provided that this License, the
     copyright notices, and the license notice saying this License
     applies to the Document are reproduced in all copies, and that you
     add no other conditions whatsoever to those of this License.  You
     may not use technical measures to obstruct or control the reading
     or further copying of the copies you make or distribute.  However,
     you may accept compensation in exchange for copies.  If you
     distribute a large enough number of copies you must also follow the
     conditions in section 3.

     You may also lend copies, under the same conditions stated above,
     and you may publicly display copies.

  3. COPYING IN QUANTITY

     If you publish printed copies (or copies in media that commonly
     have printed covers) of the Document, numbering more than 100, and
     the Document's license notice requires Cover Texts, you must
     enclose the copies in covers that carry, clearly and legibly, all
     these Cover Texts: Front-Cover Texts on the front cover, and
     Back-Cover Texts on the back cover.  Both covers must also clearly
     and legibly identify you as the publisher of these copies.  The
     front cover must present the full title with all words of the title
     equally prominent and visible.  You may add other material on the
     covers in addition.  Copying with changes limited to the covers, as
     long as they preserve the title of the Document and satisfy these
     conditions, can be treated as verbatim copying in other respects.

     If the required texts for either cover are too voluminous to fit
     legibly, you should put the first ones listed (as many as fit
     reasonably) on the actual cover, and continue the rest onto
     adjacent pages.

     If you publish or distribute Opaque copies of the Document
     numbering more than 100, you must either include a machine-readable
     Transparent copy along with each Opaque copy, or state in or with
     each Opaque copy a computer-network location from which the general
     network-using public has access to download using public-standard
     network protocols a complete Transparent copy of the Document, free
     of added material.  If you use the latter option, you must take
     reasonably prudent steps, when you begin distribution of Opaque
     copies in quantity, to ensure that this Transparent copy will
     remain thus accessible at the stated location until at least one
     year after the last time you distribute an Opaque copy (directly or
     through your agents or retailers) of that edition to the public.

     It is requested, but not required, that you contact the authors of
     the Document well before redistributing any large number of copies,
     to give them a chance to provide you with an updated version of the
     Document.

  4. MODIFICATIONS

     You may copy and distribute a Modified Version of the Document
     under the conditions of sections 2 and 3 above, provided that you
     release the Modified Version under precisely this License, with the
     Modified Version filling the role of the Document, thus licensing
     distribution and modification of the Modified Version to whoever
     possesses a copy of it.  In addition, you must do these things in
     the Modified Version:

       A. Use in the Title Page (and on the covers, if any) a title
          distinct from that of the Document, and from those of previous
          versions (which should, if there were any, be listed in the
          History section of the Document).  You may use the same title
          as a previous version if the original publisher of that
          version gives permission.

       B. List on the Title Page, as authors, one or more persons or
          entities responsible for authorship of the modifications in
          the Modified Version, together with at least five of the
          principal authors of the Document (all of its principal
          authors, if it has fewer than five), unless they release you
          from this requirement.

       C. State on the Title page the name of the publisher of the
          Modified Version, as the publisher.

       D. Preserve all the copyright notices of the Document.

       E. Add an appropriate copyright notice for your modifications
          adjacent to the other copyright notices.

       F. Include, immediately after the copyright notices, a license
          notice giving the public permission to use the Modified
          Version under the terms of this License, in the form shown in
          the Addendum below.

       G. Preserve in that license notice the full lists of Invariant
          Sections and required Cover Texts given in the Document's
          license notice.

       H. Include an unaltered copy of this License.

       I. Preserve the section Entitled "History", Preserve its Title,
          and add to it an item stating at least the title, year, new
          authors, and publisher of the Modified Version as given on the
          Title Page.  If there is no section Entitled "History" in the
          Document, create one stating the title, year, authors, and
          publisher of the Document as given on its Title Page, then add
          an item describing the Modified Version as stated in the
          previous sentence.

       J. Preserve the network location, if any, given in the Document
          for public access to a Transparent copy of the Document, and
          likewise the network locations given in the Document for
          previous versions it was based on.  These may be placed in the
          "History" section.  You may omit a network location for a work
          that was published at least four years before the Document
          itself, or if the original publisher of the version it refers
          to gives permission.

       K. For any section Entitled "Acknowledgements" or "Dedications",
          Preserve the Title of the section, and preserve in the section
          all the substance and tone of each of the contributor
          acknowledgements and/or dedications given therein.

       L. Preserve all the Invariant Sections of the Document, unaltered
          in their text and in their titles.  Section numbers or the
          equivalent are not considered part of the section titles.

       M. Delete any section Entitled "Endorsements".  Such a section
          may not be included in the Modified Version.

       N. Do not retitle any existing section to be Entitled
          "Endorsements" or to conflict in title with any Invariant
          Section.

       O. Preserve any Warranty Disclaimers.

     If the Modified Version includes new front-matter sections or
     appendices that qualify as Secondary Sections and contain no
     material copied from the Document, you may at your option designate
     some or all of these sections as invariant.  To do this, add their
     titles to the list of Invariant Sections in the Modified Version's
     license notice.  These titles must be distinct from any other
     section titles.

     You may add a section Entitled "Endorsements", provided it contains
     nothing but endorsements of your Modified Version by various
     parties--for example, statements of peer review or that the text
     has been approved by an organization as the authoritative
     definition of a standard.

     You may add a passage of up to five words as a Front-Cover Text,
     and a passage of up to 25 words as a Back-Cover Text, to the end of
     the list of Cover Texts in the Modified Version.  Only one passage
     of Front-Cover Text and one of Back-Cover Text may be added by (or
     through arrangements made by) any one entity.  If the Document
     already includes a cover text for the same cover, previously added
     by you or by arrangement made by the same entity you are acting on
     behalf of, you may not add another; but you may replace the old
     one, on explicit permission from the previous publisher that added
     the old one.

     The author(s) and publisher(s) of the Document do not by this
     License give permission to use their names for publicity for or to
     assert or imply endorsement of any Modified Version.

  5. COMBINING DOCUMENTS

     You may combine the Document with other documents released under
     this License, under the terms defined in section 4 above for
     modified versions, provided that you include in the combination all
     of the Invariant Sections of all of the original documents,
     unmodified, and list them all as Invariant Sections of your
     combined work in its license notice, and that you preserve all
     their Warranty Disclaimers.

     The combined work need only contain one copy of this License, and
     multiple identical Invariant Sections may be replaced with a single
     copy.  If there are multiple Invariant Sections with the same name
     but different contents, make the title of each such section unique
     by adding at the end of it, in parentheses, the name of the
     original author or publisher of that section if known, or else a
     unique number.  Make the same adjustment to the section titles in
     the list of Invariant Sections in the license notice of the
     combined work.

     In the combination, you must combine any sections Entitled
     "History" in the various original documents, forming one section
     Entitled "History"; likewise combine any sections Entitled
     "Acknowledgements", and any sections Entitled "Dedications".  You
     must delete all sections Entitled "Endorsements."

  6. COLLECTIONS OF DOCUMENTS

     You may make a collection consisting of the Document and other
     documents released under this License, and replace the individual
     copies of this License in the various documents with a single copy
     that is included in the collection, provided that you follow the
     rules of this License for verbatim copying of each of the documents
     in all other respects.

     You may extract a single document from such a collection, and
     distribute it individually under this License, provided you insert
     a copy of this License into the extracted document, and follow this
     License in all other respects regarding verbatim copying of that
     document.

  7. AGGREGATION WITH INDEPENDENT WORKS

     A compilation of the Document or its derivatives with other
     separate and independent documents or works, in or on a volume of a
     storage or distribution medium, is called an "aggregate" if the
     copyright resulting from the compilation is not used to limit the
     legal rights of the compilation's users beyond what the individual
     works permit.  When the Document is included in an aggregate, this
     License does not apply to the other works in the aggregate which
     are not themselves derivative works of the Document.

     If the Cover Text requirement of section 3 is applicable to these
     copies of the Document, then if the Document is less than one half
     of the entire aggregate, the Document's Cover Texts may be placed
     on covers that bracket the Document within the aggregate, or the
     electronic equivalent of covers if the Document is in electronic
     form.  Otherwise they must appear on printed covers that bracket
     the whole aggregate.

  8. TRANSLATION

     Translation is considered a kind of modification, so you may
     distribute translations of the Document under the terms of section
     4.  Replacing Invariant Sections with translations requires special
     permission from their copyright holders, but you may include
     translations of some or all Invariant Sections in addition to the
     original versions of these Invariant Sections.  You may include a
     translation of this License, and all the license notices in the
     Document, and any Warranty Disclaimers, provided that you also
     include the original English version of this License and the
     original versions of those notices and disclaimers.  In case of a
     disagreement between the translation and the original version of
     this License or a notice or disclaimer, the original version will
     prevail.

     If a section in the Document is Entitled "Acknowledgements",
     "Dedications", or "History", the requirement (section 4) to
     Preserve its Title (section 1) will typically require changing the
     actual title.

  9. TERMINATION

     You may not copy, modify, sublicense, or distribute the Document
     except as expressly provided under this License.  Any attempt
     otherwise to copy, modify, sublicense, or distribute it is void,
     and will automatically terminate your rights under this License.

     However, if you cease all violation of this License, then your
     license from a particular copyright holder is reinstated (a)
     provisionally, unless and until the copyright holder explicitly and
     finally terminates your license, and (b) permanently, if the
     copyright holder fails to notify you of the violation by some
     reasonable means prior to 60 days after the cessation.

     Moreover, your license from a particular copyright holder is
     reinstated permanently if the copyright holder notifies you of the
     violation by some reasonable means, this is the first time you have
     received notice of violation of this License (for any work) from
     that copyright holder, and you cure the violation prior to 30 days
     after your receipt of the notice.

     Termination of your rights under this section does not terminate
     the licenses of parties who have received copies or rights from you
     under this License.  If your rights have been terminated and not
     permanently reinstated, receipt of a copy of some or all of the
     same material does not give you any rights to use it.

  10. FUTURE REVISIONS OF THIS LICENSE

     The Free Software Foundation may publish new, revised versions of
     the GNU Free Documentation License from time to time.  Such new
     versions will be similar in spirit to the present version, but may
     differ in detail to address new problems or concerns.  See
     <http://www.gnu.org/copyleft/>.

     Each version of the License is given a distinguishing version
     number.  If the Document specifies that a particular numbered
     version of this License "or any later version" applies to it, you
     have the option of following the terms and conditions either of
     that specified version or of any later version that has been
     published (not as a draft) by the Free Software Foundation.  If the
     Document does not specify a version number of this License, you may
     choose any version ever published (not as a draft) by the Free
     Software Foundation.  If the Document specifies that a proxy can
     decide which future versions of this License can be used, that
     proxy's public statement of acceptance of a version permanently
     authorizes you to choose that version for the Document.

  11. RELICENSING

     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
     World Wide Web server that publishes copyrightable works and also
     provides prominent facilities for anybody to edit those works.  A
     public wiki that anybody can edit is an example of such a server.
     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
     site means any set of copyrightable works thus published on the MMC
     site.

     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
     license published by Creative Commons Corporation, a not-for-profit
     corporation with a principal place of business in San Francisco,
     California, as well as future copyleft versions of that license
     published by that same organization.

     "Incorporate" means to publish or republish a Document, in whole or
     in part, as part of another Document.

     An MMC is "eligible for relicensing" if it is licensed under this
     License, and if all works that were first published under this
     License somewhere other than this MMC, and subsequently
     incorporated in whole or in part into the MMC, (1) had no cover
     texts or invariant sections, and (2) were thus incorporated prior
     to November 1, 2008.

     The operator of an MMC Site may republish an MMC contained in the
     site under CC-BY-SA on the same site at any time before August 1,
     2009, provided the MMC is eligible for relicensing.

ADDENDUM: How to use this License for your documents
====================================================

To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and license
notices just after the title page:

       Copyright (C)  YEAR  YOUR NAME.
       Permission is granted to copy, distribute and/or modify this document
       under the terms of the GNU Free Documentation License, Version 1.3
       or any later version published by the Free Software Foundation;
       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
       Texts.  A copy of the license is included in the section entitled ``GNU
       Free Documentation License''.

  If you have Invariant Sections, Front-Cover Texts and Back-Cover
Texts, replace the "with...Texts."  line with this:

         with the Invariant Sections being LIST THEIR TITLES, with
         the Front-Cover Texts being LIST, and with the Back-Cover Texts
         being LIST.

  If you have Invariant Sections without Cover Texts, or some other
combination of the three, merge those two alternatives to suit the
situation.

  If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of free
software license, such as the GNU General Public License, to permit
their use in free software.


File: gcal.info,  Node: Concept Index,  Prev: GNU Free Documentation License,  Up: Top

Concept Index
*************

[index]
* Menu:

* # separator character of ranges of days: Ranges of days.   (line    6)
* $ regexp, anchor metacharacter:        Regexp Operators.   (line   32)
* % special text starting character:     Special Texts processed.
                                                             (line    6)
* %![ARGUMENT] special text, shell command: Shell Command.   (line    6)
* %"[ARGUMENT] special text, numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  213)
* %,[DATE] special text, biorhythm text: Biorhythm.          (line   33)
* %0 special text, end of highlighting sequence 1 or 2: Highlighting.
                                                             (line  125)
* %1 special text, start of highlighting sequence 1: Highlighting.
                                                             (line    9)
* %2 special text, end of highlighting sequence 1: Highlighting.
                                                             (line   28)
* %3 special text, start of highlighting sequence 2: Highlighting.
                                                             (line   37)
* %4 special text, end of highlighting sequence 2: Highlighting.
                                                             (line   56)
* %5 special text, start of highlighting sequence 1: Highlighting.
                                                             (line   65)
* %6 special text, end of highlighting sequence 1: Highlighting.
                                                             (line   78)
* %7 special text, start of highlighting sequence 2: Highlighting.
                                                             (line   87)
* %8 special text, end of highlighting sequence 2: Highlighting.
                                                             (line  100)
* %9 special text, start of highlighting sequence 1 or 2: Highlighting.
                                                             (line  109)
* %;[DATE] special text, biorhythm text graphics: Biorhythm. (line   60)
* %=[ARGUMENT] special text, numerical local time timezone offset value: Actual clocktime.
                                                             (line  234)
* %>02&*D[DATE] special text, day number: Day number.        (line   30)
* %>02&*M[DATE] special text, month number: Month number.    (line   31)
* %>02*D[DATE] special text, day number: Day number.         (line   14)
* %>02*M[DATE] special text, month number: Month number.     (line   15)
* %>03&*N[DATE] special text, day-of-year number: Day-of-year number.
                                                             (line   32)
* %>03*N[DATE] special text, day-of-year number: Day-of-year number.
                                                             (line   15)
* %>03*O[DATE] special text, Moon phase text: Moon phase.    (line   30)
* %>04*Y[DATE] special text, year number: Year number.       (line   14)
* %>1&*B[DATE] special text, age value:  Difference value.   (line   30)
* %>1&*D[DATE] special text, day number: Day number.         (line   22)
* %>1&*E[DATE] special text, weekday number: Weekday number. (line   36)
* %>1&*I[DATE] special text, weekday number: Weekday number. (line   55)
* %>1&*J[DATE] special text, weekday number: Weekday number. (line   74)
* %>1&*M[DATE] special text, month number: Month number.     (line   23)
* %>1&*N[DATE] special text, day-of-year number: Day-of-year number.
                                                             (line   24)
* %>1&*S[DATE] special text, weekday number: Weekday number. (line   95)
* %>1&*T[DATE] special text, weekday number: Weekday number. (line  118)
* %>1&*W[DATE] special text, weekday number: Weekday number. (line   18)
* %>2#K[DATE] special text, 2-letter weekday name: Weekday name.
                                                             (line   23)
* %>3#K[DATE] special text, 3-letter weekday name: Weekday name.
                                                             (line   15)
* %>3#U[DATE] special text, 3-letter month name: Month name. (line   15)
* %? special texts, exclusions without any argument: Exclusions without any argument.
                                                             (line    6)
* %? special texts, exclusive day period: Exclusive day period.
                                                             (line    6)
* %? special texts, highlighting:        Highlighting.       (line    6)
* %? special texts, inclusive day period: Inclusive day period.
                                                             (line    6)
* %? special texts, replacements without any argument: Replacements without any argument.
                                                             (line    6)
* %?... special texts:                   Special Texts processed.
                                                             (line    6)
* %?... special texts, date exclusion:   Exclusions.         (line    6)
* %?... special texts, description:      Special Texts.      (line    6)
* %?... special texts, short-list:       Special Texts Summary.
                                                             (line    6)
* %?... special texts, summary:          Special Texts Summary.
                                                             (line    6)
* %?... special texts, text replacement: Replacements.       (line    6)
* %?[DATE] special texts, biorhythm:     Biorhythm.          (line    6)
* %?[DATE] special texts, exclusions with date argument: Exclusions with date argument.
                                                             (line    6)
* %?[DATE] special texts, replacements with date argument: Replacements with date argument.
                                                             (line    6)
* %@[ARGUMENT] special text, actual Universal time in HH:MM/DATE format: Actual clocktime.
                                                             (line  126)
* %A special text, exclusive Monday:     Exclusive day period.
                                                             (line   18)
* %a special text, inclusive Monday:     Inclusive day period.
                                                             (line   18)
* %B[DATE] special text, age value:      Difference value.   (line   18)
* %C special text, exclusive Tuesday:    Exclusive day period.
                                                             (line   21)
* %c special text, inclusive Tuesday:    Inclusive day period.
                                                             (line   21)
* %d special text, relative day number:  Other difference values.
                                                             (line   21)
* %DATE actual date modifier:            Actual date modifier.
                                                             (line    6)
* %DATE, command line argument:          Actual date modifier.
                                                             (line    6)
* %DATE, option:                         Command line arguments.
                                                             (line    6)
* %D[DATE] special text, day number:     Day number.         (line    7)
* %E[DATE] special text, weekday number: Weekday number.     (line   28)
* %e[DATE][#[DATE]] special text, exclusive date period: Exclusive date period.
                                                             (line    6)
* %F special text, exclusive Wednesday:  Exclusive day period.
                                                             (line   24)
* %f special text, inclusive Wednesday:  Inclusive day period.
                                                             (line   24)
* %G special text, exclusive Thursday:   Exclusive day period.
                                                             (line   27)
* %g special text, inclusive Thursday:   Inclusive day period.
                                                             (line   27)
* %H special text, exclusive Friday:     Exclusive day period.
                                                             (line   30)
* %h special text, inclusive Friday:     Inclusive day period.
                                                             (line   30)
* %I[DATE] special text, weekday number: Weekday number.     (line   46)
* %i[DATE][#[DATE]] special text, inclusive date period: Inclusive date period.
                                                             (line    6)
* %J[DATE] special text, weekday number: Weekday number.     (line   65)
* %K[DATE] special text, complete weekday name: Weekday name.
                                                             (line    7)
* %k[DATE] special text, week number:    Week number.        (line    6)
* %L special text, exclusive Saturday:   Exclusive day period.
                                                             (line   33)
* %l special text, inclusive Saturday:   Inclusive day period.
                                                             (line   33)
* %m special text, relative month number: Other difference values.
                                                             (line   34)
* %M[DATE] special text, month number:   Month number.       (line    7)
* %n[ARGUMENT] special text, textual date: Textual date.     (line    6)
* %N[DATE] special text, day-of-year number: Day-of-year number.
                                                             (line    7)
* %O[DATE] special text, Moon phase text: Moon phase.        (line   15)
* %P special text, exclusive Sunday:     Exclusive day period.
                                                             (line   36)
* %p special text, inclusive Sunday:     Inclusive day period.
                                                             (line   36)
* %Q special text, exclusive Monday...Thursday: Exclusive day period.
                                                             (line   39)
* %q special text, inclusive Monday...Thursday: Inclusive day period.
                                                             (line   39)
* %R special text, exclusive Monday...Friday: Exclusive day period.
                                                             (line   42)
* %r special text, inclusive Monday...Friday: Inclusive day period.
                                                             (line   42)
* %S[DATE] special text, weekday number: Weekday number.     (line   84)
* %t* special text:                      Actual clocktime.   (line   33)
* %t[ARGUMENT] special text, actual local time in HH:MM format: Actual clocktime.
                                                             (line   23)
* %T[DATE] special text, weekday number: Weekday number.     (line  107)
* %U[DATE] special text, complete month name: Month name.    (line    7)
* %V special text, exclusive legal holidays: Exclusive day period.
                                                             (line   10)
* %v special text, inclusive legal holidays: Inclusive day period.
                                                             (line   10)
* %w special text, relative week number: Other difference values.
                                                             (line   29)
* %W[DATE] special text, weekday number: Weekday number.     (line   10)
* %X special text, exclusive all holidays: Exclusive day period.
                                                             (line   14)
* %x special text, inclusive all holidays: Inclusive day period.
                                                             (line   14)
* %y special text, relative year number: Other difference values.
                                                             (line   39)
* %yDATE special text, relative year number: Difference value.
                                                             (line   10)
* %Y[DATE] special text, year number:    Year number.        (line    7)
* %Z[DATE] special text, Moon phase text graphics: Moon phase.
                                                             (line   45)
* %[FORMAT]'[ARGUMENT] special text, actual local time in M[M...] format: Actual clocktime.
                                                             (line   62)
* %[FORMAT]-[ARGUMENT] special text, environment variable: Contents of Environment variable.
                                                             (line    6)
* %[FORMAT].[ARGUMENT] special text, actual Universal time hour: Actual clocktime.
                                                             (line  163)
* %[FORMAT]/[ARGUMENT] special text, actual Universal time minute: Actual clocktime.
                                                             (line  179)
* %[FORMAT]? special texts, difference value: Other difference values.
                                                             (line    6)
* %[FORMAT]?ARGUMENT special texts, Moon data: Moon data.    (line    6)
* %[FORMAT]?ARGUMENT special texts, Sun data: Sun data.      (line    6)
* %[FORMAT]?[ARGUMENT] special text, actual local time minute: Actual clocktime.
                                                             (line   94)
* %[FORMAT]?[ARGUMENT] special texts, actual clocktime: Actual clocktime.
                                                             (line    6)
* %[FORMAT]?[ARGUMENT] special texts, replacements with other argument: Replacements with other argument.
                                                             (line    6)
* %[FORMAT]?[DATE] special texts, difference value: Difference value.
                                                             (line    6)
* %[FORMAT]?[DATE] special texts, Moon phase: Moon phase.    (line    6)
* %[FORMAT]?[DATE] special texts, weekday number: Weekday number.
                                                             (line    6)
* %[FORMAT]b[ARGUMENT] special text, geographical distance and course angle: Geographical distance and course angle.
                                                             (line    6)
* %[FORMAT]D[DATE] special text, day number: Day number.     (line    6)
* %[FORMAT]j[ARGUMENT] special text, Julian day number: Julian day number.
                                                             (line    6)
* %[FORMAT]K[DATE] special text, weekday name: Weekday name. (line    6)
* %[FORMAT]M[DATE] special text, month number: Month number. (line    6)
* %[FORMAT]N[DATE] special text, day-of-year number: Day-of-year number.
                                                             (line    6)
* %[FORMAT]U[DATE] special text, month name: Month name.     (line    6)
* %[FORMAT]Y[DATE] special text, year number: Year number.   (line    6)
* %[FORMAT]_[ARGUMENT] special text, actual local time hour: Actual clocktime.
                                                             (line   78)
* %[FORMAT]`[ARGUMENT] special text, actual Universal time in M[M...]/DATE format: Actual clocktime.
                                                             (line  145)
* %[FORMAT]{[ARGUMENT] special text, actual local time 12-hour format suffix: Actual clocktime.
                                                             (line  110)
* %[FORMAT]}[ARGUMENT] special text, actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  196)
* (...) regexp, grouping:                Regexp Operators.   (line  186)
* * regexp, operator:                    Regexp Operators.   (line  193)
* + regexp, operator:                    Regexp Operators.   (line  213)
* + separator character:                 Calendar options.   (line  154)
* + separator character <1>:             Fixed date options. (line  488)
* , separator character of lists of days: Lists of days.     (line    6)
* - switch character:                    Command line arguments.
                                                             (line   22)
* -- switch character:                   Command line arguments.
                                                             (line   22)
* . regexp, metacharacter:               Regexp Operators.   (line   40)
* .gcalrc resource file:                 Resource file.      (line    6)
* .N appearance factor of days:          Appearance factor of days.
                                                             (line    6)
* / co-ordinate termination character:   Geographical distance and course angle.
                                                             (line   56)
* / switch character:                    Command line arguments.
                                                             (line   22)
* 12-hours display format of time:       Actual clocktime.   (line   33)
* 2-letter weekday name %>2#K[DATE] special text: Weekday name.
                                                             (line   23)
* 2-letter weekday name %>2#K[DATE] special text <1>: Special Texts Summary.
                                                             (line   98)
* 24-hours display format of time:       Actual clocktime.   (line   33)
* 3-letter month name %>3#U[DATE] special text: Month name.  (line   15)
* 3-letter month name %>3#U[DATE] special text <1>: Special Texts Summary.
                                                             (line  177)
* 3-letter weekday name %>3#K[DATE] special text: Weekday name.
                                                             (line   15)
* 3-letter weekday name %>3#K[DATE] special text <1>: Special Texts Summary.
                                                             (line   95)
* 3-Month mode command:                  Glossary.           (line  644)
* 3-Month mode command . YYYY, special:  3-Month mode commands.
                                                             (line   12)
* 3-Month mode command .+ YYYY, special: 3-Month mode commands.
                                                             (line   32)
* 3-Month mode command .+, special:      3-Month mode commands.
                                                             (line   27)
* 3-Month mode command ., special:       3-Month mode commands.
                                                             (line    7)
* 3-Month mode command .- YYYY, special: 3-Month mode commands.
                                                             (line   42)
* 3-Month mode command .-, special:      3-Month mode commands.
                                                             (line   37)
* 3-Month mode command .. YYYY, special: 3-Month mode commands.
                                                             (line   22)
* 3-Month mode command .., special:      3-Month mode commands.
                                                             (line   17)
* 3-Month mode commands:                 Commands.           (line    6)
* 3-Month mode commands <1>:             3-Month mode commands.
                                                             (line    6)
* 3-Month mode, limitations:             Further date part attributes.
                                                             (line   29)
* 3-Month mode, limitations <1>:         Date variables.     (line   49)
* : separator character:                 Global options.     (line  107)
* : separator character <1>:             Global options.     (line  172)
* : separator character <2>:             Fixed date options. (line    8)
* : separator character <3>:             Fixed date options. (line   33)
* :N repetition factor of days:          Repetition factor of days.
                                                             (line    6)
* ; comment character:                   Response file.      (line   21)
* ; comment character <1>:               Comment line.       (line    6)
* ; remark character:                    Response file.      (line   21)
* ; remark character <1>:                Comment line.       (line    6)
* ? regexp, operator:                    Regexp Operators.   (line  225)
* @FILE response file:                   Response file.      (line    6)
* @FILE, command line argument:          Response file.      (line    6)
* @FILE, option:                         Command line arguments.
                                                             (line    6)
* [...] regexp, character list:          Regexp Operators.   (line   51)
* [.ELEMENT.] regexp, collating symbols: Regexp Operators.   (line  143)
* [:alnum:] regexp, character class:     Regexp Operators.   (line   89)
* [:alpha:] regexp, character class:     Regexp Operators.   (line   92)
* [:blank:] regexp, character class:     Regexp Operators.   (line   95)
* [:cntrl:] regexp, character class:     Regexp Operators.   (line   98)
* [:digit:] regexp, character class:     Regexp Operators.   (line  101)
* [:graph:] regexp, character class:     Regexp Operators.   (line  104)
* [:KEYWORD:] regexp, character classes: Regexp Operators.   (line   75)
* [:lower:] regexp, character class:     Regexp Operators.   (line  108)
* [:print:] regexp, character class:     Regexp Operators.   (line  111)
* [:punct:] regexp, character class:     Regexp Operators.   (line  114)
* [:space:] regexp, character class:     Regexp Operators.   (line  118)
* [:upper:] regexp, character class:     Regexp Operators.   (line  121)
* [:xdigit:] regexp, character class:    Regexp Operators.   (line  124)
* [=LIST=] regexp, equivalence classes:  Regexp Operators.   (line  150)
* [^ ...] regexp, complemented character list: Regexp Operators.
                                                             (line  163)
* \ depreciation character:              Fixed date options. (line   98)
* \ depreciation character <1>:          Fixed date options. (line  104)
* \ depreciation character <2>:          Fixed date options. (line  114)
* \ depreciation character <3>:          Fixed date options. (line  415)
* \ depreciation character <4>:          Fixed date options. (line  503)
* \ depreciation character <5>:          Fixed date options. (line  512)
* \ depreciation character <6>:          Fixed date options. (line  547)
* \ depreciation character <7>:          Fixed date options. (line  747)
* \ depreciation character <8>:          Fixed date options. (line  757)
* \ depreciation character <9>:          Fixed date options. (line  841)
* \ depreciation character <10>:         Fixed date options. (line  851)
* \ depreciation character <11>:         Text part of a line.
                                                             (line   52)
* \ depreciation character <12>:         Text part of a line.
                                                             (line   93)
* \ depreciation character <13>:         Special Texts processed.
                                                             (line    6)
* \ depreciation character <14>:         Text variables.     (line   90)
* \ depreciation character <15>:         Other difference values.
                                                             (line   11)
* \ line continuation character:         Text part of a line.
                                                             (line   28)
* \ protection character:                Fixed date options. (line   98)
* \ protection character <1>:            Fixed date options. (line  104)
* \ protection character <2>:            Fixed date options. (line  114)
* \ protection character <3>:            Fixed date options. (line  415)
* \ protection character <4>:            Fixed date options. (line  503)
* \ protection character <5>:            Fixed date options. (line  512)
* \ protection character <6>:            Fixed date options. (line  547)
* \ protection character <7>:            Fixed date options. (line  747)
* \ protection character <8>:            Fixed date options. (line  757)
* \ protection character <9>:            Fixed date options. (line  841)
* \ protection character <10>:           Fixed date options. (line  851)
* \ protection character <11>:           Text part of a line.
                                                             (line   52)
* \ protection character <12>:           Text part of a line.
                                                             (line   93)
* \ protection character <13>:           Special Texts processed.
                                                             (line    6)
* \ protection character <14>:           Text variables.     (line   90)
* \ protection character <15>:           Other difference values.
                                                             (line   11)
* \ regexp, metacharacter:               Regexp Operators.   (line   14)
* \' regexp, operator:                   Regexp Operators.   (line  303)
* \< regexp, operator:                   Regexp Operators.   (line  270)
* \> regexp, operator:                   Regexp Operators.   (line  274)
* \b regexp, operator:                   Regexp Operators.   (line  278)
* \B regexp, operator:                   Regexp Operators.   (line  283)
* \w regexp, operator:                   Regexp Operators.   (line  259)
* \W regexp, operator:                   Regexp Operators.   (line  265)
* \` regexp, operator:                   Regexp Operators.   (line  299)
* ^ line break-up character:             Fixed date options. (line  398)
* ^ line break-up character <1>:         Fixed date options. (line  744)
* ^ line break-up character <2>:         Fixed date options. (line  838)
* ^ line break-up character <3>:         Text part of a line.
                                                             (line    6)
* ^ line break-up character <4>:         Text part of a line.
                                                             (line   58)
* ^ regexp, anchor metacharacter:        Regexp Operators.   (line   22)
* _ pseudo space character:              Fixed date options. (line  111)
* _ pseudo space character <1>:          Fixed date options. (line  411)
* _ pseudo space character <2>:          Fixed date options. (line  509)
* _ pseudo space character <3>:          Fixed date options. (line  544)
* _ pseudo space character <4>:          Fixed date options. (line  754)
* _ pseudo space character <5>:          Fixed date options. (line  848)
* {EXPRESSION} regexp, interval expressions: Regexp Operators.
                                                             (line  235)
* | regexp, operator:                    Regexp Operators.   (line  173)
* ~ line break-up character:             Fixed date options. (line  398)
* ~ line break-up character <1>:         Fixed date options. (line  744)
* ~ line break-up character <2>:         Fixed date options. (line  838)
* ~ line break-up character <3>:         Text part of a line.
                                                             (line    6)
* ~ line break-up character <4>:         Text part of a line.
                                                             (line   47)
* Accuracy of astronomical calculations: Preface.            (line   19)
* Activate fixed date function:          Fixed date options. (line  435)
* Activate fixed date function <1>:      Fixed date options. (line  475)
* Activate fixed date function <2>:      Fixed date options. (line  520)
* Activate fixed date function <3>:      Fixed date options. (line  600)
* Actual clocktime %[FORMAT]?[ARGUMENT] special texts: Actual clocktime.
                                                             (line    6)
* Actual clocktime %[FORMAT]?[ARGUMENT] special texts <1>: Special Texts Summary.
                                                             (line  233)
* Actual date modifier:                  Glossary.           (line   10)
* Actual date modifier, %DATE:           Actual date modifier.
                                                             (line    6)
* Actual file directory:                 Resource file.      (line   32)
* Actual local time 12-hour format suffix %[FORMAT]{[ARGUMENT] special text: Actual clocktime.
                                                             (line  110)
* Actual local time 12-hour format suffix %[FORMAT]{[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  247)
* Actual local time hour %[FORMAT]_[*][[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  241)
* Actual local time hour %[FORMAT]_[ARGUMENT] special text: Actual clocktime.
                                                             (line   78)
* Actual local time in HH:MM format %t[ARGUMENT] special text: Actual clocktime.
                                                             (line   23)
* Actual local time in HH:MM format %t[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  235)
* Actual local time in M[M...] format %[FORMAT]'[ARGUMENT] special text: Actual clocktime.
                                                             (line   62)
* Actual local time in M[M...] format %[FORMAT]'[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  238)
* Actual local time minute %[FORMAT]?[ARGUMENT] special text: Actual clocktime.
                                                             (line   94)
* Actual local time minute %[FORMAT]?[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  244)
* Actual Universal time 12-hour format suffix %[FORMAT]}[ARGUMENT] special text: Actual clocktime.
                                                             (line  196)
* Actual Universal time 12-hour format suffix %[FORMAT]}[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  262)
* Actual Universal time hour %[FORMAT].[*][[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  256)
* Actual Universal time hour %[FORMAT].[ARGUMENT] special text: Actual clocktime.
                                                             (line  163)
* Actual Universal time in HH:MM/DATE format %@[ARGUMENT] special text: Actual clocktime.
                                                             (line  126)
* Actual Universal time in HH:MM/DATE format %@[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  250)
* Actual Universal time in M[M...]/DATE format %[FORMAT]`[ARGUMENT] special text: Actual clocktime.
                                                             (line  145)
* Actual Universal time in M[M...]/DATE format %[FORMAT]`[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  253)
* Actual Universal time minute %[FORMAT]/[ARGUMENT] special text: Actual clocktime.
                                                             (line  179)
* Actual Universal time minute %[FORMAT]/[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  259)
* Addition by days of date variables:    Date variables.     (line  124)
* Addition by weekdays of date variables: Date variables.    (line  126)
* Addition of text variables:            Text variables.     (line  300)
* Additional resource file:              Fixed date options. (line  475)
* Additional resource file line:         Fixed date options. (line  520)
* Age value %>1&*B[DATE] special text:   Difference value.   (line   30)
* Age value %B[DATE] special text:       Difference value.   (line   18)
* Age value %B[DATE] special text <1>:   Special Texts Summary.
                                                             (line  230)
* Age value (birthday) %b[DATE] special text: Special Texts Summary.
                                                             (line  227)
* Air pressure of Earth's atmosphere, set: Fixed date options.
                                                             (line  152)
* Alternation operator:                  Glossary.           (line   15)
* Alternative date format in calendar sheet: Calendar options.
                                                             (line 1416)
* Alternative date format in eternal holiday list: Calendar options.
                                                             (line 1433)
* Alternative date format in fixed date list: Calendar options.
                                                             (line 1451)
* Amateur-astronomical twilight:         Glossary.           (line   19)
* Amateur-astronomical twilight, Sun:    Sun data.           (line  287)
* Amateur-astronomical twilight, Sun <1>: Sun data.          (line  296)
* Anchor:                                Glossary.           (line   23)
* Anchor metacharacter, $ regexp:        Regexp Operators.   (line   32)
* Anchor metacharacter, ^ regexp:        Regexp Operators.   (line   22)
* Anchors in regexp:                     Regexp Operators.   (line   22)
* ANSI:                                  Glossary.           (line   26)
* Appearance factor of days, .N:         Appearance factor of days.
                                                             (line    6)
* Appearance factors of days, examples:  Appearance factor of days.
                                                             (line   84)
* Appearance factors of days, valid date parts: Appearance factor of days.
                                                             (line   49)
* Arguments of command line:             Command line arguments.
                                                             (line    6)
* Aspects in Internationalization:       Internationalization.
                                                             (line    6)
* Asr prayer time:                       Glossary.           (line   31)
* Asr, Islamic prayer time:              Sun data.           (line   50)
* Asr, Islamic prayer time <1>:          Sun data.           (line  818)
* Asr, Islamic prayer time <2>:          Sun data.           (line  855)
* Assignment of special texts to text variables, limitations: Special Texts.
                                                             (line   20)
* Assignments to date variables:         Fixed date options. (line    8)
* Assignments to date variables <1>:     Structure of resource file.
                                                             (line   58)
* Assignments to date variables <2>:     Date variables.     (line    6)
* Assignments to text variables:         Fixed date options. (line   33)
* Assignments to text variables <1>:     Structure of resource file.
                                                             (line   73)
* Assignments to text variables <2>:     Text variables.     (line    6)
* Astronomical calculations, accuracy:   Preface.            (line   19)
* Astronomical calculations, precision:  Preface.            (line   19)
* Astronomical data and times, more precise representation: Fixed date options.
                                                             (line  341)
* Astronomical data in eternal holiday list: Calendar options.
                                                             (line   48)
* Astronomical midnight time, Moon:      Moon data.          (line   38)
* Astronomical midnight time, Sun:       Sun data.           (line   38)
* Astronomical noon time, Moon:          Moon data.          (line   58)
* Astronomical noon time, Sun:           Sun data.           (line   50)
* Astronomical twilight:                 Glossary.           (line   36)
* Astronomical twilight, Sun:            Sun data.           (line  313)
* Astronomical twilight, Sun <1>:        Sun data.           (line  327)
* Astronomical unit:                     Glossary.           (line   40)
* Astronomical unit, Sun:                Sun data.           (line  402)
* Atmospheric refraction:                Fixed date options. (line  152)
* Autumnal equinox:                      Calendar options.   (line   48)
* Autumnal equinox point on the ecliptic: Glossary.          (line   46)
* Azimuth:                               Glossary.           (line   50)
* Azimuth, Moon:                         Moon data.          (line   38)
* Azimuth, Sun:                          Sun data.           (line   38)
* Baha''i` holidays in eternal holiday list: Calendar options.
                                                             (line   57)
* Base data of Earth's atmosphere to calculate refraction, set: Fixed date options.
                                                             (line  152)
* Base time of astronomical functions, output: Sun data.     (line  488)
* Base time of astronomical functions, output <1>: Moon data.
                                                             (line  453)
* Base time of the astronomical functions, change: Calendar options.
                                                             (line 1491)
* Base year of calendar, change:         Calendar options.   (line 1542)
* Biorhythm:                             Glossary.           (line   54)
* Biorhythm %?[DATE] special texts:      Biorhythm.          (line    6)
* Biorhythm %?[DATE] special texts <1>:  Special Texts Summary.
                                                             (line  214)
* Biorhythm text %,[DATE] special text:  Biorhythm.          (line   33)
* Biorhythm text %,[DATE] special text <1>: Special Texts Summary.
                                                             (line  216)
* Biorhythm text graphics %;[DATE] special text: Biorhythm.  (line   60)
* Biorhythm text graphics %;[DATE] special text <1>: Special Texts Summary.
                                                             (line  219)
* Biorhythm, critical day:               Biorhythm.          (line   20)
* Biorhythm, negative day:               Biorhythm.          (line   20)
* Biorhythm, positive day:               Biorhythm.          (line   20)
* Birthday:                              Difference value.   (line   18)
* Birthday <1>:                          Difference value.   (line   30)
* BSD:                                   Glossary.           (line   59)
* Buffer matching operators, regexp:     Regexp Operators.   (line  298)
* Buffer, regexp:                        Regexp Operators.   (line  289)
* C:                                     Glossary.           (line   63)
* C Preprocessor symbol USE_PAGER:       Global options.     (line  176)
* Calendar format, special:              Calendar options.   (line 1286)
* Calendar format, standard:             Calendar options.   (line 1286)
* Calendar mode, hybrid:                 Calendar options.   (line 1563)
* Calendar mode, proleptic:              Calendar options.   (line 1595)
* Calendar option class:                 Options.            (line   13)
* Calendar option class <1>:             Glossary.           (line   67)
* Calendar options:                      Calendar options.   (line    6)
* Calendar sheet, alternative date format: Calendar options. (line 1416)
* Calendar sheet, provide with week numbers: Calendar options.
                                                             (line 1347)
* Calendar sheet, special date format:   Calendar options.   (line 1422)
* Calendar sheet, standard and special date format: Calendar options.
                                                             (line 1428)
* Calendar sheet, suppress:              Calendar options.   (line 1380)
* Calendar, Chinese:                     Preface.            (line  186)
* Calendar, Gregorian:                   Todays Calendar.    (line    6)
* Calendar, Japanese:                    Preface.            (line  186)
* Calendar, Julian:                      Todays Calendar.    (line    6)
* Calendar, leap year rule as used by Eastern churches: Calendar options.
                                                             (line 1320)
* Case sensitivity in matching, regexp:  Regexp Operators.   (line  310)
* Celestial axis:                        Glossary.           (line   70)
* Celestial body elevation:              Glossary.           (line   74)
* Celestial equator:                     Sun data.           (line  376)
* Celestial equator <1>:                 Moon data.          (line  316)
* Celestial equator <2>:                 Glossary.           (line   78)
* Celestial Pole:                        Glossary.           (line   83)
* Celtic holidays in eternal holiday list: Calendar options. (line   61)
* Change base time of the astronomical functions: Calendar options.
                                                             (line 1491)
* Change base year of calendar:          Calendar options.   (line 1542)
* Character class:                       Glossary.           (line   87)
* Character class, [:alnum:] regexp:     Regexp Operators.   (line   89)
* Character class, [:alpha:] regexp:     Regexp Operators.   (line   92)
* Character class, [:blank:] regexp:     Regexp Operators.   (line   95)
* Character class, [:cntrl:] regexp:     Regexp Operators.   (line   98)
* Character class, [:digit:] regexp:     Regexp Operators.   (line  101)
* Character class, [:graph:] regexp:     Regexp Operators.   (line  104)
* Character class, [:lower:] regexp:     Regexp Operators.   (line  108)
* Character class, [:print:] regexp:     Regexp Operators.   (line  111)
* Character class, [:punct:] regexp:     Regexp Operators.   (line  114)
* Character class, [:space:] regexp:     Regexp Operators.   (line  118)
* Character class, [:upper:] regexp:     Regexp Operators.   (line  121)
* Character class, [:xdigit:] regexp:    Regexp Operators.   (line  124)
* Character classes, regexp:             Regexp Operators.   (line   75)
* Character classes, [:KEYWORD:] regexp: Regexp Operators.   (line   75)
* Character list:                        Glossary.           (line   93)
* Character list in regexp, complemented: Regexp Operators.  (line  163)
* Character list in regexp, negated:     Regexp Operators.   (line  163)
* Character list, regexp:                Regexp Operators.   (line   51)
* Character list, [...] regexp:          Regexp Operators.   (line   51)
* Character replacement instruction:     Calendar options.   (line 1670)
* Character set:                         Glossary.           (line   97)
* Characters, command separator:         Commands.           (line   38)
* Chinese calendar:                      Preface.            (line  186)
* Chinese holidays in eternal holiday list: Calendar options.
                                                             (line   75)
* Christian holidays in eternal holiday list: Calendar options.
                                                             (line   82)
* Civil Islamic calendar:                Preface.            (line  163)
* Civil Islamic calendar <1>:            Glossary.           (line  105)
* Civil midnight time:                   Calendar options.   (line 1491)
* Civil midnight time <1>:               Glossary.           (line  108)
* Civil twilight:                        Glossary.           (line  113)
* Civil twilight, Sun:                   Sun data.           (line  235)
* Civil twilight, Sun <1>:               Sun data.           (line  244)
* Clocktime value, Sun and Moon oriented special texts: Sun data.
                                                             (line  930)
* Co-ordinate termination character, /:  Geographical distance and course angle.
                                                             (line   56)
* Co-ordinate, ISO-6709:1983:            Geographical distance and course angle.
                                                             (line   56)
* Co-ordinate, ISO-6709:1983 <1>:        Sun data.           (line 1027)
* Co-ordinate, ISO-6709:1983 <2>:        Moon data.          (line  821)
* Coding scheme of resource file:        Coding Scheme.      (line    6)
* Coding Scheme Table 1:                 Coding Scheme Table 1.
                                                             (line    6)
* Coding Scheme Table 2:                 Coding Scheme Table 2.
                                                             (line    6)
* Collating element:                     Glossary.           (line  117)
* Collating elements, regexp:            Regexp Operators.   (line  135)
* Collating symbol:                      Glossary.           (line  124)
* Collating symbols, regexp:             Regexp Operators.   (line  143)
* Collating symbols, [.ELEMENT.] regexp: Regexp Operators.   (line  143)
* COLUMNS environment variable:          Environment Variables.
                                                             (line   14)
* Command:                               Glossary.           (line  132)
* Command execution:                     Fixed date options. (line   70)
* Command execution <1>:                 Fixed date options. (line  353)
* Command execution <2>:                 Text variables.     (line   42)
* Command execution <3>:                 Shell Command.      (line   24)
* Command line argument:                 Glossary.           (line  128)
* Command line argument %DATE:           Actual date modifier.
                                                             (line    6)
* Command line argument @FILE:           Response file.      (line    6)
* Command line interpreter:              Invoking Gcal.      (line   11)
* Command line interpreter <1>:          Fixed date options. (line  353)
* Command line interpreter <2>:          Text variables.     (line   96)
* Command line interpreter <3>:          Shell Command.      (line    6)
* Command line options, gcal:            Options.            (line    6)
* Command line options, gcal2txt:        Invoking gcal2txt.  (line    6)
* Command line options, tcal:            Invoking tcal.      (line    6)
* Command line options, txt2gcal:        Invoking txt2gcal.  (line    6)
* Command line word, single:             Fixed date options. (line  589)
* Command line word, single <1>:         Fixed date options. (line  600)
* Command line, arguments:               Command line arguments.
                                                             (line    6)
* Command separator characters:          Commands.           (line   38)
* Command separator characters, table:   Commands.           (line   38)
* Command, .:                            3-Month mode commands.
                                                             (line    7)
* Command, . YYYY:                       3-Month mode commands.
                                                             (line   12)
* Command, .+:                           3-Month mode commands.
                                                             (line   27)
* Command, .+ YYYY:                      3-Month mode commands.
                                                             (line   32)
* Command, .-:                           3-Month mode commands.
                                                             (line   37)
* Command, .- YYYY:                      3-Month mode commands.
                                                             (line   42)
* Command, ..:                           3-Month mode commands.
                                                             (line   17)
* Command, .. YYYY:                      3-Month mode commands.
                                                             (line   22)
* Command, ::                            Single commands.    (line   46)
* Command, :YYYY:                        Single commands.    (line   62)
* Command, lists:                        Commands.           (line    6)
* Command, MM YYYY:                      Single commands.    (line   38)
* Command, MM YYYY-YYYY:                 Ranges of commands. (line   37)
* Command, MM,...,MM:                    Lists of commands.  (line    7)
* Command, MM,...,MM YYYY:               Lists of commands.  (line   20)
* Command, MM,MM/YYYY,...:               Lists of commands.  (line   38)
* Command, MM-MM:                        Ranges of commands. (line    7)
* Command, MM-MM YYYY:                   Ranges of commands. (line   22)
* Command, MM-MM YYYY+YYYY:              Ranges of commands. (line   29)
* Command, MM/YYYY:                      Single commands.    (line   38)
* Command, MM/YYYY,...,MM/YYYY:          Lists of commands.  (line   14)
* Command, MM/YYYY-MM/YYYY:              Ranges of commands. (line   15)
* Command, MM/YYYY-YYYY:                 Ranges of commands. (line   37)
* Command, MM::                          Single commands.    (line   53)
* Command, MM:;MM:;...:                  Lists of commands.  (line   49)
* Command, MM:;MM:YYYY;...:              Lists of commands.  (line   43)
* Command, MM:YYYY:                      Single commands.    (line   69)
* Command, MM:YYYY+MM:YYYY:              Ranges of commands. (line   49)
* Command, MM:YYYY;...;MM:YYYY:          Lists of commands.  (line   31)
* Command, MONTH NAME:                   Single commands.    (line   11)
* Command, NOTHING:                      Single commands.    (line    7)
* Command, ranges:                       Commands.           (line    6)
* Command, YYYY:                         Single commands.    (line   18)
* Command, YYYY+YYYY:                    Ranges of commands. (line   44)
* Command, YYYY;...;YYYY:                Lists of commands.  (line   26)
* Commands:                              Command line arguments.
                                                             (line    6)
* Commands, general view:                Commands.           (line    6)
* Commands, lists:                       Lists of commands.  (line    6)
* Commands, ranges:                      Ranges of commands. (line    6)
* Commands, single:                      Commands.           (line    6)
* Commands, single <1>:                  Single commands.    (line    6)
* Comment character, ;:                  Response file.      (line   21)
* Comment character, ; <1>:              Comment line.       (line    6)
* Comment line in resource file:         Structure of resource file.
                                                             (line   47)
* Comment line in resource file <1>:     Comment line.       (line    6)
* Common option class:                   Options.            (line   13)
* Common option class <1>:               Glossary.           (line  136)
* Common options:                        Common options.     (line    6)
* Complemented character list:           Glossary.           (line  496)
* Complemented character list, regexp:   Regexp Operators.   (line  163)
* Complemented character list, [^ ...] regexp: Regexp Operators.
                                                             (line  163)
* Complemented regular expression:       Fixed date options. (line  427)
* Complete month name %U[DATE] special text: Month name.     (line    7)
* Complete month name %U[DATE] special text <1>: Special Texts Summary.
                                                             (line  174)
* Complete weekday name %K[DATE] special text: Weekday name. (line    7)
* Complete weekday name %K[DATE] special text <1>: Special Texts Summary.
                                                             (line   92)
* Conjunction:                           Glossary.           (line  140)
* Conjunction, Moon:                     Moon data.          (line   38)
* Continue line in resource file:        Text part of a line.
                                                             (line   28)
* Control character sequence:            Global options.     (line  107)
* Copyleft:                              Common options.     (line   33)
* Copyright:                             Common options.     (line   33)
* Country code:                          Calendar options.   (line  145)
* Country code <1>:                      Internationalization.
                                                             (line  122)
* Country specific holidays in eternal holiday list: Calendar options.
                                                             (line  141)
* Country specific special characters:   Calendar options.   (line 1732)
* Course angle:                          Glossary.           (line  718)
* Course angle (true track) %b*1ARGUMENT special text: Geographical distance and course angle.
                                                             (line   30)
* Course angle (true track) %b*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  290)
* Course angle (true track) %b*2ARGUMENT special text: Geographical distance and course angle.
                                                             (line   45)
* Course angle (true track) %b*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  300)
* Course angle (true track) %b1ARGUMENT special text: Geographical distance and course angle.
                                                             (line   30)
* Course angle (true track) %b1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  285)
* Course angle (true track) %b2ARGUMENT special text: Geographical distance and course angle.
                                                             (line   45)
* Course angle (true track) %b2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  295)
* Critical day:                          Glossary.           (line  145)
* Critical day, biorhythm:               Biorhythm.          (line   20)
* Current month of current year:         Single commands.    (line    7)
* Current months, range:                 Ranges of commands. (line    7)
* Cycle displacement value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  291)
* Cycle ending time value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  225)
* Cycle mode:                            Fixed date options. (line  225)
* Cycle mode <1>:                        Glossary.           (line  151)
* Cycle timestep value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  291)
* Date exclusion %?... special texts:    Exclusions.         (line    6)
* Date format elements:                  Calendar options.   (line 1670)
* Date format elements <1>:              Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date format texts, fixed default:      Calendar options.   (line 1636)
* Date format texts, fixed default <1>:  Table of Obsolete Date Formats.
                                                             (line    6)
* Date format texts, individual:         Calendar options.   (line 1658)
* Date format texts, individual <1>:     Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date formats:                          Calendar options.   (line 1636)
* Date formats, fixed default:           Calendar options.   (line 1636)
* Date formats, individual:              Calendar options.   (line 1658)
* Date part:                             Glossary.           (line  157)
* Date part of a resource file line:     Date part of a line.
                                                             (line    6)
* Date part, appearance factor of days:  Appearance factor of days.
                                                             (line    6)
* Date part, further attributes:         Further date part attributes.
                                                             (line    6)
* Date part, lists of days:              Lists of days.      (line    6)
* Date part, ranges of days:             Ranges of days.     (line    6)
* Date part, repetition factor of days:  Repetition factor of days.
                                                             (line    6)
* Date part, structure:                  Date part of a line.
                                                             (line    6)
* Date part, validity of omission values: Date part of a line.
                                                             (line  146)
* Date variables:                        Date variables.     (line    6)
* Date variables, addition by days:      Date variables.     (line  124)
* Date variables, addition by weekdays:  Date variables.     (line  126)
* Date variables, assignments:           Fixed date options. (line    8)
* Date variables, assignments <1>:       Structure of resource file.
                                                             (line   58)
* Date variables, assignments <2>:       Date variables.     (line    6)
* Date variables, definition:            Fixed date options. (line    8)
* Date variables, definition <1>:        Date variables.     (line    6)
* Date variables, export of local:       Fixed date options. (line   28)
* Date variables, export of local <1>:   Date variables.     (line  104)
* Date variables, global:                Fixed date options. (line    8)
* Date variables, global <1>:            Date variables.     (line    6)
* Date variables, local:                 Date variables.     (line    6)
* Date variables, management:            Fixed date options. (line    8)
* Date variables, management <1>:        Date variables.     (line    6)
* Date variables, name space:            Fixed date options. (line    8)
* Date variables, name space <1>:        Date variables.     (line   55)
* Date variables, operations:            Fixed date options. (line    8)
* Date variables, operations <1>:        Structure of resource file.
                                                             (line   58)
* Date variables, operations <2>:        Date variables.     (line  117)
* Date variables, scope:                 Fixed date options. (line    8)
* Date variables, scope <1>:             Date variables.     (line  128)
* Date variables, simple decrement:      Date variables.     (line  122)
* Date variables, simple increment:      Date variables.     (line  121)
* Date variables, subtraction by days:   Date variables.     (line  125)
* Date variables, subtraction by weekdays: Date variables.   (line  127)
* Date variables, total number:          Date variables.     (line    6)
* Date variables, visibility:            Date variables.     (line   55)
* Date variables, visibility of local:   Fixed date options. (line   28)
* Date variables, visibility of local <1>: Date variables.   (line  104)
* Day number %>02&*D[DATE] special text: Day number.         (line   30)
* Day number %>02&*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  165)
* Day number %>02*D[DATE] special text:  Day number.         (line   14)
* Day number %>02*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  159)
* Day number %>1&*D[DATE] special text:  Day number.         (line   22)
* Day number %>1&*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  162)
* Day number %D[DATE] special text:      Day number.         (line    7)
* Day number %D[DATE] special text <1>:  Special Texts Summary.
                                                             (line  156)
* Day number %[FORMAT]D[DATE] special text: Day number.      (line    6)
* Day number %[FORMAT]D[DATE] special text <1>: Special Texts Summary.
                                                             (line  154)
* Day number %[FORMAT]N[DATE] special text: Special Texts Summary.
                                                             (line  139)
* Day-of-year number %>03&*N[DATE] special text: Day-of-year number.
                                                             (line   32)
* Day-of-year number %>03&*N[DATE] special text <1>: Special Texts Summary.
                                                             (line  150)
* Day-of-year number %>03*N[DATE] special text: Day-of-year number.
                                                             (line   15)
* Day-of-year number %>03*N[DATE] special text <1>: Special Texts Summary.
                                                             (line  144)
* Day-of-year number %>1&*N[DATE] special text: Day-of-year number.
                                                             (line   24)
* Day-of-year number %>1&*N[DATE] special text <1>: Special Texts Summary.
                                                             (line  147)
* Day-of-year number %N[DATE] special text: Day-of-year number.
                                                             (line    7)
* Day-of-year number %N[DATE] special text <1>: Special Texts Summary.
                                                             (line  141)
* Day-of-year number %[FORMAT]N[DATE] special text: Day-of-year number.
                                                             (line    6)
* Daylight Savings:                      Sun data.           (line 1079)
* Decimal system:                        Glossary.           (line  161)
* Declination:                           Glossary.           (line  164)
* Declination, Moon:                     Moon data.          (line  316)
* Declination, Sun:                      Sun data.           (line  376)
* Default mode, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   49)
* Default mode, Moon data and times:     Moon data.          (line  806)
* Default mode, Sun data and times:      Sun data.           (line  883)
* Defaults of native language:           Internationalization.
                                                             (line   53)
* Definition of date variables:          Fixed date options. (line    8)
* Definition of date variables <1>:      Date variables.     (line    6)
* Definition of global date variables:   Fixed date options. (line    8)
* Definition of global text variables:   Fixed date options. (line   33)
* Definition of local date variables:    Date variables.     (line    6)
* Definition of local text variables:    Text variables.     (line    6)
* Definition of text variables:          Fixed date options. (line   33)
* Definition of text variables <1>:      Text variables.     (line    6)
* Deletion of local date variables:      Date variables.     (line   75)
* Delta-t:                               Glossary.           (line  168)
* Delta-t, Moon:                         Moon data.          (line  431)
* Delta-t, Sun:                          Sun data.           (line  466)
* Depreciation character, \:             Fixed date options. (line   98)
* Depreciation character, \ <1>:         Fixed date options. (line  104)
* Depreciation character, \ <2>:         Fixed date options. (line  114)
* Depreciation character, \ <3>:         Fixed date options. (line  415)
* Depreciation character, \ <4>:         Fixed date options. (line  503)
* Depreciation character, \ <5>:         Fixed date options. (line  512)
* Depreciation character, \ <6>:         Fixed date options. (line  547)
* Depreciation character, \ <7>:         Fixed date options. (line  747)
* Depreciation character, \ <8>:         Fixed date options. (line  757)
* Depreciation character, \ <9>:         Fixed date options. (line  841)
* Depreciation character, \ <10>:        Fixed date options. (line  851)
* Depreciation character, \ <11>:        Text part of a line.
                                                             (line   52)
* Depreciation character, \ <12>:        Text part of a line.
                                                             (line   93)
* Depreciation character, \ <13>:        Special Texts processed.
                                                             (line    6)
* Depreciation character, \ <14>:        Text variables.     (line   90)
* Depreciation character, \ <15>:        Other difference values.
                                                             (line   11)
* Depreciation of special characters:    Command line arguments.
                                                             (line   28)
* Depreciation of special characters <1>: Fixed date options.
                                                             (line   98)
* Depreciation of special characters <2>: Fixed date options.
                                                             (line  104)
* Depreciation of special characters <3>: Fixed date options.
                                                             (line  114)
* Depreciation of special characters <4>: Fixed date options.
                                                             (line  415)
* Depreciation of special characters <5>: Fixed date options.
                                                             (line  503)
* Depreciation of special characters <6>: Fixed date options.
                                                             (line  512)
* Depreciation of special characters <7>: Fixed date options.
                                                             (line  547)
* Depreciation of special characters <8>: Fixed date options.
                                                             (line  747)
* Depreciation of special characters <9>: Fixed date options.
                                                             (line  757)
* Depreciation of special characters <10>: Fixed date options.
                                                             (line  841)
* Depreciation of special characters <11>: Fixed date options.
                                                             (line  851)
* Depreciation of special characters <12>: Response file.    (line    6)
* Depreciation of special characters <13>: Text part of a line.
                                                             (line   52)
* Depreciation of special characters <14>: Text part of a line.
                                                             (line   93)
* Depreciation of special characters <15>: Special Texts processed.
                                                             (line    6)
* Depreciation of special characters <16>: Text variables.   (line   90)
* Depreciation of special characters <17>: Other difference values.
                                                             (line   11)
* Description of all %?... special texts: Special Texts.     (line    6)
* Description of format instruction:     Format Instruction. (line    6)
* Determine type of week number:         Calendar options.   (line 1354)
* Difference value %[FORMAT]? special texts: Other difference values.
                                                             (line    6)
* Difference value %[FORMAT]? special texts <1>: Special Texts Summary.
                                                             (line 1869)
* Difference value %[FORMAT]?[DATE] special texts: Difference value.
                                                             (line    6)
* Difference value %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  222)
* Direction to Makkah, Islamic prayer:   Geographical distance and course angle.
                                                             (line   86)
* Directory, actual:                     Resource file.      (line   32)
* Disable highlighting sequences:        Global options.     (line  102)
* Disable marking characters:            Global options.     (line  102)
* Double or shorter shadow length, period: Sun data.         (line  871)
* Double shadow length at afternoon:     Sun data.           (line  855)
* Double shadow length at forenoon:      Sun data.           (line  846)
* Early years:                           Glossary.           (line  174)
* Earth equator radius, unit:            Moon data.          (line  353)
* Earth's atmosphere, set air pressure:  Fixed date options. (line  152)
* Earth's atmosphere, set base data to calculate refraction: Fixed date options.
                                                             (line  152)
* Earth's atmosphere, set temperature:   Fixed date options. (line  152)
* Eastern churches' leap year rule, use: Calendar options.   (line 1320)
* Eclipse, lunar:                        Calendar options.   (line   48)
* Eclipse, solar:                        Calendar options.   (line   48)
* Ecliptic:                              Sun data.           (line  387)
* Ecliptic <1>:                          Moon data.          (line  327)
* Ecliptic <2>:                          Moon data.          (line  335)
* Ecliptic <3>:                          Glossary.           (line  187)
* Ecliptic latitude:                     Glossary.           (line  179)
* Ecliptic latitude, Moon:               Moon data.          (line  335)
* Ecliptic longitude:                    Glossary.           (line  183)
* Ecliptic longitude, Moon:              Moon data.          (line  327)
* Ecliptic longitude, Sun:               Sun data.           (line  387)
* Electronic Mail:                       Global options.     (line  189)
* Elevation, Moon:                       Moon data.          (line  302)
* Elevation, Sun:                        Sun data.           (line  348)
* Elongation:                            Glossary.           (line  190)
* Elongation, Moon:                      Moon data.          (line  359)
* EMail, empty message body:             Global options.     (line  215)
* EMail, error code:                     Error Codes.        (line    6)
* EMail, methods of sending:             Global options.     (line  194)
* EMail, option:                         Global options.     (line  189)
* Empty local text variables:            Text variables.     (line   55)
* Empty local text variables <1>:        Text variables.     (line  242)
* Empty message body in Mail:            Global options.     (line  215)
* End of highlighting sequence 1 %2 special text: Highlighting.
                                                             (line   28)
* End of highlighting sequence 1 %2 special text <1>: Special Texts Summary.
                                                             (line 1888)
* End of highlighting sequence 1 %6 special text: Highlighting.
                                                             (line   78)
* End of highlighting sequence 1 %6 special text <1>: Special Texts Summary.
                                                             (line 1901)
* End of highlighting sequence 1 or 2 %0 special text: Highlighting.
                                                             (line  125)
* End of highlighting sequence 1 or 2 %0 special text <1>: Special Texts Summary.
                                                             (line 1918)
* End of highlighting sequence 2 %4 special text: Highlighting.
                                                             (line   56)
* End of highlighting sequence 2 %4 special text <1>: Special Texts Summary.
                                                             (line 1894)
* End of highlighting sequence 2 %8 special text: Highlighting.
                                                             (line  100)
* End of highlighting sequence 2 %8 special text <1>: Special Texts Summary.
                                                             (line 1909)
* Ending date:                           Glossary.           (line  194)
* Ending date of fixed date:             Inclusive date period.
                                                             (line   31)
* Ending date of fixed date <1>:         Exclusive date period.
                                                             (line   32)
* Environment:                           Glossary.           (line  198)
* Environment variable %[FORMAT]-[ARGUMENT] special text: Contents of Environment variable.
                                                             (line    6)
* Environment variable %[FORMAT]-[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line 1866)
* Environment variable, COLUMNS:         Environment Variables.
                                                             (line   14)
* Environment variable, GCAL:            Global options.     (line    8)
* Environment variable, GCAL <1>:        Global options.     (line   15)
* Environment variable, GCAL <2>:        The GCAL environment variable.
                                                             (line    6)
* Environment variable, GCAL <3>:        Environment Variables.
                                                             (line   10)
* Environment variable, GCALANSI:        Global options.     (line  182)
* Environment variable, GCALANSI <1>:    Environment Variables.
                                                             (line   41)
* Environment variable, GCALPATH:        Resource file.      (line   25)
* Environment variable, GCALPATH <1>:    Environment Variables.
                                                             (line   47)
* Environment variable, GCALPROG:        Invoking tcal.      (line   21)
* Environment variable, GCALPROG <1>:    Environment Variables.
                                                             (line   52)
* Environment variable, GCAL_COLUMNS:    Environment Variables.
                                                             (line   14)
* Environment variable, GCAL_DATE_FORMAT: Environment Variables.
                                                             (line   19)
* Environment variable, GCAL_LINES:      Environment Variables.
                                                             (line   25)
* Environment variable, GCAL_OPT:        The GCAL environment variable.
                                                             (line   24)
* Environment variable, GCAL_OPT <1>:    Environment Variables.
                                                             (line   10)
* Environment variable, GCAL_SYS_DATADIR: Resource file.     (line   50)
* Environment variable, GCAL_SYS_DATADIR <1>: Environment Variables.
                                                             (line   30)
* Environment variable, GCAL_USR_DATADIR: Resource file.     (line   38)
* Environment variable, GCAL_USR_DATADIR <1>: Environment Variables.
                                                             (line   35)
* Environment variable, HOME:            Resource file.      (line   32)
* Environment variable, HOME <1>:        Environment Variables.
                                                             (line   61)
* Environment variable, LANG:            Internationalization.
                                                             (line   34)
* Environment variable, LANG <1>:        Environment Variables.
                                                             (line   80)
* Environment variable, LANGUAGE:        Internationalization.
                                                             (line   31)
* Environment variable, LANGUAGE <1>:    Environment Variables.
                                                             (line   66)
* Environment variable, LC_ALL:          Internationalization.
                                                             (line   32)
* Environment variable, LC_ALL <1>:      Environment Variables.
                                                             (line   71)
* Environment variable, LC_MESSAGES:     Internationalization.
                                                             (line   33)
* Environment variable, LC_MESSAGES <1>: Environment Variables.
                                                             (line   76)
* Environment variable, LINES:           Environment Variables.
                                                             (line   25)
* Environment variable, LOGNAME:         Global options.     (line  207)
* Environment variable, LOGNAME <1>:     Environment Variables.
                                                             (line   84)
* Environment variable, MAILPROG:        Global options.     (line  229)
* Environment variable, MAILPROG <1>:    Environment Variables.
                                                             (line   88)
* Environment variable, MAILTO:          Global options.     (line  197)
* Environment variable, MAILTO <1>:      Environment Variables.
                                                             (line   94)
* Environment variable, PAGER:           Global options.     (line   48)
* Environment variable, PAGER <1>:       Environment Variables.
                                                             (line   99)
* Environment variable, PATH:            Global options.     (line   53)
* Environment variable, PATH <1>:        Environment Variables.
                                                             (line  104)
* Environment variable, TERM:            Environment Variables.
                                                             (line  109)
* Environment variable, TXT2GCALPROG:    Text variables.     (line  112)
* Environment variable, TXT2GCALPROG <1>: Environment Variables.
                                                             (line  112)
* Environment variable, TZ:              Environment Variables.
                                                             (line  122)
* Environment variable, USER:            Global options.     (line  202)
* Environment variable, USER <1>:        Environment Variables.
                                                             (line  126)
* Environment variables, table:          Environment Variables.
                                                             (line    6)
* Ephemeris date, Julian:                Sun data.           (line  503)
* Ephemeris date, Julian <1>:            Moon data.          (line  468)
* Ephemeris time (ET):                   Sun data.           (line  466)
* Ephemeris time (ET) <1>:               Moon data.          (line  431)
* Equation of time:                      Sun data.           (line  508)
* Equation of time <1>:                  Glossary.           (line  204)
* Equinox, autumnal:                     Calendar options.   (line   48)
* Equinox, vernal:                       Calendar options.   (line   48)
* Equivalence class:                     Glossary.           (line  208)
* Equivalence classes, regexp:           Regexp Operators.   (line  150)
* Equivalence classes, [=LIST=] regexp:  Regexp Operators.   (line  150)
* Error code 1:                          Fixed date options. (line  441)
* Error code 1 <1>:                      Fixed date options. (line  450)
* Error code 1 <2>:                      Fixed date options. (line  475)
* Error code 1 <3>:                      Fixed date options. (line  520)
* Error code 113:                        Date variables.     (line   55)
* Error code 118:                        Resource file.      (line   64)
* Error code 119:                        Include directives. (line   53)
* Error code 126:                        Fixed date options. (line  965)
* Error code 126 <1>:                    Fixed date options. (line 1043)
* Error code 126 <2>:                    Fixed date options. (line 1049)
* Error code 126 <3>:                    Fixed date options. (line 1069)
* Error code 126 <4>:                    Fixed date options. (line 1076)
* Error code 126 <5>:                    Fixed date options. (line 1097)
* Error code 126 <6>:                    Fixed date options. (line 1106)
* Error code 126 <7>:                    Fixed date options. (line 1112)
* Error code 126 <8>:                    Fixed date options. (line 1132)
* Error code 126 <9>:                    Fixed date options. (line 1143)
* Error code 126 <10>:                   Fixed date options. (line 1150)
* Error code 127:                        Common options.     (line   41)
* Error code 2:                          Text variables.     (line  134)
* Error code 2 <1>:                      Shell Command.      (line   18)
* Error code of executed commands:       Shell Command.      (line    6)
* Error codes, table:                    Error Codes.        (line    6)
* Escape sequence:                       Global options.     (line  107)
* Escape sequence <1>:                   Glossary.           (line  212)
* Eternal holiday list, alternative date format: Calendar options.
                                                             (line 1433)
* Eternal holiday list, astronomical data: Calendar options. (line   48)
* Eternal holiday list, Baha''i` holidays: Calendar options. (line   57)
* Eternal holiday list, Celtic holidays: Calendar options.   (line   61)
* Eternal holiday list, Chinese holidays: Calendar options.  (line   75)
* Eternal holiday list, Christian holidays: Calendar options.
                                                             (line   82)
* Eternal holiday list, country specific holidays: Calendar options.
                                                             (line  141)
* Eternal holiday list, Hebrew holidays: Calendar options.   (line   86)
* Eternal holiday list, holidays from the flexible Chinese calendar: Calendar options.
                                                             (line   67)
* Eternal holiday list, holidays from the flexible Japanese calendar: Calendar options.
                                                             (line   94)
* Eternal holiday list, Islamic holidays: Calendar options.  (line   89)
* Eternal holiday list, Japanese holidays: Calendar options. (line  101)
* Eternal holiday list, months from Baha''i` calendar: Calendar options.
                                                             (line 1204)
* Eternal holiday list, months from flexible Chinese calendar: Calendar options.
                                                             (line 1210)
* Eternal holiday list, months from flexible Japanese calendar: Calendar options.
                                                             (line 1255)
* Eternal holiday list, months from the Chinese calendar: Calendar options.
                                                             (line 1217)
* Eternal holiday list, months from the civil Indian calendar: Calendar options.
                                                             (line 1243)
* Eternal holiday list, months from the civil Islamic calendar: Calendar options.
                                                             (line 1248)
* Eternal holiday list, months from the Coptic calendar: Calendar options.
                                                             (line 1223)
* Eternal holiday list, months from the Ethiopic calendar: Calendar options.
                                                             (line 1228)
* Eternal holiday list, months from the French Revolutionary calendar: Calendar options.
                                                             (line 1233)
* Eternal holiday list, months from the Hebrew calendar: Calendar options.
                                                             (line 1238)
* Eternal holiday list, months from the Japanese calendar: Calendar options.
                                                             (line 1262)
* Eternal holiday list, months from the Old-Armenic calendar: Calendar options.
                                                             (line 1268)
* Eternal holiday list, months from the Old-Egyptic calendar: Calendar options.
                                                             (line 1273)
* Eternal holiday list, months from the Persian Jalaali calendar: Calendar options.
                                                             (line 1278)
* Eternal holiday list, multicultural New Year holidays: Calendar options.
                                                             (line  107)
* Eternal holiday list, option:          Calendar options.   (line    9)
* Eternal holiday list, Orthodox new calendar holidays: Calendar options.
                                                             (line  113)
* Eternal holiday list, Orthodox old calendar holidays: Calendar options.
                                                             (line  119)
* Eternal holiday list, Persian Jalaali holidays: Calendar options.
                                                             (line  125)
* Eternal holiday list, special date format: Calendar options.
                                                             (line 1440)
* Eternal holiday list, standard and special date format: Calendar options.
                                                             (line 1446)
* Eternal holiday list, suppression of leading blank line: Calendar options.
                                                             (line   40)
* Eternal holiday list, suppression of title text: Calendar options.
                                                             (line   45)
* Eternal holiday list, zodiacal marker holidays: Calendar options.
                                                             (line  132)
* Eternal Holidays:                      Eternal Holidays.   (line    6)
* Evening width:                         Glossary.           (line  218)
* Evening width geocentric, Sun:         Sun data.           (line  799)
* Evening width topocentric, Sun:        Sun data.           (line  751)
* Event oriented texts of Moon data and times, special: Sun data.
                                                             (line  939)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  939)
* Examples of resource files:            Resource file examples.
                                                             (line    6)
* Examples to appearance factors of days: Appearance factor of days.
                                                             (line   84)
* Examples to lists of days:             Lists of days.      (line   36)
* Examples to ranges of days:            Ranges of days.     (line   63)
* Examples to repetition factors of days: Repetition factor of days.
                                                             (line   56)
* Exclusions with date argument %?[DATE] special texts: Exclusions with date argument.
                                                             (line    6)
* Exclusions without any argument %? special texts: Exclusions without any argument.
                                                             (line    6)
* Exclusive all holidays %X special text: Exclusive day period.
                                                             (line   14)
* Exclusive all holidays %X special text <1>: Special Texts Summary.
                                                             (line   60)
* Exclusive date period:                 Exclusions with date argument.
                                                             (line   11)
* Exclusive date period <1>:             Glossary.           (line  223)
* Exclusive date period %e[DATE][#[DATE]] special text: Exclusive date period.
                                                             (line    6)
* Exclusive date period %e[DATE][#[DATE]] special text <1>: Special Texts Summary.
                                                             (line   17)
* Exclusive day period:                  Exclusions without any argument.
                                                             (line   11)
* Exclusive day period <1>:              Glossary.           (line  223)
* Exclusive day period %? special texts: Exclusive day period.
                                                             (line    6)
* Exclusive day period %? special texts <1>: Special Texts Summary.
                                                             (line   55)
* Exclusive Friday %H special text:      Exclusive day period.
                                                             (line   30)
* Exclusive Friday %H special text <1>:  Special Texts Summary.
                                                             (line   75)
* Exclusive legal holidays %V special text: Exclusive day period.
                                                             (line   10)
* Exclusive legal holidays %V special text <1>: Special Texts Summary.
                                                             (line   57)
* Exclusive Monday %A special text:      Exclusive day period.
                                                             (line   18)
* Exclusive Monday %A special text <1>:  Special Texts Summary.
                                                             (line   63)
* Exclusive Monday...Friday %R special text: Exclusive day period.
                                                             (line   42)
* Exclusive Monday...Friday %R special text <1>: Special Texts Summary.
                                                             (line   87)
* Exclusive Monday...Thursday %Q special text: Exclusive day period.
                                                             (line   39)
* Exclusive Monday...Thursday %Q special text <1>: Special Texts Summary.
                                                             (line   84)
* Exclusive Saturday %L special text:    Exclusive day period.
                                                             (line   33)
* Exclusive Saturday %L special text <1>: Special Texts Summary.
                                                             (line   78)
* Exclusive Sunday %P special text:      Exclusive day period.
                                                             (line   36)
* Exclusive Sunday %P special text <1>:  Special Texts Summary.
                                                             (line   81)
* Exclusive Thursday %G special text:    Exclusive day period.
                                                             (line   27)
* Exclusive Thursday %G special text <1>: Special Texts Summary.
                                                             (line   72)
* Exclusive Tuesday %C special text:     Exclusive day period.
                                                             (line   21)
* Exclusive Tuesday %C special text <1>: Special Texts Summary.
                                                             (line   66)
* Exclusive Wednesday %F special text:   Exclusive day period.
                                                             (line   24)
* Exclusive Wednesday %F special text <1>: Special Texts Summary.
                                                             (line   69)
* Execute command:                       Fixed date options. (line   70)
* Execute command <1>:                   Fixed date options. (line  353)
* Execute command <2>:                   Text variables.     (line   42)
* Execute command <3>:                   Shell Command.      (line   24)
* Executed commands, error code:         Shell Command.      (line    6)
* Executed commands, exit code:          Shell Command.      (line    6)
* Exit code 1:                           Fixed date options. (line  441)
* Exit code 1 <1>:                       Fixed date options. (line  450)
* Exit code 1 <2>:                       Fixed date options. (line  475)
* Exit code 1 <3>:                       Fixed date options. (line  520)
* Exit code 113:                         Date variables.     (line   55)
* Exit code 118:                         Resource file.      (line   64)
* Exit code 119:                         Include directives. (line   53)
* Exit code 126:                         Fixed date options. (line  965)
* Exit code 126 <1>:                     Fixed date options. (line 1043)
* Exit code 126 <2>:                     Fixed date options. (line 1049)
* Exit code 126 <3>:                     Fixed date options. (line 1069)
* Exit code 126 <4>:                     Fixed date options. (line 1076)
* Exit code 126 <5>:                     Fixed date options. (line 1097)
* Exit code 126 <6>:                     Fixed date options. (line 1106)
* Exit code 126 <7>:                     Fixed date options. (line 1112)
* Exit code 126 <8>:                     Fixed date options. (line 1132)
* Exit code 126 <9>:                     Fixed date options. (line 1143)
* Exit code 126 <10>:                    Fixed date options. (line 1150)
* Exit code 127:                         Common options.     (line   41)
* Exit code 2:                           Text variables.     (line  134)
* Exit code 2 <1>:                       Shell Command.      (line   18)
* Exit code of executed commands:        Shell Command.      (line    6)
* Exit codes, table:                     Error Codes.        (line    6)
* Explicit fiscal year:                  Single commands.    (line   53)
* Explicit fiscal year <1>:              Single commands.    (line   62)
* Explicit fiscal year <2>:              Single commands.    (line   69)
* Export of local date variables:        Fixed date options. (line   28)
* Export of local date variables <1>:    Date variables.     (line  104)
* Export of local text variables:        Fixed date options. (line  121)
* Export of local text variables <1>:    Text variables.     (line  279)
* Extended file name:                    Resource file.      (line   78)
* Extended file name <1>:                Glossary.           (line  228)
* Extended help text:                    Common options.     (line   16)
* Extended language code information:    Internationalization.
                                                             (line  122)
* Extended language code information <1>: Glossary.          (line  234)
* External pager program:                Global options.     (line   48)
* Fajr prayer time:                      Glossary.           (line  239)
* Fajr, Islamic prayer time:             Sun data.           (line  313)
* File directory, actual:                Resource file.      (line   32)
* File name, extended:                   Resource file.      (line   78)
* File name, simple:                     Resource file.      (line   88)
* File searching mechanism:              Resource file.      (line    6)
* Filtration, days of fixed dates:       Fixed date options. (line  365)
* Filtration, fixed date texts:          Fixed date options. (line  398)
* Filtration, fixed date texts <1>:      Fixed date options. (line  422)
* Filtration, fixed date texts <2>:      Fixed date options. (line  427)
* Filtration, periods of fixed dates:    Fixed date options. (line  380)
* Fiscal year, explicit:                 Single commands.    (line   53)
* Fiscal year, explicit <1>:             Single commands.    (line   62)
* Fiscal year, explicit <2>:             Single commands.    (line   69)
* Fiscal year, implicit:                 Single commands.    (line   46)
* Fiscal year, limitations:              Further date part attributes.
                                                             (line   29)
* Fiscal year, limitations <1>:          Date variables.     (line   49)
* Fiscal year, single:                   Single commands.    (line   46)
* Fiscal year, single <1>:               Single commands.    (line   53)
* Fiscal year, single <2>:               Single commands.    (line   62)
* Fiscal year, single <3>:               Single commands.    (line   69)
* Fiscal years of the actual year, list: Lists of commands.  (line   49)
* Fiscal years, list:                    Lists of commands.  (line   31)
* Fiscal years, mixed list:              Lists of commands.  (line   43)
* Fiscal years, range:                   Ranges of commands. (line   49)
* Fixed date function, activate:         Fixed date options. (line  435)
* Fixed date function, activate <1>:     Fixed date options. (line  475)
* Fixed date function, activate <2>:     Fixed date options. (line  520)
* Fixed date function, activate <3>:     Fixed date options. (line  600)
* Fixed date list, alternative date format: Calendar options.
                                                             (line 1451)
* Fixed date list, special date format:  Calendar options.   (line 1458)
* Fixed date list, standard and special date format: Calendar options.
                                                             (line 1464)
* Fixed date list, suppression of leading blank line: Fixed date options.
                                                             (line  785)
* Fixed date list, suppression of title text: Fixed date options.
                                                             (line  815)
* Fixed date option class:               Options.            (line   13)
* Fixed date option class <1>:           Glossary.           (line  243)
* Fixed date option, --heading-text=TEXT: Fixed date options.
                                                             (line  818)
* Fixed date options:                    Fixed date options. (line    6)
* Fixed date period long-style option, --end-of-month: Fixed date options.
                                                             (line 1387)
* Fixed date period long-style option, --end-of-week: Fixed date options.
                                                             (line 1349)
* Fixed date period long-style option, --end-of-year: Fixed date options.
                                                             (line 1424)
* Fixed date period long-style option, --month: Fixed date options.
                                                             (line 1387)
* Fixed date period long-style option, --start-of-month: Fixed date options.
                                                             (line 1387)
* Fixed date period long-style option, --start-of-week: Fixed date options.
                                                             (line 1349)
* Fixed date period long-style option, --start-of-year: Fixed date options.
                                                             (line 1424)
* Fixed date period long-style option, --today: Fixed date options.
                                                             (line  435)
* Fixed date period long-style option, --tomorrow: Fixed date options.
                                                             (line 1337)
* Fixed date period long-style option, --week: Fixed date options.
                                                             (line 1349)
* Fixed date period long-style option, --year: Fixed date options.
                                                             (line 1424)
* Fixed date period modifier, *dN:       Fixed date options. (line  901)
* Fixed date period modifier, *dNWWW:    Fixed date options. (line 1037)
* Fixed date period modifier, *wN[WWW]:  Fixed date options. (line 1089)
* Fixed date period modifier, 0MMDD:     Fixed date options. (line 1001)
* Fixed date period modifier, @DVAR[+|-]NWWW: Fixed date options.
                                                             (line 1309)
* Fixed date period modifier, @DVAR[[+|-]N]: Fixed date options.
                                                             (line 1277)
* Fixed date period modifier, @e[+|-]NWWW: Fixed date options.
                                                             (line 1196)
* Fixed date period modifier, @e[[+|-]N]: Fixed date options.
                                                             (line 1163)
* Fixed date period modifier, @t[+|-]NWWW: Fixed date options.
                                                             (line 1251)
* Fixed date period modifier, @t[[+|-]N]: Fixed date options.
                                                             (line 1222)
* Fixed date period modifier, d:         Fixed date options. (line  586)
* Fixed date period modifier, d <1>:     Fixed date options. (line  884)
* Fixed date period modifier, l:         Fixed date options. (line  586)
* Fixed date period modifier, l <1>:     Fixed date options. (line  890)
* Fixed date period modifier, l*dN:      Fixed date options. (line  914)
* Fixed date period modifier, l*dNWWW:   Fixed date options. (line 1060)
* Fixed date period modifier, l*wN[WWW]: Fixed date options. (line 1123)
* Fixed date period modifier, l@DVAR[+|-]NWWW: Fixed date options.
                                                             (line 1321)
* Fixed date period modifier, l@DVAR[[+|-]N]: Fixed date options.
                                                             (line 1292)
* Fixed date period modifier, l@e[+|-]NWWW: Fixed date options.
                                                             (line 1208)
* Fixed date period modifier, l@e[[+|-]N]: Fixed date options.
                                                             (line 1178)
* Fixed date period modifier, l@t[+|-]NWWW: Fixed date options.
                                                             (line 1263)
* Fixed date period modifier, l@t[[+|-]N]: Fixed date options.
                                                             (line 1236)
* Fixed date period modifier, lMMWWWN:   Fixed date options. (line 1023)
* Fixed date period modifier, lN+|-:     Fixed date options. (line  933)
* Fixed date period modifier, lNd:       Fixed date options. (line  914)
* Fixed date period modifier, lNw:       Fixed date options. (line  976)
* Fixed date period modifier, MMDD:      Fixed date options. (line  994)
* Fixed date period modifier, MMWWWN:    Fixed date options. (line 1012)
* Fixed date period modifier, m|M[+|-]:  Fixed date options. (line 1387)
* Fixed date period modifier, N+|-:      Fixed date options. (line  923)
* Fixed date period modifier, Nd:        Fixed date options. (line  901)
* Fixed date period modifier, Nw:        Fixed date options. (line  946)
* Fixed date period modifier, t|T:       Fixed date options. (line 1337)
* Fixed date period modifier, w|W[+|-]:  Fixed date options. (line 1349)
* Fixed date period modifier, y|Y[+|-]:  Fixed date options. (line 1424)
* Fixed date period modifiers and options: Fixed date options.
                                                             (line  866)
* Fixed date period option, --leap-day=february: Fixed date options.
                                                             (line  873)
* Fixed date period option, --leap-day=february|march: Fixed date options.
                                                             (line  586)
* Fixed date period option, --leap-day=february|march <1>: Fixed date options.
                                                             (line  869)
* Fixed date period option, --leap-day=march: Fixed date options.
                                                             (line  878)
* Fixed date text modifier, a:           Fixed date options. (line  675)
* Fixed date text modifier, A:           Fixed date options. (line  684)
* Fixed date text modifier, alternative list format: Fixed date options.
                                                             (line  684)
* Fixed date text modifier, e:           Fixed date options. (line  699)
* Fixed date text modifier, E:           Fixed date options. (line  704)
* Fixed date text modifier, g[TEXT]:     Fixed date options. (line  709)
* Fixed date text modifier, J:           Fixed date options. (line  805)
* Fixed date text modifier, k:           Fixed date options. (line  765)
* Fixed date text modifier, o:           Fixed date options. (line  773)
* Fixed date text modifier, Q:           Fixed date options. (line  785)
* Fixed date text modifier, U:           Fixed date options. (line  795)
* Fixed date text modifier, x:           Fixed date options. (line  815)
* Fixed date text modifier, z:           Fixed date options. (line  859)
* Fixed date text modifier, Z:           Fixed date options. (line  863)
* Fixed date text modifiers:             Fixed date options. (line  620)
* Fixed date text option, --biorhythm-axis=NUMBER: Fixed date options.
                                                             (line  623)
* Fixed date text option, --moonimage-lines=NUMBER: Fixed date options.
                                                             (line  652)
* Fixed date texts, filtration:          Fixed date options. (line  398)
* Fixed date texts, filtration <1>:      Fixed date options. (line  422)
* Fixed date texts, filtration <2>:      Fixed date options. (line  427)
* Fixed date, ending date:               Inclusive date period.
                                                             (line   31)
* Fixed date, ending date <1>:           Exclusive date period.
                                                             (line   32)
* Fixed date, line structure:            Structure of resource file.
                                                             (line   32)
* Fixed date, option:                    Fixed date options. (line  435)
* Fixed date, option <1>:                Fixed date options. (line  600)
* Fixed date, starting date:             Inclusive date period.
                                                             (line   11)
* Fixed date, starting date <1>:         Exclusive date period.
                                                             (line   12)
* Fixed dates:                           Fixed date options. (line  435)
* Fixed dates <1>:                       Fixed date options. (line  600)
* Fixed dates <2>:                       Fixed Dates.        (line    6)
* Fixed dates for the _month_:           Fixed date options. (line 1387)
* Fixed dates for the _week_:            Fixed date options. (line 1349)
* Fixed dates for the _year_:            Fixed date options. (line 1424)
* Fixed dates for _today_:               Fixed date options. (line  435)
* Fixed dates for _tomorrow_:            Fixed date options. (line 1337)
* Fixed dates, filtration of days:       Fixed date options. (line  365)
* Fixed dates, filtration of periods:    Fixed date options. (line  380)
* Fixed default date format texts:       Calendar options.   (line 1636)
* Fixed default date format texts <1>:   Table of Obsolete Date Formats.
                                                             (line    6)
* Fixed default date formats:            Calendar options.   (line 1636)
* Fixed format date text:                Textual date.       (line    6)
* Floating Point number:                 Glossary.           (line  563)
* Force line break-up:                   Fixed date options. (line  744)
* Force line break-up <1>:               Fixed date options. (line  838)
* Force line break-up in resource file:  Text part of a line.
                                                             (line   42)
* Force year calendar sheet:             Calendar options.   (line 1384)
* Forcing highlighting sequences:        Global options.     (line   91)
* Format elements:                       Calendar options.   (line 1670)
* Format elements <1>:                   Table of Obsolete Date Formats.
                                                             (line    6)
* Format elements, obsolete:             Obsolete Special Texts.
                                                             (line    6)
* Format instruction:                    Calendar options.   (line 1670)
* Format instruction <1>:                Special Texts processed.
                                                             (line    6)
* Format instruction <2>:                Text variables.     (line   59)
* Format instruction <3>:                Special Texts.      (line   20)
* Format instruction <4>:                Glossary.           (line  246)
* Format instruction, description:       Format Instruction. (line    6)
* Free Software Foundation:              Glossary.           (line  253)
* FSF:                                   Glossary.           (line  253)
* Full Moon phase:                       Calendar options.   (line   48)
* Further date part attributes:          Further date part attributes.
                                                             (line    6)
* Further resource file line:            Fixed date options. (line  520)
* GCAL environment variable:             Global options.     (line    8)
* GCAL environment variable <1>:         Global options.     (line   15)
* GCAL environment variable <2>:         The GCAL environment variable.
                                                             (line    6)
* GCAL environment variable <3>:         Environment Variables.
                                                             (line   10)
* Gcal Introduction:                     Gcal Introduction.  (line    6)
* gcal options:                          Options.            (line    6)
* Gcal Utilities:                        Gcal Utilities.     (line    6)
* gcal, options:                         Command line arguments.
                                                             (line    6)
* Gcal, preliminary remarks:             Preface.            (line    6)
* gcal2txt, options:                     Invoking gcal2txt.  (line    6)
* gcal2txt, utility:                     Invoking gcal2txt.  (line    6)
* GCALANSI environment variable:         Global options.     (line  182)
* GCALANSI environment variable <1>:     Environment Variables.
                                                             (line   41)
* GCALPATH environment variable:         Resource file.      (line   25)
* GCALPATH environment variable <1>:     Environment Variables.
                                                             (line   47)
* GCALPROG environment variable:         Invoking tcal.      (line   21)
* GCALPROG environment variable <1>:     Environment Variables.
                                                             (line   52)
* GCAL_COLUMNS environment variable:     Environment Variables.
                                                             (line   14)
* GCAL_DATE_FORMAT environment variable: Environment Variables.
                                                             (line   19)
* GCAL_LINES environment variable:       Environment Variables.
                                                             (line   25)
* GCAL_OPT environment variable:         The GCAL environment variable.
                                                             (line   24)
* GCAL_OPT environment variable <1>:     Environment Variables.
                                                             (line   10)
* GCAL_SYS_DATADIR environment variable: Resource file.      (line   50)
* GCAL_SYS_DATADIR environment variable <1>: Environment Variables.
                                                             (line   30)
* GCAL_USR_DATADIR environment variable: Resource file.      (line   38)
* GCAL_USR_DATADIR environment variable <1>: Environment Variables.
                                                             (line   35)
* General Public License:                Glossary.           (line  293)
* Geocentric data:                       Glossary.           (line  258)
* Geocentric data, Moon:                 Moon data.          (line  258)
* Geocentric data, Sun:                  Sun data.           (line  348)
* Geocentrical horizon:                  Glossary.           (line  262)
* Geographical data, more precise representation: Fixed date options.
                                                             (line  341)
* Geographical distance %b*0ARGUMENT special text: Geographical distance and course angle.
                                                             (line   18)
* Geographical distance %b*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  282)
* Geographical distance %b0ARGUMENT special text: Geographical distance and course angle.
                                                             (line   18)
* Geographical distance %b0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  279)
* Geographical distance and course angle %[FORMAT]bARGUMENT special texts: Special Texts Summary.
                                                             (line  277)
* Geographical distance and course angle %[FORMAT]b[ARGUMENT] special text: Geographical distance and course angle.
                                                             (line    6)
* Geographical distance and course angle, default mode: Geographical distance and course angle.
                                                             (line   49)
* Geographical distance and course angle, mode characters: Geographical distance and course angle.
                                                             (line   16)
* Geographical distance and course angle, style of representation: Geographical distance and course angle.
                                                             (line   16)
* Geometric horizon, Moon:               Moon data.          (line   71)
* Geometrical horizon:                   Glossary.           (line  268)
* Global date variable:                  Glossary.           (line  273)
* Global date variables, definition:     Fixed date options. (line    8)
* Global option class:                   Options.            (line   13)
* Global option class <1>:               Glossary.           (line  277)
* Global options:                        Global options.     (line    6)
* Global text variable:                  Glossary.           (line  280)
* Global text variables, definition:     Fixed date options. (line   33)
* Glossary:                              Glossary.           (line    6)
* Gnomon:                                Sun data.           (line   50)
* Gnomon <1>:                            Glossary.           (line  284)
* GNU:                                   Glossary.           (line  287)
* GNU specific regexp operators:         Regexp Operators.   (line  251)
* GNU style options:                     Options.            (line   21)
* GPL:                                   Glossary.           (line  293)
* Greenwich Mean time (GMT):             Calendar options.   (line 1491)
* Greenwich Mean time (GMT) <1>:         Moon phase.         (line    6)
* Greenwich Mean time (GMT) <2>:         Actual clocktime.   (line    6)
* Greenwich Mean time (GMT) <3>:         Actual clocktime.   (line  126)
* Greenwich Mean time (GMT) <4>:         Actual clocktime.   (line  145)
* Greenwich Mean time (GMT) <5>:         Actual clocktime.   (line  163)
* Greenwich Mean time (GMT) <6>:         Actual clocktime.   (line  179)
* Greenwich Mean time (GMT) <7>:         Actual clocktime.   (line  196)
* Greenwich Mean time (GMT) <8>:         Actual clocktime.   (line  213)
* Greenwich Mean time (GMT) <9>:         Julian day number.  (line    6)
* Greenwich Mean time (GMT) <10>:        Sun data.           (line  488)
* Greenwich Mean time (GMT) <11>:        Sun data.           (line 1079)
* Greenwich Mean time (GMT) <12>:        Moon data.          (line  453)
* Gregorian calendar:                    Glossary.           (line  296)
* Gregorian calendar, genesis:           Todays Calendar.    (line    6)
* Gregorian Reformation, set period:     Calendar options.   (line 1563)
* Grouping, (...) regexp:                Regexp Operators.   (line  186)
* Handling of non-printable characters in the text part: Text part of a line.
                                                             (line    6)
* Handling of NUL characters in the text part: Text part of a line.
                                                             (line   21)
* Handling of special character sequences in the text part: Text part of a line.
                                                             (line    6)
* Hebrew holidays in eternal holiday list: Calendar options. (line   86)
* Help text, extended:                   Common options.     (line   16)
* Help text, long:                       Common options.     (line   16)
* Help text, short:                      Common options.     (line    9)
* Help, online:                          Common options.     (line    9)
* Help, online <1>:                      Common options.     (line   16)
* Hexadecimal system:                    Glossary.           (line  302)
* Highest culmination point:             Glossary.           (line  307)
* Highest culmination point, Moon:       Moon data.          (line   58)
* Highest culmination point, Sun:        Sun data.           (line   50)
* Highlighting %? special texts:         Highlighting.       (line    6)
* Highlighting %? special texts <1>:     Special Texts Summary.
                                                             (line 1883)
* Highlighting sequence:                 Glossary.           (line  311)
* Highlighting sequences, disabling:     Global options.     (line  102)
* Highlighting sequences, forcing:       Global options.     (line   91)
* Highlighting sequences, setting:       Global options.     (line  107)
* Holiday list, eternal:                 Eternal Holidays.   (line    6)
* Holiday, legal:                        Preface.            (line  140)
* Holidays from the flexible Chinese calendar in eternal holiday list: Calendar options.
                                                             (line   67)
* Holidays from the flexible Japanese calendar in eternal holiday list: Calendar options.
                                                             (line   94)
* HOME environment variable:             Resource file.      (line   32)
* HOME environment variable <1>:         Environment Variables.
                                                             (line   61)
* Horizontal parallax:                   Glossary.           (line  318)
* Horizontal parallax, moon:             Moon data.          (line  258)
* Horizontal parallax, Sun:              Sun data.           (line  410)
* How to use regular expressions:        Regexp Usage.       (line    6)
* Hybrid calendar mode:                  Calendar options.   (line 1563)
* Hybrid calendar mode <1>:              Glossary.           (line  322)
* Ignoring case distinctions in regular expression: Fixed date options.
                                                             (line  422)
* Ignoring case distinctions in regular expression <1>: Regexp Operators.
                                                             (line  315)
* Ignoring case, regexp:                 Fixed date options. (line  422)
* Ignoring case, regexp <1>:             Regexp Operators.   (line  315)
* Implicit fiscal year:                  Single commands.    (line   46)
* Include directives:                    Structure of resource file.
                                                             (line   53)
* Include directives <1>:                Include directives. (line    6)
* Inclusive all holidays %x special text: Inclusive day period.
                                                             (line   14)
* Inclusive all holidays %x special text <1>: Special Texts Summary.
                                                             (line   25)
* Inclusive date period:                 Exclusions with date argument.
                                                             (line   11)
* Inclusive date period <1>:             Glossary.           (line  330)
* Inclusive date period %i[DATE][#[DATE]] special text: Inclusive date period.
                                                             (line    6)
* Inclusive date period %i[DATE][#[DATE]] special text <1>: Special Texts Summary.
                                                             (line   14)
* Inclusive day period:                  Exclusions without any argument.
                                                             (line   11)
* Inclusive day period <1>:              Glossary.           (line  330)
* Inclusive day period %? special texts: Inclusive day period.
                                                             (line    6)
* Inclusive day period %? special texts <1>: Special Texts Summary.
                                                             (line   20)
* Inclusive Friday %h special text:      Inclusive day period.
                                                             (line   30)
* Inclusive Friday %h special text <1>:  Special Texts Summary.
                                                             (line   40)
* Inclusive legal holidays %v special text: Inclusive day period.
                                                             (line   10)
* Inclusive legal holidays %v special text <1>: Special Texts Summary.
                                                             (line   22)
* Inclusive Monday %a special text:      Inclusive day period.
                                                             (line   18)
* Inclusive Monday %a special text <1>:  Special Texts Summary.
                                                             (line   28)
* Inclusive Monday...Friday %r special text: Inclusive day period.
                                                             (line   42)
* Inclusive Monday...Friday %r special text <1>: Special Texts Summary.
                                                             (line   52)
* Inclusive Monday...Thursday %q special text: Inclusive day period.
                                                             (line   39)
* Inclusive Monday...Thursday %q special text <1>: Special Texts Summary.
                                                             (line   49)
* Inclusive Saturday %l special text:    Inclusive day period.
                                                             (line   33)
* Inclusive Saturday %l special text <1>: Special Texts Summary.
                                                             (line   43)
* Inclusive Sunday %p special text:      Inclusive day period.
                                                             (line   36)
* Inclusive Sunday %p special text <1>:  Special Texts Summary.
                                                             (line   46)
* Inclusive Thursday %g special text:    Inclusive day period.
                                                             (line   27)
* Inclusive Thursday %g special text <1>: Special Texts Summary.
                                                             (line   37)
* Inclusive Tuesday %c special text:     Inclusive day period.
                                                             (line   21)
* Inclusive Tuesday %c special text <1>: Special Texts Summary.
                                                             (line   31)
* Inclusive Wednesday %f special text:   Inclusive day period.
                                                             (line   24)
* Inclusive Wednesday %f special text <1>: Special Texts Summary.
                                                             (line   34)
* Individual date format texts:          Calendar options.   (line 1658)
* Individual date format texts <1>:      Table of Obsolete Date Format Elements.
                                                             (line    6)
* Individual date formats:               Calendar options.   (line 1658)
* Integer number:                        Glossary.           (line  335)
* Internal pager, simple:                Global options.     (line   60)
* Internationalization aspects:          Internationalization.
                                                             (line    6)
* Interval expression:                   Glossary.           (line  338)
* Interval expressions, regexp:          Regexp Operators.   (line  235)
* Interval expressions, {EXPRESSION} regexp: Regexp Operators.
                                                             (line  235)
* Introduction, Gcal:                    Gcal Introduction.  (line    6)
* Invoking gcal:                         Invoking Gcal.      (line    6)
* Invoking gcal2txt:                     Invoking gcal2txt.  (line    6)
* Invoking tcal:                         Invoking tcal.      (line    6)
* Invoking txt2gcal:                     Invoking txt2gcal.  (line    6)
* Isha prayer time:                      Glossary.           (line  341)
* Isha, Islamic prayer time:             Sun data.           (line  327)
* Islamic calendar, civil:               Preface.            (line  163)
* Islamic calendar, religious:           Preface.            (line  163)
* Islamic holidays in eternal holiday list: Calendar options.
                                                             (line   89)
* Islamic prayer time, Asr:              Sun data.           (line   50)
* Islamic prayer time, Asr <1>:          Sun data.           (line  818)
* Islamic prayer time, Asr <2>:          Sun data.           (line  855)
* Islamic prayer time, Fajr:             Sun data.           (line  313)
* Islamic prayer time, Isha:             Sun data.           (line  327)
* Islamic prayer time, Maghrib:          Sun data.           (line  199)
* Islamic prayer time, Zuhr:             Sun data.           (line   50)
* Islamic prayer, direction to Makkah:   Geographical distance and course angle.
                                                             (line   86)
* ISO:                                   Glossary.           (line  346)
* ISO week number:                       Glossary.           (line  350)
* ISO-3166:                              Calendar options.   (line  145)
* ISO-3166 <1>:                          Internationalization.
                                                             (line  122)
* ISO-639:1988:                          Internationalization.
                                                             (line   46)
* ISO-6709:1983 co-ordinate:             Geographical distance and course angle.
                                                             (line   56)
* ISO-6709:1983 co-ordinate <1>:         Sun data.           (line 1027)
* ISO-6709:1983 co-ordinate <2>:         Moon data.          (line  821)
* ISO-8601:1988 week number:             Calendar options.   (line 1361)
* ISO-8601:1988 week number <1>:         Fixed date options. (line  765)
* ISO-8601:1988 week number <2>:         Fixed date options. (line  946)
* ISO-8601:1988 week number <3>:         Fixed date options. (line  976)
* ISO-8601:1988 week number <4>:         Fixed date options. (line 1089)
* ISO-8601:1988 week number <5>:         Fixed date options. (line 1123)
* ISO-8601:1988 week number <6>:         Date part of a line.
                                                             (line   57)
* ISO-8601:1988 week number <7>:         Week number.        (line    7)
* Japanese calendar:                     Preface.            (line  186)
* Japanese holidays in eternal holiday list: Calendar options.
                                                             (line  101)
* Julian calendar:                       Todays Calendar.    (line    6)
* Julian calendar <1>:                   Glossary.           (line  358)
* Julian date:                           Glossary.           (line  366)
* Julian day number:                     Glossary.           (line  366)
* Julian day number %[FORMAT]j[ARGUMENT] special text: Julian day number.
                                                             (line    6)
* Julian day number %[FORMAT]j[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  274)
* Julian Ephemeris date:                 Sun data.           (line  503)
* Julian Ephemeris date <1>:             Moon data.          (line  468)
* Julian Ephemeris date <2>:             Glossary.           (line  355)
* LANG environment variable:             Internationalization.
                                                             (line   34)
* LANG environment variable <1>:         Environment Variables.
                                                             (line   80)
* Language code information, extended:   Internationalization.
                                                             (line  122)
* Language code information, simple:     Internationalization.
                                                             (line   46)
* Language codes:                        Internationalization.
                                                             (line   46)
* LANGUAGE environment variable:         Internationalization.
                                                             (line   31)
* LANGUAGE environment variable <1>:     Environment Variables.
                                                             (line   66)
* LC_ALL environment variable:           Internationalization.
                                                             (line   32)
* LC_ALL environment variable <1>:       Environment Variables.
                                                             (line   71)
* LC_MESSAGES environment variable:      Internationalization.
                                                             (line   33)
* LC_MESSAGES environment variable <1>:  Environment Variables.
                                                             (line   76)
* Leap day:                              Fixed date options. (line  869)
* Leap day <1>:                          Glossary.           (line  374)
* Leap year:                             Glossary.           (line  377)
* Leap year rule as used by Eastern Orthodox churches: Calendar options.
                                                             (line 1320)
* Legal holiday:                         Preface.            (line  140)
* Legal holiday <1>:                     Glossary.           (line  387)
* Length preserving behavior of numerical text variables: Text variables.
                                                             (line  348)
* Limit sunrise and sunset to actual day: Fixed date options.
                                                             (line  173)
* Limitations concerning the assignment of special texts to text variables: Special Texts.
                                                             (line   20)
* Limitations in a resource file:        Global options.     (line  219)
* Limitations in a resource file <1>:    Structure of resource file.
                                                             (line    6)
* Limitations in a resource file <2>:    Text part of a line.
                                                             (line    6)
* Limitations in a resource file <3>:    Date variables.     (line    6)
* Limitations in the text part of a line: Text part of a line.
                                                             (line    6)
* Limitations of use of 3-Month modes:   Further date part attributes.
                                                             (line   29)
* Limitations of use of 3-Month modes <1>: Date variables.   (line   49)
* Limitations of use of fiscal years:    Further date part attributes.
                                                             (line   29)
* Limitations of use of fiscal years <1>: Date variables.    (line   49)
* Limitations, Moon oriented special texts: Moon data.       (line  947)
* Limitations, Sun oriented special texts: Sun data.         (line 1209)
* Line break-up character, ^:            Fixed date options. (line  398)
* Line break-up character, ^ <1>:        Fixed date options. (line  744)
* Line break-up character, ^ <2>:        Fixed date options. (line  838)
* Line break-up character, ^ <3>:        Text part of a line.
                                                             (line    6)
* Line break-up character, ^ <4>:        Text part of a line.
                                                             (line   58)
* Line break-up character, ~:            Fixed date options. (line  398)
* Line break-up character, ~ <1>:        Fixed date options. (line  744)
* Line break-up character, ~ <2>:        Fixed date options. (line  838)
* Line break-up character, ~ <3>:        Text part of a line.
                                                             (line    6)
* Line break-up character, ~ <4>:        Text part of a line.
                                                             (line   47)
* Line continuation character, \:        Text part of a line.
                                                             (line   28)
* Line structure of fixed date:          Structure of resource file.
                                                             (line   32)
* Line, date part:                       Date part of a line.
                                                             (line    6)
* LINES environment variable:            Environment Variables.
                                                             (line   25)
* List of all long-style option names:   Common options.     (line   25)
* List of fiscal years:                  Lists of commands.  (line   31)
* List of fiscal years of the actual year: Lists of commands.
                                                             (line   49)
* List of months in specified year:      Lists of commands.  (line   14)
* List of specified fiscal years:        Lists of commands.  (line   31)
* List of specified months of selected year: Lists of commands.
                                                             (line   20)
* List of specified months of the current year: Lists of commands.
                                                             (line    7)
* List of specified years:               Lists of commands.  (line   26)
* List of whitespace character:          Structure of resource file.
                                                             (line    6)
* Lists of commands:                     Commands.           (line    6)
* Lists of commands <1>:                 Lists of commands.  (line    6)
* Lists of commands <2>:                 Glossary.           (line  392)
* Lists of days:                         Lists of days.      (line    6)
* Lists of days, examples:               Lists of days.      (line   36)
* Lists of days, valid date parts:       Lists of days.      (line   28)
* Local date variable:                   Glossary.           (line  395)
* Local date variables:                  Date variables.     (line    6)
* Local date variables, definition:      Date variables.     (line    6)
* Local date variables, deletion:        Date variables.     (line   75)
* Local sidereal time:                   Glossary.           (line  401)
* Local star time:                       Glossary.           (line  401)
* Local text variable:                   Glossary.           (line  408)
* Local text variables:                  Text variables.     (line    6)
* Local text variables, definition:      Text variables.     (line    6)
* Local text variables, empty:           Text variables.     (line   55)
* Local text variables, empty <1>:       Text variables.     (line  242)
* Local time:                            Sun data.           (line 1079)
* Local time 12-hour format suffix, display: Actual clocktime.
                                                             (line  110)
* Local time hour, display:              Actual clocktime.   (line   78)
* Local time in HH:MM format, display:   Actual clocktime.   (line   23)
* Local time in M[M...] format, display: Actual clocktime.   (line   62)
* Local time minute, display:            Actual clocktime.   (line   94)
* LOGNAME environment variable:          Global options.     (line  207)
* LOGNAME environment variable <1>:      Environment Variables.
                                                             (line   84)
* Long help text:                        Common options.     (line   16)
* Long text part in resource file line:  Text part of a line.
                                                             (line   42)
* Long-style option:                     Options.            (line   21)
* Long-style option <1>:                 Glossary.           (line  413)
* Long-style option names, list:         Common options.     (line   25)
* Longer than double shadow length, period: Sun data.        (line  877)
* Longer than single shadow length, period: Sun data.        (line  840)
* Lowest culmination point:              Glossary.           (line  416)
* Lowest culmination point, Moon:        Moon data.          (line   38)
* Lowest culmination point, Sun:         Sun data.           (line   38)
* Lunar Arctic Circle:                   Moon data.          (line  980)
* Lunar Arctic Circle <1>:               Glossary.           (line  420)
* Lunar day length:                      Moon data.          (line    6)
* Lunar eclipse:                         Calendar options.   (line   48)
* Lunar night length:                    Moon data.          (line    6)
* Lunation:                              Glossary.           (line  426)
* Lunation, Moon:                        Moon data.          (line   38)
* Maghrib prayer time:                   Glossary.           (line  429)
* Maghrib, Islamic prayer time:          Sun data.           (line  199)
* Magnitude unit:                        Glossary.           (line  433)
* Magnitude units, Moon:                 Moon data.          (line  283)
* Mail, empty message body:              Global options.     (line  215)
* Mail, methods of sending:              Global options.     (line  194)
* Mail, sending:                         Global options.     (line  189)
* MAILPROG environment variable:         Global options.     (line  229)
* MAILPROG environment variable <1>:     Environment Variables.
                                                             (line   88)
* MAILTO environment variable:           Global options.     (line  197)
* MAILTO environment variable <1>:       Environment Variables.
                                                             (line   94)
* Management of date variables:          Fixed date options. (line    8)
* Management of date variables <1>:      Date variables.     (line    6)
* Management of text variables:          Fixed date options. (line   33)
* Management of text variables <1>:      Text variables.     (line    6)
* Marking character:                     Glossary.           (line  448)
* Marking characters, disabling:         Global options.     (line  102)
* Marking characters, setting:           Global options.     (line  107)
* Matching word boundaries in regexp:    Regexp Operators.   (line  278)
* Mathematical horizon:                  Glossary.           (line  268)
* Mathematical-geocentric horizon:       Glossary.           (line  268)
* Mathematical-geocentric horizon, Moon: Moon data.          (line   71)
* Mean Earth equator radius:             Glossary.           (line  452)
* Mean solar day:                        Sun data.           (line  508)
* Mean solar day <1>:                    Glossary.           (line  458)
* Mean solar time:                       Sun data.           (line  508)
* Mean solar time <1>:                   Glossary.           (line  458)
* Mean Sun:                              Sun data.           (line  508)
* Mean sun:                              Glossary.           (line  458)
* Meridian:                              Geographical distance and course angle.
                                                             (line    6)
* Meridian <1>:                          Glossary.           (line  467)
* Message catalog:                       Internationalization.
                                                             (line   11)
* Metacharacter, . regexp:               Regexp Operators.   (line   40)
* Metacharacter, \ regexp:               Regexp Operators.   (line   14)
* Metacharacters:                        Glossary.           (line  471)
* Metacharacters, regexp:                Regexp Operators.   (line    6)
* Metasymbols within this document, table: Metasymbols.      (line    6)
* Methods of sending Mail:               Global options.     (line  194)
* Midnight height:                       Glossary.           (line  474)
* Midnight height geocentric, Moon:      Moon data.          (line  730)
* Midnight height geocentric, Sun:       Sun data.           (line  761)
* Midnight height topocentric, Moon:     Moon data.          (line  654)
* Midnight height topocentric, Sun:      Sun data.           (line  713)
* Midnight phase angle:                  Glossary.           (line  478)
* Midnight phase angle geocentric, Moon: Moon data.          (line  737)
* Midnight phase angle topocentric, Moon: Moon data.         (line  661)
* Midnight time of Moon, astronomical:   Moon data.          (line   38)
* Midnight time of Sun, astronomical:    Sun data.           (line   38)
* Mixed list of fiscal years:            Lists of commands.  (line   43)
* Mixed list of months:                  Lists of commands.  (line   38)
* Mode characters, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   16)
* Mode characters, Moon data and times:  Moon data.          (line   23)
* Mode characters, Sun data and times:   Sun data.           (line   23)
* Modifier:                              Options.            (line   73)
* Modifier <1>:                          Glossary.           (line  482)
* Modifiers, fixed date period:          Fixed date options. (line  866)
* Modifiers, fixed date text:            Fixed date options. (line  620)
* Month %[FORMAT]M[DATE] special text:   Special Texts Summary.
                                                             (line  180)
* Month mode, selected:                  Single commands.    (line   11)
* Month mode, single:                    Single commands.    (line    7)
* Month name %[FORMAT]U[DATE] special text: Month name.      (line    6)
* Month name %[FORMAT]U[DATE] special text <1>: Special Texts Summary.
                                                             (line  172)
* Month number %>02&*M[DATE] special text: Month number.     (line   31)
* Month number %>02&*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  191)
* Month number %>02*M[DATE] special text: Month number.      (line   15)
* Month number %>02*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  185)
* Month number %>1&*M[DATE] special text: Month number.      (line   23)
* Month number %>1&*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  188)
* Month number %M[DATE] special text:    Month number.       (line    7)
* Month number %M[DATE] special text <1>: Special Texts Summary.
                                                             (line  182)
* Month number %[FORMAT]M[DATE] special text: Month number.  (line    6)
* Months from the Baha''i` calendar in eternal holiday list: Calendar options.
                                                             (line 1204)
* Months from the Chinese calendar in eternal holiday list: Calendar options.
                                                             (line 1217)
* Months from the civil Indian calendar in eternal holiday list: Calendar options.
                                                             (line 1243)
* Months from the civil Islamic calendar in eternal holiday list: Calendar options.
                                                             (line 1248)
* Months from the Coptic calendar in eternal holiday list: Calendar options.
                                                             (line 1223)
* Months from the Ethiopic calendar in eternal holiday list: Calendar options.
                                                             (line 1228)
* Months from the flexible Chinese calendar in eternal holiday list: Calendar options.
                                                             (line 1210)
* Months from the flexible Japanese calendar in eternal holiday list: Calendar options.
                                                             (line 1255)
* Months from the French Revolutionary calendar in eternal holiday list: Calendar options.
                                                             (line 1233)
* Months from the Hebrew calendar in eternal holiday list: Calendar options.
                                                             (line 1238)
* Months from the Japanese calendar in eternal holiday list: Calendar options.
                                                             (line 1262)
* Months from the Old-Armenic calendar in eternal holiday list: Calendar options.
                                                             (line 1268)
* Months from the Old-Egyptic calendar in eternal holiday list: Calendar options.
                                                             (line 1273)
* Months from the Persian Jalaali calendar in eternal holiday list: Calendar options.
                                                             (line 1278)
* Months in specified year, list:        Lists of commands.  (line   14)
* Months of year, range:                 Ranges of commands. (line   15)
* Months' fixed dates:                   Fixed date options. (line 1387)
* Months, mixed list:                    Lists of commands.  (line   38)
* Moon data %[FORMAT]?ARGUMENT special texts: Moon data.     (line    6)
* Moon data %[FORMAT]?ARGUMENT special texts <1>: Special Texts Summary.
                                                             (line 1117)
* Moon data and times, default mode:     Moon data.          (line  806)
* Moon data and times, mode characters:  Moon data.          (line   23)
* Moon data and times, special event oriented texts: Sun data.
                                                             (line  939)
* Moon data and times, style of representation: Sun data.    (line  890)
* Moon data and times, style of representation <1>: Moon data.
                                                             (line  813)
* Moon data and times, type of representation: Sun data.     (line  890)
* Moon data and times, type of representation <1>: Moon data.
                                                             (line  813)
* Moon oriented special texts, limitations: Moon data.       (line  947)
* Moon oriented special texts, reference systems used: Moon data.
                                                             (line  947)
* Moon oriented special texts, table of modes: Moon data.    (line   35)
* Moon oriented special texts, table of representation types: Moon data.
                                                             (line  841)
* Moon phase %[FORMAT]?[DATE] special texts: Moon phase.     (line    6)
* Moon phase %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  203)
* Moon phase text %>03*O[DATE] special text: Moon phase.     (line   30)
* Moon phase text %>03*O[DATE] special text <1>: Special Texts Summary.
                                                             (line  208)
* Moon phase text %O[DATE] special text: Moon phase.         (line   15)
* Moon phase text %O[DATE] special text <1>: Special Texts Summary.
                                                             (line  205)
* Moon phase text graphics %Z[DATE] special text: Moon phase.
                                                             (line   45)
* Moon phase text graphics %Z[DATE] special text <1>: Special Texts Summary.
                                                             (line  211)
* Moon phase, Full:                      Calendar options.   (line   48)
* Moon phase, New:                       Calendar options.   (line   48)
* Moon phase, waning Half:               Calendar options.   (line   48)
* Moon phase, waxing Half:               Calendar options.   (line   48)
* Moon's center, geocentric brightness %(*lARGUMENT special text: Moon data.
                                                             (line  377)
* Moon's center, geocentric brightness %(lARGUMENT special text: Moon data.
                                                             (line  377)
* Moon's center, geocentric brightness %)*lARGUMENT special text: Moon data.
                                                             (line  377)
* Moon's center, geocentric brightness %)lARGUMENT special text: Moon data.
                                                             (line  377)
* Moon's center, geocentric horizontal parallax %(*jARGUMENT special text: Moon data.
                                                             (line  369)
* Moon's center, geocentric horizontal parallax %(jARGUMENT special text: Moon data.
                                                             (line  369)
* Moon's center, geocentric horizontal parallax %)*jARGUMENT special text: Moon data.
                                                             (line  369)
* Moon's center, geocentric horizontal parallax %)jARGUMENT special text: Moon data.
                                                             (line  369)
* Moon's center, geocentric phase angle %(*mARGUMENT special text: Moon data.
                                                             (line  381)
* Moon's center, geocentric phase angle %(mARGUMENT special text: Moon data.
                                                             (line  381)
* Moon's center, geocentric phase angle %)*mARGUMENT special text: Moon data.
                                                             (line  381)
* Moon's center, geocentric phase angle %)mARGUMENT special text: Moon data.
                                                             (line  381)
* Moon's center, geocentric semidiameter %(*kARGUMENT special text: Moon data.
                                                             (line  373)
* Moon's center, geocentric semidiameter %(kARGUMENT special text: Moon data.
                                                             (line  373)
* Moon's center, geocentric semidiameter %)*kARGUMENT special text: Moon data.
                                                             (line  373)
* Moon's center, geocentric semidiameter %)kARGUMENT special text: Moon data.
                                                             (line  373)
* Moon's center, geometrical non-visibility %]*2ARGUMENT special text: Moon data.
                                                             (line  106)
* Moon's center, geometrical non-visibility %]*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1165)
* Moon's center, geometrical non-visibility %]2ARGUMENT special text: Moon data.
                                                             (line  106)
* Moon's center, geometrical non-visibility %]2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1161)
* Moon's center, geometrical rise time %(*2ARGUMENT special text: Moon data.
                                                             (line   71)
* Moon's center, geometrical rise time %(*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1141)
* Moon's center, geometrical rise time %(2ARGUMENT special text: Moon data.
                                                             (line   71)
* Moon's center, geometrical rise time %(2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1137)
* Moon's center, geometrical set time %)*2ARGUMENT special text: Moon data.
                                                             (line   91)
* Moon's center, geometrical set time %)*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1149)
* Moon's center, geometrical set time %)2ARGUMENT special text: Moon data.
                                                             (line   91)
* Moon's center, geometrical set time %)2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1145)
* Moon's center, geometrical visibility %[*2ARGUMENT special text: Moon data.
                                                             (line  101)
* Moon's center, geometrical visibility %[*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1157)
* Moon's center, geometrical visibility %[2ARGUMENT special text: Moon data.
                                                             (line  101)
* Moon's center, geometrical visibility %[2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1153)
* Moon's center, non-visibility %]*4ARGUMENT special text: Moon data.
                                                             (line  190)
* Moon's center, non-visibility %]*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1229)
* Moon's center, non-visibility %]4ARGUMENT special text: Moon data.
                                                             (line  190)
* Moon's center, non-visibility %]4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1225)
* Moon's center, rise time %(*4ARGUMENT special text: Moon data.
                                                             (line  148)
* Moon's center, rise time %(*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1206)
* Moon's center, rise time %(4ARGUMENT special text: Moon data.
                                                             (line  148)
* Moon's center, rise time %(4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1203)
* Moon's center, set time %)*4ARGUMENT special text: Moon data.
                                                             (line  169)
* Moon's center, set time %)*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1213)
* Moon's center, set time %)4ARGUMENT special text: Moon data.
                                                             (line  169)
* Moon's center, set time %)4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1210)
* Moon's center, topocentric brightness %(*8ARGUMENT special text: Moon data.
                                                             (line  283)
* Moon's center, topocentric brightness %(8ARGUMENT special text: Moon data.
                                                             (line  283)
* Moon's center, topocentric brightness %)*8ARGUMENT special text: Moon data.
                                                             (line  283)
* Moon's center, topocentric brightness %)8ARGUMENT special text: Moon data.
                                                             (line  283)
* Moon's center, topocentric horizontal parallax %(*6ARGUMENT special text: Moon data.
                                                             (line  258)
* Moon's center, topocentric horizontal parallax %(6ARGUMENT special text: Moon data.
                                                             (line  258)
* Moon's center, topocentric horizontal parallax %)*6ARGUMENT special text: Moon data.
                                                             (line  258)
* Moon's center, topocentric horizontal parallax %)6ARGUMENT special text: Moon data.
                                                             (line  258)
* Moon's center, topocentric phase angle %(*9ARGUMENT special text: Moon data.
                                                             (line  298)
* Moon's center, topocentric phase angle %(9ARGUMENT special text: Moon data.
                                                             (line  298)
* Moon's center, topocentric phase angle %)*9ARGUMENT special text: Moon data.
                                                             (line  298)
* Moon's center, topocentric phase angle %)9ARGUMENT special text: Moon data.
                                                             (line  298)
* Moon's center, topocentric semidiameter %(*7ARGUMENT special text: Moon data.
                                                             (line  279)
* Moon's center, topocentric semidiameter %(7ARGUMENT special text: Moon data.
                                                             (line  279)
* Moon's center, topocentric semidiameter %)*7ARGUMENT special text: Moon data.
                                                             (line  279)
* Moon's center, topocentric semidiameter %)7ARGUMENT special text: Moon data.
                                                             (line  279)
* Moon's center, visibility %[*4ARGUMENT special text: Moon data.
                                                             (line  185)
* Moon's center, visibility %[*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1221)
* Moon's center, visibility %[4ARGUMENT special text: Moon data.
                                                             (line  185)
* Moon's center, visibility %[4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1217)
* Moon's upper limb, geometrical non-visibility %]*3ARGUMENT special text: Moon data.
                                                             (line  143)
* Moon's upper limb, geometrical non-visibility %]*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1199)
* Moon's upper limb, geometrical non-visibility %]3ARGUMENT special text: Moon data.
                                                             (line  143)
* Moon's upper limb, geometrical non-visibility %]3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1195)
* Moon's upper limb, geometrical rise time %(*3ARGUMENT special text: Moon data.
                                                             (line  111)
* Moon's upper limb, geometrical rise time %(*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1173)
* Moon's upper limb, geometrical rise time %(3ARGUMENT special text: Moon data.
                                                             (line  111)
* Moon's upper limb, geometrical rise time %(3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1169)
* Moon's upper limb, geometrical set time %)*3ARGUMENT special text: Moon data.
                                                             (line  127)
* Moon's upper limb, geometrical set time %)*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1182)
* Moon's upper limb, geometrical set time %)3ARGUMENT special text: Moon data.
                                                             (line  127)
* Moon's upper limb, geometrical set time %)3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1177)
* Moon's upper limb, geometrical visibility %[*3ARGUMENT special text: Moon data.
                                                             (line  138)
* Moon's upper limb, geometrical visibility %[*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1191)
* Moon's upper limb, geometrical visibility %[3ARGUMENT special text: Moon data.
                                                             (line  138)
* Moon's upper limb, geometrical visibility %[3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1187)
* Moon's upper limb, non-visibility standard %]*5ARGUMENT special text: Special Texts Summary.
                                                             (line 1261)
* Moon's upper limb, non-visibility standard %]5ARGUMENT special text: Special Texts Summary.
                                                             (line 1257)
* Moon's upper limb, standard non-visibility %]*5ARGUMENT special text: Moon data.
                                                             (line  250)
* Moon's upper limb, standard non-visibility %]5ARGUMENT special text: Moon data.
                                                             (line  250)
* Moon's upper limb, standard rise time %(*5ARGUMENT special text: Moon data.
                                                             (line  195)
* Moon's upper limb, standard rise time %(*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1237)
* Moon's upper limb, standard rise time %(5ARGUMENT special text: Moon data.
                                                             (line  195)
* Moon's upper limb, standard rise time %(5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1233)
* Moon's upper limb, standard set time %)*5ARGUMENT special text: Moon data.
                                                             (line  223)
* Moon's upper limb, standard set time %)*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1245)
* Moon's upper limb, standard set time %)5ARGUMENT special text: Moon data.
                                                             (line  223)
* Moon's upper limb, standard set time %)5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1241)
* Moon's upper limb, standard visibility %[*5ARGUMENT special text: Moon data.
                                                             (line  242)
* Moon's upper limb, standard visibility %[5ARGUMENT special text: Moon data.
                                                             (line  242)
* Moon's upper limb, visibility standard %[*5ARGUMENT special text: Special Texts Summary.
                                                             (line 1253)
* Moon's upper limb, visibility standard %[5ARGUMENT special text: Special Texts Summary.
                                                             (line 1249)
* Moon, astronomical midnight time %(*0ARGUMENT special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time %(*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1124)
* Moon, astronomical midnight time %(0ARGUMENT special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time %(0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1120)
* Moon, astronomical midnight time %)*0ARGUMENT special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time %)*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1124)
* Moon, astronomical midnight time %)0ARGUMENT special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time %)0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1120)
* Moon, astronomical noon time %(*1ARGUMENT special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time %(*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1133)
* Moon, astronomical noon time %(1ARGUMENT special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time %(1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1129)
* Moon, astronomical noon time %)*1ARGUMENT special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time %)*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1133)
* Moon, astronomical noon time %)1ARGUMENT special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time %)1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1129)
* Moon, azimuth:                         Moon data.          (line   38)
* Moon, base time %(*xARGUMENT special text: Moon data.      (line  453)
* Moon, base time %(*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1529)
* Moon, base time %(xARGUMENT special text: Moon data.       (line  453)
* Moon, base time %(xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, base time %)*xARGUMENT special text: Moon data.      (line  453)
* Moon, base time %)*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1529)
* Moon, base time %)xARGUMENT special text: Moon data.       (line  453)
* Moon, base time %)xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, conjunction:                     Moon data.          (line   38)
* Moon, delta-t %(*vARGUMENT special text: Moon data.        (line  431)
* Moon, delta-t %(*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1511)
* Moon, delta-t %(vARGUMENT special text: Moon data.         (line  431)
* Moon, delta-t %(vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1511)
* Moon, delta-t %)*vARGUMENT special text: Moon data.        (line  431)
* Moon, delta-t %)*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1511)
* Moon, delta-t %)vARGUMENT special text: Moon data.         (line  431)
* Moon, delta-t %)vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1511)
* Moon, geocentric azimuth %(*oARGUMENT special text: Moon data.
                                                             (line  393)
* Moon, geocentric azimuth %(*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1445)
* Moon, geocentric azimuth %(oARGUMENT special text: Moon data.
                                                             (line  393)
* Moon, geocentric azimuth %(oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1440)
* Moon, geocentric azimuth %)*oARGUMENT special text: Moon data.
                                                             (line  393)
* Moon, geocentric azimuth %)*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1445)
* Moon, geocentric azimuth %)oARGUMENT special text: Moon data.
                                                             (line  393)
* Moon, geocentric azimuth %)oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1440)
* Moon, geocentric azimuth at standard rise time %(*XARGUMENT special text: Moon data.
                                                             (line  772)
* Moon, geocentric azimuth at standard rise time %(*XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1836)
* Moon, geocentric azimuth at standard rise time %(XARGUMENT special text: Moon data.
                                                             (line  772)
* Moon, geocentric azimuth at standard rise time %(XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1832)
* Moon, geocentric azimuth at standard set time %)*XARGUMENT special text: Moon data.
                                                             (line  782)
* Moon, geocentric azimuth at standard set time %)*XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1844)
* Moon, geocentric azimuth at standard set time %)XARGUMENT special text: Moon data.
                                                             (line  782)
* Moon, geocentric azimuth at standard set time %)XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1840)
* Moon, geocentric brightness %(*lARGUMENT special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric brightness %(lARGUMENT special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric brightness %)*lARGUMENT special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric brightness %)lARGUMENT special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric data:                 Moon data.          (line  258)
* Moon, geocentric declination %(*pARGUMENT special text: Moon data.
                                                             (line  397)
* Moon, geocentric declination %(*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1455)
* Moon, geocentric declination %(pARGUMENT special text: Moon data.
                                                             (line  397)
* Moon, geocentric declination %(pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1450)
* Moon, geocentric declination %)*pARGUMENT special text: Moon data.
                                                             (line  397)
* Moon, geocentric declination %)*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1455)
* Moon, geocentric declination %)pARGUMENT special text: Moon data.
                                                             (line  397)
* Moon, geocentric declination %)pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1450)
* Moon, geocentric distance %(*tARGUMENT special text: Moon data.
                                                             (line  423)
* Moon, geocentric distance %(*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1495)
* Moon, geocentric distance %(tARGUMENT special text: Moon data.
                                                             (line  423)
* Moon, geocentric distance %(tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, geocentric distance %)*tARGUMENT special text: Moon data.
                                                             (line  423)
* Moon, geocentric distance %)*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1495)
* Moon, geocentric distance %)tARGUMENT special text: Moon data.
                                                             (line  423)
* Moon, geocentric distance %)tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, geocentric ecliptic latitude %(*rARGUMENT special text: Moon data.
                                                             (line  410)
* Moon, geocentric ecliptic latitude %(*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1475)
* Moon, geocentric ecliptic latitude %(rARGUMENT special text: Moon data.
                                                             (line  410)
* Moon, geocentric ecliptic latitude %(rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1470)
* Moon, geocentric ecliptic latitude %)*rARGUMENT special text: Moon data.
                                                             (line  410)
* Moon, geocentric ecliptic latitude %)*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1475)
* Moon, geocentric ecliptic latitude %)rARGUMENT special text: Moon data.
                                                             (line  410)
* Moon, geocentric ecliptic latitude %)rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1470)
* Moon, geocentric ecliptic longitude %(*qARGUMENT special text: Moon data.
                                                             (line  406)
* Moon, geocentric ecliptic longitude %(*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1465)
* Moon, geocentric ecliptic longitude %(qARGUMENT special text: Moon data.
                                                             (line  406)
* Moon, geocentric ecliptic longitude %(qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1460)
* Moon, geocentric ecliptic longitude %)*qARGUMENT special text: Moon data.
                                                             (line  406)
* Moon, geocentric ecliptic longitude %)*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1465)
* Moon, geocentric ecliptic longitude %)qARGUMENT special text: Moon data.
                                                             (line  406)
* Moon, geocentric ecliptic longitude %)qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1460)
* Moon, geocentric elevation %(*nARGUMENT special text: Moon data.
                                                             (line  385)
* Moon, geocentric elevation %(*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1435)
* Moon, geocentric elevation %(nARGUMENT special text: Moon data.
                                                             (line  385)
* Moon, geocentric elevation %(nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1430)
* Moon, geocentric elevation %)*nARGUMENT special text: Moon data.
                                                             (line  385)
* Moon, geocentric elevation %)*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1435)
* Moon, geocentric elevation %)nARGUMENT special text: Moon data.
                                                             (line  385)
* Moon, geocentric elevation %)nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1430)
* Moon, geocentric elevation at Moon's astronomical midnight time %(*SARGUMENT special text: Moon data.
                                                             (line  730)
* Moon, geocentric elevation at Moon's astronomical midnight time %(*SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1782)
* Moon, geocentric elevation at Moon's astronomical midnight time %(SARGUMENT special text: Moon data.
                                                             (line  730)
* Moon, geocentric elevation at Moon's astronomical midnight time %(SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1777)
* Moon, geocentric elevation at Moon's astronomical midnight time %)*SARGUMENT special text: Moon data.
                                                             (line  730)
* Moon, geocentric elevation at Moon's astronomical midnight time %)*SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1782)
* Moon, geocentric elevation at Moon's astronomical midnight time %)SARGUMENT special text: Moon data.
                                                             (line  730)
* Moon, geocentric elevation at Moon's astronomical midnight time %)SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1777)
* Moon, geocentric elevation at Moon's astronomical noon time %(*UARGUMENT special text: Moon data.
                                                             (line  744)
* Moon, geocentric elevation at Moon's astronomical noon time %(*UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1802)
* Moon, geocentric elevation at Moon's astronomical noon time %(UARGUMENT special text: Moon data.
                                                             (line  744)
* Moon, geocentric elevation at Moon's astronomical noon time %(UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1797)
* Moon, geocentric elevation at Moon's astronomical noon time %)*UARGUMENT special text: Moon data.
                                                             (line  744)
* Moon, geocentric elevation at Moon's astronomical noon time %)*UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1802)
* Moon, geocentric elevation at Moon's astronomical noon time %)UARGUMENT special text: Moon data.
                                                             (line  744)
* Moon, geocentric elevation at Moon's astronomical noon time %)UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1797)
* Moon, geocentric elevation at standard rise time %(*WARGUMENT special text: Moon data.
                                                             (line  758)
* Moon, geocentric elevation at standard rise time %(*WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1820)
* Moon, geocentric elevation at standard rise time %(WARGUMENT special text: Moon data.
                                                             (line  758)
* Moon, geocentric elevation at standard rise time %(WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1816)
* Moon, geocentric elevation at standard set time %)*WARGUMENT special text: Moon data.
                                                             (line  765)
* Moon, geocentric elevation at standard set time %)*WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1828)
* Moon, geocentric elevation at standard set time %)WARGUMENT special text: Moon data.
                                                             (line  765)
* Moon, geocentric elevation at standard set time %)WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1824)
* Moon, geocentric elongation %(*uARGUMENT special text: Moon data.
                                                             (line  427)
* Moon, geocentric elongation %(*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1504)
* Moon, geocentric elongation %(uARGUMENT special text: Moon data.
                                                             (line  427)
* Moon, geocentric elongation %(uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1499)
* Moon, geocentric elongation %)*uARGUMENT special text: Moon data.
                                                             (line  427)
* Moon, geocentric elongation %)*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1504)
* Moon, geocentric elongation %)uARGUMENT special text: Moon data.
                                                             (line  427)
* Moon, geocentric elongation %)uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1499)
* Moon, geocentric horizontal parallax %(*jARGUMENT special text: Special Texts Summary.
                                                             (line 1397)
* Moon, geocentric horizontal parallax %(jARGUMENT special text: Special Texts Summary.
                                                             (line 1392)
* Moon, geocentric horizontal parallax %)*jARGUMENT special text: Special Texts Summary.
                                                             (line 1397)
* Moon, geocentric horizontal parallax %)jARGUMENT special text: Special Texts Summary.
                                                             (line 1392)
* Moon, geocentric phase angle %(*mARGUMENT special text: Special Texts Summary.
                                                             (line 1425)
* Moon, geocentric phase angle %(mARGUMENT special text: Special Texts Summary.
                                                             (line 1420)
* Moon, geocentric phase angle %)*mARGUMENT special text: Special Texts Summary.
                                                             (line 1425)
* Moon, geocentric phase angle %)mARGUMENT special text: Special Texts Summary.
                                                             (line 1420)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(*TARGUMENT special text: Moon data.
                                                             (line  737)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(*TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1792)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(TARGUMENT special text: Moon data.
                                                             (line  737)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1787)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)*TARGUMENT special text: Moon data.
                                                             (line  737)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)*TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1792)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)TARGUMENT special text: Moon data.
                                                             (line  737)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1787)
* Moon, geocentric phase angle at Moon's astronomical noon time %(*VARGUMENT special text: Moon data.
                                                             (line  751)
* Moon, geocentric phase angle at Moon's astronomical noon time %(*VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1812)
* Moon, geocentric phase angle at Moon's astronomical noon time %(VARGUMENT special text: Moon data.
                                                             (line  751)
* Moon, geocentric phase angle at Moon's astronomical noon time %(VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1807)
* Moon, geocentric phase angle at Moon's astronomical noon time %)*VARGUMENT special text: Moon data.
                                                             (line  751)
* Moon, geocentric phase angle at Moon's astronomical noon time %)*VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1812)
* Moon, geocentric phase angle at Moon's astronomical noon time %)VARGUMENT special text: Moon data.
                                                             (line  751)
* Moon, geocentric phase angle at Moon's astronomical noon time %)VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1807)
* Moon, geocentric phase angle at standard rise time %(*YARGUMENT special text: Moon data.
                                                             (line  792)
* Moon, geocentric phase angle at standard rise time %(*YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1853)
* Moon, geocentric phase angle at standard rise time %(YARGUMENT special text: Moon data.
                                                             (line  792)
* Moon, geocentric phase angle at standard rise time %(YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1848)
* Moon, geocentric phase angle at standard set time %)*YARGUMENT special text: Moon data.
                                                             (line  799)
* Moon, geocentric phase angle at standard set time %)*YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1862)
* Moon, geocentric phase angle at standard set time %)YARGUMENT special text: Moon data.
                                                             (line  799)
* Moon, geocentric phase angle at standard set time %)YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1857)
* Moon, geocentric right ascension %(*sARGUMENT special text: Moon data.
                                                             (line  419)
* Moon, geocentric right ascension %(*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1485)
* Moon, geocentric right ascension %(sARGUMENT special text: Moon data.
                                                             (line  419)
* Moon, geocentric right ascension %(sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1480)
* Moon, geocentric right ascension %)*sARGUMENT special text: Moon data.
                                                             (line  419)
* Moon, geocentric right ascension %)*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1485)
* Moon, geocentric right ascension %)sARGUMENT special text: Moon data.
                                                             (line  419)
* Moon, geocentric right ascension %)sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1480)
* Moon, geocentric semidiameter %(*kARGUMENT special text: Special Texts Summary.
                                                             (line 1407)
* Moon, geocentric semidiameter %(kARGUMENT special text: Special Texts Summary.
                                                             (line 1402)
* Moon, geocentric semidiameter %)*kARGUMENT special text: Special Texts Summary.
                                                             (line 1407)
* Moon, geocentric semidiameter %)kARGUMENT special text: Special Texts Summary.
                                                             (line 1402)
* Moon, geometric horizon:               Moon data.          (line   71)
* Moon, highest culmination point:       Moon data.          (line   58)
* Moon, Julian date %(*yARGUMENT special text: Moon data.    (line  463)
* Moon, Julian date %(*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1535)
* Moon, Julian date %(yARGUMENT special text: Moon data.     (line  463)
* Moon, Julian date %(yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1535)
* Moon, Julian date %)*yARGUMENT special text: Moon data.    (line  463)
* Moon, Julian date %)*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1535)
* Moon, Julian date %)yARGUMENT special text: Moon data.     (line  463)
* Moon, Julian date %)yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1535)
* Moon, Julian Ephemeris date %(*zARGUMENT special text: Moon data.
                                                             (line  468)
* Moon, Julian Ephemeris date %(*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1541)
* Moon, Julian Ephemeris date %(zARGUMENT special text: Moon data.
                                                             (line  468)
* Moon, Julian Ephemeris date %(zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1541)
* Moon, Julian Ephemeris date %)*zARGUMENT special text: Moon data.
                                                             (line  468)
* Moon, Julian Ephemeris date %)*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1541)
* Moon, Julian Ephemeris date %)zARGUMENT special text: Moon data.
                                                             (line  468)
* Moon, Julian Ephemeris date %)zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1541)
* Moon, local sidereal time %(*wARGUMENT special text: Moon data.
                                                             (line  438)
* Moon, local sidereal time %(*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1519)
* Moon, local sidereal time %(wARGUMENT special text: Moon data.
                                                             (line  438)
* Moon, local sidereal time %(wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1515)
* Moon, local sidereal time %)*wARGUMENT special text: Moon data.
                                                             (line  438)
* Moon, local sidereal time %)*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1519)
* Moon, local sidereal time %)wARGUMENT special text: Moon data.
                                                             (line  438)
* Moon, local sidereal time %)wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1515)
* Moon, lowest culmination point:        Moon data.          (line   38)
* Moon, lunation:                        Moon data.          (line   38)
* Moon, magnitude units:                 Moon data.          (line  283)
* Moon, mathematical-geocentric horizon: Moon data.          (line   71)
* Moon, midnight height geocentric:      Moon data.          (line  730)
* Moon, midnight height topocentric:     Moon data.          (line  654)
* Moon, midnight phase angle geocentric: Moon data.          (line  737)
* Moon, midnight phase angle topocentric: Moon data.         (line  661)
* Moon, noon height geocentric:          Moon data.          (line  744)
* Moon, noon height topocentric:         Moon data.          (line  668)
* Moon, noon phase angle geocentric:     Moon data.          (line  751)
* Moon, noon phase angle topocentric:    Moon data.          (line  675)
* Moon, refraction %(*iARGUMENT special text: Moon data.     (line  365)
* Moon, refraction %(*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1388)
* Moon, refraction %(iARGUMENT special text: Moon data.      (line  365)
* Moon, refraction %(iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1383)
* Moon, refraction %)*iARGUMENT special text: Moon data.     (line  365)
* Moon, refraction %)*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1388)
* Moon, refraction %)iARGUMENT special text: Moon data.      (line  365)
* Moon, refraction %)iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1383)
* Moon, rise azimuth geocentric:         Moon data.          (line  772)
* Moon, rise azimuth topocentric:        Moon data.          (line  696)
* Moon, rise height geocentric:          Moon data.          (line  758)
* Moon, rise height topocentric:         Moon data.          (line  682)
* Moon, rise phase angle geocentric:     Moon data.          (line  792)
* Moon, rise phase angle topocentric:    Moon data.          (line  716)
* Moon, rise width geocentric:           Moon data.          (line  772)
* Moon, rise width topocentric:          Moon data.          (line  696)
* Moon, set azimuth geocentric:          Moon data.          (line  782)
* Moon, set azimuth topocentric:         Moon data.          (line  706)
* Moon, set height geocentric:           Moon data.          (line  765)
* Moon, set height topocentric:          Moon data.          (line  689)
* Moon, set phase angle geocentric:      Moon data.          (line  799)
* Moon, set phase angle topocentric:     Moon data.          (line  723)
* Moon, set width geocentric:            Moon data.          (line  782)
* Moon, set width topocentric:           Moon data.          (line  706)
* Moon, standard non-visibility period:  Moon data.          (line  250)
* Moon, standard rise time:              Moon data.          (line  195)
* Moon, standard set time:               Moon data.          (line  223)
* Moon, standard visibility period:      Moon data.          (line  242)
* Moon, synodic month:                   Moon data.          (line   38)
* Moon, topocentric azimuth %(*bARGUMENT special text: Moon data.
                                                             (line  312)
* Moon, topocentric azimuth %(*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1318)
* Moon, topocentric azimuth %(bARGUMENT special text: Moon data.
                                                             (line  312)
* Moon, topocentric azimuth %(bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1313)
* Moon, topocentric azimuth %)*bARGUMENT special text: Moon data.
                                                             (line  312)
* Moon, topocentric azimuth %)*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1318)
* Moon, topocentric azimuth %)bARGUMENT special text: Moon data.
                                                             (line  312)
* Moon, topocentric azimuth %)bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1313)
* Moon, topocentric azimuth at standard rise time %(*QARGUMENT special text: Moon data.
                                                             (line  696)
* Moon, topocentric azimuth at standard rise time %(*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1746)
* Moon, topocentric azimuth at standard rise time %(QARGUMENT special text: Moon data.
                                                             (line  696)
* Moon, topocentric azimuth at standard rise time %(QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1742)
* Moon, topocentric azimuth at standard set time %)*QARGUMENT special text: Moon data.
                                                             (line  706)
* Moon, topocentric azimuth at standard set time %)*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1754)
* Moon, topocentric azimuth at standard set time %)QARGUMENT special text: Moon data.
                                                             (line  706)
* Moon, topocentric azimuth at standard set time %)QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1750)
* Moon, topocentric brightness %(*8ARGUMENT special text: Special Texts Summary.
                                                             (line 1288)
* Moon, topocentric brightness %(8ARGUMENT special text: Special Texts Summary.
                                                             (line 1288)
* Moon, topocentric brightness %)*8ARGUMENT special text: Special Texts Summary.
                                                             (line 1288)
* Moon, topocentric brightness %)8ARGUMENT special text: Special Texts Summary.
                                                             (line 1288)
* Moon, topocentric data:                Moon data.          (line  258)
* Moon, topocentric declination %(*cARGUMENT special text: Moon data.
                                                             (line  316)
* Moon, topocentric declination %(*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1328)
* Moon, topocentric declination %(cARGUMENT special text: Moon data.
                                                             (line  316)
* Moon, topocentric declination %(cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1323)
* Moon, topocentric declination %)*cARGUMENT special text: Moon data.
                                                             (line  316)
* Moon, topocentric declination %)*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1328)
* Moon, topocentric declination %)cARGUMENT special text: Moon data.
                                                             (line  316)
* Moon, topocentric declination %)cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1323)
* Moon, topocentric distance %(*gARGUMENT special text: Moon data.
                                                             (line  353)
* Moon, topocentric distance %(*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, topocentric distance %(gARGUMENT special text: Moon data.
                                                             (line  353)
* Moon, topocentric distance %(gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, topocentric distance %)*gARGUMENT special text: Moon data.
                                                             (line  353)
* Moon, topocentric distance %)*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, topocentric distance %)gARGUMENT special text: Moon data.
                                                             (line  353)
* Moon, topocentric distance %)gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, topocentric ecliptic latitude %(*eARGUMENT special text: Moon data.
                                                             (line  335)
* Moon, topocentric ecliptic latitude %(*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1348)
* Moon, topocentric ecliptic latitude %(eARGUMENT special text: Moon data.
                                                             (line  335)
* Moon, topocentric ecliptic latitude %(eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1343)
* Moon, topocentric ecliptic latitude %)*eARGUMENT special text: Moon data.
                                                             (line  335)
* Moon, topocentric ecliptic latitude %)*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1348)
* Moon, topocentric ecliptic latitude %)eARGUMENT special text: Moon data.
                                                             (line  335)
* Moon, topocentric ecliptic latitude %)eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1343)
* Moon, topocentric ecliptic longitude %(*dARGUMENT special text: Moon data.
                                                             (line  327)
* Moon, topocentric ecliptic longitude %(*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1338)
* Moon, topocentric ecliptic longitude %(dARGUMENT special text: Moon data.
                                                             (line  327)
* Moon, topocentric ecliptic longitude %(dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1333)
* Moon, topocentric ecliptic longitude %)*dARGUMENT special text: Moon data.
                                                             (line  327)
* Moon, topocentric ecliptic longitude %)*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1338)
* Moon, topocentric ecliptic longitude %)dARGUMENT special text: Moon data.
                                                             (line  327)
* Moon, topocentric ecliptic longitude %)dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1333)
* Moon, topocentric elevation %(*aARGUMENT special text: Moon data.
                                                             (line  302)
* Moon, topocentric elevation %(*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1308)
* Moon, topocentric elevation %(aARGUMENT special text: Moon data.
                                                             (line  302)
* Moon, topocentric elevation %(aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1303)
* Moon, topocentric elevation %)*aARGUMENT special text: Moon data.
                                                             (line  302)
* Moon, topocentric elevation %)*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1308)
* Moon, topocentric elevation %)aARGUMENT special text: Moon data.
                                                             (line  302)
* Moon, topocentric elevation %)aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1303)
* Moon, topocentric elevation at Moon's astronomical midnight time %(*LARGUMENT special text: Moon data.
                                                             (line  654)
* Moon, topocentric elevation at Moon's astronomical midnight time %(*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1690)
* Moon, topocentric elevation at Moon's astronomical midnight time %(LARGUMENT special text: Moon data.
                                                             (line  654)
* Moon, topocentric elevation at Moon's astronomical midnight time %(LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1685)
* Moon, topocentric elevation at Moon's astronomical midnight time %)*LARGUMENT special text: Moon data.
                                                             (line  654)
* Moon, topocentric elevation at Moon's astronomical midnight time %)*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1690)
* Moon, topocentric elevation at Moon's astronomical midnight time %)LARGUMENT special text: Moon data.
                                                             (line  654)
* Moon, topocentric elevation at Moon's astronomical midnight time %)LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1685)
* Moon, topocentric elevation at Moon's astronomical noon time %(*NARGUMENT special text: Moon data.
                                                             (line  668)
* Moon, topocentric elevation at Moon's astronomical noon time %(*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1712)
* Moon, topocentric elevation at Moon's astronomical noon time %(NARGUMENT special text: Moon data.
                                                             (line  668)
* Moon, topocentric elevation at Moon's astronomical noon time %(NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1707)
* Moon, topocentric elevation at Moon's astronomical noon time %)*NARGUMENT special text: Moon data.
                                                             (line  668)
* Moon, topocentric elevation at Moon's astronomical noon time %)*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1712)
* Moon, topocentric elevation at Moon's astronomical noon time %)NARGUMENT special text: Moon data.
                                                             (line  668)
* Moon, topocentric elevation at Moon's astronomical noon time %)NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1707)
* Moon, topocentric elevation at standard rise time %(*PARGUMENT special text: Moon data.
                                                             (line  682)
* Moon, topocentric elevation at standard rise time %(*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1730)
* Moon, topocentric elevation at standard rise time %(PARGUMENT special text: Moon data.
                                                             (line  682)
* Moon, topocentric elevation at standard rise time %(PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1726)
* Moon, topocentric elevation at standard set time %)*PARGUMENT special text: Moon data.
                                                             (line  689)
* Moon, topocentric elevation at standard set time %)*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1738)
* Moon, topocentric elevation at standard set time %)PARGUMENT special text: Moon data.
                                                             (line  689)
* Moon, topocentric elevation at standard set time %)PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1734)
* Moon, topocentric elongation %(*hARGUMENT special text: Moon data.
                                                             (line  359)
* Moon, topocentric elongation %(*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1377)
* Moon, topocentric elongation %(hARGUMENT special text: Moon data.
                                                             (line  359)
* Moon, topocentric elongation %(hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1372)
* Moon, topocentric elongation %)*hARGUMENT special text: Moon data.
                                                             (line  359)
* Moon, topocentric elongation %)*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1377)
* Moon, topocentric elongation %)hARGUMENT special text: Moon data.
                                                             (line  359)
* Moon, topocentric elongation %)hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1372)
* Moon, topocentric horizontal parallax %(*6ARGUMENT special text: Special Texts Summary.
                                                             (line 1271)
* Moon, topocentric horizontal parallax %(6ARGUMENT special text: Special Texts Summary.
                                                             (line 1266)
* Moon, topocentric horizontal parallax %)*6ARGUMENT special text: Special Texts Summary.
                                                             (line 1271)
* Moon, topocentric horizontal parallax %)6ARGUMENT special text: Special Texts Summary.
                                                             (line 1266)
* Moon, topocentric phase angle %(*9ARGUMENT special text: Special Texts Summary.
                                                             (line 1298)
* Moon, topocentric phase angle %(9ARGUMENT special text: Special Texts Summary.
                                                             (line 1293)
* Moon, topocentric phase angle %)*9ARGUMENT special text: Special Texts Summary.
                                                             (line 1298)
* Moon, topocentric phase angle %)9ARGUMENT special text: Special Texts Summary.
                                                             (line 1293)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(*MARGUMENT special text: Moon data.
                                                             (line  661)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(MARGUMENT special text: Moon data.
                                                             (line  661)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)*MARGUMENT special text: Moon data.
                                                             (line  661)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)MARGUMENT special text: Moon data.
                                                             (line  661)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric phase angle at Moon's astronomical noon time %(*OARGUMENT special text: Moon data.
                                                             (line  675)
* Moon, topocentric phase angle at Moon's astronomical noon time %(*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1722)
* Moon, topocentric phase angle at Moon's astronomical noon time %(OARGUMENT special text: Moon data.
                                                             (line  675)
* Moon, topocentric phase angle at Moon's astronomical noon time %(OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1717)
* Moon, topocentric phase angle at Moon's astronomical noon time %)*OARGUMENT special text: Moon data.
                                                             (line  675)
* Moon, topocentric phase angle at Moon's astronomical noon time %)*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1722)
* Moon, topocentric phase angle at Moon's astronomical noon time %)OARGUMENT special text: Moon data.
                                                             (line  675)
* Moon, topocentric phase angle at Moon's astronomical noon time %)OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1717)
* Moon, topocentric phase angle at standard rise time %(*RARGUMENT special text: Moon data.
                                                             (line  716)
* Moon, topocentric phase angle at standard rise time %(*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1763)
* Moon, topocentric phase angle at standard rise time %(RARGUMENT special text: Moon data.
                                                             (line  716)
* Moon, topocentric phase angle at standard rise time %(RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1758)
* Moon, topocentric phase angle at standard set time %)*RARGUMENT special text: Moon data.
                                                             (line  723)
* Moon, topocentric phase angle at standard set time %)*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1772)
* Moon, topocentric phase angle at standard set time %)RARGUMENT special text: Moon data.
                                                             (line  723)
* Moon, topocentric phase angle at standard set time %)RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1767)
* Moon, topocentric right ascension %(*fARGUMENT special text: Moon data.
                                                             (line  346)
* Moon, topocentric right ascension %(*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1358)
* Moon, topocentric right ascension %(fARGUMENT special text: Moon data.
                                                             (line  346)
* Moon, topocentric right ascension %(fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1353)
* Moon, topocentric right ascension %)*fARGUMENT special text: Moon data.
                                                             (line  346)
* Moon, topocentric right ascension %)*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1358)
* Moon, topocentric right ascension %)fARGUMENT special text: Moon data.
                                                             (line  346)
* Moon, topocentric right ascension %)fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1353)
* Moon, topocentric semidiameter %(*7ARGUMENT special text: Special Texts Summary.
                                                             (line 1281)
* Moon, topocentric semidiameter %(7ARGUMENT special text: Special Texts Summary.
                                                             (line 1276)
* Moon, topocentric semidiameter %)*7ARGUMENT special text: Special Texts Summary.
                                                             (line 1281)
* Moon, topocentric semidiameter %)7ARGUMENT special text: Special Texts Summary.
                                                             (line 1276)
* Moon/Sun, delta astronomical midnight time %(*IARGUMENT special text: Moon data.
                                                             (line  583)
* Moon/Sun, delta astronomical midnight time %(*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1654)
* Moon/Sun, delta astronomical midnight time %(IARGUMENT special text: Moon data.
                                                             (line  583)
* Moon/Sun, delta astronomical midnight time %(IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1649)
* Moon/Sun, delta astronomical midnight time %)*IARGUMENT special text: Moon data.
                                                             (line  583)
* Moon/Sun, delta astronomical midnight time %)*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1654)
* Moon/Sun, delta astronomical midnight time %)IARGUMENT special text: Moon data.
                                                             (line  583)
* Moon/Sun, delta astronomical midnight time %)IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1649)
* Moon/Sun, delta astronomical noon time %(*JARGUMENT special text: Moon data.
                                                             (line  602)
* Moon/Sun, delta astronomical noon time %(*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1664)
* Moon/Sun, delta astronomical noon time %(JARGUMENT special text: Moon data.
                                                             (line  602)
* Moon/Sun, delta astronomical noon time %(JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1659)
* Moon/Sun, delta astronomical noon time %)*JARGUMENT special text: Moon data.
                                                             (line  602)
* Moon/Sun, delta astronomical noon time %)*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1664)
* Moon/Sun, delta astronomical noon time %)JARGUMENT special text: Moon data.
                                                             (line  602)
* Moon/Sun, delta astronomical noon time %)JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1659)
* Moon/Sun, delta geocentric azimuth %(*DARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta geocentric azimuth %(*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1580)
* Moon/Sun, delta geocentric azimuth %(DARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta geocentric azimuth %(DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1575)
* Moon/Sun, delta geocentric azimuth %)*DARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta geocentric azimuth %)*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1580)
* Moon/Sun, delta geocentric azimuth %)DARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta geocentric azimuth %)DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1575)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(*HARGUMENT special text: Moon data.
                                                             (line  567)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1636)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(HARGUMENT special text: Moon data.
                                                             (line  567)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1632)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)*HARGUMENT special text: Moon data.
                                                             (line  575)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1644)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)HARGUMENT special text: Moon data.
                                                             (line  575)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1640)
* Moon/Sun, delta geocentric elevation %(*CARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric elevation %(*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1570)
* Moon/Sun, delta geocentric elevation %(CARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric elevation %(CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1565)
* Moon/Sun, delta geocentric elevation %)*CARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric elevation %)*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1570)
* Moon/Sun, delta geocentric elevation %)CARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric elevation %)CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1565)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(*GARGUMENT special text: Moon data.
                                                             (line  551)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1620)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(GARGUMENT special text: Moon data.
                                                             (line  551)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1616)
* Moon/Sun, delta geocentric elevation at standard moonset time %)*GARGUMENT special text: Moon data.
                                                             (line  559)
* Moon/Sun, delta geocentric elevation at standard moonset time %)*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1628)
* Moon/Sun, delta geocentric elevation at standard moonset time %)GARGUMENT special text: Moon data.
                                                             (line  559)
* Moon/Sun, delta geocentric elevation at standard moonset time %)GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1624)
* Moon/Sun, delta standard rise time %(*KARGUMENT special text: Special Texts Summary.
                                                             (line 1672)
* Moon/Sun, delta standard rise time %(KARGUMENT special text: Special Texts Summary.
                                                             (line 1668)
* Moon/Sun, delta standard set time %)*KARGUMENT special text: Special Texts Summary.
                                                             (line 1680)
* Moon/Sun, delta standard set time %)KARGUMENT special text: Special Texts Summary.
                                                             (line 1676)
* Moon/Sun, delta topocentric azimuth %(*BARGUMENT special text: Moon data.
                                                             (line  487)
* Moon/Sun, delta topocentric azimuth %(*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1560)
* Moon/Sun, delta topocentric azimuth %(BARGUMENT special text: Moon data.
                                                             (line  487)
* Moon/Sun, delta topocentric azimuth %(BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1555)
* Moon/Sun, delta topocentric azimuth %)*BARGUMENT special text: Moon data.
                                                             (line  487)
* Moon/Sun, delta topocentric azimuth %)*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1560)
* Moon/Sun, delta topocentric azimuth %)BARGUMENT special text: Moon data.
                                                             (line  487)
* Moon/Sun, delta topocentric azimuth %)BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1555)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(*FARGUMENT special text: Moon data.
                                                             (line  535)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1604)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(FARGUMENT special text: Moon data.
                                                             (line  535)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1600)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)*FARGUMENT special text: Moon data.
                                                             (line  543)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1612)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)FARGUMENT special text: Moon data.
                                                             (line  543)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1608)
* Moon/Sun, delta topocentric elevation %(*AARGUMENT special text: Moon data.
                                                             (line  473)
* Moon/Sun, delta topocentric elevation %(*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1550)
* Moon/Sun, delta topocentric elevation %(AARGUMENT special text: Moon data.
                                                             (line  473)
* Moon/Sun, delta topocentric elevation %(AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1545)
* Moon/Sun, delta topocentric elevation %)*AARGUMENT special text: Moon data.
                                                             (line  473)
* Moon/Sun, delta topocentric elevation %)*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1550)
* Moon/Sun, delta topocentric elevation %)AARGUMENT special text: Moon data.
                                                             (line  473)
* Moon/Sun, delta topocentric elevation %)AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1545)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(*EARGUMENT special text: Moon data.
                                                             (line  519)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1588)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(EARGUMENT special text: Moon data.
                                                             (line  519)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1584)
* Moon/Sun, delta topocentric elevation at standard moonset time %)*EARGUMENT special text: Moon data.
                                                             (line  527)
* Moon/Sun, delta topocentric elevation at standard moonset time %)*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1596)
* Moon/Sun, delta topocentric elevation at standard moonset time %)EARGUMENT special text: Moon data.
                                                             (line  527)
* Moon/Sun, delta topocentric elevation at standard moonset time %)EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1592)
* Moonrise:                              Moon data.          (line    6)
* Moonrise and moonset, set reference altitude: Fixed date options.
                                                             (line  125)
* Moonset:                               Moon data.          (line    6)
* More precise representation of astronomical data and times: Fixed date options.
                                                             (line  341)
* More precise representation of geographical data: Fixed date options.
                                                             (line  341)
* Morning width:                         Glossary.           (line  487)
* Morning width geocentric, Sun:         Sun data.           (line  789)
* Morning width topocentric, Sun:        Sun data.           (line  741)
* Move leap day to 1st March:            Fixed date options. (line  878)
* Move leap day to 28th February:        Fixed date options. (line  873)
* Multicultural New Year holidays in eternal holiday list: Calendar options.
                                                             (line  107)
* Name space of date variables:          Fixed date options. (line    8)
* Name space of date variables <1>:      Date variables.     (line   55)
* Name space of text variables:          Fixed date options. (line   33)
* Name space of text variables <1>:      Text variables.     (line  242)
* Native language defaults:              Internationalization.
                                                             (line   53)
* Native language, selection:            Internationalization.
                                                             (line   27)
* Native language, used:                 Internationalization.
                                                             (line    6)
* Nautical twilight:                     Glossary.           (line  491)
* Nautical twilight, Sun:                Sun data.           (line  261)
* Nautical twilight, Sun <1>:            Sun data.           (line  270)
* Negated character list:                Glossary.           (line  496)
* Negated character list, regexp:        Regexp Operators.   (line  163)
* Negated regular expression:            Fixed date options. (line  427)
* Negative day:                          Glossary.           (line  500)
* Negative day, biorhythm:               Biorhythm.          (line   20)
* New Moon phase:                        Calendar options.   (line   48)
* Non-printable characters in the text part, handling: Text part of a line.
                                                             (line    6)
* Noon height:                           Glossary.           (line  505)
* Noon height geocentric, Moon:          Moon data.          (line  744)
* Noon height geocentric, Sun:           Sun data.           (line  768)
* Noon height topocentric, Moon:         Moon data.          (line  668)
* Noon height topocentric, Sun:          Sun data.           (line  720)
* Noon line:                             Glossary.           (line  509)
* Noon line, Sun:                        Sun data.           (line   38)
* Noon phase angle:                      Glossary.           (line  512)
* Noon phase angle geocentric, Moon:     Moon data.          (line  751)
* Noon phase angle topocentric, Moon:    Moon data.          (line  675)
* Noon time of Moon, astronomical:       Moon data.          (line   58)
* Noon time of Sun, astronomical:        Sun data.           (line   50)
* NUL characters in the text part, handling: Text part of a line.
                                                             (line   21)
* Number of year calendar sheet blocks:  Calendar options.   (line 1384)
* Numerical local time timezone offset value %=[ARGUMENT] special text: Actual clocktime.
                                                             (line  234)
* Numerical local time timezone offset value %=[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  268)
* Numerical local time timezone offset value using RFC-822 style, display: Actual clocktime.
                                                             (line  234)
* Numerical text variables:              Text variables.     (line  292)
* Numerical text variables, length preserving behavior: Text variables.
                                                             (line  348)
* Numerical Universal time timezone offset value %"[ARGUMENT] special text: Actual clocktime.
                                                             (line  213)
* Numerical Universal time timezone offset value %"[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  265)
* Numerical Universal time timezone offset value using RFC-822 style, display: Actual clocktime.
                                                             (line  213)
* Obsolete date format elements, table:  Table of Obsolete Date Format Elements.
                                                             (line    6)
* Obsolete date format texts, fixed default: Table of Obsolete Date Formats.
                                                             (line    6)
* Obsolete date format texts, individual: Table of Obsolete Date Format Elements.
                                                             (line    6)
* Obsolete date formats, table:          Table of Obsolete Date Formats.
                                                             (line    6)
* Obsolete fixed default date format texts: Table of Obsolete Date Formats.
                                                             (line    6)
* Obsolete fixed default date format texts, table: Table of Obsolete Date Formats.
                                                             (line    6)
* Obsolete individual date format texts: Table of Obsolete Date Format Elements.
                                                             (line    6)
* Obsolete special texts and format elements: Obsolete Special Texts.
                                                             (line    6)
* Obsolete special texts, table:         Table of Obsolete Special Texts.
                                                             (line    6)
* Octal system:                          Glossary.           (line  516)
* Omission values in date part, validity: Date part of a line.
                                                             (line  146)
* Operations on date variables:          Fixed date options. (line    8)
* Operations on date variables <1>:      Structure of resource file.
                                                             (line   58)
* Operations on date variables <2>:      Date variables.     (line  117)
* Operations on text variables:          Structure of resource file.
                                                             (line   73)
* Operations on text variables <1>:      Text variables.     (line  292)
* Operator, * regexp:                    Regexp Operators.   (line  193)
* Operator, + regexp:                    Regexp Operators.   (line  213)
* Operator, ? regexp:                    Regexp Operators.   (line  225)
* Operator, \' regexp:                   Regexp Operators.   (line  303)
* Operator, \< regexp:                   Regexp Operators.   (line  270)
* Operator, \> regexp:                   Regexp Operators.   (line  274)
* Operator, \b regexp:                   Regexp Operators.   (line  278)
* Operator, \B regexp:                   Regexp Operators.   (line  283)
* Operator, \w regexp:                   Regexp Operators.   (line  259)
* Operator, \W regexp:                   Regexp Operators.   (line  265)
* Operator, \` regexp:                   Regexp Operators.   (line  299)
* Operator, | regexp:                    Regexp Operators.   (line  173)
* Operators, regexp:                     Regexp Operators.   (line    6)
* Opposition:                            Glossary.           (line  519)
* Option:                                Glossary.           (line  524)
* Option %DATE:                          Command line arguments.
                                                             (line    6)
* Option @FILE:                          Command line arguments.
                                                             (line    6)
* Option class, calendar:                Options.            (line   13)
* Option class, common:                  Options.            (line   13)
* Option class, fixed date:              Options.            (line   13)
* Option class, global:                  Options.            (line   13)
* Option modifier:                       Options.            (line   73)
* Options:                               Command line arguments.
                                                             (line    6)
* Options <1>:                           Options.            (line    6)
* Options of gcal:                       Command line arguments.
                                                             (line    6)
* Options of gcal2txt:                   Invoking gcal2txt.  (line    6)
* Options of tcal:                       Invoking tcal.      (line    6)
* Options of txt2gcal:                   Invoking txt2gcal.  (line    6)
* Options, fixed date period:            Fixed date options. (line  866)
* Options, fixed date text:              Fixed date options. (line  620)
* Options, long-style:                   Options.            (line   21)
* Options, short-style:                  Options.            (line   21)
* Options, single character:             Fixed date options. (line  589)
* Options, single character <1>:         Fixed date options. (line  600)
* Orbit, Sun's:                          Sun data.           (line  387)
* Orbit, Sun's <1>:                      Moon data.          (line  327)
* Orbit, Sun's <2>:                      Moon data.          (line  335)
* Orthodox new calendar holidays in eternal holiday list: Calendar options.
                                                             (line  113)
* Orthodox old calendar holidays in eternal holiday list: Calendar options.
                                                             (line  119)
* Orthodrome:                            Geographical distance and course angle.
                                                             (line    6)
* Orthodrome <1>:                        Glossary.           (line  528)
* Other resource file:                   Fixed date options. (line  475)
* Output of base time of astronomical functions: Sun data.   (line  488)
* Output of base time of astronomical functions <1>: Moon data.
                                                             (line  453)
* Output, pipelining:                    Global options.     (line  176)
* Output, redirection:                   Global options.     (line  176)
* PAGER environment variable:            Global options.     (line   48)
* PAGER environment variable <1>:        Environment Variables.
                                                             (line   99)
* Pager program:                         Global options.     (line   48)
* Pager, external:                       Global options.     (line   48)
* Pager, internal:                       Global options.     (line   60)
* Pager, using:                          Global options.     (line   48)
* PATH environment variable:             Global options.     (line   53)
* PATH environment variable <1>:         Environment Variables.
                                                             (line  104)
* Pattern:                               Fixed date options. (line  398)
* Pattern <1>:                           Glossary.           (line  533)
* Pattern, regular expressions:          Regular Expressions.
                                                             (line    6)
* Period of double or shorter shadow length: Sun data.       (line  871)
* Period of Gregorian Reformation, set:  Calendar options.   (line 1563)
* Period of longer than double shadow length: Sun data.      (line  877)
* Period of longer than single shadow length: Sun data.      (line  840)
* Period of single or shorter shadow length: Sun data.       (line  834)
* Period, Exclusive date:                Exclusions with date argument.
                                                             (line   11)
* Period, exclusive day:                 Exclusions without any argument.
                                                             (line   11)
* Period, inclusive date:                Exclusions with date argument.
                                                             (line   11)
* Period, inclusive day:                 Exclusions without any argument.
                                                             (line   11)
* Period-of-fixed-dates-modifier:        Fixed date options. (line  575)
* Persian Jalaali holidays in eternal holiday list: Calendar options.
                                                             (line  125)
* Phase angle:                           Glossary.           (line  539)
* Pipelining:                            Global options.     (line   91)
* Pipelining <1>:                        Glossary.           (line  543)
* Pipelining of output:                  Global options.     (line  176)
* Positive day:                          Glossary.           (line  547)
* Positive day, biorhythm:               Biorhythm.          (line   20)
* POSIX:                                 Glossary.           (line  552)
* POSIX regexp:                          Regexp Operators.   (line   75)
* POSIX regexp <1>:                      Regexp Operators.   (line  235)
* Prayer time Asr, Islamic:              Sun data.           (line   50)
* Prayer time Asr, Islamic <1>:          Sun data.           (line  818)
* Prayer time Asr, Islamic <2>:          Sun data.           (line  855)
* Prayer time Fajr, Islamic:             Sun data.           (line  313)
* Prayer time Isha, Islamic:             Sun data.           (line  327)
* Prayer time Maghrib, Islamic:          Sun data.           (line  199)
* Prayer time Zuhr, Islamic:             Sun data.           (line   50)
* Precedence, regexp operators:          Regexp Operators.   (line  305)
* Precision of astronomical calculations: Preface.           (line   19)
* Preliminary remarks to Gcal:           Preface.            (line    6)
* Private-access resource files:         Environment Variables.
                                                             (line   35)
* Program exit state 127:                Common options.     (line   41)
* Program exit states, table:            Error Codes.        (line    6)
* Proleptic calendar mode:               Calendar options.   (line 1595)
* Proleptic calendar mode <1>:           Glossary.           (line  557)
* Proleptic Gregorian calendar:          Calendar options.   (line 1602)
* Proleptic Julian calendar:             Calendar options.   (line 1607)
* Protection character, \:               Fixed date options. (line   98)
* Protection character, \ <1>:           Fixed date options. (line  104)
* Protection character, \ <2>:           Fixed date options. (line  114)
* Protection character, \ <3>:           Fixed date options. (line  415)
* Protection character, \ <4>:           Fixed date options. (line  503)
* Protection character, \ <5>:           Fixed date options. (line  512)
* Protection character, \ <6>:           Fixed date options. (line  547)
* Protection character, \ <7>:           Fixed date options. (line  747)
* Protection character, \ <8>:           Fixed date options. (line  757)
* Protection character, \ <9>:           Fixed date options. (line  841)
* Protection character, \ <10>:          Fixed date options. (line  851)
* Protection character, \ <11>:          Text part of a line.
                                                             (line   52)
* Protection character, \ <12>:          Text part of a line.
                                                             (line   93)
* Protection character, \ <13>:          Special Texts processed.
                                                             (line    6)
* Protection character, \ <14>:          Text variables.     (line   90)
* Protection character, \ <15>:          Other difference values.
                                                             (line   11)
* Protection of special characters:      Command line arguments.
                                                             (line   28)
* Protection of special characters <1>:  Fixed date options. (line   98)
* Protection of special characters <2>:  Fixed date options. (line  104)
* Protection of special characters <3>:  Fixed date options. (line  114)
* Protection of special characters <4>:  Fixed date options. (line  415)
* Protection of special characters <5>:  Fixed date options. (line  503)
* Protection of special characters <6>:  Fixed date options. (line  512)
* Protection of special characters <7>:  Fixed date options. (line  547)
* Protection of special characters <8>:  Fixed date options. (line  747)
* Protection of special characters <9>:  Fixed date options. (line  757)
* Protection of special characters <10>: Fixed date options. (line  841)
* Protection of special characters <11>: Fixed date options. (line  851)
* Protection of special characters <12>: Response file.      (line    6)
* Protection of special characters <13>: Text part of a line.
                                                             (line   52)
* Protection of special characters <14>: Text part of a line.
                                                             (line   93)
* Protection of special characters <15>: Special Texts processed.
                                                             (line    6)
* Protection of special characters <16>: Text variables.     (line   90)
* Protection of special characters <17>: Other difference values.
                                                             (line   11)
* Provide calendar sheet with week numbers: Calendar options.
                                                             (line 1347)
* Pseudo space character, _:             Fixed date options. (line  111)
* Pseudo space character, _ <1>:         Fixed date options. (line  411)
* Pseudo space character, _ <2>:         Fixed date options. (line  509)
* Pseudo space character, _ <3>:         Fixed date options. (line  544)
* Pseudo space character, _ <4>:         Fixed date options. (line  754)
* Pseudo space character, _ <5>:         Fixed date options. (line  848)
* Public-access resource files:          Environment Variables.
                                                             (line   30)
* Quotation of special characters:       Command line arguments.
                                                             (line   28)
* Quotation of special characters <1>:   Response file.      (line    6)
* Range of current months:               Ranges of commands. (line    7)
* Range of fiscal years:                 Ranges of commands. (line   49)
* Range of months of year:               Ranges of commands. (line   15)
* Range of specified fiscal years:       Ranges of commands. (line   49)
* Range of specified month of selected years: Ranges of commands.
                                                             (line   37)
* Range of specified months of selected year: Ranges of commands.
                                                             (line   22)
* Range of specified months of selected years: Ranges of commands.
                                                             (line   29)
* Range of specified years:              Ranges of commands. (line   44)
* Ranges of commands:                    Commands.           (line    6)
* Ranges of commands <1>:                Ranges of commands. (line    6)
* Ranges of commands <2>:                Glossary.           (line  392)
* Ranges of days:                        Ranges of days.     (line    6)
* Ranges of days, examples:              Ranges of days.     (line   63)
* Ranges of days, valid date parts:      Ranges of days.     (line   31)
* Rational number:                       Glossary.           (line  563)
* Redirection:                           Global options.     (line   91)
* Redirection <1>:                       Glossary.           (line  569)
* Redirection of output:                 Global options.     (line  176)
* Redirection of standard output:        Structure of resource file.
                                                             (line   20)
* Redirection of standard output, appending to file: Structure of resource file.
                                                             (line   10)
* Reference altitude used for moonrise and moonset, set: Fixed date options.
                                                             (line  125)
* Reference altitude used for sunrise and sunset, set: Fixed date options.
                                                             (line  125)
* Reference systems used, Moon oriented special texts: Moon data.
                                                             (line  947)
* Reference systems used, Sun oriented special texts: Sun data.
                                                             (line 1209)
* References of text variables:          Structure of resource file.
                                                             (line   83)
* Refraction:                            Glossary.           (line  573)
* Refraction, atmospheric:               Fixed date options. (line  152)
* Regexp:                                Regular Expressions.
                                                             (line    6)
* Regexp <1>:                            Glossary.           (line  580)
* Regexp anchor metacharacter, $:        Regexp Operators.   (line   32)
* Regexp anchor metacharacter, ^:        Regexp Operators.   (line   22)
* Regexp character class, [:alnum:]:     Regexp Operators.   (line   89)
* Regexp character class, [:alpha:]:     Regexp Operators.   (line   92)
* Regexp character class, [:blank:]:     Regexp Operators.   (line   95)
* Regexp character class, [:cntrl:]:     Regexp Operators.   (line   98)
* Regexp character class, [:digit:]:     Regexp Operators.   (line  101)
* Regexp character class, [:graph:]:     Regexp Operators.   (line  104)
* Regexp character class, [:lower:]:     Regexp Operators.   (line  108)
* Regexp character class, [:print:]:     Regexp Operators.   (line  111)
* Regexp character class, [:punct:]:     Regexp Operators.   (line  114)
* Regexp character class, [:space:]:     Regexp Operators.   (line  118)
* Regexp character class, [:upper:]:     Regexp Operators.   (line  121)
* Regexp character class, [:xdigit:]:    Regexp Operators.   (line  124)
* Regexp character classes, [:KEYWORD:]: Regexp Operators.   (line   75)
* Regexp character list, [...]:          Regexp Operators.   (line   51)
* Regexp collating symbols, [.ELEMENT.]: Regexp Operators.   (line  143)
* Regexp complemented character list, [^ ...]: Regexp Operators.
                                                             (line  163)
* Regexp equivalence classes, [=LIST=]:  Regexp Operators.   (line  150)
* Regexp grouping, (...):                Regexp Operators.   (line  186)
* Regexp interval expressions, {EXPRESSION}: Regexp Operators.
                                                             (line  235)
* Regexp metacharacter, .:               Regexp Operators.   (line   40)
* Regexp metacharacter, \:               Regexp Operators.   (line   14)
* Regexp metacharacters:                 Regexp Operators.   (line    6)
* Regexp operator, *:                    Regexp Operators.   (line  193)
* Regexp operator, +:                    Regexp Operators.   (line  213)
* Regexp operator, ?:                    Regexp Operators.   (line  225)
* Regexp operator, \':                   Regexp Operators.   (line  303)
* Regexp operator, \<:                   Regexp Operators.   (line  270)
* Regexp operator, \>:                   Regexp Operators.   (line  274)
* Regexp operator, \b:                   Regexp Operators.   (line  278)
* Regexp operator, \B:                   Regexp Operators.   (line  283)
* Regexp operator, \w:                   Regexp Operators.   (line  259)
* Regexp operator, \W:                   Regexp Operators.   (line  265)
* Regexp operator, \`:                   Regexp Operators.   (line  299)
* Regexp operator, |:                    Regexp Operators.   (line  173)
* Regexp operators:                      Regexp Operators.   (line    6)
* Regexp operators, GNU specific:        Regexp Operators.   (line  251)
* Regexp operators, precedence:          Regexp Operators.   (line  305)
* Regexp, anchors:                       Regexp Operators.   (line   22)
* Regexp, buffer:                        Regexp Operators.   (line  289)
* Regexp, buffer matching operators:     Regexp Operators.   (line  298)
* Regexp, case sensitivity in matching:  Regexp Operators.   (line  310)
* Regexp, character classes:             Regexp Operators.   (line   75)
* Regexp, character list:                Regexp Operators.   (line   51)
* Regexp, collating elements:            Regexp Operators.   (line  135)
* Regexp, collating symbols:             Regexp Operators.   (line  143)
* Regexp, complemented character list:   Regexp Operators.   (line  163)
* Regexp, definition of a word:          Regexp Operators.   (line  254)
* Regexp, equivalence classes:           Regexp Operators.   (line  150)
* Regexp, ignoring case:                 Fixed date options. (line  422)
* Regexp, ignoring case <1>:             Regexp Operators.   (line  315)
* Regexp, interval expressions:          Regexp Operators.   (line  235)
* Regexp, matching word boundaries:      Regexp Operators.   (line  278)
* Regexp, negated character list:        Regexp Operators.   (line  163)
* Regexp, POSIX:                         Regexp Operators.   (line   75)
* Regexp, POSIX <1>:                     Regexp Operators.   (line  235)
* Regular expression:                    Fixed date options. (line  398)
* Regular expression <1>:                Regular Expressions.
                                                             (line    6)
* Regular expression <2>:                Glossary.           (line  580)
* Regular expression anchor metacharacter, $: Regexp Operators.
                                                             (line   32)
* Regular expression anchor metacharacter, ^: Regexp Operators.
                                                             (line   22)
* Regular expression character class, [:alnum:]: Regexp Operators.
                                                             (line   89)
* Regular expression character class, [:alpha:]: Regexp Operators.
                                                             (line   92)
* Regular expression character class, [:blank:]: Regexp Operators.
                                                             (line   95)
* Regular expression character class, [:cntrl:]: Regexp Operators.
                                                             (line   98)
* Regular expression character class, [:digit:]: Regexp Operators.
                                                             (line  101)
* Regular expression character class, [:graph:]: Regexp Operators.
                                                             (line  104)
* Regular expression character class, [:lower:]: Regexp Operators.
                                                             (line  108)
* Regular expression character class, [:print:]: Regexp Operators.
                                                             (line  111)
* Regular expression character class, [:punct:]: Regexp Operators.
                                                             (line  114)
* Regular expression character class, [:space:]: Regexp Operators.
                                                             (line  118)
* Regular expression character class, [:upper:]: Regexp Operators.
                                                             (line  121)
* Regular expression character class, [:xdigit:]: Regexp Operators.
                                                             (line  124)
* Regular expression character classes, [:KEYWORD:]: Regexp Operators.
                                                             (line   75)
* Regular expression character list, [...]: Regexp Operators.
                                                             (line   51)
* Regular expression collating symbols, [.ELEMENT.]: Regexp Operators.
                                                             (line  143)
* Regular expression complemented character list, [^ ...]: Regexp Operators.
                                                             (line  163)
* Regular expression equivalence class, [=LIST=]: Regexp Operators.
                                                             (line  150)
* Regular expression grouping, (...):    Regexp Operators.   (line  186)
* Regular expression interval expressions, {EXPRESSION}: Regexp Operators.
                                                             (line  235)
* Regular expression metacharacter, .:   Regexp Operators.   (line   40)
* Regular expression metacharacter, \:   Regexp Operators.   (line   14)
* Regular expression metacharacters:     Regexp Operators.   (line    6)
* Regular expression operator, *:        Regexp Operators.   (line  193)
* Regular expression operator, +:        Regexp Operators.   (line  213)
* Regular expression operator, ?:        Regexp Operators.   (line  225)
* Regular expression operator, \':       Regexp Operators.   (line  303)
* Regular expression operator, \<:       Regexp Operators.   (line  270)
* Regular expression operator, \>:       Regexp Operators.   (line  274)
* Regular expression operator, \b:       Regexp Operators.   (line  278)
* Regular expression operator, \B:       Regexp Operators.   (line  283)
* Regular expression operator, \w:       Regexp Operators.   (line  259)
* Regular expression operator, \W:       Regexp Operators.   (line  265)
* Regular expression operator, \`:       Regexp Operators.   (line  299)
* Regular expression operator, |:        Regexp Operators.   (line  173)
* Regular expression operators:          Regexp Operators.   (line    6)
* Regular expression operators <1>:      Glossary.           (line  471)
* Regular expression, complemented:      Fixed date options. (line  427)
* Regular expression, ignoring case distinctions: Fixed date options.
                                                             (line  422)
* Regular expression, ignoring case distinctions <1>: Regexp Operators.
                                                             (line  315)
* Regular expression, negated:           Fixed date options. (line  427)
* Regular expression, reverted:          Fixed date options. (line  427)
* Regular expressions as patterns:       Regular Expressions.
                                                             (line    6)
* Regular expressions, how to use:       Regexp Usage.       (line    6)
* Regular expressions, short-list:       Regexp Summary.     (line    6)
* Regular expressions, summary:          Regexp Summary.     (line    6)
* Relative day number %d special text:   Other difference values.
                                                             (line   21)
* Relative day number %d special text <1>: Special Texts Summary.
                                                             (line 1871)
* Relative month number %m special text: Other difference values.
                                                             (line   34)
* Relative month number %m special text <1>: Special Texts Summary.
                                                             (line 1877)
* Relative time offset value:            Calendar options.   (line 1506)
* Relative time offset value <1>:        Calendar options.   (line 1532)
* Relative time offset value <2>:        Glossary.           (line  583)
* Relative week number %w special text:  Other difference values.
                                                             (line   29)
* Relative week number %w special text <1>: Special Texts Summary.
                                                             (line 1874)
* Relative year number %y special text:  Other difference values.
                                                             (line   39)
* Relative year number %y special text <1>: Special Texts Summary.
                                                             (line 1880)
* Relative year number %yDATE special text: Difference value.
                                                             (line   10)
* Relative year number %yDATE special text <1>: Special Texts Summary.
                                                             (line  224)
* Religious Islamic calendar:            Preface.            (line  163)
* Religious Islamic calendar <1>:        Glossary.           (line  586)
* Remark character, ;:                   Response file.      (line   21)
* Remark character, ; <1>:               Comment line.       (line    6)
* Remarked line in resource file:        Structure of resource file.
                                                             (line   47)
* Remarked line in resource file <1>:    Comment line.       (line    6)
* Repetition factor of days, :N:         Repetition factor of days.
                                                             (line    6)
* Repetition factors of days, examples:  Repetition factor of days.
                                                             (line   56)
* Repetition factors of days, valid date parts: Repetition factor of days.
                                                             (line   41)
* Replacements with date argument %?[DATE] special texts: Replacements with date argument.
                                                             (line    6)
* Replacements with other argument %[FORMAT]?[ARGUMENT] special texts: Replacements with other argument.
                                                             (line    6)
* Replacements without any argument %? special texts: Replacements without any argument.
                                                             (line    6)
* Representation-of-text-modifier:       Fixed date options. (line  572)
* Resource file:                         Fixed Dates.        (line   11)
* Resource file <1>:                     Glossary.           (line  589)
* Resource file examples:                Resource file examples.
                                                             (line    6)
* Resource file line, additional:        Fixed date options. (line  520)
* Resource file line, commented:         Structure of resource file.
                                                             (line   47)
* Resource file line, commented <1>:     Comment line.       (line    6)
* Resource file line, further:           Fixed date options. (line  520)
* Resource file line, long text part:    Text part of a line.
                                                             (line   42)
* Resource file line, remarked:          Structure of resource file.
                                                             (line   47)
* Resource file line, remarked <1>:      Comment line.       (line    6)
* Resource file, .gcalrc:                Resource file.      (line    6)
* Resource file, additional:             Fixed date options. (line  475)
* Resource file, additional <1>:         Resource file.      (line    6)
* Resource file, coding scheme:          Coding Scheme.      (line    6)
* Resource file, commented line:         Structure of resource file.
                                                             (line   47)
* Resource file, commented line <1>:     Comment line.       (line    6)
* Resource file, date part:              Coding Scheme.      (line    6)
* Resource file, date part of a line:    Date part of a line.
                                                             (line    6)
* Resource file, force line break-up:    Text part of a line.
                                                             (line   42)
* Resource file, include directives:     Include directives. (line    6)
* Resource file, limitations:            Global options.     (line  219)
* Resource file, limitations <1>:        Structure of resource file.
                                                             (line    6)
* Resource file, limitations <2>:        Text part of a line.
                                                             (line    6)
* Resource file, limitations <3>:        Date variables.     (line    6)
* Resource file, line continuation:      Text part of a line.
                                                             (line   28)
* Resource file, loading:                Resource file.      (line    6)
* Resource file, name:                   Resource file.      (line    6)
* Resource file, other:                  Fixed date options. (line  475)
* Resource file, remarked line:          Structure of resource file.
                                                             (line   47)
* Resource file, remarked line <1>:      Comment line.       (line    6)
* Resource file, remarking of text part: Text part of a line.
                                                             (line   21)
* Resource file, searching mechanism:    Resource file.      (line    6)
* Resource file, standard:               Resource file.      (line    6)
* Resource file, structure:              Structure of resource file.
                                                             (line    6)
* Resource file, text part:              Text part of a line.
                                                             (line    6)
* Resource file, two parts of a line:    Structure of resource file.
                                                             (line    6)
* Resource file, use:                    Resource file.      (line    6)
* Respected environment variables, table: Environment Variables.
                                                             (line    6)
* Response file:                         Glossary.           (line  592)
* Response file, @FILE:                  Response file.      (line    6)
* Response file, creation:               Global options.     (line    8)
* Reverted regular expression:           Fixed date options. (line  427)
* RFC:                                   Glossary.           (line  566)
* RFC-822, numerical local time timezone offset value: Actual clocktime.
                                                             (line  234)
* RFC-822, numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  213)
* Right ascension:                       Glossary.           (line  597)
* Right ascension, Moon:                 Moon data.          (line  346)
* Right ascension, Sun:                  Sun data.           (line  395)
* Rise azimuth:                          Glossary.           (line  602)
* Rise azimuth geocentric, Moon:         Moon data.          (line  772)
* Rise azimuth geocentric, Sun:          Sun data.           (line  789)
* Rise azimuth topocentric, Moon:        Moon data.          (line  696)
* Rise azimuth topocentric, Sun:         Sun data.           (line  741)
* Rise height:                           Glossary.           (line  606)
* Rise height geocentric, Moon:          Moon data.          (line  758)
* Rise height geocentric, Sun:           Sun data.           (line  775)
* Rise height topocentric, Moon:         Moon data.          (line  682)
* Rise height topocentric, Sun:          Sun data.           (line  727)
* Rise phase angle:                      Glossary.           (line  610)
* Rise phase angle geocentric, Moon:     Moon data.          (line  792)
* Rise phase angle topocentric, Moon:    Moon data.          (line  716)
* Rise width:                            Glossary.           (line  487)
* Rise width geocentric, Moon:           Moon data.          (line  772)
* Rise width topocentric, Moon:          Moon data.          (line  696)
* Run-time error codes, table:           Error Codes.        (line    6)
* Scope of date variables:               Fixed date options. (line    8)
* Scope of date variables <1>:           Date variables.     (line  128)
* Scope of text variables:               Fixed date options. (line   33)
* Scope of text variables <1>:           Text variables.     (line  356)
* Searching resource file:               Resource file.      (line    6)
* Selected month mode:                   Single commands.    (line   11)
* Selected month of current year:        Single commands.    (line   11)
* Selected year:                         Single commands.    (line   18)
* Selection of native language:          Internationalization.
                                                             (line   27)
* Sending eMail:                         Global options.     (line  189)
* Separator character of lists of days, ,: Lists of days.    (line    6)
* Separator character of ranges of days, #: Ranges of days.  (line    6)
* Separator character, +:                Calendar options.   (line  154)
* Separator character, + <1>:            Fixed date options. (line  488)
* Separator character, ::                Global options.     (line  107)
* Separator character, : <1>:            Global options.     (line  172)
* Separator character, : <2>:            Fixed date options. (line    8)
* Separator character, : <3>:            Fixed date options. (line   33)
* Separator character, whitespace:       Options.            (line   66)
* Separator character, whitespace <1>:   Options.            (line   73)
* Separator character, whitespace <2>:   Structure of resource file.
                                                             (line    6)
* Separator character, whitespace <3>:   Include directives. (line   23)
* Sequence of control characters:        Global options.     (line  107)
* Set azimuth:                           Glossary.           (line  614)
* Set azimuth geocentric, Moon:          Moon data.          (line  782)
* Set azimuth geocentric, Sun:           Sun data.           (line  799)
* Set azimuth topocentric, Moon:         Moon data.          (line  706)
* Set azimuth topocentric, Sun:          Sun data.           (line  751)
* Set cycle displacement value for Sun and Moon data and times: Fixed date options.
                                                             (line  291)
* Set cycle ending time value for Sun and Moon data and times: Fixed date options.
                                                             (line  225)
* Set cycle timestep value for Sun and Moon data and times: Fixed date options.
                                                             (line  291)
* Set height:                            Glossary.           (line  618)
* Set height geocentric, Moon:           Moon data.          (line  765)
* Set height geocentric, Sun:            Sun data.           (line  782)
* Set height topocentric, Moon:          Moon data.          (line  689)
* Set height topocentric, Sun:           Sun data.           (line  734)
* Set highlighting sequences:            Global options.     (line  107)
* Set marking characters:                Global options.     (line  107)
* Set phase angle:                       Glossary.           (line  622)
* Set phase angle geocentric, Moon:      Moon data.          (line  799)
* Set phase angle topocentric, Moon:     Moon data.          (line  723)
* Set shadow length factor:              Fixed date options. (line  138)
* Set starting day of week:              Calendar options.   (line 1469)
* Set width:                             Glossary.           (line  218)
* Set width geocentric, Moon:            Moon data.          (line  782)
* Set width topocentric, Moon:           Moon data.          (line  706)
* Shadow length at afternoon, double:    Sun data.           (line  855)
* Shadow length at afternoon, single:    Sun data.           (line  818)
* Shadow length at forenoon, double:     Sun data.           (line  846)
* Shadow length at forenoon, single:     Sun data.           (line  809)
* Shadow length factor, set:             Fixed date options. (line  138)
* Shell:                                 Invoking Gcal.      (line   11)
* Shell <1>:                             Command line arguments.
                                                             (line   28)
* Shell <2>:                             Fixed date options. (line  353)
* Shell <3>:                             Text variables.     (line   96)
* Shell <4>:                             Glossary.           (line  626)
* Shell command %![ARGUMENT] special text: Shell Command.    (line    6)
* Shell command %![ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line 1923)
* Shell command, execution:              Shell Command.      (line    6)
* Shell script, creation:                Global options.     (line   15)
* Short help text:                       Common options.     (line    9)
* Short-list of all %?... special texts: Special Texts Summary.
                                                             (line    6)
* Short-list of all regular expressions: Regexp Summary.     (line    6)
* Short-style option:                    Options.            (line   21)
* Short-style option <1>:                Glossary.           (line  630)
* Sidereal time, Moon:                   Moon data.          (line  438)
* Sidereal time, Sun:                    Sun data.           (line  473)
* Signed angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line 1013)
* Signed decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  915)
* Signed time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  982)
* Simple decrement of date variables:    Date variables.     (line  122)
* Simple decrement of text variables:    Text variables.     (line  298)
* Simple file name:                      Resource file.      (line   88)
* Simple file name <1>:                  Glossary.           (line  633)
* Simple increment of date variables:    Date variables.     (line  121)
* Simple increment of text variables:    Text variables.     (line  297)
* Simple language code information:      Internationalization.
                                                             (line   46)
* Simple language code information <1>:  Glossary.           (line  638)
* Single character options:              Options.            (line   21)
* Single character options <1>:          Fixed date options. (line  589)
* Single character options <2>:          Fixed date options. (line  600)
* Single command:                        Glossary.           (line  644)
* Single command line word:              Options.            (line   21)
* Single command line word <1>:          Fixed date options. (line  589)
* Single command line word <2>:          Fixed date options. (line  600)
* Single commands:                       Commands.           (line    6)
* Single Commands:                       Single commands.    (line    6)
* Single fiscal year:                    Single commands.    (line   46)
* Single fiscal year <1>:                Single commands.    (line   53)
* Single fiscal year <2>:                Single commands.    (line   62)
* Single fiscal year <3>:                Single commands.    (line   69)
* Single month mode:                     Single commands.    (line    7)
* Single month of selected year:         Single commands.    (line   38)
* Single or shorter shadow length, period: Sun data.         (line  834)
* Single shadow length at afternoon:     Sun data.           (line  818)
* Single shadow length at forenoon:      Sun data.           (line  809)
* Single year mode:                      Single commands.    (line   18)
* Software license, finding:             Common options.     (line   33)
* Solar Arctic Circle:                   Sun data.           (line 1242)
* Solar Arctic Circle <1>:               Glossary.           (line  647)
* Solar day length:                      Sun data.           (line    6)
* Solar day, mean:                       Sun data.           (line  508)
* Solar day, true:                       Sun data.           (line  508)
* Solar eclipse:                         Calendar options.   (line   48)
* Solar night length:                    Sun data.           (line    6)
* Solar time, mean:                      Sun data.           (line  508)
* Solar time, true:                      Sun data.           (line  508)
* Solstice in summer:                    Glossary.           (line  670)
* Solstice in winter:                    Glossary.           (line  756)
* Solstice, summer:                      Calendar options.   (line   48)
* Solstice, winter:                      Calendar options.   (line   48)
* Special 3-Month mode commands:         Commands.           (line    6)
* Special 3-Month mode commands <1>:     3-Month mode commands.
                                                             (line    6)
* Special 3-Month mode, .:               3-Month mode commands.
                                                             (line    7)
* Special 3-Month mode, . YYYY:          3-Month mode commands.
                                                             (line   12)
* Special 3-Month mode, .+:              3-Month mode commands.
                                                             (line   27)
* Special 3-Month mode, .+ YYYY:         3-Month mode commands.
                                                             (line   32)
* Special 3-Month mode, .-:              3-Month mode commands.
                                                             (line   37)
* Special 3-Month mode, .- YYYY:         3-Month mode commands.
                                                             (line   42)
* Special 3-Month mode, ..:              3-Month mode commands.
                                                             (line   17)
* Special 3-Month mode, .. YYYY:         3-Month mode commands.
                                                             (line   22)
* Special calendar format:               Calendar options.   (line 1286)
* Special character sequences in the text part, handling: Text part of a line.
                                                             (line    6)
* Special characters, country specific:  Calendar options.   (line 1732)
* Special characters, depreciation:      Command line arguments.
                                                             (line   28)
* Special characters, depreciation <1>:  Fixed date options. (line   98)
* Special characters, depreciation <2>:  Fixed date options. (line  104)
* Special characters, depreciation <3>:  Fixed date options. (line  114)
* Special characters, depreciation <4>:  Fixed date options. (line  415)
* Special characters, depreciation <5>:  Fixed date options. (line  503)
* Special characters, depreciation <6>:  Fixed date options. (line  512)
* Special characters, depreciation <7>:  Fixed date options. (line  547)
* Special characters, depreciation <8>:  Fixed date options. (line  747)
* Special characters, depreciation <9>:  Fixed date options. (line  757)
* Special characters, depreciation <10>: Fixed date options. (line  841)
* Special characters, depreciation <11>: Fixed date options. (line  851)
* Special characters, depreciation <12>: Response file.      (line    6)
* Special characters, depreciation <13>: Text part of a line.
                                                             (line   52)
* Special characters, depreciation <14>: Text part of a line.
                                                             (line   93)
* Special characters, depreciation <15>: Special Texts processed.
                                                             (line    6)
* Special characters, depreciation <16>: Text variables.     (line   90)
* Special characters, depreciation <17>: Other difference values.
                                                             (line   11)
* Special characters, protection:        Command line arguments.
                                                             (line   28)
* Special characters, protection <1>:    Fixed date options. (line   98)
* Special characters, protection <2>:    Fixed date options. (line  104)
* Special characters, protection <3>:    Fixed date options. (line  114)
* Special characters, protection <4>:    Fixed date options. (line  415)
* Special characters, protection <5>:    Fixed date options. (line  503)
* Special characters, protection <6>:    Fixed date options. (line  512)
* Special characters, protection <7>:    Fixed date options. (line  547)
* Special characters, protection <8>:    Fixed date options. (line  747)
* Special characters, protection <9>:    Fixed date options. (line  757)
* Special characters, protection <10>:   Fixed date options. (line  841)
* Special characters, protection <11>:   Fixed date options. (line  851)
* Special characters, protection <12>:   Response file.      (line    6)
* Special characters, protection <13>:   Text part of a line.
                                                             (line   52)
* Special characters, protection <14>:   Text part of a line.
                                                             (line   93)
* Special characters, protection <15>:   Special Texts processed.
                                                             (line    6)
* Special characters, protection <16>:   Text variables.     (line   90)
* Special characters, protection <17>:   Other difference values.
                                                             (line   11)
* Special characters, quotation:         Command line arguments.
                                                             (line   28)
* Special characters, quotation <1>:     Response file.      (line    6)
* Special date format in calendar sheet: Calendar options.   (line 1422)
* Special date format in eternal holiday list: Calendar options.
                                                             (line 1440)
* Special date format in fixed date list: Calendar options.  (line 1458)
* Special event oriented texts, Moon data and times: Sun data.
                                                             (line  939)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  939)
* Special text:                          Glossary.           (line  662)
* Special text %![ARGUMENT], shell command: Shell Command.   (line    6)
* Special text %"[ARGUMENT], numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  213)
* Special text %,[DATE], biorhythm text: Biorhythm.          (line   33)
* Special text %0, end of highlighting sequence 1 or 2: Highlighting.
                                                             (line  125)
* Special text %1, start of highlighting sequence 1: Highlighting.
                                                             (line    9)
* Special text %2, end of highlighting sequence 1: Highlighting.
                                                             (line   28)
* Special text %3, start of highlighting sequence 2: Highlighting.
                                                             (line   37)
* Special text %4, end of highlighting sequence 2: Highlighting.
                                                             (line   56)
* Special text %5, start of highlighting sequence 1: Highlighting.
                                                             (line   65)
* Special text %6, end of highlighting sequence 1: Highlighting.
                                                             (line   78)
* Special text %7, start of highlighting sequence 2: Highlighting.
                                                             (line   87)
* Special text %8, end of highlighting sequence 2: Highlighting.
                                                             (line  100)
* Special text %9, start of highlighting sequence 1 or 2: Highlighting.
                                                             (line  109)
* Special text %;[DATE], biorhythm text graphics: Biorhythm. (line   60)
* Special text %=[ARGUMENT], numerical local time timezone offset value: Actual clocktime.
                                                             (line  234)
* Special text %>02&*D[DATE], day number: Day number.        (line   30)
* Special text %>02&*M[DATE], month number: Month number.    (line   31)
* Special text %>02*D[DATE], day number: Day number.         (line   14)
* Special text %>02*M[DATE], month number: Month number.     (line   15)
* Special text %>03&*N[DATE], day-of-year number: Day-of-year number.
                                                             (line   32)
* Special text %>03*N[DATE], day-of-year number: Day-of-year number.
                                                             (line   15)
* Special text %>03*O[DATE], Moon phase text: Moon phase.    (line   30)
* Special text %>04*Y[DATE], year number: Year number.       (line   14)
* Special text %>1&*B[DATE], age value:  Difference value.   (line   30)
* Special text %>1&*D[DATE], day number: Day number.         (line   22)
* Special text %>1&*E[DATE], weekday number: Weekday number. (line   36)
* Special text %>1&*I[DATE], weekday number: Weekday number. (line   55)
* Special text %>1&*J[DATE], weekday number: Weekday number. (line   74)
* Special text %>1&*M[DATE], month number: Month number.     (line   23)
* Special text %>1&*N[DATE], day-of-year number: Day-of-year number.
                                                             (line   24)
* Special text %>1&*S[DATE], weekday number: Weekday number. (line   95)
* Special text %>1&*T[DATE], weekday number: Weekday number. (line  118)
* Special text %>1&*W[DATE], weekday number: Weekday number. (line   18)
* Special text %>2#K[DATE], 2-letter weekday name: Weekday name.
                                                             (line   23)
* Special text %>3#K[DATE], 3-letter weekday name: Weekday name.
                                                             (line   15)
* Special text %>3#U[DATE], 3-letter month name: Month name. (line   15)
* Special text %@[ARGUMENT], actual Universal time in HH:MM/DATE format: Actual clocktime.
                                                             (line  126)
* Special text %A, exclusive Monday:     Exclusive day period.
                                                             (line   18)
* Special text %a, inclusive Monday:     Inclusive day period.
                                                             (line   18)
* Special text %B[DATE], age value:      Difference value.   (line   18)
* Special text %C, exclusive Tuesday:    Exclusive day period.
                                                             (line   21)
* Special text %c, inclusive Tuesday:    Inclusive day period.
                                                             (line   21)
* Special text %d, relative day number:  Other difference values.
                                                             (line   21)
* Special text %D[DATE], day number:     Day number.         (line    7)
* Special text %E[DATE], weekday number: Weekday number.     (line   28)
* Special text %e[DATE][#[DATE]], exclusive date period: Exclusive date period.
                                                             (line    6)
* Special text %F, exclusive Wednesday:  Exclusive day period.
                                                             (line   24)
* Special text %f, inclusive Wednesday:  Inclusive day period.
                                                             (line   24)
* Special text %G, exclusive Thursday:   Exclusive day period.
                                                             (line   27)
* Special text %g, inclusive Thursday:   Inclusive day period.
                                                             (line   27)
* Special text %H, exclusive Friday:     Exclusive day period.
                                                             (line   30)
* Special text %h, inclusive Friday:     Inclusive day period.
                                                             (line   30)
* Special text %I[DATE], weekday number: Weekday number.     (line   46)
* Special text %i[DATE][#[DATE]], inclusive date period: Inclusive date period.
                                                             (line    6)
* Special text %J[DATE], weekday number: Weekday number.     (line   65)
* Special text %K[DATE], complete weekday name: Weekday name.
                                                             (line    7)
* Special text %k[DATE], week number:    Week number.        (line    6)
* Special text %L, exclusive Saturday:   Exclusive day period.
                                                             (line   33)
* Special text %l, inclusive Saturday:   Inclusive day period.
                                                             (line   33)
* Special text %m, relative month number: Other difference values.
                                                             (line   34)
* Special text %M[DATE], month number:   Month number.       (line    7)
* Special text %n[ARGUMENT], textual date: Textual date.     (line    6)
* Special text %N[DATE], day-of-year number: Day-of-year number.
                                                             (line    7)
* Special text %O[DATE], Moon phase text: Moon phase.        (line   15)
* Special text %P, exclusive Sunday:     Exclusive day period.
                                                             (line   36)
* Special text %p, inclusive Sunday:     Inclusive day period.
                                                             (line   36)
* Special text %Q, exclusive Monday...Thursday: Exclusive day period.
                                                             (line   39)
* Special text %q, inclusive Monday...Thursday: Inclusive day period.
                                                             (line   39)
* Special text %R, exclusive Monday...Friday: Exclusive day period.
                                                             (line   42)
* Special text %r, inclusive Monday...Friday: Inclusive day period.
                                                             (line   42)
* Special text %S[DATE], weekday number: Weekday number.     (line   84)
* Special text %t[ARGUMENT], actual local time in HH:MM format: Actual clocktime.
                                                             (line   23)
* Special text %T[DATE], weekday number: Weekday number.     (line  107)
* Special text %U[DATE], complete month name: Month name.    (line    7)
* Special text %V, exclusive legal holidays: Exclusive day period.
                                                             (line   10)
* Special text %v, inclusive legal holidays: Inclusive day period.
                                                             (line   10)
* Special text %w, relative week number: Other difference values.
                                                             (line   29)
* Special text %W[DATE], weekday number: Weekday number.     (line   10)
* Special text %X, exclusive all holidays: Exclusive day period.
                                                             (line   14)
* Special text %x, inclusive all holidays: Inclusive day period.
                                                             (line   14)
* Special text %y, relative year number: Other difference values.
                                                             (line   39)
* Special text %yDATE, relative year number: Difference value.
                                                             (line   10)
* Special text %Y[DATE], year number:    Year number.        (line    7)
* Special text %Z[DATE], Moon phase text graphics: Moon phase.
                                                             (line   45)
* Special text %[FORMAT]'[ARGUMENT], actual local time in M[M...] format: Actual clocktime.
                                                             (line   62)
* Special text %[FORMAT]-[ARGUMENT], environment varibale: Contents of Environment variable.
                                                             (line    6)
* Special text %[FORMAT].[ARGUMENT], actual Universal time hour: Actual clocktime.
                                                             (line  163)
* Special text %[FORMAT]/[ARGUMENT], actual Universal time minute: Actual clocktime.
                                                             (line  179)
* Special text %[FORMAT]?[ARGUMENT], actual local time minute: Actual clocktime.
                                                             (line   94)
* Special text %[FORMAT]b[ARGUMENT], geographical distance and course angle: Geographical distance and course angle.
                                                             (line    6)
* Special text %[FORMAT]D[DATE], day number: Day number.     (line    6)
* Special text %[FORMAT]j[ARGUMENT], Julian day number: Julian day number.
                                                             (line    6)
* Special text %[FORMAT]K[DATE], weekday name: Weekday name. (line    6)
* Special text %[FORMAT]M[DATE], month number: Month number. (line    6)
* Special text %[FORMAT]N[DATE], day-of-year number: Day-of-year number.
                                                             (line    6)
* Special text %[FORMAT]U[DATE], month name: Month name.     (line    6)
* Special text %[FORMAT]Y[DATE], year number: Year number.   (line    6)
* Special text %[FORMAT]_[ARGUMENT], actual local time hour: Actual clocktime.
                                                             (line   78)
* Special text %[FORMAT]`[ARGUMENT], actual Universal time in M[M...]/DATE format: Actual clocktime.
                                                             (line  145)
* Special text %[FORMAT]{[ARGUMENT], actual local time 12-hour format suffix: Actual clocktime.
                                                             (line  110)
* Special text %[FORMAT]}[ARGUMENT], actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  196)
* Special text starting character, %:    Special Texts processed.
                                                             (line    6)
* Special texts:                         Table of Obsolete Special Texts.
                                                             (line    6)
* Special texts %?, exclusions without any argument: Exclusions without any argument.
                                                             (line    6)
* Special texts %?, exclusive day period: Exclusive day period.
                                                             (line    6)
* Special texts %?, highlighting:        Highlighting.       (line    6)
* Special texts %?, inclusive day period: Inclusive day period.
                                                             (line    6)
* Special texts %?, replacements without any argument: Replacements without any argument.
                                                             (line    6)
* Special texts %?..., date exclusion:   Exclusions.         (line    6)
* Special texts %?..., text replacement: Replacements.       (line    6)
* Special texts %?[DATE], biorhythm:     Biorhythm.          (line    6)
* Special texts %?[DATE], exclusions with date argument: Exclusions with date argument.
                                                             (line    6)
* Special texts %?[DATE], replacements with date argument: Replacements with date argument.
                                                             (line    6)
* Special texts %[FORMAT]?, difference value: Other difference values.
                                                             (line    6)
* Special texts %[FORMAT]?ARGUMENT, Moon data: Moon data.    (line    6)
* Special texts %[FORMAT]?ARGUMENT, Sun data: Sun data.      (line    6)
* Special texts %[FORMAT]?[ARGUMENT], actual clocktime: Actual clocktime.
                                                             (line    6)
* Special texts %[FORMAT]?[ARGUMENT], replacements with other argument: Replacements with other argument.
                                                             (line    6)
* Special texts %[FORMAT]?[DATE], difference value: Difference value.
                                                             (line    6)
* Special texts %[FORMAT]?[DATE], Moon phase: Moon phase.    (line    6)
* Special texts %[FORMAT]?[DATE], weekday number: Weekday number.
                                                             (line    6)
* Special texts, obsolete:               Obsolete Special Texts.
                                                             (line    6)
* Specified fiscal years, list:          Lists of commands.  (line   31)
* Specified fiscal years, range:         Ranges of commands. (line   49)
* Specified month of selected years, range: Ranges of commands.
                                                             (line   37)
* Specified months of selected year, list: Lists of commands.
                                                             (line   20)
* Specified months of selected year, range: Ranges of commands.
                                                             (line   22)
* Specified months of selected years, range: Ranges of commands.
                                                             (line   29)
* Specified months of the current year, list: Lists of commands.
                                                             (line    7)
* Specified years, list:                 Lists of commands.  (line   26)
* Specified years, range:                Ranges of commands. (line   44)
* Standard and special date format in calendar sheet: Calendar options.
                                                             (line 1428)
* Standard and special date format in eternal holiday list: Calendar options.
                                                             (line 1446)
* Standard and special date format in fixed date list: Calendar options.
                                                             (line 1464)
* Standard calendar format:              Calendar options.   (line 1286)
* Standard non-visibility period, Moon:  Moon data.          (line  250)
* Standard non-visibility period, Sun:   Sun data.           (line  227)
* Standard rise time, Moon:              Moon data.          (line  195)
* Standard rise time, Sun:               Sun data.           (line  173)
* Standard set time, Moon:               Moon data.          (line  223)
* Standard set time, Sun:                Sun data.           (line  199)
* Standard visibility period, Moon:      Moon data.          (line  242)
* Standard visibility period, Sun:       Sun data.           (line  219)
* Standard week number:                  Calendar options.   (line 1372)
* Standard week number <1>:              Fixed date options. (line  765)
* Standard week number <2>:              Fixed date options. (line  946)
* Standard week number <3>:              Fixed date options. (line  976)
* Standard week number <4>:              Fixed date options. (line 1089)
* Standard week number <5>:              Fixed date options. (line 1123)
* Standard week number <6>:              Date part of a line.
                                                             (line   57)
* Standard week number <7>:              Week number.        (line    7)
* Standard week number <8>:              Glossary.           (line  675)
* Star day:                              Sun data.           (line  473)
* Star day <1>:                          Moon data.          (line  438)
* Star day <2>:                          Glossary.           (line  681)
* Star time:                             Sun data.           (line  473)
* Star time <1>:                         Moon data.          (line  438)
* Start of highlighting sequence 1 %1 special text: Highlighting.
                                                             (line    9)
* Start of highlighting sequence 1 %1 special text <1>: Special Texts Summary.
                                                             (line 1885)
* Start of highlighting sequence 1 %5 special text: Highlighting.
                                                             (line   65)
* Start of highlighting sequence 1 %5 special text <1>: Special Texts Summary.
                                                             (line 1897)
* Start of highlighting sequence 1 or 2 %9 special text: Highlighting.
                                                             (line  109)
* Start of highlighting sequence 1 or 2 %9 special text <1>: Special Texts Summary.
                                                             (line 1913)
* Start of highlighting sequence 2 %3 special text: Highlighting.
                                                             (line   37)
* Start of highlighting sequence 2 %3 special text <1>: Special Texts Summary.
                                                             (line 1891)
* Start of highlighting sequence 2 %7 special text: Highlighting.
                                                             (line   87)
* Start of highlighting sequence 2 %7 special text <1>: Special Texts Summary.
                                                             (line 1905)
* Starting date:                         Glossary.           (line  686)
* Starting date of fixed date:           Inclusive date period.
                                                             (line   11)
* Starting date of fixed date <1>:       Exclusive date period.
                                                             (line   12)
* Starting day of week, setting:         Calendar options.   (line 1469)
* Statute mile:                          Geographical distance and course angle.
                                                             (line   16)
* Statute mile <1>:                      Glossary.           (line  690)
* String:                                Glossary.           (line  693)
* Structure of date part:                Date part of a line.
                                                             (line    6)
* Structure of resource file:            Structure of resource file.
                                                             (line    6)
* Style of representation of Moon data and times: Sun data.  (line  890)
* Style of representation of Moon data and times <1>: Moon data.
                                                             (line  813)
* Style of representation of Sun data and times: Sun data.   (line  890)
* Style of representation, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   16)
* Subtraction by days of date variables: Date variables.     (line  125)
* Subtraction by weekdays of date variables: Date variables. (line  127)
* Subtraction of text variables:         Text variables.     (line  301)
* Summary of all %?... special texts:    Special Texts Summary.
                                                             (line    6)
* Summary of all regular expressions:    Regexp Summary.     (line    6)
* Summer point on the ecliptic:          Glossary.           (line  670)
* Summer solstice:                       Calendar options.   (line   48)
* Summer solstice <1>:                   Glossary.           (line  670)
* Summertime:                            Sun data.           (line 1079)
* Sun and Moon data and times, set cycle displacement value: Fixed date options.
                                                             (line  291)
* Sun and Moon data and times, set cycle ending time value: Fixed date options.
                                                             (line  225)
* Sun and Moon data and times, set cycle timestep value: Fixed date options.
                                                             (line  291)
* Sun and Moon oriented special texts, Clocktime value: Sun data.
                                                             (line  930)
* Sun and Moon oriented special texts, signed angular value: Sun data.
                                                             (line 1013)
* Sun and Moon oriented special texts, signed decimal based rational number value: Sun data.
                                                             (line  915)
* Sun and Moon oriented special texts, signed time value: Sun data.
                                                             (line  982)
* Sun and Moon oriented special texts, unsigned angular value: Sun data.
                                                             (line  998)
* Sun and Moon oriented special texts, unsigned decimal based rational number value: Sun data.
                                                             (line  894)
* Sun and Moon oriented special texts, unsigned time value: Sun data.
                                                             (line  966)
* Sun data %[FORMAT]?ARGUMENT special texts: Sun data.       (line    6)
* Sun data %[FORMAT]?ARGUMENT special texts <1>: Special Texts Summary.
                                                             (line  305)
* Sun data and times, default mode:      Sun data.           (line  883)
* Sun data and times, mode characters:   Sun data.           (line   23)
* Sun data and times, special event oriented texts: Sun data.
                                                             (line  939)
* Sun data and times, style of representation: Sun data.     (line  890)
* Sun data and times, type of representation: Sun data.      (line  890)
* Sun oriented special texts, limitations: Sun data.         (line 1209)
* Sun oriented special texts, reference systems used: Sun data.
                                                             (line 1209)
* Sun oriented special texts, table of modes: Sun data.      (line   35)
* Sun oriented special texts, table of representation types: Sun data.
                                                             (line 1110)
* Sun's center, begin of amateur-astronomical %o*8ARGUMENT special text: Special Texts Summary.
                                                             (line  523)
* Sun's center, begin of amateur-astronomical %o8ARGUMENT special text: Special Texts Summary.
                                                             (line  519)
* Sun's center, begin of amateur-astronomical twilight %o*8ARGUMENT special text: Sun data.
                                                             (line  287)
* Sun's center, begin of amateur-astronomical twilight %o8ARGUMENT special text: Sun data.
                                                             (line  287)
* Sun's center, begin of astronomical twilight %o*9ARGUMENT special text: Sun data.
                                                             (line  313)
* Sun's center, begin of astronomical twilight %o*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  559)
* Sun's center, begin of astronomical twilight %o9ARGUMENT special text: Sun data.
                                                             (line  313)
* Sun's center, begin of astronomical twilight %o9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  555)
* Sun's center, begin of civil twilight %o*6ARGUMENT special text: Sun data.
                                                             (line  235)
* Sun's center, begin of civil twilight %o*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  457)
* Sun's center, begin of civil twilight %o6ARGUMENT special text: Sun data.
                                                             (line  235)
* Sun's center, begin of civil twilight %o6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  453)
* Sun's center, begin of nautical twilight %o*7ARGUMENT special text: Sun data.
                                                             (line  261)
* Sun's center, begin of nautical twilight %o*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  491)
* Sun's center, begin of nautical twilight %o7ARGUMENT special text: Sun data.
                                                             (line  261)
* Sun's center, begin of nautical twilight %o7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  487)
* Sun's center, end of amateur-astronomical %s*8ARGUMENT special text: Special Texts Summary.
                                                             (line  531)
* Sun's center, end of amateur-astronomical %s8ARGUMENT special text: Special Texts Summary.
                                                             (line  527)
* Sun's center, end of amateur-astronomical twilight %s*8ARGUMENT special text: Sun data.
                                                             (line  296)
* Sun's center, end of amateur-astronomical twilight %s8ARGUMENT special text: Sun data.
                                                             (line  296)
* Sun's center, end of astronomical twilight %s*9ARGUMENT special text: Sun data.
                                                             (line  327)
* Sun's center, end of astronomical twilight %s*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  567)
* Sun's center, end of astronomical twilight %s9ARGUMENT special text: Sun data.
                                                             (line  327)
* Sun's center, end of astronomical twilight %s9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  563)
* Sun's center, end of civil twilight %s*6ARGUMENT special text: Sun data.
                                                             (line  244)
* Sun's center, end of civil twilight %s*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  466)
* Sun's center, end of civil twilight %s6ARGUMENT special text: Sun data.
                                                             (line  244)
* Sun's center, end of civil twilight %s6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  461)
* Sun's center, end of nautical twilight %s*7ARGUMENT special text: Sun data.
                                                             (line  270)
* Sun's center, end of nautical twilight %s*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  499)
* Sun's center, end of nautical twilight %s7ARGUMENT special text: Sun data.
                                                             (line  270)
* Sun's center, end of nautical twilight %s7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  495)
* Sun's center, geometrical non-visibility %z*2ARGUMENT special text: Sun data.
                                                             (line  105)
* Sun's center, geometrical non-visibility %z*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  353)
* Sun's center, geometrical non-visibility %z2ARGUMENT special text: Sun data.
                                                             (line  105)
* Sun's center, geometrical non-visibility %z2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  349)
* Sun's center, geometrical rise time %o*2ARGUMENT special text: Sun data.
                                                             (line   81)
* Sun's center, geometrical rise time %o*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  329)
* Sun's center, geometrical rise time %o2ARGUMENT special text: Sun data.
                                                             (line   81)
* Sun's center, geometrical rise time %o2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  325)
* Sun's center, geometrical set time %s*2ARGUMENT special text: Sun data.
                                                             (line   95)
* Sun's center, geometrical set time %s*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  337)
* Sun's center, geometrical set time %s2ARGUMENT special text: Sun data.
                                                             (line   95)
* Sun's center, geometrical set time %s2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  333)
* Sun's center, geometrical visibility %u*2ARGUMENT special text: Sun data.
                                                             (line  100)
* Sun's center, geometrical visibility %u*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  345)
* Sun's center, geometrical visibility %u2ARGUMENT special text: Sun data.
                                                             (line  100)
* Sun's center, geometrical visibility %u2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  341)
* Sun's center, non-visibility %z*4ARGUMENT special text: Sun data.
                                                             (line  168)
* Sun's center, non-visibility %z*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  417)
* Sun's center, non-visibility %z4ARGUMENT special text: Sun data.
                                                             (line  168)
* Sun's center, non-visibility %z4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  413)
* Sun's center, period above amateur-astronomical twilight reference altitude %u*8ARGUMENT special text: Sun data.
                                                             (line  301)
* Sun's center, period above amateur-astronomical twilight reference altitude %u*8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  540)
* Sun's center, period above amateur-astronomical twilight reference altitude %u8ARGUMENT special text: Sun data.
                                                             (line  301)
* Sun's center, period above amateur-astronomical twilight reference altitude %u8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  535)
* Sun's center, period above astronomical twilight reference altitude %u*9ARGUMENT special text: Sun data.
                                                             (line  336)
* Sun's center, period above astronomical twilight reference altitude %u*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  575)
* Sun's center, period above astronomical twilight reference altitude %u9ARGUMENT special text: Sun data.
                                                             (line  336)
* Sun's center, period above astronomical twilight reference altitude %u9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  571)
* Sun's center, period above civil twilight reference altitude %u*6ARGUMENT special text: Sun data.
                                                             (line  249)
* Sun's center, period above civil twilight reference altitude %u*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  475)
* Sun's center, period above civil twilight reference altitude %u6ARGUMENT special text: Sun data.
                                                             (line  249)
* Sun's center, period above civil twilight reference altitude %u6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  471)
* Sun's center, period above nautical twilight reference altitude %u*7ARGUMENT special text: Sun data.
                                                             (line  275)
* Sun's center, period above nautical twilight reference altitude %u*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  507)
* Sun's center, period above nautical twilight reference altitude %u7ARGUMENT special text: Sun data.
                                                             (line  275)
* Sun's center, period above nautical twilight reference altitude %u7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  503)
* Sun's center, period below amateur-astronomical twilight reference altitude %z*8ARGUMENT special text: Sun data.
                                                             (line  307)
* Sun's center, period below amateur-astronomical twilight reference altitude %z*8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  550)
* Sun's center, period below amateur-astronomical twilight reference altitude %z8ARGUMENT special text: Sun data.
                                                             (line  307)
* Sun's center, period below amateur-astronomical twilight reference altitude %z8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  545)
* Sun's center, period below astronomical twilight reference altitude %z*9ARGUMENT special text: Sun data.
                                                             (line  342)
* Sun's center, period below astronomical twilight reference altitude %z*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  583)
* Sun's center, period below astronomical twilight reference altitude %z9ARGUMENT special text: Sun data.
                                                             (line  342)
* Sun's center, period below astronomical twilight reference altitude %z9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  579)
* Sun's center, period below civil twilight reference altitude %z*6ARGUMENT special text: Sun data.
                                                             (line  255)
* Sun's center, period below civil twilight reference altitude %z*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  483)
* Sun's center, period below civil twilight reference altitude %z6ARGUMENT special text: Sun data.
                                                             (line  255)
* Sun's center, period below civil twilight reference altitude %z6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  479)
* Sun's center, period below nautical twilight reference altitude %z*7ARGUMENT special text: Sun data.
                                                             (line  281)
* Sun's center, period below nautical twilight reference altitude %z*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  515)
* Sun's center, period below nautical twilight reference altitude %z7ARGUMENT special text: Sun data.
                                                             (line  281)
* Sun's center, period below nautical twilight reference altitude %z7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  511)
* Sun's center, rise time %o*4ARGUMENT special text: Sun data.
                                                             (line  139)
* Sun's center, rise time %o*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  394)
* Sun's center, rise time %o4ARGUMENT special text: Sun data.
                                                             (line  139)
* Sun's center, rise time %o4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  391)
* Sun's center, set time %s*4ARGUMENT special text: Sun data.
                                                             (line  153)
* Sun's center, set time %s*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  401)
* Sun's center, set time %s4ARGUMENT special text: Sun data. (line  153)
* Sun's center, set time %s4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  398)
* Sun's center, visibility %u*4ARGUMENT special text: Sun data.
                                                             (line  163)
* Sun's center, visibility %u*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  409)
* Sun's center, visibility %u4ARGUMENT special text: Sun data.
                                                             (line  163)
* Sun's center, visibility %u4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  405)
* Sun's orbit:                           Sun data.           (line  387)
* Sun's orbit <1>:                       Moon data.          (line  327)
* Sun's orbit <2>:                       Moon data.          (line  335)
* Sun's upper limb, geometrical non-visibility %z*3ARGUMENT special text: Sun data.
                                                             (line  134)
* Sun's upper limb, geometrical non-visibility %z*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  387)
* Sun's upper limb, geometrical non-visibility %z3ARGUMENT special text: Sun data.
                                                             (line  134)
* Sun's upper limb, geometrical non-visibility %z3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  383)
* Sun's upper limb, geometrical rise time %o*3ARGUMENT special text: Sun data.
                                                             (line  110)
* Sun's upper limb, geometrical rise time %o*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  362)
* Sun's upper limb, geometrical rise time %o3ARGUMENT special text: Sun data.
                                                             (line  110)
* Sun's upper limb, geometrical rise time %o3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  357)
* Sun's upper limb, geometrical set time %s*3ARGUMENT special text: Sun data.
                                                             (line  122)
* Sun's upper limb, geometrical set time %s*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  371)
* Sun's upper limb, geometrical set time %s3ARGUMENT special text: Sun data.
                                                             (line  122)
* Sun's upper limb, geometrical set time %s3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  367)
* Sun's upper limb, geometrical visibility %u*3ARGUMENT special text: Sun data.
                                                             (line  129)
* Sun's upper limb, geometrical visibility %u*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  379)
* Sun's upper limb, geometrical visibility %u3ARGUMENT special text: Sun data.
                                                             (line  129)
* Sun's upper limb, geometrical visibility %u3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  375)
* Sun's upper limb, standard non-visibility %z*5ARGUMENT special text: Sun data.
                                                             (line  227)
* Sun's upper limb, standard non-visibility %z*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  449)
* Sun's upper limb, standard non-visibility %z5ARGUMENT special text: Sun data.
                                                             (line  227)
* Sun's upper limb, standard non-visibility %z5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  445)
* Sun's upper limb, standard rise time %o*5ARGUMENT special text: Sun data.
                                                             (line  173)
* Sun's upper limb, standard rise time %o*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  425)
* Sun's upper limb, standard rise time %o5ARGUMENT special text: Sun data.
                                                             (line  173)
* Sun's upper limb, standard rise time %o5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  421)
* Sun's upper limb, standard set time %s*5ARGUMENT special text: Sun data.
                                                             (line  199)
* Sun's upper limb, standard set time %s*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  433)
* Sun's upper limb, standard set time %s5ARGUMENT special text: Sun data.
                                                             (line  199)
* Sun's upper limb, standard set time %s5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  429)
* Sun's upper limb, standard visibility %u*5ARGUMENT special text: Sun data.
                                                             (line  219)
* Sun's upper limb, standard visibility %u*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  441)
* Sun's upper limb, standard visibility %u5ARGUMENT special text: Sun data.
                                                             (line  219)
* Sun's upper limb, standard visibility %u5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  437)
* Sun, amateur-astronomical twilight:    Sun data.           (line  287)
* Sun, amateur-astronomical twilight <1>: Sun data.          (line  296)
* Sun, astronomical midnight time %o*0ARGUMENT special text: Sun data.
                                                             (line   38)
* Sun, astronomical midnight time %o*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  312)
* Sun, astronomical midnight time %o0ARGUMENT special text: Sun data.
                                                             (line   38)
* Sun, astronomical midnight time %o0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  308)
* Sun, astronomical midnight time %s*0ARGUMENT special text: Sun data.
                                                             (line   38)
* Sun, astronomical midnight time %s*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  312)
* Sun, astronomical midnight time %s0ARGUMENT special text: Sun data.
                                                             (line   38)
* Sun, astronomical midnight time %s0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  308)
* Sun, astronomical noon time %o*1ARGUMENT special text: Sun data.
                                                             (line   50)
* Sun, astronomical noon time %o*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  321)
* Sun, astronomical noon time %o1ARGUMENT special text: Sun data.
                                                             (line   50)
* Sun, astronomical noon time %o1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  317)
* Sun, astronomical noon time %s*1ARGUMENT special text: Sun data.
                                                             (line   50)
* Sun, astronomical noon time %s*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  321)
* Sun, astronomical noon time %s1ARGUMENT special text: Sun data.
                                                             (line   50)
* Sun, astronomical noon time %s1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  317)
* Sun, astronomical twilight:            Sun data.           (line  313)
* Sun, astronomical twilight <1>:        Sun data.           (line  327)
* Sun, astronomical unit:                Sun data.           (line  402)
* Sun, azimuth:                          Sun data.           (line   38)
* Sun, base time %o*tARGUMENT special text: Sun data.        (line  488)
* Sun, base time %o*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line  777)
* Sun, base time %otARGUMENT special text: Sun data.         (line  488)
* Sun, base time %otARGUMENT special text <1>: Special Texts Summary.
                                                             (line  772)
* Sun, base time %s*tARGUMENT special text: Sun data.        (line  488)
* Sun, base time %s*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line  777)
* Sun, base time %stARGUMENT special text: Sun data.         (line  488)
* Sun, base time %stARGUMENT special text <1>: Special Texts Summary.
                                                             (line  772)
* Sun, civil twilight:                   Sun data.           (line  235)
* Sun, civil twilight <1>:               Sun data.           (line  244)
* Sun, delta-t %o*rARGUMENT special text: Sun data.          (line  466)
* Sun, delta-t %o*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line  759)
* Sun, delta-t %orARGUMENT special text: Sun data.           (line  466)
* Sun, delta-t %orARGUMENT special text <1>: Special Texts Summary.
                                                             (line  759)
* Sun, delta-t %s*rARGUMENT special text: Sun data.          (line  466)
* Sun, delta-t %s*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line  759)
* Sun, delta-t %srARGUMENT special text: Sun data.           (line  466)
* Sun, delta-t %srARGUMENT special text <1>: Special Texts Summary.
                                                             (line  759)
* Sun, double shadow length time at afternoon %s*RARGUMENT special text: Sun data.
                                                             (line  855)
* Sun, double shadow length time at afternoon %s*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1096)
* Sun, double shadow length time at afternoon %sRARGUMENT special text: Sun data.
                                                             (line  855)
* Sun, double shadow length time at afternoon %sRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1092)
* Sun, double shadow length time at forenoon %o*RARGUMENT special text: Sun data.
                                                             (line  846)
* Sun, double shadow length time at forenoon %o*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1087)
* Sun, double shadow length time at forenoon %oRARGUMENT special text: Sun data.
                                                             (line  846)
* Sun, double shadow length time at forenoon %oRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1082)
* Sun, equation of time %o*wARGUMENT special text: Sun data. (line  508)
* Sun, equation of time %o*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line  798)
* Sun, equation of time %owARGUMENT special text: Sun data.  (line  508)
* Sun, equation of time %owARGUMENT special text <1>: Special Texts Summary.
                                                             (line  793)
* Sun, equation of time %s*wARGUMENT special text: Sun data. (line  508)
* Sun, equation of time %s*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line  798)
* Sun, equation of time %swARGUMENT special text: Sun data.  (line  508)
* Sun, equation of time %swARGUMENT special text <1>: Special Texts Summary.
                                                             (line  793)
* Sun, evening width geocentric:         Sun data.           (line  799)
* Sun, evening width topocentric:        Sun data.           (line  751)
* Sun, geocentric azimuth %o*kARGUMENT special text: Sun data.
                                                             (line  433)
* Sun, geocentric azimuth %o*kARGUMENT special text <1>: Special Texts Summary.
                                                             (line  692)
* Sun, geocentric azimuth %okARGUMENT special text: Sun data.
                                                             (line  433)
* Sun, geocentric azimuth %okARGUMENT special text <1>: Special Texts Summary.
                                                             (line  687)
* Sun, geocentric azimuth %s*kARGUMENT special text: Sun data.
                                                             (line  433)
* Sun, geocentric azimuth %s*kARGUMENT special text <1>: Special Texts Summary.
                                                             (line  692)
* Sun, geocentric azimuth %skARGUMENT special text: Sun data.
                                                             (line  433)
* Sun, geocentric azimuth %skARGUMENT special text <1>: Special Texts Summary.
                                                             (line  687)
* Sun, geocentric azimuth at standard rise time %o*PARGUMENT special text: Sun data.
                                                             (line  789)
* Sun, geocentric azimuth at standard rise time %o*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1035)
* Sun, geocentric azimuth at standard rise time %oPARGUMENT special text: Sun data.
                                                             (line  789)
* Sun, geocentric azimuth at standard rise time %oPARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1031)
* Sun, geocentric azimuth at standard set time %s*PARGUMENT special text: Sun data.
                                                             (line  799)
* Sun, geocentric azimuth at standard set time %s*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1043)
* Sun, geocentric azimuth at standard set time %sPARGUMENT special text: Sun data.
                                                             (line  799)
* Sun, geocentric azimuth at standard set time %sPARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1039)
* Sun, geocentric data:                  Sun data.           (line  348)
* Sun, geocentric declination %o*lARGUMENT special text: Sun data.
                                                             (line  437)
* Sun, geocentric declination %o*lARGUMENT special text <1>: Special Texts Summary.
                                                             (line  702)
* Sun, geocentric declination %olARGUMENT special text: Sun data.
                                                             (line  437)
* Sun, geocentric declination %olARGUMENT special text <1>: Special Texts Summary.
                                                             (line  697)
* Sun, geocentric declination %s*lARGUMENT special text: Sun data.
                                                             (line  437)
* Sun, geocentric declination %s*lARGUMENT special text <1>: Special Texts Summary.
                                                             (line  702)
* Sun, geocentric declination %slARGUMENT special text: Sun data.
                                                             (line  437)
* Sun, geocentric declination %slARGUMENT special text <1>: Special Texts Summary.
                                                             (line  697)
* Sun, geocentric distance %o*oARGUMENT special text: Sun data.
                                                             (line  454)
* Sun, geocentric distance %o*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line  732)
* Sun, geocentric distance %ooARGUMENT special text: Sun data.
                                                             (line  454)
* Sun, geocentric distance %ooARGUMENT special text <1>: Special Texts Summary.
                                                             (line  727)
* Sun, geocentric distance %s*oARGUMENT special text: Sun data.
                                                             (line  454)
* Sun, geocentric distance %s*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line  732)
* Sun, geocentric distance %soARGUMENT special text: Sun data.
                                                             (line  454)
* Sun, geocentric distance %soARGUMENT special text <1>: Special Texts Summary.
                                                             (line  727)
* Sun, geocentric ecliptic longitude %o*mARGUMENT special text: Sun data.
                                                             (line  446)
* Sun, geocentric ecliptic longitude %o*mARGUMENT special text <1>: Special Texts Summary.
                                                             (line  712)
* Sun, geocentric ecliptic longitude %omARGUMENT special text: Sun data.
                                                             (line  446)
* Sun, geocentric ecliptic longitude %omARGUMENT special text <1>: Special Texts Summary.
                                                             (line  707)
* Sun, geocentric ecliptic longitude %s*mARGUMENT special text: Sun data.
                                                             (line  446)
* Sun, geocentric ecliptic longitude %s*mARGUMENT special text <1>: Special Texts Summary.
                                                             (line  712)
* Sun, geocentric ecliptic longitude %smARGUMENT special text: Sun data.
                                                             (line  446)
* Sun, geocentric ecliptic longitude %smARGUMENT special text <1>: Special Texts Summary.
                                                             (line  707)
* Sun, geocentric elevation %o*jARGUMENT special text: Sun data.
                                                             (line  425)
* Sun, geocentric elevation %o*jARGUMENT special text <1>: Special Texts Summary.
                                                             (line  681)
* Sun, geocentric elevation %ojARGUMENT special text: Sun data.
                                                             (line  425)
* Sun, geocentric elevation %ojARGUMENT special text <1>: Special Texts Summary.
                                                             (line  676)
* Sun, geocentric elevation %s*jARGUMENT special text: Sun data.
                                                             (line  425)
* Sun, geocentric elevation %s*jARGUMENT special text <1>: Special Texts Summary.
                                                             (line  681)
* Sun, geocentric elevation %sjARGUMENT special text: Sun data.
                                                             (line  425)
* Sun, geocentric elevation %sjARGUMENT special text <1>: Special Texts Summary.
                                                             (line  676)
* Sun, geocentric elevation at standard rise time %o*OARGUMENT special text: Sun data.
                                                             (line  775)
* Sun, geocentric elevation at standard rise time %o*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1019)
* Sun, geocentric elevation at standard rise time %oOARGUMENT special text: Sun data.
                                                             (line  775)
* Sun, geocentric elevation at standard rise time %oOARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1015)
* Sun, geocentric elevation at standard set time %s*OARGUMENT special text: Sun data.
                                                             (line  782)
* Sun, geocentric elevation at standard set time %s*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1027)
* Sun, geocentric elevation at standard set time %sOARGUMENT special text: Sun data.
                                                             (line  782)
* Sun, geocentric elevation at standard set time %sOARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1023)
* Sun, geocentric elevation at Sun's astronomical midnight time %o*MARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at Sun's astronomical midnight time %o*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1001)
* Sun, geocentric elevation at Sun's astronomical midnight time %oMARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at Sun's astronomical midnight time %oMARGUMENT special text <1>: Special Texts Summary.
                                                             (line  996)
* Sun, geocentric elevation at Sun's astronomical midnight time %s*MARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at Sun's astronomical midnight time %s*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1001)
* Sun, geocentric elevation at Sun's astronomical midnight time %sMARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at Sun's astronomical midnight time %sMARGUMENT special text <1>: Special Texts Summary.
                                                             (line  996)
* Sun, geocentric elevation at Sun's astronomical noon time %o*NARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at Sun's astronomical noon time %o*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1011)
* Sun, geocentric elevation at Sun's astronomical noon time %oNARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at Sun's astronomical noon time %oNARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1006)
* Sun, geocentric elevation at Sun's astronomical noon time %s*NARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at Sun's astronomical noon time %s*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1011)
* Sun, geocentric elevation at Sun's astronomical noon time %sNARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at Sun's astronomical noon time %sNARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1006)
* Sun, geocentric horizontal parallax %o*pARGUMENT special text: Sun data.
                                                             (line  458)
* Sun, geocentric horizontal parallax %o*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line  741)
* Sun, geocentric horizontal parallax %opARGUMENT special text: Sun data.
                                                             (line  458)
* Sun, geocentric horizontal parallax %opARGUMENT special text <1>: Special Texts Summary.
                                                             (line  736)
* Sun, geocentric horizontal parallax %s*pARGUMENT special text: Sun data.
                                                             (line  458)
* Sun, geocentric horizontal parallax %s*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line  741)
* Sun, geocentric horizontal parallax %spARGUMENT special text: Sun data.
                                                             (line  458)
* Sun, geocentric horizontal parallax %spARGUMENT special text <1>: Special Texts Summary.
                                                             (line  736)
* Sun, geocentric right ascension %o*nARGUMENT special text: Sun data.
                                                             (line  450)
* Sun, geocentric right ascension %o*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line  722)
* Sun, geocentric right ascension %onARGUMENT special text: Sun data.
                                                             (line  450)
* Sun, geocentric right ascension %onARGUMENT special text <1>: Special Texts Summary.
                                                             (line  717)
* Sun, geocentric right ascension %s*nARGUMENT special text: Sun data.
                                                             (line  450)
* Sun, geocentric right ascension %s*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line  722)
* Sun, geocentric right ascension %snARGUMENT special text: Sun data.
                                                             (line  450)
* Sun, geocentric right ascension %snARGUMENT special text <1>: Special Texts Summary.
                                                             (line  717)
* Sun, geocentric semidiameter %o*qARGUMENT special text: Sun data.
                                                             (line  462)
* Sun, geocentric semidiameter %o*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line  751)
* Sun, geocentric semidiameter %oqARGUMENT special text: Sun data.
                                                             (line  462)
* Sun, geocentric semidiameter %oqARGUMENT special text <1>: Special Texts Summary.
                                                             (line  746)
* Sun, geocentric semidiameter %s*qARGUMENT special text: Sun data.
                                                             (line  462)
* Sun, geocentric semidiameter %s*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line  751)
* Sun, geocentric semidiameter %sqARGUMENT special text: Sun data.
                                                             (line  462)
* Sun, geocentric semidiameter %sqARGUMENT special text <1>: Special Texts Summary.
                                                             (line  746)
* Sun, highest culmination point:        Sun data.           (line   50)
* Sun, Julian date %o*uARGUMENT special text: Sun data.      (line  498)
* Sun, Julian date %o*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, Julian date %ouARGUMENT special text: Sun data.       (line  498)
* Sun, Julian date %ouARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, Julian date %s*uARGUMENT special text: Sun data.      (line  498)
* Sun, Julian date %s*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, Julian date %suARGUMENT special text: Sun data.       (line  498)
* Sun, Julian date %suARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, Julian Ephemeris date %o*vARGUMENT special text: Sun data.
                                                             (line  503)
* Sun, Julian Ephemeris date %o*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line  789)
* Sun, Julian Ephemeris date %ovARGUMENT special text: Sun data.
                                                             (line  503)
* Sun, Julian Ephemeris date %ovARGUMENT special text <1>: Special Texts Summary.
                                                             (line  789)
* Sun, Julian Ephemeris date %s*vARGUMENT special text: Sun data.
                                                             (line  503)
* Sun, Julian Ephemeris date %s*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line  789)
* Sun, Julian Ephemeris date %svARGUMENT special text: Sun data.
                                                             (line  503)
* Sun, Julian Ephemeris date %svARGUMENT special text <1>: Special Texts Summary.
                                                             (line  789)
* Sun, local sidereal time %o*sARGUMENT special text: Sun data.
                                                             (line  473)
* Sun, local sidereal time %o*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line  767)
* Sun, local sidereal time %osARGUMENT special text: Sun data.
                                                             (line  473)
* Sun, local sidereal time %osARGUMENT special text <1>: Special Texts Summary.
                                                             (line  763)
* Sun, local sidereal time %s*sARGUMENT special text: Sun data.
                                                             (line  473)
* Sun, local sidereal time %s*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line  767)
* Sun, local sidereal time %ssARGUMENT special text: Sun data.
                                                             (line  473)
* Sun, local sidereal time %ssARGUMENT special text <1>: Special Texts Summary.
                                                             (line  763)
* Sun, lowest culmination point:         Sun data.           (line   38)
* Sun, mean:                             Sun data.           (line  508)
* Sun, midnight height geocentric:       Sun data.           (line  761)
* Sun, midnight height topocentric:      Sun data.           (line  713)
* Sun, morning width geocentric:         Sun data.           (line  789)
* Sun, morning width topocentric:        Sun data.           (line  741)
* Sun, nautical twilight:                Sun data.           (line  261)
* Sun, nautical twilight <1>:            Sun data.           (line  270)
* Sun, noon height geocentric:           Sun data.           (line  768)
* Sun, noon height topocentric:          Sun data.           (line  720)
* Sun, noon line:                        Sun data.           (line   38)
* Sun, period of double or shorter shadow length %u*RARGUMENT special text: Sun data.
                                                             (line  871)
* Sun, period of double or shorter shadow length %u*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1104)
* Sun, period of double or shorter shadow length %uRARGUMENT special text: Sun data.
                                                             (line  871)
* Sun, period of double or shorter shadow length %uRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1100)
* Sun, period of longer than double shadow length %z*RARGUMENT special text: Sun data.
                                                             (line  877)
* Sun, period of longer than double shadow length %z*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1112)
* Sun, period of longer than double shadow length %zRARGUMENT special text: Sun data.
                                                             (line  877)
* Sun, period of longer than double shadow length %zRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1108)
* Sun, period of longer than single shadow length %z*QARGUMENT special text: Sun data.
                                                             (line  840)
* Sun, period of longer than single shadow length %z*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1077)
* Sun, period of longer than single shadow length %zQARGUMENT special text: Sun data.
                                                             (line  840)
* Sun, period of longer than single shadow length %zQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1073)
* Sun, period of single or shorter shadow length %u*QARGUMENT special text: Sun data.
                                                             (line  834)
* Sun, period of single or shorter shadow length %u*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1069)
* Sun, period of single or shorter shadow length %uQARGUMENT special text: Sun data.
                                                             (line  834)
* Sun, period of single or shorter shadow length %uQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1065)
* Sun, refraction %o*iARGUMENT special text: Sun data.       (line  421)
* Sun, refraction %o*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line  672)
* Sun, refraction %oiARGUMENT special text: Sun data.        (line  421)
* Sun, refraction %oiARGUMENT special text <1>: Special Texts Summary.
                                                             (line  667)
* Sun, refraction %s*iARGUMENT special text: Sun data.       (line  421)
* Sun, refraction %s*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line  672)
* Sun, refraction %siARGUMENT special text: Sun data.        (line  421)
* Sun, refraction %siARGUMENT special text <1>: Special Texts Summary.
                                                             (line  667)
* Sun, rise azimuth geocentric:          Sun data.           (line  789)
* Sun, rise azimuth topocentric:         Sun data.           (line  741)
* Sun, rise height geocentric:           Sun data.           (line  775)
* Sun, rise height topocentric:          Sun data.           (line  727)
* Sun, set azimuth geocentric:           Sun data.           (line  799)
* Sun, set azimuth topocentric:          Sun data.           (line  751)
* Sun, set height geocentric:            Sun data.           (line  782)
* Sun, set height topocentric:           Sun data.           (line  734)
* Sun, single shadow length time at afternoon %s*QARGUMENT special text: Sun data.
                                                             (line  818)
* Sun, single shadow length time at afternoon %s*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1061)
* Sun, single shadow length time at afternoon %sQARGUMENT special text: Sun data.
                                                             (line  818)
* Sun, single shadow length time at afternoon %sQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1057)
* Sun, single shadow length time at forenoon %o*QARGUMENT special text: Sun data.
                                                             (line  809)
* Sun, single shadow length time at forenoon %o*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1052)
* Sun, single shadow length time at forenoon %oQARGUMENT special text: Sun data.
                                                             (line  809)
* Sun, single shadow length time at forenoon %oQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1047)
* Sun, standard non-visibility period:   Sun data.           (line  227)
* Sun, standard rise time:               Sun data.           (line  173)
* Sun, standard set time:                Sun data.           (line  199)
* Sun, standard visibility period:       Sun data.           (line  219)
* Sun, topocentric azimuth %o*bARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric azimuth %o*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line  603)
* Sun, topocentric azimuth %obARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric azimuth %obARGUMENT special text <1>: Special Texts Summary.
                                                             (line  598)
* Sun, topocentric azimuth %s*bARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric azimuth %s*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line  603)
* Sun, topocentric azimuth %sbARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric azimuth %sbARGUMENT special text <1>: Special Texts Summary.
                                                             (line  598)
* Sun, topocentric azimuth at standard rise time %o*LARGUMENT special text: Sun data.
                                                             (line  741)
* Sun, topocentric azimuth at standard rise time %o*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line  983)
* Sun, topocentric azimuth at standard rise time %oLARGUMENT special text: Sun data.
                                                             (line  741)
* Sun, topocentric azimuth at standard rise time %oLARGUMENT special text <1>: Special Texts Summary.
                                                             (line  979)
* Sun, topocentric azimuth at standard set time %s*LARGUMENT special text: Sun data.
                                                             (line  751)
* Sun, topocentric azimuth at standard set time %s*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line  991)
* Sun, topocentric azimuth at standard set time %sLARGUMENT special text: Sun data.
                                                             (line  751)
* Sun, topocentric azimuth at standard set time %sLARGUMENT special text <1>: Special Texts Summary.
                                                             (line  987)
* Sun, topocentric data:                 Sun data.           (line  348)
* Sun, topocentric declination %o*cARGUMENT special text: Sun data.
                                                             (line  376)
* Sun, topocentric declination %o*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line  613)
* Sun, topocentric declination %ocARGUMENT special text: Sun data.
                                                             (line  376)
* Sun, topocentric declination %ocARGUMENT special text <1>: Special Texts Summary.
                                                             (line  608)
* Sun, topocentric declination %s*cARGUMENT special text: Sun data.
                                                             (line  376)
* Sun, topocentric declination %s*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line  613)
* Sun, topocentric declination %scARGUMENT special text: Sun data.
                                                             (line  376)
* Sun, topocentric declination %scARGUMENT special text <1>: Special Texts Summary.
                                                             (line  608)
* Sun, topocentric distance %o*fARGUMENT special text: Sun data.
                                                             (line  402)
* Sun, topocentric distance %o*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line  643)
* Sun, topocentric distance %ofARGUMENT special text: Sun data.
                                                             (line  402)
* Sun, topocentric distance %ofARGUMENT special text <1>: Special Texts Summary.
                                                             (line  638)
* Sun, topocentric distance %s*fARGUMENT special text: Sun data.
                                                             (line  402)
* Sun, topocentric distance %s*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line  643)
* Sun, topocentric distance %sfARGUMENT special text: Sun data.
                                                             (line  402)
* Sun, topocentric distance %sfARGUMENT special text <1>: Special Texts Summary.
                                                             (line  638)
* Sun, topocentric ecliptic longitude %o*dARGUMENT special text: Sun data.
                                                             (line  387)
* Sun, topocentric ecliptic longitude %o*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line  623)
* Sun, topocentric ecliptic longitude %odARGUMENT special text: Sun data.
                                                             (line  387)
* Sun, topocentric ecliptic longitude %odARGUMENT special text <1>: Special Texts Summary.
                                                             (line  618)
* Sun, topocentric ecliptic longitude %s*dARGUMENT special text: Sun data.
                                                             (line  387)
* Sun, topocentric ecliptic longitude %s*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line  623)
* Sun, topocentric ecliptic longitude %sdARGUMENT special text: Sun data.
                                                             (line  387)
* Sun, topocentric ecliptic longitude %sdARGUMENT special text <1>: Special Texts Summary.
                                                             (line  618)
* Sun, topocentric elevation %o*aARGUMENT special text: Sun data.
                                                             (line  348)
* Sun, topocentric elevation %o*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line  593)
* Sun, topocentric elevation %oaARGUMENT special text: Sun data.
                                                             (line  348)
* Sun, topocentric elevation %oaARGUMENT special text <1>: Special Texts Summary.
                                                             (line  588)
* Sun, topocentric elevation %s*aARGUMENT special text: Sun data.
                                                             (line  348)
* Sun, topocentric elevation %s*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line  593)
* Sun, topocentric elevation %saARGUMENT special text: Sun data.
                                                             (line  348)
* Sun, topocentric elevation %saARGUMENT special text <1>: Special Texts Summary.
                                                             (line  588)
* Sun, topocentric elevation at standard rise time %o*KARGUMENT special text: Sun data.
                                                             (line  727)
* Sun, topocentric elevation at standard rise time %o*KARGUMENT special text <1>: Special Texts Summary.
                                                             (line  967)
* Sun, topocentric elevation at standard rise time %oKARGUMENT special text: Sun data.
                                                             (line  727)
* Sun, topocentric elevation at standard rise time %oKARGUMENT special text <1>: Special Texts Summary.
                                                             (line  963)
* Sun, topocentric elevation at standard set time %s*KARGUMENT special text: Sun data.
                                                             (line  734)
* Sun, topocentric elevation at standard set time %s*KARGUMENT special text <1>: Special Texts Summary.
                                                             (line  975)
* Sun, topocentric elevation at standard set time %sKARGUMENT special text: Sun data.
                                                             (line  734)
* Sun, topocentric elevation at standard set time %sKARGUMENT special text <1>: Special Texts Summary.
                                                             (line  971)
* Sun, topocentric elevation at Sun's astronomical midnight time %o*IARGUMENT special text: Sun data.
                                                             (line  713)
* Sun, topocentric elevation at Sun's astronomical midnight time %o*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line  949)
* Sun, topocentric elevation at Sun's astronomical midnight time %oIARGUMENT special text: Sun data.
                                                             (line  713)
* Sun, topocentric elevation at Sun's astronomical midnight time %oIARGUMENT special text <1>: Special Texts Summary.
                                                             (line  944)
* Sun, topocentric elevation at Sun's astronomical midnight time %s*IARGUMENT special text: Sun data.
                                                             (line  713)
* Sun, topocentric elevation at Sun's astronomical midnight time %s*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line  949)
* Sun, topocentric elevation at Sun's astronomical midnight time %sIARGUMENT special text: Sun data.
                                                             (line  713)
* Sun, topocentric elevation at Sun's astronomical midnight time %sIARGUMENT special text <1>: Special Texts Summary.
                                                             (line  944)
* Sun, topocentric elevation at Sun's astronomical noon time %o*JARGUMENT special text: Sun data.
                                                             (line  720)
* Sun, topocentric elevation at Sun's astronomical noon time %o*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line  959)
* Sun, topocentric elevation at Sun's astronomical noon time %oJARGUMENT special text: Sun data.
                                                             (line  720)
* Sun, topocentric elevation at Sun's astronomical noon time %oJARGUMENT special text <1>: Special Texts Summary.
                                                             (line  954)
* Sun, topocentric elevation at Sun's astronomical noon time %s*JARGUMENT special text: Sun data.
                                                             (line  720)
* Sun, topocentric elevation at Sun's astronomical noon time %s*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line  959)
* Sun, topocentric elevation at Sun's astronomical noon time %sJARGUMENT special text: Sun data.
                                                             (line  720)
* Sun, topocentric elevation at Sun's astronomical noon time %sJARGUMENT special text <1>: Special Texts Summary.
                                                             (line  954)
* Sun, topocentric horizontal parallax %o*gARGUMENT special text: Sun data.
                                                             (line  410)
* Sun, topocentric horizontal parallax %o*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line  652)
* Sun, topocentric horizontal parallax %ogARGUMENT special text: Sun data.
                                                             (line  410)
* Sun, topocentric horizontal parallax %ogARGUMENT special text <1>: Special Texts Summary.
                                                             (line  647)
* Sun, topocentric horizontal parallax %s*gARGUMENT special text: Sun data.
                                                             (line  410)
* Sun, topocentric horizontal parallax %s*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line  652)
* Sun, topocentric horizontal parallax %sgARGUMENT special text: Sun data.
                                                             (line  410)
* Sun, topocentric horizontal parallax %sgARGUMENT special text <1>: Special Texts Summary.
                                                             (line  647)
* Sun, topocentric right ascension %o*eARGUMENT special text: Sun data.
                                                             (line  395)
* Sun, topocentric right ascension %o*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line  633)
* Sun, topocentric right ascension %oeARGUMENT special text: Sun data.
                                                             (line  395)
* Sun, topocentric right ascension %oeARGUMENT special text <1>: Special Texts Summary.
                                                             (line  628)
* Sun, topocentric right ascension %s*eARGUMENT special text: Sun data.
                                                             (line  395)
* Sun, topocentric right ascension %s*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line  633)
* Sun, topocentric right ascension %seARGUMENT special text: Sun data.
                                                             (line  395)
* Sun, topocentric right ascension %seARGUMENT special text <1>: Special Texts Summary.
                                                             (line  628)
* Sun, topocentric semidiameter %o*hARGUMENT special text: Sun data.
                                                             (line  417)
* Sun, topocentric semidiameter %o*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line  662)
* Sun, topocentric semidiameter %ohARGUMENT special text: Sun data.
                                                             (line  417)
* Sun, topocentric semidiameter %ohARGUMENT special text <1>: Special Texts Summary.
                                                             (line  657)
* Sun, topocentric semidiameter %s*hARGUMENT special text: Sun data.
                                                             (line  417)
* Sun, topocentric semidiameter %s*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line  662)
* Sun, topocentric semidiameter %shARGUMENT special text: Sun data.
                                                             (line  417)
* Sun, topocentric semidiameter %shARGUMENT special text <1>: Special Texts Summary.
                                                             (line  657)
* Sun/Moon, delta astronomical midnight time %o*FARGUMENT special text: Sun data.
                                                             (line  642)
* Sun/Moon, delta astronomical midnight time %o*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line  913)
* Sun/Moon, delta astronomical midnight time %oFARGUMENT special text: Sun data.
                                                             (line  642)
* Sun/Moon, delta astronomical midnight time %oFARGUMENT special text <1>: Special Texts Summary.
                                                             (line  908)
* Sun/Moon, delta astronomical midnight time %s*FARGUMENT special text: Sun data.
                                                             (line  642)
* Sun/Moon, delta astronomical midnight time %s*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line  913)
* Sun/Moon, delta astronomical midnight time %sFARGUMENT special text: Sun data.
                                                             (line  642)
* Sun/Moon, delta astronomical midnight time %sFARGUMENT special text <1>: Special Texts Summary.
                                                             (line  908)
* Sun/Moon, delta astronomical noon time %o*GARGUMENT special text: Sun data.
                                                             (line  661)
* Sun/Moon, delta astronomical noon time %o*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line  923)
* Sun/Moon, delta astronomical noon time %oGARGUMENT special text: Sun data.
                                                             (line  661)
* Sun/Moon, delta astronomical noon time %oGARGUMENT special text <1>: Special Texts Summary.
                                                             (line  918)
* Sun/Moon, delta astronomical noon time %s*GARGUMENT special text: Sun data.
                                                             (line  661)
* Sun/Moon, delta astronomical noon time %s*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line  923)
* Sun/Moon, delta astronomical noon time %sGARGUMENT special text: Sun data.
                                                             (line  661)
* Sun/Moon, delta astronomical noon time %sGARGUMENT special text <1>: Special Texts Summary.
                                                             (line  918)
* Sun/Moon, delta geocentric azimuth %o*AARGUMENT special text: Sun data.
                                                             (line  572)
* Sun/Moon, delta geocentric azimuth %o*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line  839)
* Sun/Moon, delta geocentric azimuth %oAARGUMENT special text: Sun data.
                                                             (line  572)
* Sun/Moon, delta geocentric azimuth %oAARGUMENT special text <1>: Special Texts Summary.
                                                             (line  834)
* Sun/Moon, delta geocentric azimuth %s*AARGUMENT special text: Sun data.
                                                             (line  572)
* Sun/Moon, delta geocentric azimuth %s*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line  839)
* Sun/Moon, delta geocentric azimuth %sAARGUMENT special text: Sun data.
                                                             (line  572)
* Sun/Moon, delta geocentric azimuth %sAARGUMENT special text <1>: Special Texts Summary.
                                                             (line  834)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %o*EARGUMENT special text: Sun data.
                                                             (line  626)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %o*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line  895)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %oEARGUMENT special text: Sun data.
                                                             (line  626)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %oEARGUMENT special text <1>: Special Texts Summary.
                                                             (line  891)
* Sun/Moon, delta geocentric azimuth at standard sunset time %s*EARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta geocentric azimuth at standard sunset time %s*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line  903)
* Sun/Moon, delta geocentric azimuth at standard sunset time %sEARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta geocentric azimuth at standard sunset time %sEARGUMENT special text <1>: Special Texts Summary.
                                                             (line  899)
* Sun/Moon, delta geocentric elevation %o*zARGUMENT special text: Sun data.
                                                             (line  566)
* Sun/Moon, delta geocentric elevation %o*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line  829)
* Sun/Moon, delta geocentric elevation %ozARGUMENT special text: Sun data.
                                                             (line  566)
* Sun/Moon, delta geocentric elevation %ozARGUMENT special text <1>: Special Texts Summary.
                                                             (line  824)
* Sun/Moon, delta geocentric elevation %s*zARGUMENT special text: Sun data.
                                                             (line  566)
* Sun/Moon, delta geocentric elevation %s*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line  829)
* Sun/Moon, delta geocentric elevation %szARGUMENT special text: Sun data.
                                                             (line  566)
* Sun/Moon, delta geocentric elevation %szARGUMENT special text <1>: Special Texts Summary.
                                                             (line  824)
* Sun/Moon, delta geocentric elevation at standard sunrise time %o*DARGUMENT special text: Sun data.
                                                             (line  610)
* Sun/Moon, delta geocentric elevation at standard sunrise time %o*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line  879)
* Sun/Moon, delta geocentric elevation at standard sunrise time %oDARGUMENT special text: Sun data.
                                                             (line  610)
* Sun/Moon, delta geocentric elevation at standard sunrise time %oDARGUMENT special text <1>: Special Texts Summary.
                                                             (line  875)
* Sun/Moon, delta geocentric elevation at standard sunset time %s*DARGUMENT special text: Sun data.
                                                             (line  618)
* Sun/Moon, delta geocentric elevation at standard sunset time %s*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line  887)
* Sun/Moon, delta geocentric elevation at standard sunset time %sDARGUMENT special text: Sun data.
                                                             (line  618)
* Sun/Moon, delta geocentric elevation at standard sunset time %sDARGUMENT special text <1>: Special Texts Summary.
                                                             (line  883)
* Sun/Moon, delta standard rise time %(*KARGUMENT special text: Moon data.
                                                             (line  620)
* Sun/Moon, delta standard rise time %(KARGUMENT special text: Moon data.
                                                             (line  620)
* Sun/Moon, delta standard rise time %o*HARGUMENT special text: Sun data.
                                                             (line  679)
* Sun/Moon, delta standard rise time %o*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line  931)
* Sun/Moon, delta standard rise time %oHARGUMENT special text: Sun data.
                                                             (line  679)
* Sun/Moon, delta standard rise time %oHARGUMENT special text <1>: Special Texts Summary.
                                                             (line  927)
* Sun/Moon, delta standard set time %)*KARGUMENT special text: Moon data.
                                                             (line  637)
* Sun/Moon, delta standard set time %)KARGUMENT special text: Moon data.
                                                             (line  637)
* Sun/Moon, delta standard set time %s*HARGUMENT special text: Sun data.
                                                             (line  696)
* Sun/Moon, delta standard set time %s*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line  939)
* Sun/Moon, delta standard set time %sHARGUMENT special text: Sun data.
                                                             (line  696)
* Sun/Moon, delta standard set time %sHARGUMENT special text <1>: Special Texts Summary.
                                                             (line  935)
* Sun/Moon, delta topocentric azimuth %o*yARGUMENT special text: Sun data.
                                                             (line  546)
* Sun/Moon, delta topocentric azimuth %o*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line  819)
* Sun/Moon, delta topocentric azimuth %oyARGUMENT special text: Sun data.
                                                             (line  546)
* Sun/Moon, delta topocentric azimuth %oyARGUMENT special text <1>: Special Texts Summary.
                                                             (line  814)
* Sun/Moon, delta topocentric azimuth %s*yARGUMENT special text: Sun data.
                                                             (line  546)
* Sun/Moon, delta topocentric azimuth %s*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line  819)
* Sun/Moon, delta topocentric azimuth %syARGUMENT special text: Sun data.
                                                             (line  546)
* Sun/Moon, delta topocentric azimuth %syARGUMENT special text <1>: Special Texts Summary.
                                                             (line  814)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %o*CARGUMENT special text: Sun data.
                                                             (line  594)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %o*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line  863)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %oCARGUMENT special text: Sun data.
                                                             (line  594)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %oCARGUMENT special text <1>: Special Texts Summary.
                                                             (line  859)
* Sun/Moon, delta topocentric azimuth at standard sunset time %s*CARGUMENT special text: Sun data.
                                                             (line  602)
* Sun/Moon, delta topocentric azimuth at standard sunset time %s*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line  871)
* Sun/Moon, delta topocentric azimuth at standard sunset time %sCARGUMENT special text: Sun data.
                                                             (line  602)
* Sun/Moon, delta topocentric azimuth at standard sunset time %sCARGUMENT special text <1>: Special Texts Summary.
                                                             (line  867)
* Sun/Moon, delta topocentric elevation %o*xARGUMENT special text: Sun data.
                                                             (line  532)
* Sun/Moon, delta topocentric elevation %o*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line  809)
* Sun/Moon, delta topocentric elevation %oxARGUMENT special text: Sun data.
                                                             (line  532)
* Sun/Moon, delta topocentric elevation %oxARGUMENT special text <1>: Special Texts Summary.
                                                             (line  804)
* Sun/Moon, delta topocentric elevation %s*xARGUMENT special text: Sun data.
                                                             (line  532)
* Sun/Moon, delta topocentric elevation %s*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line  809)
* Sun/Moon, delta topocentric elevation %sxARGUMENT special text: Sun data.
                                                             (line  532)
* Sun/Moon, delta topocentric elevation %sxARGUMENT special text <1>: Special Texts Summary.
                                                             (line  804)
* Sun/Moon, delta topocentric elevation at standard sunrise time %o*BARGUMENT special text: Sun data.
                                                             (line  578)
* Sun/Moon, delta topocentric elevation at standard sunrise time %o*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line  847)
* Sun/Moon, delta topocentric elevation at standard sunrise time %oBARGUMENT special text: Sun data.
                                                             (line  578)
* Sun/Moon, delta topocentric elevation at standard sunrise time %oBARGUMENT special text <1>: Special Texts Summary.
                                                             (line  843)
* Sun/Moon, delta topocentric elevation at standard sunset time %s*BARGUMENT special text: Sun data.
                                                             (line  586)
* Sun/Moon, delta topocentric elevation at standard sunset time %s*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line  855)
* Sun/Moon, delta topocentric elevation at standard sunset time %sBARGUMENT special text: Sun data.
                                                             (line  586)
* Sun/Moon, delta topocentric elevation at standard sunset time %sBARGUMENT special text <1>: Special Texts Summary.
                                                             (line  851)
* Sundial:                               Sun data.           (line  508)
* Sunrise:                               Sun data.           (line    6)
* Sunrise and sunset, limit to actual day: Fixed date options.
                                                             (line  173)
* Sunrise and sunset, set reference altitude: Fixed date options.
                                                             (line  125)
* Sunset:                                Sun data.           (line    6)
* Suppress calendar sheet:               Calendar options.   (line 1380)
* Suppress leading blank line of eternal holiday list: Calendar options.
                                                             (line   40)
* Suppress leading blank line of fixed date list: Fixed date options.
                                                             (line  785)
* Suppress title text of eternal holiday list: Calendar options.
                                                             (line   45)
* Suppress title text of fixed date list: Fixed date options.
                                                             (line  815)
* Switch character:                      Glossary.           (line  696)
* Switch character, -:                   Command line arguments.
                                                             (line   22)
* Switch character, --:                  Command line arguments.
                                                             (line   22)
* Switch character, /:                   Command line arguments.
                                                             (line   22)
* Synodic month:                         Glossary.           (line  426)
* Synodic month, Moon:                   Moon data.          (line   38)
* Table of all environment variables:    Environment Variables.
                                                             (line    6)
* Table of all error codes:              Error Codes.        (line    6)
* Table of all exit codes:               Error Codes.        (line    6)
* Table of all Metasymbols within this document: Metasymbols.
                                                             (line    6)
* Table of command separator characters: Commands.           (line   38)
* Table of modes of the Moon oriented special texts: Moon data.
                                                             (line   35)
* Table of modes of the Sun oriented special texts: Sun data.
                                                             (line   35)
* Table of obsolete date format elements: Table of Obsolete Date Format Elements.
                                                             (line    6)
* Table of obsolete date formats:        Table of Obsolete Date Formats.
                                                             (line    6)
* Table of obsolete fixed default date format texts: Table of Obsolete Date Formats.
                                                             (line    6)
* Table of obsolete special texts:       Table of Obsolete Special Texts.
                                                             (line    6)
* Table of representation types of the Moon oriented special texts: Moon data.
                                                             (line  841)
* Table of representation types of the Sun oriented special texts: Sun data.
                                                             (line 1110)
* tcal, options:                         Invoking tcal.      (line    6)
* tcal, utility:                         Invoking tcal.      (line    6)
* Temperature of Earth's atmosphere, set: Fixed date options.
                                                             (line  152)
* TERM environment variable:             Environment Variables.
                                                             (line  109)
* Terrestrial Dynamical time (TDT):      Sun data.           (line  466)
* Terrestrial Dynamical time (TDT) <1>:  Moon data.          (line  431)
* Territory code:                        Calendar options.   (line  150)
* Territory code <1>:                    Internationalization.
                                                             (line  122)
* Text part:                             Glossary.           (line  702)
* Text part of a line:                   Text part of a line.
                                                             (line    6)
* Text part of a line, limitations:      Text part of a line.
                                                             (line    6)
* Text part of a resource file line:     Text part of a line.
                                                             (line    6)
* Text replacement %?... special texts:  Replacements.       (line    6)
* Text variables:                        Text variables.     (line    6)
* Text variables, addition:              Text variables.     (line  300)
* Text variables, assignments:           Fixed date options. (line   33)
* Text variables, assignments <1>:       Structure of resource file.
                                                             (line   73)
* Text variables, assignments <2>:       Text variables.     (line    6)
* Text variables, definition:            Fixed date options. (line   33)
* Text variables, definition <1>:        Text variables.     (line    6)
* Text variables, export of local:       Fixed date options. (line  121)
* Text variables, export of local <1>:   Text variables.     (line  279)
* Text variables, global:                Fixed date options. (line   33)
* Text variables, global <1>:            Text variables.     (line    6)
* Text variables, local:                 Text variables.     (line    6)
* Text variables, management:            Fixed date options. (line   33)
* Text variables, management <1>:        Text variables.     (line    6)
* Text variables, name space:            Fixed date options. (line   33)
* Text variables, name space <1>:        Text variables.     (line  242)
* Text variables, numerical:             Text variables.     (line  292)
* Text variables, operations:            Structure of resource file.
                                                             (line   73)
* Text variables, operations <1>:        Text variables.     (line  292)
* Text variables, references:            Structure of resource file.
                                                             (line   83)
* Text variables, scope:                 Fixed date options. (line   33)
* Text variables, scope <1>:             Text variables.     (line  356)
* Text variables, simple decrement:      Text variables.     (line  298)
* Text variables, simple increment:      Text variables.     (line  297)
* Text variables, subtraction:           Text variables.     (line  301)
* Text variables, total number:          Text variables.     (line    6)
* Text variables, visibility:            Text variables.     (line  242)
* Text variables, visibility of local:   Fixed date options. (line  121)
* Text variables, visibility of local <1>: Text variables.   (line  279)
* Textual date %n[ARGUMENT] special text: Textual date.      (line    6)
* Textual date %n[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  271)
* The gcal2txt utility:                  Invoking gcal2txt.  (line    6)
* The tcal utility:                      Invoking tcal.      (line    6)
* The txt2gcal utility:                  Invoking txt2gcal.  (line    6)
* Time offset value, relative:           Calendar options.   (line 1506)
* Time offset value, relative <1>:       Calendar options.   (line 1532)
* Time, 12-hours display format:         Actual clocktime.   (line   33)
* Time, 24-hours display format:         Actual clocktime.   (line   33)
* Timezone:                              Sun data.           (line 1079)
* Timezone <1>:                          Moon data.          (line  821)
* Today's fixed dates:                   Fixed date options. (line  435)
* Tomorrows' fixed dates:                Fixed date options. (line 1337)
* Topocentric data:                      Glossary.           (line  706)
* Topocentric data, Moon:                Moon data.          (line  258)
* Topocentric data, Sun:                 Sun data.           (line  348)
* Total number of date variables:        Date variables.     (line    6)
* Total number of text variables:        Text variables.     (line    6)
* True solar day:                        Sun data.           (line  508)
* True solar day <1>:                    Glossary.           (line  711)
* True solar time:                       Sun data.           (line  508)
* True solar time <1>:                   Glossary.           (line  711)
* True track:                            Glossary.           (line  718)
* Twilight:                              Glossary.           (line  731)
* Twilight, amateur-astronomical:        Sun data.           (line  287)
* Twilight, amateur-astronomical <1>:    Sun data.           (line  296)
* Twilight, astronomical:                Sun data.           (line  313)
* Twilight, astronomical <1>:            Sun data.           (line  327)
* Twilight, civil:                       Sun data.           (line  235)
* Twilight, civil <1>:                   Sun data.           (line  244)
* Twilight, nautical:                    Sun data.           (line  261)
* Twilight, nautical <1>:                Sun data.           (line  270)
* txt2gcal, options:                     Invoking txt2gcal.  (line    6)
* txt2gcal, utility:                     Invoking txt2gcal.  (line    6)
* TXT2GCALPROG environment variable:     Text variables.     (line  112)
* TXT2GCALPROG environment variable <1>: Environment Variables.
                                                             (line  112)
* Type of representation of Moon data and times: Sun data.   (line  890)
* Type of representation of Moon data and times <1>: Moon data.
                                                             (line  813)
* Type of representation of Sun data and times: Sun data.    (line  890)
* TZ environment variable:               Environment Variables.
                                                             (line  122)
* Unit, Earth equator radius:            Moon data.          (line  353)
* Universal time (UTC):                  Calendar options.   (line 1491)
* Universal time (UTC) <1>:              Moon phase.         (line    6)
* Universal time (UTC) <2>:              Actual clocktime.   (line    6)
* Universal time (UTC) <3>:              Actual clocktime.   (line  126)
* Universal time (UTC) <4>:              Actual clocktime.   (line  145)
* Universal time (UTC) <5>:              Actual clocktime.   (line  163)
* Universal time (UTC) <6>:              Actual clocktime.   (line  179)
* Universal time (UTC) <7>:              Actual clocktime.   (line  196)
* Universal time (UTC) <8>:              Actual clocktime.   (line  213)
* Universal time (UTC) <9>:              Julian day number.  (line    6)
* Universal time (UTC) <10>:             Sun data.           (line  488)
* Universal time (UTC) <11>:             Sun data.           (line 1079)
* Universal time (UTC) <12>:             Moon data.          (line  453)
* Universal time 12-hour format suffix, display: Actual clocktime.
                                                             (line  196)
* Universal time hour, display:          Actual clocktime.   (line  163)
* Universal time in HH:MM/DATE format, display: Actual clocktime.
                                                             (line  126)
* Universal time in M[M...]/DATE format, display: Actual clocktime.
                                                             (line  145)
* Universal time minute, display:        Actual clocktime.   (line  179)
* Unix:                                  Glossary.           (line  737)
* Unsigned angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line  998)
* Unsigned decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  894)
* Unsigned time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  966)
* Use Eastern Orthodox churches' leap year rule: Calendar options.
                                                             (line 1320)
* USER environment variable:             Global options.     (line  202)
* USER environment variable <1>:         Environment Variables.
                                                             (line  126)
* Utilities for Gcal:                    Gcal Utilities.     (line    6)
* Utility gcal2txt:                      Invoking gcal2txt.  (line    6)
* Utility tcal:                          Invoking tcal.      (line    6)
* Utility txt2gcal:                      Invoking txt2gcal.  (line    6)
* Valid date parts of appearance factors of days: Appearance factor of days.
                                                             (line   49)
* Valid date parts of lists of days:     Lists of days.      (line   28)
* Valid date parts of ranges of days:    Ranges of days.     (line   31)
* Valid date parts of repetition factors of days: Repetition factor of days.
                                                             (line   41)
* Validity of omission values in date part: Date part of a line.
                                                             (line  146)
* Vernal equinox:                        Calendar options.   (line   48)
* Vernal equinox point on the ecliptic:  Sun data.           (line  387)
* Vernal equinox point on the ecliptic <1>: Sun data.        (line  395)
* Vernal equinox point on the ecliptic <2>: Sun data.        (line  473)
* Vernal equinox point on the ecliptic <3>: Moon data.       (line  327)
* Vernal equinox point on the ecliptic <4>: Moon data.       (line  346)
* Vernal equinox point on the ecliptic <5>: Moon data.       (line  438)
* Vernal equinox point on the ecliptic <6>: Glossary.        (line  747)
* Version number, finding:               Common options.     (line   37)
* Visibility of date variables:          Date variables.     (line   55)
* Visibility of local date variables:    Fixed date options. (line   28)
* Visibility of local date variables <1>: Date variables.    (line  104)
* Visibility of local text variables:    Fixed date options. (line  121)
* Visibility of local text variables <1>: Text variables.    (line  279)
* Visibility of text variables:          Text variables.     (line  242)
* Waning Half Moon phase:                Calendar options.   (line   48)
* Waxing Half Moon phase:                Calendar options.   (line   48)
* Week number %?[DATE] special text:     Special Texts Summary.
                                                             (line  168)
* Week number %k[DATE] special text:     Week number.        (line    6)
* Week number, determine type:           Calendar options.   (line 1354)
* Week number, ISO-8601:1988:            Calendar options.   (line 1361)
* Week number, ISO-8601:1988 <1>:        Fixed date options. (line  765)
* Week number, ISO-8601:1988 <2>:        Fixed date options. (line  946)
* Week number, ISO-8601:1988 <3>:        Fixed date options. (line  976)
* Week number, ISO-8601:1988 <4>:        Fixed date options. (line 1089)
* Week number, ISO-8601:1988 <5>:        Fixed date options. (line 1123)
* Week number, ISO-8601:1988 <6>:        Date part of a line.
                                                             (line   57)
* Week number, ISO-8601:1988 <7>:        Week number.        (line    7)
* Week number, standard:                 Calendar options.   (line 1372)
* Week number, standard <1>:             Fixed date options. (line  765)
* Week number, standard <2>:             Fixed date options. (line  946)
* Week number, standard <3>:             Fixed date options. (line  976)
* Week number, standard <4>:             Fixed date options. (line 1089)
* Week number, standard <5>:             Fixed date options. (line 1123)
* Week number, standard <6>:             Date part of a line.
                                                             (line   57)
* Week number, standard <7>:             Week number.        (line    7)
* Week numbers in calendar sheet:        Calendar options.   (line 1347)
* Weekday name %[FORMAT]K[DATE] special text: Weekday name.  (line    6)
* Weekday name %[FORMAT]K[DATE] special text <1>: Special Texts Summary.
                                                             (line   90)
* Weekday number %>1&*E[DATE] special text: Weekday number.  (line   36)
* Weekday number %>1&*E[DATE] special text <1>: Special Texts Summary.
                                                             (line  112)
* Weekday number %>1&*I[DATE] special text: Weekday number.  (line   55)
* Weekday number %>1&*I[DATE] special text <1>: Special Texts Summary.
                                                             (line  118)
* Weekday number %>1&*J[DATE] special text: Weekday number.  (line   74)
* Weekday number %>1&*J[DATE] special text <1>: Special Texts Summary.
                                                             (line  124)
* Weekday number %>1&*S[DATE] special text: Weekday number.  (line   95)
* Weekday number %>1&*S[DATE] special text <1>: Special Texts Summary.
                                                             (line  130)
* Weekday number %>1&*T[DATE] special text: Weekday number.  (line  118)
* Weekday number %>1&*T[DATE] special text <1>: Special Texts Summary.
                                                             (line  136)
* Weekday number %>1&*W[DATE] special text: Weekday number.  (line   18)
* Weekday number %>1&*W[DATE] special text <1>: Special Texts Summary.
                                                             (line  106)
* Weekday number %E[DATE] special text:  Weekday number.     (line   28)
* Weekday number %E[DATE] special text <1>: Special Texts Summary.
                                                             (line  109)
* Weekday number %I[DATE] special text:  Weekday number.     (line   46)
* Weekday number %I[DATE] special text <1>: Special Texts Summary.
                                                             (line  115)
* Weekday number %J[DATE] special text:  Weekday number.     (line   65)
* Weekday number %J[DATE] special text <1>: Special Texts Summary.
                                                             (line  121)
* Weekday number %S[DATE] special text:  Weekday number.     (line   84)
* Weekday number %S[DATE] special text <1>: Special Texts Summary.
                                                             (line  127)
* Weekday number %T[DATE] special text:  Weekday number.     (line  107)
* Weekday number %T[DATE] special text <1>: Special Texts Summary.
                                                             (line  133)
* Weekday number %W[DATE] special text:  Weekday number.     (line   10)
* Weekday number %W[DATE] special text <1>: Special Texts Summary.
                                                             (line  103)
* Weekday number %[FORMAT]?[DATE] special texts: Weekday number.
                                                             (line    6)
* Weekday number %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  101)
* Weeks' fixed dates:                    Fixed date options. (line 1349)
* Whitespace character:                  Text part of a line.
                                                             (line   93)
* Whitespace character <1>:              Comment line.       (line    6)
* Whitespace character <2>:              Error Codes.        (line    6)
* Whitespace character <3>:              Glossary.           (line  751)
* Whitespace separator character:        Options.            (line   66)
* Whitespace separator character <1>:    Options.            (line   73)
* Whitespace separator character <2>:    Structure of resource file.
                                                             (line    6)
* Whitespace separator character <3>:    Include directives. (line   23)
* Winter point on the ecliptic:          Glossary.           (line  756)
* Winter solstice:                       Calendar options.   (line   48)
* Winter solstice <1>:                   Glossary.           (line  756)
* Wintertime:                            Sun data.           (line 1079)
* Word:                                  Glossary.           (line  761)
* Word boundaries, matching in regexp:   Regexp Operators.   (line  278)
* Word, regexp definition:               Regexp Operators.   (line  254)
* Year calendar sheet blocks, number:    Calendar options.   (line 1384)
* Year calendar sheet, force output:     Calendar options.   (line 1384)
* Year difference value:                 Difference value.   (line   10)
* Year mode, single:                     Single commands.    (line   18)
* Year number %>04*Y[DATE] special text: Year number.        (line   14)
* Year number %>04*Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  200)
* Year number %Y[DATE] special text:     Year number.        (line    7)
* Year number %Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  197)
* Year number %[FORMAT]Y[DATE] special text: Year number.    (line    6)
* Year number %[FORMAT]Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  195)
* Years' fixed dates:                    Fixed date options. (line 1424)
* Zodiacal line:                         Sun data.           (line  387)
* Zodiacal line <1>:                     Moon data.          (line  327)
* Zodiacal line <2>:                     Moon data.          (line  335)
* Zodiacal marker holidays in eternal holiday list: Calendar options.
                                                             (line  132)
* Zuhr prayer time:                      Glossary.           (line  765)
* Zuhr, Islamic prayer time:             Sun data.           (line   50)



Tag Table:
Node: Top1601
Node: Preface8091
Node: Preface-Footnotes19168
Ref: Preface-Footnote-119227
Ref: Preface-Footnote-219530
Node: Gcal Introduction19600
Node: Gcal Introduction-Footnotes23164
Ref: Gcal Introduction-Footnote-123243
Ref: Gcal Introduction-Footnote-223275
Ref: Gcal Introduction-Footnote-323297
Node: Invoking Gcal23317
Node: Invoking Gcal-Footnotes24677
Ref: Invoking Gcal-Footnote-124748
Node: Command line arguments24839
Node: Command line arguments-Footnotes26514
Ref: Command line arguments-Footnote-126603
Node: Options26642
Node: Options-Footnotes29977
Ref: Options-Footnote-130036
Node: Common options30074
Node: Global options31317
Ref: x-response-file31501
Ref: x-debug-internal32376
Ref: x-debug-abort32917
Ref: x-pager33133
Ref: x-highlighting35861
Ref: x-mail39841
Node: Global options-Footnotes41968
Ref: Global options-Footnote-142041
Ref: Global options-Footnote-242108
Ref: Global options-Footnote-342159
Ref: Global options-Footnote-442206
Ref: Global options-Footnote-542250
Ref: Global options-Footnote-642320
Ref: Global options-Footnote-742376
Node: Calendar options42426
Ref: x-holiday-list42666
Ref: x-astronomical-holidays44031
Ref: x-bahai-holidays44456
Ref: x-chinese-flexible-holidays44843
Ref: x-chinese-holidays45235
Ref: x-islamic-civil-holidays45761
Ref: x-japanese-flexible-holidays45992
Ref: x-japanese-holidays46343
Ref: x-persian-jalaali-holidays47547
Ref: x-cc-holidays48223
Ref: x-type65883
Ref: x-orthodox-calendar66958
Ref: x-iso-week-number68495
Ref: x-blocks69923
Ref: x-starting-day72763
Ref: x-time-offset73423
Ref: x-date-format80065
Ref: x-translate-string83888
Node: Calendar options-Footnotes85605
Ref: Calendar options-Footnote-185682
Ref: Calendar options-Footnote-285767
Ref: Calendar options-Footnote-385806
Ref: Calendar options-Footnote-485876
Ref: Calendar options-Footnote-586074
Node: Fixed date options86176
Ref: x-date-variable86357
Ref: x-text-variable87446
Ref: x-adjust-value92008
Ref: x-atmosphere93220
Ref: x-limit94301
Ref: x-cycle-end96899
Ref: x-cycle-step100091
Ref: x-precise102580
Ref: x-execute-command103216
Ref: x-filter-text105377
Ref: x-ignore-case106551
Ref: x-list-of-fixed-dates107078
Ref: x-resource-file108915
Ref: x-biorhythm-axis115747
Ref: x-moonimage-lines117044
Ref: x-list-mode125690
Ref: x-period-of-fixed-dates125977
Node: Fixed date options-Footnotes150194
Ref: Fixed date options-Footnote-1150275
Ref: Fixed date options-Footnote-2150542
Ref: Fixed date options-Footnote-3150701
Ref: Fixed date options-Footnote-4150953
Ref: Fixed date options-Footnote-5151075
Ref: Fixed date options-Footnote-6151253
Ref: Fixed date options-Footnote-7151429
Ref: Fixed date options-Footnote-8151486
Ref: Fixed date options-Footnote-9151558
Ref: Fixed date options-Footnote-10151605
Ref: Fixed date options-Footnote-11151652
Ref: Fixed date options-Footnote-12151737
Ref: Fixed date options-Footnote-13151765
Ref: Fixed date options-Footnote-14151820
Ref: Fixed date options-Footnote-15151875
Ref: Fixed date options-Footnote-16151942
Node: Response file152009
Node: Actual date modifier154153
Node: Commands163402
Node: Single commands165578
Ref: x-mm-yyyy166442
Node: 3-Month mode commands167555
Node: Lists of commands168420
Node: Ranges of commands169605
Node: The GCAL environment variable170711
Node: Eternal Holidays171668
Node: Fixed Dates176363
Node: Resource file181302
Ref: x-File-searching-mechanism182233
Node: Resource file-Footnotes185690
Ref: Resource file-Footnote-1185761
Ref: Resource file-Footnote-2185902
Ref: Resource file-Footnote-3186021
Ref: Resource file-Footnote-4186057
Ref: Resource file-Footnote-5186123
Node: Structure of resource file186253
Node: Structure of resource file-Footnotes188896
Ref: Structure of resource file-Footnote-1188993
Ref: Structure of resource file-Footnote-2189065
Node: Date part of a line189259
Node: Further date part attributes195711
Node: Lists of days197082
Node: Ranges of days200234
Node: Ranges of days-Footnotes204805
Ref: Ranges of days-Footnote-1204878
Ref: Ranges of days-Footnote-2204962
Node: Repetition factor of days204989
Node: Repetition factor of days-Footnotes209060
Ref: Repetition factor of days-Footnote-1209155
Ref: Repetition factor of days-Footnote-2209187
Node: Appearance factor of days209282
Node: Appearance factor of days-Footnotes215903
Ref: Appearance factor of days-Footnote-1215998
Node: Text part of a line216082
Node: Text part of a line-Footnotes221884
Ref: Text part of a line-Footnote-1221967
Ref: Text part of a line-Footnote-2221994
Ref: Text part of a line-Footnote-3222039
Ref: Text part of a line-Footnote-4222134
Node: Special Texts processed222205
Node: Special Texts processed-Footnotes224449
Ref: Special Texts processed-Footnote-1224540
Node: Comment line224558
Node: Comment line-Footnotes227008
Ref: Comment line-Footnote-1227077
Node: Include directives227111
Node: Include directives-Footnotes230010
Ref: Include directives-Footnote-1230091
Ref: Include directives-Footnote-2230167
Ref: Include directives-Footnote-3230228
Ref: Include directives-Footnote-4230336
Ref: Include directives-Footnote-5230419
Ref: Include directives-Footnote-6230476
Node: Date variables230583
Node: Date variables-Footnotes236969
Ref: Date variables-Footnote-1237042
Ref: Date variables-Footnote-2237309
Ref: Date variables-Footnote-3237381
Ref: Date variables-Footnote-4237456
Node: Text variables237492
Node: Text variables-Footnotes251845
Ref: Text variables-Footnote-1251918
Ref: Text variables-Footnote-2251993
Node: Resource file examples252029
Node: Resource file examples-Footnotes265372
Ref: Resource file examples-Footnote-1265461
Node: Todays Calendar265528
Node: Gcal Utilities270207
Node: Invoking tcal270913
Node: Invoking tcal-Footnotes272754
Ref: Invoking tcal-Footnote-1272825
Node: Invoking txt2gcal272876
Node: Invoking gcal2txt275234
Node: Internationalization277223
Node: Internationalization-Footnotes283006
Ref: Internationalization-Footnote-1283091
Ref: Internationalization-Footnote-2283152
Ref: Internationalization-Footnote-3283209
Ref: Internationalization-Footnote-4283275
Ref: Internationalization-Footnote-5283381
Ref: Internationalization-Footnote-6283463
Node: Metasymbols283570
Node: Regular Expressions285033
Node: Regexp Usage286647
Node: Regexp Usage-Footnotes287270
Ref: Regexp Usage-Footnote-1287339
Node: Regexp Operators287423
Node: Regexp Operators-Footnotes298936
Ref: Regexp Operators-Footnote-1299013
Ref: Regexp Operators-Footnote-2299082
Ref: Regexp Operators-Footnote-3299134
Ref: Regexp Operators-Footnote-4299223
Ref: Regexp Operators-Footnote-5299281
Node: Regexp Summary299343
Node: Regexp Summary-Footnotes301559
Ref: Regexp Summary-Footnote-1301632
Node: Special Texts301699
Node: Exclusions305378
Node: Exclusions with date argument305923
Node: Inclusive date period307084
Node: Exclusive date period310530
Node: Exclusions without any argument313940
Node: Inclusive day period315002
Node: Exclusive day period316164
Node: Replacements317267
Node: Replacements with date argument318159
Node: Replacements with date argument-Footnotes319762
Ref: Replacements with date argument-Footnote-1319869
Node: Weekday name319958
Node: Weekday number321022
Node: Day-of-year number326488
Node: Day number328030
Node: Week number329397
Node: Month name330218
Node: Month number330983
Node: Year number332384
Node: Moon phase333137
Node: Biorhythm336239
Node: Difference value340532
Ref: x-Age-value341104
Node: Replacements with other argument342074
Node: Actual clocktime343232
Ref: x-Actual-local-time344821
Node: Actual clocktime-Footnotes352770
Ref: Actual clocktime-Footnote-1352847
Node: Textual date352906
Node: Julian day number353600
Node: Geographical distance and course angle355392
Node: Geographical distance and course angle-Footnotes360154
Ref: Geographical distance and course angle-Footnote-1360275
Node: Sun data360974
Ref: x-Sun-midnight362822
Ref: x-Sun-noon363612
Ref: x-Sun-standard-rise370972
Ref: x-Sun-standard-set372680
Ref: x-Sun-asr-1409258
Ref: x-Sun-asr-2411516
Ref: x-Sun-representation413510
Ref: x-Sun-event-texts415864
Ref: x-Sun-arguments420362
Node: Moon data433553
Ref: x-Moon-midnight435402
Ref: x-Moon-noon436723
Ref: x-Moon-standard-rise445213
Ref: x-Moon-standard-set447138
Node: Contents of Environment variable493093
Node: Replacements without any argument493666
Node: Other difference values494092
Node: Highlighting496843
Node: Shell Command503936
Node: Special Texts Summary505355
Node: Obsolete Special Texts581806
Node: Table of Obsolete Special Texts582798
Node: Table of Obsolete Date Format Elements585834
Node: Table of Obsolete Date Formats587475
Node: Format Instruction588284
Node: Coding Scheme590994
Node: Coding Scheme Table 1592476
Node: Coding Scheme Table 2595451
Node: Environment Variables597841
Ref: x-GCAL598097
Ref: x-GCAL_COLUMNS598186
Ref: x-COLUMNS598186
Ref: x-GCAL_DATE_FORMAT598375
Ref: x-GCAL_LINES598543
Ref: x-LINES598543
Ref: x-GCAL_SYS_DATADIR598728
Ref: x-GCAL_USR_DATADIR598927
Ref: x-GCALANSI599158
Ref: x-GCALPATH599392
Ref: x-GCALPROG599587
Ref: x-HOME600062
Ref: x-LOGNAME600822
Ref: x-MAILPROG600975
Ref: x-MAILTO601258
Ref: x-PAGER601458
Ref: x-PATH601623
Ref: x-TERM601809
Ref: x-TXT2GCALPROG601891
Ref: x-USER602589
Node: Error Codes602770
Ref: x-126-Error-code603054
Ref: x-119-Error-code603509
Ref: x-118-Error-code603609
Ref: x-113-Error-code603941
Ref: x-2-Error-code604598
Ref: x-1-Error-code604665
Node: Glossary604815
Node: Argument Index632234
Node: Variable Index660413
Node: Table Index666799
Node: GNU Free Documentation License674555
Node: Concept Index699727

End Tag Table
