This is gcal.info, produced by makeinfo version 5.2 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 3.6.

     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 3.6 of 'Gcal, an Extended Calendar Program',
24 June 2000, for the 3.6 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 3.6 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 3.6 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 3.6 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 3.6 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 3.6 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 3.6 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 3.6 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 3.6 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  516)
* -*dN:                                  Fixed date options. (line  898)
* -*dNWWW:                               Fixed date options. (line 1033)
* -*wN[WWW]:                             Fixed date options. (line 1085)
* --adjust-value=ARGUMENT:               Fixed date options. (line  125)
* --alternative-format:                  Fixed date options. (line  681)
* --astronomical-holidays:               Calendar options.   (line   48)
* --atmosphere=AIR-PRESSURE[,TEMPERATURE]: Fixed date options.
                                                             (line  149)
* --bahai-holidays:                      Calendar options.   (line   57)
* --bahai-months:                        Calendar options.   (line 1204)
* --biorhythm-axis=NUMBER:               Fixed date options. (line  620)
* --blocks=1:                            Calendar options.   (line 1393)
* --blocks=12:                           Calendar options.   (line 1413)
* --blocks=2:                            Calendar options.   (line 1397)
* --blocks=3:                            Calendar options.   (line 1401)
* --blocks=4:                            Calendar options.   (line 1405)
* --blocks=6:                            Calendar options.   (line 1409)
* --blocks=NUMBER:                       Calendar options.   (line 1384)
* --calendar-dates=both:                 Calendar options.   (line 1429)
* --calendar-dates=special:              Calendar options.   (line 1423)
* --calendar-dates=special|both:         Calendar options.   (line 1417)
* --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  222)
* --cycle-step=ARGUMENT:                 Fixed date options. (line  288)
* --date-format=de|us|gb|TEXT:           Calendar options.   (line 1624)
* --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  463)
* --descending-fixed-dates=short:        Fixed date options. (line  446)
* --descending-fixed-dates[=short|long]: Fixed date options. (line  431)
* --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 1393)
* --end-of-week:                         Fixed date options. (line 1345)
* --end-of-week <1>:                     Fixed date options. (line 1356)
* --end-of-year:                         Fixed date options. (line 1430)
* --ethiopic-months:                     Calendar options.   (line 1228)
* --exclude-fixed-dates-list-title:      Fixed date options. (line  812)
* --exclude-holiday-list-title:          Calendar options.   (line   45)
* --execute-command:                     Fixed date options. (line  350)
* --exit-status-help-non-zero:           Common options.     (line   41)
* --export-date-variables:               Fixed date options. (line   28)
* --export-date-variables <1>:           Date variables.     (line  105)
* --export-text-variables:               Fixed date options. (line  121)
* --export-text-variables <1>:           Text variables.     (line  279)
* --filter-day=ARGUMENT:                 Fixed date options. (line  361)
* --filter-period=ARGUMENT:              Fixed date options. (line  376)
* --filter-text=PATTERN:                 Fixed date options. (line  394)
* --fixed-dates=both:                    Calendar options.   (line 1465)
* --fixed-dates=special:                 Calendar options.   (line 1459)
* --fixed-dates=special|both:            Calendar options.   (line 1452)
* --force-highlighting:                  Global options.     (line   91)
* --french-revolutionary-months:         Calendar options.   (line 1233)
* --gregorian-reform=1582|1700|1752|1753|ARGUMENT: Calendar options.
                                                             (line 1560)
* --grouping-text[=TEXT]:                Fixed date options. (line  706)
* --heading-text=TEXT:                   Fixed date options. (line  815)
* --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  516)
* --highlighting=no:                     Global options.     (line  102)
* --highlighting=TEXT:                   Global options.     (line  107)
* --highlighting=yes:                    Global options.     (line   91)
* --holiday-dates=both:                  Calendar options.   (line 1447)
* --holiday-dates=special:               Calendar options.   (line 1441)
* --holiday-dates=special|both:          Calendar options.   (line 1434)
* --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  418)
* --include-consecutive-number:          Fixed date options. (line  856)
* --include-holidays=long:               Fixed date options. (line  696)
* --include-holidays=short:              Fixed date options. (line  701)
* --include-resource-file-name:          Fixed date options. (line  672)
* --include-today:                       Fixed date options. (line  881)
* --include-week-number:                 Fixed date options. (line  762)
* --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  870)
* --leap-day=february|march:             Fixed date options. (line  866)
* --leap-day=march:                      Fixed date options. (line  875)
* --license:                             Common options.     (line   33)
* --limit:                               Fixed date options. (line  170)
* --list-mode:                           Fixed date options. (line  887)
* --list-of-fixed-dates=long:            Fixed date options. (line  455)
* --list-of-fixed-dates=short:           Fixed date options. (line  437)
* --list-of-fixed-dates[=short|long]:    Fixed date options. (line  431)
* --long-help=?:                         Common options.     (line   25)
* --long-help[=ARGUMENT]:                Common options.     (line   16)
* --mail[=ADDRESS]:                      Global options.     (line  186)
* --month:                               Fixed date options. (line 1386)
* --moonimage-lines=NUMBER:              Fixed date options. (line  649)
* --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  770)
* --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  895)
* --persian-jalaali-holidays:            Calendar options.   (line  125)
* --persian-jalaali-months:              Calendar options.   (line 1278)
* --precise:                             Fixed date options. (line  338)
* --resource-file=NAME[+...]:            Fixed date options. (line  471)
* --response-file=NAME:                  Global options.     (line    8)
* --revert-match:                        Fixed date options. (line  423)
* --shell-script=NAME:                   Global options.     (line   15)
* --shift=[+|-]NUMBER:                   Invoking tcal.      (line   42)
* --start-of-month:                      Fixed date options. (line 1405)
* --start-of-week:                       Fixed date options. (line 1345)
* --start-of-week <1>:                   Fixed date options. (line 1368)
* --start-of-year:                       Fixed date options. (line 1442)
* --starting-day=ARGUMENT:               Calendar options.   (line 1470)
* --suppress-calendar:                   Calendar options.   (line 1380)
* --suppress-date-part:                  Fixed date options. (line  792)
* --suppress-fixed-dates-list-separator: Fixed date options. (line  782)
* --suppress-holiday-list-separator:     Calendar options.   (line   40)
* --suppress-text-part:                  Fixed date options. (line  802)
* --text-variable=ARGUMENT:              Fixed date options. (line   33)
* --time-offset=ARGUMENT:                Calendar options.   (line 1491)
* --today:                               Fixed date options. (line  431)
* --today <1>:                           Fixed date options. (line  437)
* --tomorrow:                            Fixed date options. (line 1333)
* --transform-year=ARGUMENT:             Calendar options.   (line 1540)
* --translate-string=TEXT:               Calendar options.   (line 1728)
* --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 1345)
* --week <1>:                            Fixed date options. (line 1349)
* --with-week-number:                    Calendar options.   (line 1347)
* --year:                                Fixed date options. (line 1423)
* --zero-dates-only:                     Fixed date options. (line  860)
* --zodical-marker-holidays:             Calendar options.   (line  132)
* -?:                                    Common options.     (line    9)
* -??:                                   Common options.     (line   16)
* -@DVAR[+|-]NWWW:                       Fixed date options. (line 1305)
* -@DVAR[[+|-]N]:                        Fixed date options. (line 1273)
* -@e[+|-]NWWW:                          Fixed date options. (line 1192)
* -@e[[+|-]N]:                           Fixed date options. (line 1159)
* -@t[+|-]NWWW:                          Fixed date options. (line 1247)
* -@t[[+|-]N]:                           Fixed date options. (line 1218)
* -a:                                    Fixed date options. (line  672)
* -A:                                    Fixed date options. (line  681)
* -b 1:                                  Calendar options.   (line 1393)
* -b 12:                                 Calendar options.   (line 1413)
* -b 2:                                  Calendar options.   (line 1397)
* -b 3:                                  Calendar options.   (line 1401)
* -b 4:                                  Calendar options.   (line 1405)
* -b 6:                                  Calendar options.   (line 1409)
* -b NUMBER:                             Calendar options.   (line 1384)
* -c:                                    Fixed date options. (line  437)
* -C:                                    Fixed date options. (line  455)
* -c*dN:                                 Fixed date options. (line  898)
* -c*dNWWW:                              Fixed date options. (line 1033)
* -c*wN[WWW]:                            Fixed date options. (line 1085)
* -c-:                                   Fixed date options. (line  446)
* -C-:                                   Fixed date options. (line  463)
* -c@DVAR[+|-]NWWW:                      Fixed date options. (line 1305)
* -c@DVAR[[+|-]N]:                       Fixed date options. (line 1273)
* -c@e[+|-]NWWW:                         Fixed date options. (line 1192)
* -c@e[[+|-]N]:                          Fixed date options. (line 1159)
* -c@t[+|-]NWWW:                         Fixed date options. (line 1247)
* -c@t[[+|-]N]:                          Fixed date options. (line 1218)
* -ca:                                   Fixed date options. (line  672)
* -cA:                                   Fixed date options. (line  681)
* -cd:                                   Fixed date options. (line  881)
* -ce:                                   Fixed date options. (line  696)
* -cE:                                   Fixed date options. (line  701)
* -cg[TEXT]:                             Fixed date options. (line  706)
* -cJ:                                   Fixed date options. (line  802)
* -ck:                                   Fixed date options. (line  762)
* -cl:                                   Fixed date options. (line  887)
* -cl*dN:                                Fixed date options. (line  910)
* -cl*dNWWW:                             Fixed date options. (line 1056)
* -cl*wN[WWW]:                           Fixed date options. (line 1119)
* -cl@DVAR[+|-]NWWW:                     Fixed date options. (line 1317)
* -cl@DVAR[[+|-]N]:                      Fixed date options. (line 1288)
* -cl@e[+|-]NWWW:                        Fixed date options. (line 1204)
* -cl@e[[+|-]N]:                         Fixed date options. (line 1174)
* -cl@t[+|-]NWWW:                        Fixed date options. (line 1259)
* -cl@t[[+|-]N]:                         Fixed date options. (line 1232)
* -clMMDD:                               Fixed date options. (line  997)
* -clMMWWWN:                             Fixed date options. (line 1019)
* -clN+|-:                               Fixed date options. (line  929)
* -clNd:                                 Fixed date options. (line  910)
* -clNw:                                 Fixed date options. (line  972)
* -cm:                                   Fixed date options. (line 1386)
* -cm+:                                  Fixed date options. (line 1393)
* -cm-:                                  Fixed date options. (line 1405)
* -cMMDD:                                Fixed date options. (line  990)
* -cMMWWWN:                              Fixed date options. (line 1008)
* -cN+|-:                                Fixed date options. (line  919)
* -cNd:                                  Fixed date options. (line  898)
* -cNw:                                  Fixed date options. (line  942)
* -co:                                   Fixed date options. (line  770)
* -cQ:                                   Fixed date options. (line  782)
* -ct:                                   Fixed date options. (line 1333)
* -cT:                                   Fixed date options. (line 1333)
* -cU:                                   Fixed date options. (line  792)
* -cw:                                   Fixed date options. (line 1349)
* -cw+:                                  Fixed date options. (line 1356)
* -cw-:                                  Fixed date options. (line 1368)
* -cx:                                   Fixed date options. (line  812)
* -cy:                                   Fixed date options. (line 1423)
* -cy+:                                  Fixed date options. (line 1430)
* -cy-:                                  Fixed date options. (line 1442)
* -cz:                                   Fixed date options. (line  856)
* -cZ:                                   Fixed date options. (line  860)
* -c[m|M[+|-]]:                          Fixed date options. (line 1383)
* -c[t|T]:                               Fixed date options. (line 1333)
* -c[w|W[+|-]]:                          Fixed date options. (line 1345)
* -c[y|Y[+|-]]:                          Fixed date options. (line 1420)
* -c|C[-]:                               Fixed date options. (line  431)
* -d:                                    Fixed date options. (line  881)
* -D ARGUMENT:                           Fixed date options. (line  361)
* -e:                                    Fixed date options. (line  696)
* -E:                                    Fixed date options. (line  701)
* -f|F NAME[+...]:                       Fixed date options. (line  471)
* -G:                                    Calendar options.   (line   40)
* -g[TEXT]:                              Fixed date options. (line  706)
* -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  394)
* -i[-]:                                 Calendar options.   (line 1286)
* -j:                                    Calendar options.   (line 1423)
* -J:                                    Fixed date options. (line  802)
* -jb:                                   Calendar options.   (line 1429)
* -jc:                                   Calendar options.   (line 1459)
* -jcb:                                  Calendar options.   (line 1465)
* -jc[b]:                                Calendar options.   (line 1452)
* -jn:                                   Calendar options.   (line 1441)
* -jnb:                                  Calendar options.   (line 1447)
* -jn[b]:                                Calendar options.   (line 1434)
* -j[b]:                                 Calendar options.   (line 1417)
* -K:                                    Calendar options.   (line 1347)
* -k:                                    Fixed date options. (line  762)
* -L:                                    Common options.     (line   33)
* -l:                                    Fixed date options. (line  887)
* -l*dN:                                 Fixed date options. (line  910)
* -l*dNWWW:                              Fixed date options. (line 1056)
* -l*wN[WWW]:                            Fixed date options. (line 1119)
* -l@DVAR[+|-]NWWW:                      Fixed date options. (line 1317)
* -l@DVAR[[+|-]N]:                       Fixed date options. (line 1288)
* -l@e[+|-]NWWW:                         Fixed date options. (line 1204)
* -l@e[[+|-]N]:                          Fixed date options. (line 1174)
* -l@t[+|-]NWWW:                         Fixed date options. (line 1259)
* -l@t[[+|-]N]:                          Fixed date options. (line 1232)
* -lMMDD:                                Fixed date options. (line  997)
* -lMMWWWN:                              Fixed date options. (line 1019)
* -lN+|-:                                Fixed date options. (line  929)
* -lNd:                                  Fixed date options. (line  910)
* -lNw:                                  Fixed date options. (line  972)
* -m:                                    Fixed date options. (line 1383)
* -M:                                    Fixed date options. (line 1383)
* -m <1>:                                Fixed date options. (line 1386)
* -m+:                                   Fixed date options. (line 1393)
* -m-:                                   Fixed date options. (line 1405)
* -m[+|-]]:                              Fixed date options. (line 1383)
* -M[+|-]]:                              Fixed date options. (line 1383)
* -m|M[+|-]]:                            Fixed date options. (line 1383)
* -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  770)
* -p:                                    Global options.     (line   48)
* -P ARGUMENT:                           Fixed date options. (line  376)
* -Q:                                    Fixed date options. (line  782)
* -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 1470)
* -S NAME:                               Global options.     (line   15)
* -t:                                    Fixed date options. (line 1333)
* -T:                                    Fixed date options. (line 1333)
* -u:                                    Calendar options.   (line 1380)
* -U:                                    Fixed date options. (line  792)
* -V:                                    Common options.     (line   37)
* -v ARGUMENT:                           Fixed date options. (line    8)
* -w:                                    Fixed date options. (line 1345)
* -W:                                    Fixed date options. (line 1345)
* -w <1>:                                Fixed date options. (line 1349)
* -w+:                                   Fixed date options. (line 1356)
* -w-:                                   Fixed date options. (line 1368)
* -w[+|-]]:                              Fixed date options. (line 1345)
* -W[+|-]]:                              Fixed date options. (line 1345)
* -w|W[+|-]]:                            Fixed date options. (line 1345)
* -X:                                    Calendar options.   (line   45)
* -y:                                    Fixed date options. (line 1420)
* -Y:                                    Fixed date options. (line 1420)
* -y <1>:                                Fixed date options. (line 1423)
* -y+:                                   Fixed date options. (line 1430)
* -y-:                                   Fixed date options. (line 1442)
* -y[+|-]]:                              Fixed date options. (line 1420)
* -Y[+|-]]:                              Fixed date options. (line 1420)
* -y|Y[+|-]]:                            Fixed date options. (line 1420)
* -z:                                    Fixed date options. (line  856)
* -Z:                                    Fixed date options. (line  860)
* @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  179)
* 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   53)
* GCAL_COLUMNS:                          Global options.     (line   65)
* GCAL_COLUMNS <1>:                      Environment Variables.
                                                             (line   14)
* GCAL_DATE_FORMAT:                      Calendar options.   (line 1655)
* 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   49)
* 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  484)
* HOME <1>:                              Resource file.      (line   32)
* HOME <2>:                              Environment Variables.
                                                             (line   62)
* LANG:                                  Internationalization.
                                                             (line   34)
* LANG <1>:                              Internationalization.
                                                             (line  122)
* LANG <2>:                              Environment Variables.
                                                             (line   81)
* LANGUAGE:                              Internationalization.
                                                             (line   31)
* LANGUAGE <1>:                          Environment Variables.
                                                             (line   67)
* LC_ALL:                                Internationalization.
                                                             (line   32)
* LC_ALL <1>:                            Environment Variables.
                                                             (line   72)
* LC_MESSAGES:                           Internationalization.
                                                             (line   33)
* LC_MESSAGES <1>:                       Environment Variables.
                                                             (line   77)
* LINES:                                 Global options.     (line   70)
* LINES <1>:                             Environment Variables.
                                                             (line   25)
* LOGNAME:                               Global options.     (line  204)
* LOGNAME <1>:                           Environment Variables.
                                                             (line   85)
* MAILPROG:                              Global options.     (line  226)
* MAILPROG <1>:                          Environment Variables.
                                                             (line   89)
* MAILTO:                                Global options.     (line  194)
* MAILTO <1>:                            Environment Variables.
                                                             (line   95)
* PAGER:                                 Global options.     (line   48)
* PAGER <1>:                             Environment Variables.
                                                             (line  100)
* PATH:                                  Global options.     (line   53)
* PATH <1>:                              Environment Variables.
                                                             (line  105)
* TERM:                                  Global options.     (line   75)
* TERM <1>:                              Environment Variables.
                                                             (line  110)
* TXT2GCALPROG:                          Text variables.     (line  112)
* TXT2GCALPROG <1>:                      Environment Variables.
                                                             (line  113)
* TZ:                                    Environment Variables.
                                                             (line  123)
* USER:                                  Global options.     (line  199)
* USER <1>:                              Environment Variables.
                                                             (line  127)


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 1028)
* 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 1680)
* 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  118)
* 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  934)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  934)
* 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 1680)
* 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 1028)
* 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  934)
* Moon oriented special texts, modes:    Moon data.          (line   35)
* Moon oriented special texts, representation types: Moon data.
                                                             (line  838)
* 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  118)
* 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  838)
* Representation types of the Sun oriented special texts: Sun data.
                                                             (line 1105)
* 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  934)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  934)
* 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  934)
* Sun oriented special texts, modes:     Sun data.           (line   35)
* Sun oriented special texts, representation types: Sun data.
                                                             (line 1105)
* 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  211)
* '%,[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  232)
* '%>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  127)
* '%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   63)
* '%[FORMAT]-[ARGUMENT]' special text, environment variable: Contents of Environment variable.
                                                             (line    6)
* '%[FORMAT].[ARGUMENT]' special text, actual Universal time hour: Actual clocktime.
                                                             (line  161)
* '%[FORMAT]/[ARGUMENT]' special text, actual Universal time minute: Actual clocktime.
                                                             (line  177)
* '%[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   95)
* '%[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   79)
* '%[FORMAT]`[ARGUMENT]' special text, actual Universal time in 'M[M...]/DATE' format: Actual clocktime.
                                                             (line  144)
* '%[FORMAT]{[ARGUMENT]' special text, actual local time 12-hour format suffix: Actual clocktime.
                                                             (line  111)
* '%[FORMAT]}[ARGUMENT]' special text, actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  194)
* '(...)' 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  484)
* ',' 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   53)
* '/' 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  642)
* 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   50)
* ':' separator character:               Global options.     (line  107)
* ':' separator character <1>:           Global options.     (line  169)
* ':' 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  411)
* '\' depreciation character <4>:        Fixed date options. (line  499)
* '\' depreciation character <5>:        Fixed date options. (line  508)
* '\' depreciation character <6>:        Fixed date options. (line  543)
* '\' depreciation character <7>:        Fixed date options. (line  744)
* '\' depreciation character <8>:        Fixed date options. (line  754)
* '\' depreciation character <9>:        Fixed date options. (line  838)
* '\' depreciation character <10>:       Fixed date options. (line  848)
* '\' depreciation character <11>:       Text part of a line.
                                                             (line   51)
* '\' depreciation character <12>:       Text part of a line.
                                                             (line   92)
* '\' 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  411)
* '\' protection character <4>:          Fixed date options. (line  499)
* '\' protection character <5>:          Fixed date options. (line  508)
* '\' protection character <6>:          Fixed date options. (line  543)
* '\' protection character <7>:          Fixed date options. (line  744)
* '\' protection character <8>:          Fixed date options. (line  754)
* '\' protection character <9>:          Fixed date options. (line  838)
* '\' protection character <10>:         Fixed date options. (line  848)
* '\' protection character <11>:         Text part of a line.
                                                             (line   51)
* '\' protection character <12>:         Text part of a line.
                                                             (line   92)
* '\' 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  304)
* '\<' regexp, operator:                 Regexp Operators.   (line  271)
* '\>' regexp, operator:                 Regexp Operators.   (line  275)
* '\b' regexp, operator:                 Regexp Operators.   (line  279)
* '\B' regexp, operator:                 Regexp Operators.   (line  284)
* '\w' regexp, operator:                 Regexp Operators.   (line  259)
* '\W' regexp, operator:                 Regexp Operators.   (line  266)
* '\`' regexp, operator:                 Regexp Operators.   (line  300)
* '^' line break-up character:           Fixed date options. (line  394)
* '^' line break-up character <1>:       Fixed date options. (line  741)
* '^' line break-up character <2>:       Fixed date options. (line  835)
* '^' line break-up character <3>:       Text part of a line.
                                                             (line    6)
* '^' line break-up character <4>:       Text part of a line.
                                                             (line   57)
* '^' regexp, anchor metacharacter:      Regexp Operators.   (line   22)
* '_' pseudo space character:            Fixed date options. (line  111)
* '_' pseudo space character <1>:        Fixed date options. (line  407)
* '_' pseudo space character <2>:        Fixed date options. (line  505)
* '_' pseudo space character <3>:        Fixed date options. (line  540)
* '_' pseudo space character <4>:        Fixed date options. (line  751)
* '_' pseudo space character <5>:        Fixed date options. (line  845)
* '{EXPRESSION}' regexp, interval expressions: Regexp Operators.
                                                             (line  235)
* '|' regexp, operator:                  Regexp Operators.   (line  173)
* '~' line break-up character:           Fixed date options. (line  394)
* '~' line break-up character <1>:       Fixed date options. (line  741)
* '~' line break-up character <2>:       Fixed date options. (line  835)
* '~' line break-up character <3>:       Text part of a line.
                                                             (line    6)
* '~' line break-up character <4>:       Text part of a line.
                                                             (line   46)
* Accuracy of astronomical calculations: Preface.            (line   19)
* Activate fixed date function:          Fixed date options. (line  431)
* Activate fixed date function <1>:      Fixed date options. (line  471)
* Activate fixed date function <2>:      Fixed date options. (line  516)
* Activate fixed date function <3>:      Fixed date options. (line  598)
* 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  111)
* 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   79)
* 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   63)
* 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   95)
* 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  194)
* 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  161)
* Actual Universal time in 'HH:MM/DATE' format '%@[ARGUMENT]' special text: Actual clocktime.
                                                             (line  127)
* 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  144)
* 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  177)
* Actual Universal time minute '%[FORMAT]/[[+|-]MMMM|HH:[MM]]' special text: Special Texts Summary.
                                                             (line  259)
* Addition by days of date variables:    Date variables.     (line  125)
* Addition by weekdays of date variables: Date variables.    (line  127)
* Addition of text variables:            Text variables.     (line  300)
* Additional resource file:              Fixed date options. (line  471)
* Additional resource file line:         Fixed date options. (line  516)
* 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  149)
* Alternation operator:                  Glossary.           (line   15)
* Alternative date format in calendar sheet: Calendar options.
                                                             (line 1417)
* Alternative date format in eternal holiday list: Calendar options.
                                                             (line 1434)
* Alternative date format in fixed date list: Calendar options.
                                                             (line 1452)
* Amateur-astronomical twilight:         Glossary.           (line   19)
* Amateur-astronomical twilight, Sun:    Sun data.           (line  288)
* Amateur-astronomical twilight, Sun <1>: Sun data.          (line  297)
* 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  813)
* Asr, Islamic prayer time <2>:          Sun data.           (line  850)
* 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  338)
* 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  314)
* Astronomical twilight, Sun <1>:        Sun data.           (line  328)
* Astronomical unit:                     Glossary.           (line   40)
* Astronomical unit, Sun:                Sun data.           (line  403)
* Atmospheric refraction:                Fixed date options. (line  149)
* 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  149)
* Base time of astronomical functions, output: Sun data.     (line  489)
* Base time of astronomical functions, output <1>: Moon data.
                                                             (line  455)
* Base time of the astronomical functions, change: Calendar options.
                                                             (line 1491)
* Base year of calendar, change:         Calendar options.   (line 1540)
* 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  299)
* Buffer, regexp:                        Regexp Operators.   (line  290)
* C:                                     Glossary.           (line   63)
* C Preprocessor symbol USE_PAGER:       Global options.     (line  173)
* Calendar format, special:              Calendar options.   (line 1286)
* Calendar format, standard:             Calendar options.   (line 1286)
* Calendar mode, hybrid:                 Calendar options.   (line 1560)
* Calendar mode, proleptic:              Calendar options.   (line 1592)
* 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 1417)
* Calendar sheet, provide with week numbers: Calendar options.
                                                             (line 1347)
* Calendar sheet, special date format:   Calendar options.   (line 1423)
* Calendar sheet, standard and special date format: Calendar options.
                                                             (line 1429)
* 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  311)
* Celestial axis:                        Glossary.           (line   70)
* Celestial body elevation:              Glossary.           (line   74)
* Celestial equator:                     Sun data.           (line  377)
* Celestial equator <1>:                 Moon data.          (line  318)
* 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 1540)
* 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 1666)
* 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  236)
* Civil twilight, Sun <1>:               Sun data.           (line  245)
* Clocktime value, Sun and Moon oriented special texts: Sun data.
                                                             (line  925)
* Co-ordinate termination character, '/': Geographical distance and course angle.
                                                             (line   53)
* Co-ordinate, ISO-6709:1983:            Geographical distance and course angle.
                                                             (line   53)
* Co-ordinate, ISO-6709:1983 <1>:        Sun data.           (line 1022)
* Co-ordinate, ISO-6709:1983 <2>:        Moon data.          (line  818)
* 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  350)
* 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  350)
* 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  587)
* Command line word, single <1>:         Fixed date options. (line  598)
* 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  494)
* Complemented character list, regexp:   Regexp Operators.   (line  163)
* Complemented character list, '[^ ...]' regexp: Regexp Operators.
                                                             (line  163)
* Complemented regular expression:       Fixed date options. (line  423)
* 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 1728)
* Course angle:                          Glossary.           (line  715)
* Course angle (true track) '%b*1ARGUMENT' special text: Geographical distance and course angle.
                                                             (line   29)
* 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   43)
* 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   29)
* 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   43)
* 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  288)
* Cycle ending time value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  222)
* Cycle mode:                            Fixed date options. (line  222)
* Cycle mode <1>:                        Glossary.           (line  151)
* Cycle timestep value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  288)
* Date exclusion '%?'... special texts:  Exclusions.         (line    6)
* Date format elements:                  Calendar options.   (line 1666)
* Date format elements <1>:              Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date format texts, fixed default:      Calendar options.   (line 1633)
* Date format texts, fixed default <1>:  Table of Obsolete Date Formats.
                                                             (line    6)
* Date format texts, individual:         Calendar options.   (line 1655)
* Date format texts, individual <1>:     Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date formats:                          Calendar options.   (line 1633)
* Date formats, fixed default:           Calendar options.   (line 1633)
* Date formats, individual:              Calendar options.   (line 1655)
* 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  125)
* Date variables, addition by weekdays:  Date variables.     (line  127)
* 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  105)
* 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   56)
* 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  118)
* Date variables, scope:                 Fixed date options. (line    8)
* Date variables, scope <1>:             Date variables.     (line  129)
* Date variables, simple decrement:      Date variables.     (line  123)
* Date variables, simple increment:      Date variables.     (line  122)
* Date variables, subtraction by days:   Date variables.     (line  126)
* Date variables, subtraction by weekdays: Date variables.   (line  128)
* Date variables, total number:          Date variables.     (line    6)
* Date variables, visibility:            Date variables.     (line   56)
* Date variables, visibility of local:   Fixed date options. (line   28)
* Date variables, visibility of local <1>: Date variables.   (line  105)
* 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 1074)
* Decimal system:                        Glossary.           (line  161)
* Declination:                           Glossary.           (line  164)
* Declination, Moon:                     Moon data.          (line  318)
* Declination, Sun:                      Sun data.           (line  377)
* Default mode, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   46)
* Default mode, Moon data and times:     Moon data.          (line  803)
* Default mode, Sun data and times:      Sun data.           (line  878)
* 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   76)
* Delta-t:                               Glossary.           (line  168)
* Delta-t, Moon:                         Moon data.          (line  433)
* Delta-t, Sun:                          Sun data.           (line  467)
* 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  411)
* Depreciation character, '\' <4>:       Fixed date options. (line  499)
* Depreciation character, '\' <5>:       Fixed date options. (line  508)
* Depreciation character, '\' <6>:       Fixed date options. (line  543)
* Depreciation character, '\' <7>:       Fixed date options. (line  744)
* Depreciation character, '\' <8>:       Fixed date options. (line  754)
* Depreciation character, '\' <9>:       Fixed date options. (line  838)
* Depreciation character, '\' <10>:      Fixed date options. (line  848)
* Depreciation character, '\' <11>:      Text part of a line.
                                                             (line   51)
* Depreciation character, '\' <12>:      Text part of a line.
                                                             (line   92)
* 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  411)
* Depreciation of special characters <5>: Fixed date options.
                                                             (line  499)
* Depreciation of special characters <6>: Fixed date options.
                                                             (line  508)
* Depreciation of special characters <7>: Fixed date options.
                                                             (line  543)
* Depreciation of special characters <8>: Fixed date options.
                                                             (line  744)
* Depreciation of special characters <9>: Fixed date options.
                                                             (line  754)
* Depreciation of special characters <10>: Fixed date options.
                                                             (line  838)
* Depreciation of special characters <11>: Fixed date options.
                                                             (line  848)
* Depreciation of special characters <12>: Response file.    (line    6)
* Depreciation of special characters <13>: Text part of a line.
                                                             (line   51)
* Depreciation of special characters <14>: Text part of a line.
                                                             (line   92)
* 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 1857)
* 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   83)
* 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  866)
* Double shadow length at afternoon:     Sun data.           (line  850)
* Double shadow length at forenoon:      Sun data.           (line  841)
* Early years:                           Glossary.           (line  174)
* Earth equator radius, unit:            Moon data.          (line  355)
* Earth's atmosphere, set air pressure:  Fixed date options. (line  149)
* Earth's atmosphere, set base data to calculate refraction: Fixed date options.
                                                             (line  149)
* Earth's atmosphere, set temperature:   Fixed date options. (line  149)
* 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  388)
* Ecliptic <1>:                          Moon data.          (line  329)
* Ecliptic <2>:                          Moon data.          (line  337)
* Ecliptic <3>:                          Glossary.           (line  187)
* Ecliptic latitude:                     Glossary.           (line  179)
* Ecliptic latitude, Moon:               Moon data.          (line  337)
* Ecliptic longitude:                    Glossary.           (line  183)
* Ecliptic longitude, Moon:              Moon data.          (line  329)
* Ecliptic longitude, Sun:               Sun data.           (line  388)
* Electronic Mail:                       Global options.     (line  186)
* Elevation, Moon:                       Moon data.          (line  304)
* Elevation, Sun:                        Sun data.           (line  349)
* Elongation:                            Glossary.           (line  190)
* Elongation, Moon:                      Moon data.          (line  361)
* EMail, empty message body:             Global options.     (line  212)
* EMail, error code:                     Error Codes.        (line    6)
* EMail, methods of sending:             Global options.     (line  191)
* EMail, option:                         Global options.     (line  186)
* 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  212)
* End of highlighting sequence 1 '%2' special text: Highlighting.
                                                             (line   28)
* End of highlighting sequence 1 '%2' special text <1>: Special Texts Summary.
                                                             (line 1876)
* End of highlighting sequence 1 '%6' special text: Highlighting.
                                                             (line   78)
* End of highlighting sequence 1 '%6' special text <1>: Special Texts Summary.
                                                             (line 1889)
* 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 1906)
* End of highlighting sequence 2 '%4' special text: Highlighting.
                                                             (line   56)
* End of highlighting sequence 2 '%4' special text <1>: Special Texts Summary.
                                                             (line 1882)
* End of highlighting sequence 2 '%8' special text: Highlighting.
                                                             (line  100)
* End of highlighting sequence 2 '%8' special text <1>: Special Texts Summary.
                                                             (line 1897)
* 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 1854)
* 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  179)
* 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   53)
* 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   49)
* 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   62)
* Environment variable, 'LANG':          Internationalization.
                                                             (line   34)
* Environment variable, 'LANG' <1>:      Environment Variables.
                                                             (line   81)
* Environment variable, 'LANGUAGE':      Internationalization.
                                                             (line   31)
* Environment variable, 'LANGUAGE' <1>:  Environment Variables.
                                                             (line   67)
* Environment variable, 'LC_ALL':        Internationalization.
                                                             (line   32)
* Environment variable, 'LC_ALL' <1>:    Environment Variables.
                                                             (line   72)
* Environment variable, 'LC_MESSAGES':   Internationalization.
                                                             (line   33)
* Environment variable, 'LC_MESSAGES' <1>: Environment Variables.
                                                             (line   77)
* Environment variable, 'LINES':         Environment Variables.
                                                             (line   25)
* Environment variable, 'LOGNAME':       Global options.     (line  204)
* Environment variable, 'LOGNAME' <1>:   Environment Variables.
                                                             (line   85)
* Environment variable, 'MAILPROG':      Global options.     (line  226)
* Environment variable, 'MAILPROG' <1>:  Environment Variables.
                                                             (line   89)
* Environment variable, 'MAILTO':        Global options.     (line  194)
* Environment variable, 'MAILTO' <1>:    Environment Variables.
                                                             (line   95)
* Environment variable, 'PAGER':         Global options.     (line   48)
* Environment variable, 'PAGER' <1>:     Environment Variables.
                                                             (line  100)
* Environment variable, 'PATH':          Global options.     (line   53)
* Environment variable, 'PATH' <1>:      Environment Variables.
                                                             (line  105)
* Environment variable, 'TERM':          Environment Variables.
                                                             (line  110)
* Environment variable, 'TXT2GCALPROG':  Text variables.     (line  112)
* Environment variable, 'TXT2GCALPROG' <1>: Environment Variables.
                                                             (line  113)
* Environment variable, 'TZ':            Environment Variables.
                                                             (line  123)
* Environment variable, 'USER':          Global options.     (line  199)
* Environment variable, 'USER' <1>:      Environment Variables.
                                                             (line  127)
* Environment variables, table:          Environment Variables.
                                                             (line    6)
* Ephemeris date, Julian:                Sun data.           (line  504)
* Ephemeris date, Julian <1>:            Moon data.          (line  470)
* Ephemeris time (ET):                   Sun data.           (line  467)
* Ephemeris time (ET) <1>:               Moon data.          (line  433)
* Equation of time:                      Sun data.           (line  509)
* 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  437)
* Error code 1 <1>:                      Fixed date options. (line  446)
* Error code 1 <2>:                      Fixed date options. (line  471)
* Error code 1 <3>:                      Fixed date options. (line  516)
* Error code 113:                        Date variables.     (line   56)
* Error code 118:                        Resource file.      (line   63)
* Error code 119:                        Include directives. (line   54)
* Error code 126:                        Fixed date options. (line  961)
* Error code 126 <1>:                    Fixed date options. (line 1039)
* Error code 126 <2>:                    Fixed date options. (line 1045)
* Error code 126 <3>:                    Fixed date options. (line 1065)
* Error code 126 <4>:                    Fixed date options. (line 1072)
* Error code 126 <5>:                    Fixed date options. (line 1093)
* Error code 126 <6>:                    Fixed date options. (line 1102)
* Error code 126 <7>:                    Fixed date options. (line 1108)
* Error code 126 <8>:                    Fixed date options. (line 1128)
* Error code 126 <9>:                    Fixed date options. (line 1139)
* Error code 126 <10>:                   Fixed date options. (line 1146)
* 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 1434)
* 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 1441)
* Eternal holiday list, standard and special date format: Calendar options.
                                                             (line 1447)
* 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  795)
* Evening width topocentric, Sun:        Sun data.           (line  747)
* Event oriented texts of Moon data and times, special: Sun data.
                                                             (line  934)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  934)
* 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  350)
* 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  437)
* Exit code 1 <1>:                       Fixed date options. (line  446)
* Exit code 1 <2>:                       Fixed date options. (line  471)
* Exit code 1 <3>:                       Fixed date options. (line  516)
* Exit code 113:                         Date variables.     (line   56)
* Exit code 118:                         Resource file.      (line   63)
* Exit code 119:                         Include directives. (line   54)
* Exit code 126:                         Fixed date options. (line  961)
* Exit code 126 <1>:                     Fixed date options. (line 1039)
* Exit code 126 <2>:                     Fixed date options. (line 1045)
* Exit code 126 <3>:                     Fixed date options. (line 1065)
* Exit code 126 <4>:                     Fixed date options. (line 1072)
* Exit code 126 <5>:                     Fixed date options. (line 1093)
* Exit code 126 <6>:                     Fixed date options. (line 1102)
* Exit code 126 <7>:                     Fixed date options. (line 1108)
* Exit code 126 <8>:                     Fixed date options. (line 1128)
* Exit code 126 <9>:                     Fixed date options. (line 1139)
* Exit code 126 <10>:                    Fixed date options. (line 1146)
* 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  105)
* 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   77)
* 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  314)
* File directory, actual:                Resource file.      (line   32)
* File name, extended:                   Resource file.      (line   77)
* File name, simple:                     Resource file.      (line   87)
* File searching mechanism:              Resource file.      (line    6)
* Filtration, days of fixed dates:       Fixed date options. (line  361)
* Filtration, fixed date texts:          Fixed date options. (line  394)
* Filtration, fixed date texts <1>:      Fixed date options. (line  418)
* Filtration, fixed date texts <2>:      Fixed date options. (line  423)
* Filtration, periods of fixed dates:    Fixed date options. (line  376)
* 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   50)
* 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  431)
* Fixed date function, activate <1>:     Fixed date options. (line  471)
* Fixed date function, activate <2>:     Fixed date options. (line  516)
* Fixed date function, activate <3>:     Fixed date options. (line  598)
* Fixed date list, alternative date format: Calendar options.
                                                             (line 1452)
* Fixed date list, special date format:  Calendar options.   (line 1459)
* Fixed date list, standard and special date format: Calendar options.
                                                             (line 1465)
* Fixed date list, suppression of leading blank line: Fixed date options.
                                                             (line  782)
* Fixed date list, suppression of title text: Fixed date options.
                                                             (line  812)
* 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  815)
* Fixed date options:                    Fixed date options. (line    6)
* Fixed date period long-style option, '--end-of-month': Fixed date options.
                                                             (line 1383)
* Fixed date period long-style option, '--end-of-week': Fixed date options.
                                                             (line 1345)
* Fixed date period long-style option, '--end-of-year': Fixed date options.
                                                             (line 1420)
* Fixed date period long-style option, '--month': Fixed date options.
                                                             (line 1383)
* Fixed date period long-style option, '--start-of-month': Fixed date options.
                                                             (line 1383)
* Fixed date period long-style option, '--start-of-week': Fixed date options.
                                                             (line 1345)
* Fixed date period long-style option, '--start-of-year': Fixed date options.
                                                             (line 1420)
* Fixed date period long-style option, '--today': Fixed date options.
                                                             (line  431)
* Fixed date period long-style option, '--tomorrow': Fixed date options.
                                                             (line 1333)
* Fixed date period long-style option, '--week': Fixed date options.
                                                             (line 1345)
* Fixed date period long-style option, '--year': Fixed date options.
                                                             (line 1420)
* Fixed date period modifier, '*dN':     Fixed date options. (line  898)
* Fixed date period modifier, '*dNWWW':  Fixed date options. (line 1033)
* Fixed date period modifier, '*wN[WWW]': Fixed date options.
                                                             (line 1085)
* Fixed date period modifier, '0MMDD':   Fixed date options. (line  997)
* Fixed date period modifier, '@DVAR[+|-]NWWW': Fixed date options.
                                                             (line 1305)
* Fixed date period modifier, '@DVAR[[+|-]N]': Fixed date options.
                                                             (line 1273)
* Fixed date period modifier, '@e[+|-]NWWW': Fixed date options.
                                                             (line 1192)
* Fixed date period modifier, '@e[[+|-]N]': Fixed date options.
                                                             (line 1159)
* Fixed date period modifier, '@t[+|-]NWWW': Fixed date options.
                                                             (line 1247)
* Fixed date period modifier, '@t[[+|-]N]': Fixed date options.
                                                             (line 1218)
* Fixed date period modifier, 'd':       Fixed date options. (line  584)
* Fixed date period modifier, 'd' <1>:   Fixed date options. (line  881)
* Fixed date period modifier, 'l':       Fixed date options. (line  584)
* Fixed date period modifier, 'l' <1>:   Fixed date options. (line  887)
* Fixed date period modifier, 'l*dN':    Fixed date options. (line  910)
* Fixed date period modifier, 'l*dNWWW': Fixed date options. (line 1056)
* Fixed date period modifier, 'l*wN[WWW]': Fixed date options.
                                                             (line 1119)
* Fixed date period modifier, 'l@DVAR[+|-]NWWW': Fixed date options.
                                                             (line 1317)
* Fixed date period modifier, 'l@DVAR[[+|-]N]': Fixed date options.
                                                             (line 1288)
* Fixed date period modifier, 'l@e[+|-]NWWW': Fixed date options.
                                                             (line 1204)
* Fixed date period modifier, 'l@e[[+|-]N]': Fixed date options.
                                                             (line 1174)
* Fixed date period modifier, 'l@t[+|-]NWWW': Fixed date options.
                                                             (line 1259)
* Fixed date period modifier, 'l@t[[+|-]N]': Fixed date options.
                                                             (line 1232)
* Fixed date period modifier, 'lMMWWWN': Fixed date options. (line 1019)
* Fixed date period modifier, 'lN+|-':   Fixed date options. (line  929)
* Fixed date period modifier, 'lNd':     Fixed date options. (line  910)
* Fixed date period modifier, 'lNw':     Fixed date options. (line  972)
* Fixed date period modifier, 'MMDD':    Fixed date options. (line  990)
* Fixed date period modifier, 'MMWWWN':  Fixed date options. (line 1008)
* Fixed date period modifier, 'm|M[+|-]': Fixed date options.
                                                             (line 1383)
* Fixed date period modifier, 'N+|-':    Fixed date options. (line  919)
* Fixed date period modifier, 'Nd':      Fixed date options. (line  898)
* Fixed date period modifier, 'Nw':      Fixed date options. (line  942)
* Fixed date period modifier, 't|T':     Fixed date options. (line 1333)
* Fixed date period modifier, 'w|W[+|-]': Fixed date options.
                                                             (line 1345)
* Fixed date period modifier, 'y|Y[+|-]': Fixed date options.
                                                             (line 1420)
* Fixed date period modifiers and options: Fixed date options.
                                                             (line  863)
* Fixed date period option, '--leap-day=february': Fixed date options.
                                                             (line  870)
* Fixed date period option, '--leap-day=february|march': Fixed date options.
                                                             (line  584)
* Fixed date period option, '--leap-day=february|march' <1>: Fixed date options.
                                                             (line  866)
* Fixed date period option, '--leap-day=march': Fixed date options.
                                                             (line  875)
* Fixed date text modifier, 'a':         Fixed date options. (line  672)
* Fixed date text modifier, 'A':         Fixed date options. (line  681)
* Fixed date text modifier, alternative list format: Fixed date options.
                                                             (line  681)
* Fixed date text modifier, 'e':         Fixed date options. (line  696)
* Fixed date text modifier, 'E':         Fixed date options. (line  701)
* Fixed date text modifier, 'g[TEXT]':   Fixed date options. (line  706)
* Fixed date text modifier, 'J':         Fixed date options. (line  802)
* Fixed date text modifier, 'k':         Fixed date options. (line  762)
* Fixed date text modifier, 'o':         Fixed date options. (line  770)
* Fixed date text modifier, 'Q':         Fixed date options. (line  782)
* Fixed date text modifier, 'U':         Fixed date options. (line  792)
* Fixed date text modifier, 'x':         Fixed date options. (line  812)
* Fixed date text modifier, 'z':         Fixed date options. (line  856)
* Fixed date text modifier, 'Z':         Fixed date options. (line  860)
* Fixed date text modifiers:             Fixed date options. (line  617)
* Fixed date text option, '--biorhythm-axis=NUMBER': Fixed date options.
                                                             (line  620)
* Fixed date text option, '--moonimage-lines=NUMBER': Fixed date options.
                                                             (line  649)
* Fixed date texts, filtration:          Fixed date options. (line  394)
* Fixed date texts, filtration <1>:      Fixed date options. (line  418)
* Fixed date texts, filtration <2>:      Fixed date options. (line  423)
* 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  431)
* Fixed date, option <1>:                Fixed date options. (line  598)
* 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  431)
* Fixed dates <1>:                       Fixed date options. (line  598)
* Fixed dates <2>:                       Fixed Dates.        (line    6)
* Fixed dates for the _month_:           Fixed date options. (line 1383)
* Fixed dates for the _week_:            Fixed date options. (line 1345)
* Fixed dates for the _year_:            Fixed date options. (line 1420)
* Fixed dates for _today_:               Fixed date options. (line  431)
* Fixed dates for _tomorrow_:            Fixed date options. (line 1333)
* Fixed dates, filtration of days:       Fixed date options. (line  361)
* Fixed dates, filtration of periods:    Fixed date options. (line  376)
* Fixed default date format texts:       Calendar options.   (line 1633)
* Fixed default date format texts <1>:   Table of Obsolete Date Formats.
                                                             (line    6)
* Fixed default date formats:            Calendar options.   (line 1633)
* Fixed format date text:                Textual date.       (line    6)
* Floating Point number:                 Glossary.           (line  561)
* Force line break-up:                   Fixed date options. (line  741)
* Force line break-up <1>:               Fixed date options. (line  835)
* Force line break-up in resource file:  Text part of a line.
                                                             (line   41)
* Force year calendar sheet:             Calendar options.   (line 1384)
* Forcing highlighting sequences:        Global options.     (line   91)
* Format elements:                       Calendar options.   (line 1666)
* Format elements <1>:                   Table of Obsolete Date Formats.
                                                             (line    6)
* Format elements, obsolete:             Obsolete Special Texts.
                                                             (line    6)
* Format instruction:                    Calendar options.   (line 1666)
* 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  516)
* '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  179)
* '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   53)
* '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   49)
* '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  260)
* Geocentric data, Sun:                  Sun data.           (line  349)
* Geocentrical horizon:                  Glossary.           (line  262)
* Geographical data, more precise representation: Fixed date options.
                                                             (line  338)
* 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   46)
* 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  127)
* Greenwich Mean time (GMT) <4>:         Actual clocktime.   (line  144)
* Greenwich Mean time (GMT) <5>:         Actual clocktime.   (line  161)
* Greenwich Mean time (GMT) <6>:         Actual clocktime.   (line  177)
* Greenwich Mean time (GMT) <7>:         Actual clocktime.   (line  194)
* Greenwich Mean time (GMT) <8>:         Actual clocktime.   (line  211)
* Greenwich Mean time (GMT) <9>:         Julian day number.  (line    6)
* Greenwich Mean time (GMT) <10>:        Sun data.           (line  489)
* Greenwich Mean time (GMT) <11>:        Sun data.           (line 1074)
* Greenwich Mean time (GMT) <12>:        Moon data.          (line  455)
* Gregorian calendar:                    Glossary.           (line  296)
* Gregorian calendar, genesis:           Todays Calendar.    (line    6)
* Gregorian Reformation, set period:     Calendar options.   (line 1560)
* 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 1871)
* 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   62)
* Horizontal parallax:                   Glossary.           (line  318)
* Horizontal parallax, moon:             Moon data.          (line  260)
* Horizontal parallax, Sun:              Sun data.           (line  411)
* How to use regular expressions:        Regexp Usage.       (line    6)
* Hybrid calendar mode:                  Calendar options.   (line 1560)
* Hybrid calendar mode <1>:              Glossary.           (line  322)
* Ignoring case distinctions in regular expression: Fixed date options.
                                                             (line  418)
* Ignoring case distinctions in regular expression <1>: Regexp Operators.
                                                             (line  316)
* Ignoring case, regexp:                 Fixed date options. (line  418)
* Ignoring case, regexp <1>:             Regexp Operators.   (line  316)
* 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 1655)
* Individual date format texts <1>:      Table of Obsolete Date Format Elements.
                                                             (line    6)
* Individual date formats:               Calendar options.   (line 1655)
* 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  328)
* 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  813)
* Islamic prayer time, Asr <2>:          Sun data.           (line  850)
* Islamic prayer time, Fajr:             Sun data.           (line  314)
* Islamic prayer time, Isha:             Sun data.           (line  328)
* Islamic prayer time, Maghrib:          Sun data.           (line  200)
* Islamic prayer time, Zuhr:             Sun data.           (line   50)
* Islamic prayer, direction to Makkah:   Geographical distance and course angle.
                                                             (line   83)
* 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   53)
* ISO-6709:1983 co-ordinate <1>:         Sun data.           (line 1022)
* ISO-6709:1983 co-ordinate <2>:         Moon data.          (line  818)
* ISO-8601:1988 week number:             Calendar options.   (line 1361)
* ISO-8601:1988 week number <1>:         Fixed date options. (line  762)
* ISO-8601:1988 week number <2>:         Fixed date options. (line  942)
* ISO-8601:1988 week number <3>:         Fixed date options. (line  972)
* ISO-8601:1988 week number <4>:         Fixed date options. (line 1085)
* ISO-8601:1988 week number <5>:         Fixed date options. (line 1119)
* 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  504)
* Julian Ephemeris date <1>:             Moon data.          (line  470)
* Julian Ephemeris date <2>:             Glossary.           (line  355)
* 'LANG' environment variable:           Internationalization.
                                                             (line   34)
* 'LANG' environment variable <1>:       Environment Variables.
                                                             (line   81)
* 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   67)
* 'LC_ALL' environment variable:         Internationalization.
                                                             (line   32)
* 'LC_ALL' environment variable <1>:     Environment Variables.
                                                             (line   72)
* 'LC_MESSAGES' environment variable:    Internationalization.
                                                             (line   33)
* 'LC_MESSAGES' environment variable <1>: Environment Variables.
                                                             (line   77)
* Leap day:                              Fixed date options. (line  866)
* Leap day <1>:                          Glossary.           (line  373)
* Leap year:                             Glossary.           (line  376)
* Leap year rule as used by Eastern Orthodox churches: Calendar options.
                                                             (line 1320)
* Legal holiday:                         Preface.            (line  140)
* Legal holiday <1>:                     Glossary.           (line  386)
* Length preserving behavior of numerical text variables: Text variables.
                                                             (line  348)
* Limit sunrise and sunset to actual day: Fixed date options.
                                                             (line  170)
* Limitations concerning the assignment of special texts to text variables: Special Texts.
                                                             (line   20)
* Limitations in a resource file:        Global options.     (line  216)
* 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   50)
* Limitations of use of fiscal years:    Further date part attributes.
                                                             (line   29)
* Limitations of use of fiscal years <1>: Date variables.    (line   50)
* Limitations, Moon oriented special texts: Moon data.       (line  944)
* Limitations, Sun oriented special texts: Sun data.         (line 1204)
* Line break-up character, '^':          Fixed date options. (line  394)
* Line break-up character, '^' <1>:      Fixed date options. (line  741)
* Line break-up character, '^' <2>:      Fixed date options. (line  835)
* Line break-up character, '^' <3>:      Text part of a line.
                                                             (line    6)
* Line break-up character, '^' <4>:      Text part of a line.
                                                             (line   57)
* Line break-up character, '~':          Fixed date options. (line  394)
* Line break-up character, '~' <1>:      Fixed date options. (line  741)
* Line break-up character, '~' <2>:      Fixed date options. (line  835)
* Line break-up character, '~' <3>:      Text part of a line.
                                                             (line    6)
* Line break-up character, '~' <4>:      Text part of a line.
                                                             (line   46)
* 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  391)
* 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  394)
* Local date variables:                  Date variables.     (line    6)
* Local date variables, definition:      Date variables.     (line    6)
* Local date variables, deletion:        Date variables.     (line   76)
* Local sidereal time:                   Glossary.           (line  400)
* Local star time:                       Glossary.           (line  400)
* Local text variable:                   Glossary.           (line  407)
* 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 1074)
* Local time 12-hour format suffix, display: Actual clocktime.
                                                             (line  111)
* Local time hour, display:              Actual clocktime.   (line   79)
* Local time in 'HH:MM' format, display: Actual clocktime.   (line   23)
* Local time in M[M...] format, display: Actual clocktime.   (line   63)
* Local time minute, display:            Actual clocktime.   (line   95)
* 'LOGNAME' environment variable:        Global options.     (line  204)
* 'LOGNAME' environment variable <1>:    Environment Variables.
                                                             (line   85)
* Long help text:                        Common options.     (line   16)
* Long text part in resource file line:  Text part of a line.
                                                             (line   41)
* Long-style option:                     Options.            (line   21)
* Long-style option <1>:                 Glossary.           (line  412)
* Long-style option names, list:         Common options.     (line   25)
* Longer than double shadow length, period: Sun data.        (line  872)
* Longer than single shadow length, period: Sun data.        (line  835)
* Lowest culmination point:              Glossary.           (line  415)
* Lowest culmination point, Moon:        Moon data.          (line   38)
* Lowest culmination point, Sun:         Sun data.           (line   38)
* Lunar Arctic Circle:                   Moon data.          (line  977)
* Lunar Arctic Circle <1>:               Glossary.           (line  419)
* Lunar day length:                      Moon data.          (line    6)
* Lunar eclipse:                         Calendar options.   (line   48)
* Lunar night length:                    Moon data.          (line    6)
* Lunation:                              Glossary.           (line  424)
* Lunation, Moon:                        Moon data.          (line   38)
* Maghrib prayer time:                   Glossary.           (line  427)
* Maghrib, Islamic prayer time:          Sun data.           (line  200)
* Magnitude unit:                        Glossary.           (line  431)
* Magnitude units, Moon:                 Moon data.          (line  285)
* Mail, empty message body:              Global options.     (line  212)
* Mail, methods of sending:              Global options.     (line  191)
* Mail, sending:                         Global options.     (line  186)
* 'MAILPROG' environment variable:       Global options.     (line  226)
* 'MAILPROG' environment variable <1>:   Environment Variables.
                                                             (line   89)
* 'MAILTO' environment variable:         Global options.     (line  194)
* 'MAILTO' environment variable <1>:     Environment Variables.
                                                             (line   95)
* 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  446)
* Marking characters, disabling:         Global options.     (line  102)
* Marking characters, setting:           Global options.     (line  107)
* Matching word boundaries in regexp:    Regexp Operators.   (line  279)
* 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  450)
* Mean solar day:                        Sun data.           (line  509)
* Mean solar day <1>:                    Glossary.           (line  456)
* Mean solar time:                       Sun data.           (line  509)
* Mean solar time <1>:                   Glossary.           (line  456)
* Mean Sun:                              Sun data.           (line  509)
* Mean sun:                              Glossary.           (line  456)
* Meridian:                              Geographical distance and course angle.
                                                             (line    6)
* Meridian <1>:                          Glossary.           (line  465)
* Message catalog:                       Internationalization.
                                                             (line   11)
* Metacharacter, '.' regexp:             Regexp Operators.   (line   40)
* Metacharacter, '\' regexp:             Regexp Operators.   (line   14)
* Metacharacters:                        Glossary.           (line  469)
* Metacharacters, regexp:                Regexp Operators.   (line    6)
* Metasymbols within this document, table: Metasymbols.      (line    6)
* Methods of sending Mail:               Global options.     (line  191)
* Midnight height:                       Glossary.           (line  472)
* Midnight height geocentric, Moon:      Moon data.          (line  727)
* Midnight height geocentric, Sun:       Sun data.           (line  757)
* Midnight height topocentric, Moon:     Moon data.          (line  651)
* Midnight height topocentric, Sun:      Sun data.           (line  709)
* Midnight phase angle:                  Glossary.           (line  476)
* Midnight phase angle geocentric, Moon: Moon data.          (line  734)
* Midnight phase angle topocentric, Moon: Moon data.         (line  658)
* 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  480)
* Modifiers, fixed date period:          Fixed date options. (line  863)
* Modifiers, fixed date text:            Fixed date options. (line  617)
* 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 1383)
* 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 1110)
* Moon data and times, default mode:     Moon data.          (line  803)
* Moon data and times, mode characters:  Moon data.          (line   23)
* Moon data and times, special event oriented texts: Sun data.
                                                             (line  934)
* Moon data and times, style of representation: Sun data.    (line  885)
* Moon data and times, style of representation <1>: Moon data.
                                                             (line  810)
* Moon data and times, type of representation: Sun data.     (line  885)
* Moon data and times, type of representation <1>: Moon data.
                                                             (line  810)
* Moon oriented special texts, limitations: Moon data.       (line  944)
* Moon oriented special texts, reference systems used: Moon data.
                                                             (line  944)
* Moon oriented special texts, table of modes: Moon data.    (line   35)
* Moon oriented special texts, table of representation types: Moon data.
                                                             (line  838)
* 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  379)
* Moon's center, geocentric brightness '%(lARGUMENT' special text: Moon data.
                                                             (line  379)
* Moon's center, geocentric brightness '%)*lARGUMENT' special text: Moon data.
                                                             (line  379)
* Moon's center, geocentric brightness '%)lARGUMENT' special text: Moon data.
                                                             (line  379)
* Moon's center, geocentric horizontal parallax '%(*jARGUMENT' special text: Moon data.
                                                             (line  371)
* Moon's center, geocentric horizontal parallax '%(jARGUMENT' special text: Moon data.
                                                             (line  371)
* Moon's center, geocentric horizontal parallax '%)*jARGUMENT' special text: Moon data.
                                                             (line  371)
* Moon's center, geocentric horizontal parallax '%)jARGUMENT' special text: Moon data.
                                                             (line  371)
* Moon's center, geocentric phase angle '%(*mARGUMENT' special text: Moon data.
                                                             (line  383)
* Moon's center, geocentric phase angle '%(mARGUMENT' special text: Moon data.
                                                             (line  383)
* Moon's center, geocentric phase angle '%)*mARGUMENT' special text: Moon data.
                                                             (line  383)
* Moon's center, geocentric phase angle '%)mARGUMENT' special text: Moon data.
                                                             (line  383)
* Moon's center, geocentric semidiameter '%(*kARGUMENT' special text: Moon data.
                                                             (line  375)
* Moon's center, geocentric semidiameter '%(kARGUMENT' special text: Moon data.
                                                             (line  375)
* Moon's center, geocentric semidiameter '%)*kARGUMENT' special text: Moon data.
                                                             (line  375)
* Moon's center, geocentric semidiameter '%)kARGUMENT' special text: Moon data.
                                                             (line  375)
* 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 1158)
* 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 1154)
* 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 1134)
* 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 1130)
* 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 1142)
* 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 1138)
* 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 1150)
* 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 1146)
* 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 1220)
* 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 1216)
* 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 1197)
* 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 1194)
* 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 1204)
* 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 1201)
* Moon's center, topocentric brightness '%(*8ARGUMENT' special text: Moon data.
                                                             (line  285)
* Moon's center, topocentric brightness '%(8ARGUMENT' special text: Moon data.
                                                             (line  285)
* Moon's center, topocentric brightness '%)*8ARGUMENT' special text: Moon data.
                                                             (line  285)
* Moon's center, topocentric brightness '%)8ARGUMENT' special text: Moon data.
                                                             (line  285)
* Moon's center, topocentric horizontal parallax '%(*6ARGUMENT' special text: Moon data.
                                                             (line  260)
* Moon's center, topocentric horizontal parallax '%(6ARGUMENT' special text: Moon data.
                                                             (line  260)
* Moon's center, topocentric horizontal parallax '%)*6ARGUMENT' special text: Moon data.
                                                             (line  260)
* Moon's center, topocentric horizontal parallax '%)6ARGUMENT' special text: Moon data.
                                                             (line  260)
* Moon's center, topocentric phase angle '%(*9ARGUMENT' special text: Moon data.
                                                             (line  300)
* Moon's center, topocentric phase angle '%(9ARGUMENT' special text: Moon data.
                                                             (line  300)
* Moon's center, topocentric phase angle '%)*9ARGUMENT' special text: Moon data.
                                                             (line  300)
* Moon's center, topocentric phase angle '%)9ARGUMENT' special text: Moon data.
                                                             (line  300)
* Moon's center, topocentric semidiameter '%(*7ARGUMENT' special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric semidiameter '%(7ARGUMENT' special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric semidiameter '%)*7ARGUMENT' special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric semidiameter '%)7ARGUMENT' special text: Moon data.
                                                             (line  281)
* Moon's center, visibility '%[*4ARGUMENT' special text: Moon data.
                                                             (line  185)
* Moon's center, visibility '%[*4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1212)
* Moon's center, visibility '%[4ARGUMENT' special text: Moon data.
                                                             (line  185)
* Moon's center, visibility '%[4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1208)
* 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 1190)
* 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 1186)
* 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 1166)
* 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 1162)
* 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 1174)
* 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 1170)
* 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 1182)
* 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 1178)
* Moon's upper limb, non-visibility standard '%]*5ARGUMENT' special text: Special Texts Summary.
                                                             (line 1252)
* Moon's upper limb, non-visibility standard '%]5ARGUMENT' special text: Special Texts Summary.
                                                             (line 1248)
* Moon's upper limb, standard non-visibility '%]*5ARGUMENT' special text: Moon data.
                                                             (line  252)
* Moon's upper limb, standard non-visibility '%]5ARGUMENT' special text: Moon data.
                                                             (line  252)
* 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 1228)
* 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 1224)
* Moon's upper limb, standard set time '%)*5ARGUMENT' special text: Moon data.
                                                             (line  225)
* Moon's upper limb, standard set time '%)*5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1236)
* Moon's upper limb, standard set time '%)5ARGUMENT' special text: Moon data.
                                                             (line  225)
* Moon's upper limb, standard set time '%)5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1232)
* Moon's upper limb, standard visibility '%[*5ARGUMENT' special text: Moon data.
                                                             (line  244)
* Moon's upper limb, standard visibility '%[5ARGUMENT' special text: Moon data.
                                                             (line  244)
* Moon's upper limb, visibility standard '%[*5ARGUMENT' special text: Special Texts Summary.
                                                             (line 1244)
* Moon's upper limb, visibility standard '%[5ARGUMENT' special text: Special Texts Summary.
                                                             (line 1240)
* Moon, astronomical midnight time '%(*0ARGUMENT' special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time '%(*0ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1117)
* Moon, astronomical midnight time '%(0ARGUMENT' special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time '%(0ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1113)
* Moon, astronomical midnight time '%)*0ARGUMENT' special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time '%)*0ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1117)
* Moon, astronomical midnight time '%)0ARGUMENT' special text: Moon data.
                                                             (line   38)
* Moon, astronomical midnight time '%)0ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1113)
* Moon, astronomical noon time '%(*1ARGUMENT' special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time '%(*1ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1126)
* Moon, astronomical noon time '%(1ARGUMENT' special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time '%(1ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1122)
* Moon, astronomical noon time '%)*1ARGUMENT' special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time '%)*1ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1126)
* Moon, astronomical noon time '%)1ARGUMENT' special text: Moon data.
                                                             (line   58)
* Moon, astronomical noon time '%)1ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1122)
* Moon, azimuth:                         Moon data.          (line   38)
* Moon, base time '%(*xARGUMENT' special text: Moon data.    (line  455)
* Moon, base time '%(*xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1518)
* Moon, base time '%(xARGUMENT' special text: Moon data.     (line  455)
* Moon, base time '%(xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1513)
* Moon, base time '%)*xARGUMENT' special text: Moon data.    (line  455)
* Moon, base time '%)*xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1518)
* Moon, base time '%)xARGUMENT' special text: Moon data.     (line  455)
* Moon, base time '%)xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1513)
* Moon, conjunction:                     Moon data.          (line   38)
* Moon, delta-t '%(*vARGUMENT' special text: Moon data.      (line  433)
* Moon, delta-t '%(*vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1500)
* Moon, delta-t '%(vARGUMENT' special text: Moon data.       (line  433)
* Moon, delta-t '%(vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1500)
* Moon, delta-t '%)*vARGUMENT' special text: Moon data.      (line  433)
* Moon, delta-t '%)*vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1500)
* Moon, delta-t '%)vARGUMENT' special text: Moon data.       (line  433)
* Moon, delta-t '%)vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1500)
* Moon, geocentric azimuth '%(*oARGUMENT' special text: Moon data.
                                                             (line  395)
* Moon, geocentric azimuth '%(*oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1434)
* Moon, geocentric azimuth '%(oARGUMENT' special text: Moon data.
                                                             (line  395)
* Moon, geocentric azimuth '%(oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1429)
* Moon, geocentric azimuth '%)*oARGUMENT' special text: Moon data.
                                                             (line  395)
* Moon, geocentric azimuth '%)*oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1434)
* Moon, geocentric azimuth '%)oARGUMENT' special text: Moon data.
                                                             (line  395)
* Moon, geocentric azimuth '%)oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1429)
* Moon, geocentric azimuth at standard rise time '%(*XARGUMENT' special text: Moon data.
                                                             (line  769)
* Moon, geocentric azimuth at standard rise time '%(*XARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1824)
* Moon, geocentric azimuth at standard rise time '%(XARGUMENT' special text: Moon data.
                                                             (line  769)
* Moon, geocentric azimuth at standard rise time '%(XARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1820)
* Moon, geocentric azimuth at standard set time '%)*XARGUMENT' special text: Moon data.
                                                             (line  779)
* Moon, geocentric azimuth at standard set time '%)*XARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1832)
* Moon, geocentric azimuth at standard set time '%)XARGUMENT' special text: Moon data.
                                                             (line  779)
* Moon, geocentric azimuth at standard set time '%)XARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1828)
* Moon, geocentric brightness '%(*lARGUMENT' special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric brightness '%(lARGUMENT' special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric brightness '%)*lARGUMENT' special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric brightness '%)lARGUMENT' special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric data:                 Moon data.          (line  260)
* Moon, geocentric declination '%(*pARGUMENT' special text: Moon data.
                                                             (line  399)
* Moon, geocentric declination '%(*pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1444)
* Moon, geocentric declination '%(pARGUMENT' special text: Moon data.
                                                             (line  399)
* Moon, geocentric declination '%(pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1439)
* Moon, geocentric declination '%)*pARGUMENT' special text: Moon data.
                                                             (line  399)
* Moon, geocentric declination '%)*pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1444)
* Moon, geocentric declination '%)pARGUMENT' special text: Moon data.
                                                             (line  399)
* Moon, geocentric declination '%)pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1439)
* Moon, geocentric distance '%(*tARGUMENT' special text: Moon data.
                                                             (line  425)
* Moon, geocentric distance '%(*tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1484)
* Moon, geocentric distance '%(tARGUMENT' special text: Moon data.
                                                             (line  425)
* Moon, geocentric distance '%(tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1479)
* Moon, geocentric distance '%)*tARGUMENT' special text: Moon data.
                                                             (line  425)
* Moon, geocentric distance '%)*tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1484)
* Moon, geocentric distance '%)tARGUMENT' special text: Moon data.
                                                             (line  425)
* Moon, geocentric distance '%)tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1479)
* Moon, geocentric ecliptic latitude '%(*rARGUMENT' special text: Moon data.
                                                             (line  412)
* Moon, geocentric ecliptic latitude '%(*rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1464)
* Moon, geocentric ecliptic latitude '%(rARGUMENT' special text: Moon data.
                                                             (line  412)
* Moon, geocentric ecliptic latitude '%(rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1459)
* Moon, geocentric ecliptic latitude '%)*rARGUMENT' special text: Moon data.
                                                             (line  412)
* Moon, geocentric ecliptic latitude '%)*rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1464)
* Moon, geocentric ecliptic latitude '%)rARGUMENT' special text: Moon data.
                                                             (line  412)
* Moon, geocentric ecliptic latitude '%)rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1459)
* Moon, geocentric ecliptic longitude '%(*qARGUMENT' special text: Moon data.
                                                             (line  408)
* Moon, geocentric ecliptic longitude '%(*qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1454)
* Moon, geocentric ecliptic longitude '%(qARGUMENT' special text: Moon data.
                                                             (line  408)
* Moon, geocentric ecliptic longitude '%(qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1449)
* Moon, geocentric ecliptic longitude '%)*qARGUMENT' special text: Moon data.
                                                             (line  408)
* Moon, geocentric ecliptic longitude '%)*qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1454)
* Moon, geocentric ecliptic longitude '%)qARGUMENT' special text: Moon data.
                                                             (line  408)
* Moon, geocentric ecliptic longitude '%)qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1449)
* Moon, geocentric elevation '%(*nARGUMENT' special text: Moon data.
                                                             (line  387)
* Moon, geocentric elevation '%(*nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1424)
* Moon, geocentric elevation '%(nARGUMENT' special text: Moon data.
                                                             (line  387)
* Moon, geocentric elevation '%(nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1419)
* Moon, geocentric elevation '%)*nARGUMENT' special text: Moon data.
                                                             (line  387)
* Moon, geocentric elevation '%)*nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1424)
* Moon, geocentric elevation '%)nARGUMENT' special text: Moon data.
                                                             (line  387)
* Moon, geocentric elevation '%)nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1419)
* Moon, geocentric elevation at Moon's astronomical midnight time '%(*SARGUMENT' special text: Moon data.
                                                             (line  727)
* Moon, geocentric elevation at Moon's astronomical midnight time '%(*SARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1770)
* Moon, geocentric elevation at Moon's astronomical midnight time '%(SARGUMENT' special text: Moon data.
                                                             (line  727)
* Moon, geocentric elevation at Moon's astronomical midnight time '%(SARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1765)
* Moon, geocentric elevation at Moon's astronomical midnight time '%)*SARGUMENT' special text: Moon data.
                                                             (line  727)
* Moon, geocentric elevation at Moon's astronomical midnight time '%)*SARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1770)
* Moon, geocentric elevation at Moon's astronomical midnight time '%)SARGUMENT' special text: Moon data.
                                                             (line  727)
* Moon, geocentric elevation at Moon's astronomical midnight time '%)SARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1765)
* Moon, geocentric elevation at Moon's astronomical noon time '%(*UARGUMENT' special text: Moon data.
                                                             (line  741)
* Moon, geocentric elevation at Moon's astronomical noon time '%(*UARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1790)
* Moon, geocentric elevation at Moon's astronomical noon time '%(UARGUMENT' special text: Moon data.
                                                             (line  741)
* Moon, geocentric elevation at Moon's astronomical noon time '%(UARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1785)
* Moon, geocentric elevation at Moon's astronomical noon time '%)*UARGUMENT' special text: Moon data.
                                                             (line  741)
* Moon, geocentric elevation at Moon's astronomical noon time '%)*UARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1790)
* Moon, geocentric elevation at Moon's astronomical noon time '%)UARGUMENT' special text: Moon data.
                                                             (line  741)
* Moon, geocentric elevation at Moon's astronomical noon time '%)UARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1785)
* Moon, geocentric elevation at standard rise time '%(*WARGUMENT' special text: Moon data.
                                                             (line  755)
* Moon, geocentric elevation at standard rise time '%(*WARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1808)
* Moon, geocentric elevation at standard rise time '%(WARGUMENT' special text: Moon data.
                                                             (line  755)
* Moon, geocentric elevation at standard rise time '%(WARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1804)
* Moon, geocentric elevation at standard set time '%)*WARGUMENT' special text: Moon data.
                                                             (line  762)
* Moon, geocentric elevation at standard set time '%)*WARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1816)
* Moon, geocentric elevation at standard set time '%)WARGUMENT' special text: Moon data.
                                                             (line  762)
* Moon, geocentric elevation at standard set time '%)WARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1812)
* Moon, geocentric elongation '%(*uARGUMENT' special text: Moon data.
                                                             (line  429)
* Moon, geocentric elongation '%(*uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1493)
* Moon, geocentric elongation '%(uARGUMENT' special text: Moon data.
                                                             (line  429)
* Moon, geocentric elongation '%(uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1488)
* Moon, geocentric elongation '%)*uARGUMENT' special text: Moon data.
                                                             (line  429)
* Moon, geocentric elongation '%)*uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1493)
* Moon, geocentric elongation '%)uARGUMENT' special text: Moon data.
                                                             (line  429)
* Moon, geocentric elongation '%)uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1488)
* Moon, geocentric horizontal parallax '%(*jARGUMENT' special text: Special Texts Summary.
                                                             (line 1387)
* Moon, geocentric horizontal parallax '%(jARGUMENT' special text: Special Texts Summary.
                                                             (line 1382)
* Moon, geocentric horizontal parallax '%)*jARGUMENT' special text: Special Texts Summary.
                                                             (line 1387)
* Moon, geocentric horizontal parallax '%)jARGUMENT' special text: Special Texts Summary.
                                                             (line 1382)
* Moon, geocentric phase angle '%(*mARGUMENT' special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric phase angle '%(mARGUMENT' special text: Special Texts Summary.
                                                             (line 1409)
* Moon, geocentric phase angle '%)*mARGUMENT' special text: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric phase angle '%)mARGUMENT' special text: Special Texts Summary.
                                                             (line 1409)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%(*TARGUMENT' special text: Moon data.
                                                             (line  734)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%(*TARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1780)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%(TARGUMENT' special text: Moon data.
                                                             (line  734)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%(TARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1775)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%)*TARGUMENT' special text: Moon data.
                                                             (line  734)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%)*TARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1780)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%)TARGUMENT' special text: Moon data.
                                                             (line  734)
* Moon, geocentric phase angle at Moon's astronomical midnight time '%)TARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1775)
* Moon, geocentric phase angle at Moon's astronomical noon time '%(*VARGUMENT' special text: Moon data.
                                                             (line  748)
* Moon, geocentric phase angle at Moon's astronomical noon time '%(*VARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1800)
* Moon, geocentric phase angle at Moon's astronomical noon time '%(VARGUMENT' special text: Moon data.
                                                             (line  748)
* Moon, geocentric phase angle at Moon's astronomical noon time '%(VARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1795)
* Moon, geocentric phase angle at Moon's astronomical noon time '%)*VARGUMENT' special text: Moon data.
                                                             (line  748)
* Moon, geocentric phase angle at Moon's astronomical noon time '%)*VARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1800)
* Moon, geocentric phase angle at Moon's astronomical noon time '%)VARGUMENT' special text: Moon data.
                                                             (line  748)
* Moon, geocentric phase angle at Moon's astronomical noon time '%)VARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1795)
* Moon, geocentric phase angle at standard rise time '%(*YARGUMENT' special text: Moon data.
                                                             (line  789)
* Moon, geocentric phase angle at standard rise time '%(*YARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1841)
* Moon, geocentric phase angle at standard rise time '%(YARGUMENT' special text: Moon data.
                                                             (line  789)
* Moon, geocentric phase angle at standard rise time '%(YARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1836)
* Moon, geocentric phase angle at standard set time '%)*YARGUMENT' special text: Moon data.
                                                             (line  796)
* Moon, geocentric phase angle at standard set time '%)*YARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1850)
* Moon, geocentric phase angle at standard set time '%)YARGUMENT' special text: Moon data.
                                                             (line  796)
* Moon, geocentric phase angle at standard set time '%)YARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1845)
* Moon, geocentric right ascension '%(*sARGUMENT' special text: Moon data.
                                                             (line  421)
* Moon, geocentric right ascension '%(*sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1474)
* Moon, geocentric right ascension '%(sARGUMENT' special text: Moon data.
                                                             (line  421)
* Moon, geocentric right ascension '%(sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1469)
* Moon, geocentric right ascension '%)*sARGUMENT' special text: Moon data.
                                                             (line  421)
* Moon, geocentric right ascension '%)*sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1474)
* Moon, geocentric right ascension '%)sARGUMENT' special text: Moon data.
                                                             (line  421)
* Moon, geocentric right ascension '%)sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1469)
* Moon, geocentric semidiameter '%(*kARGUMENT' special text: Special Texts Summary.
                                                             (line 1397)
* Moon, geocentric semidiameter '%(kARGUMENT' special text: Special Texts Summary.
                                                             (line 1392)
* Moon, geocentric semidiameter '%)*kARGUMENT' special text: Special Texts Summary.
                                                             (line 1397)
* Moon, geocentric semidiameter '%)kARGUMENT' special text: Special Texts Summary.
                                                             (line 1392)
* Moon, geometric horizon:               Moon data.          (line   71)
* Moon, highest culmination point:       Moon data.          (line   58)
* Moon, Julian date '%(*yARGUMENT' special text: Moon data.  (line  465)
* Moon, Julian date '%(*yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, Julian date '%(yARGUMENT' special text: Moon data.   (line  465)
* Moon, Julian date '%(yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, Julian date '%)*yARGUMENT' special text: Moon data.  (line  465)
* Moon, Julian date '%)*yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, Julian date '%)yARGUMENT' special text: Moon data.   (line  465)
* Moon, Julian date '%)yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon, Julian Ephemeris date '%(*zARGUMENT' special text: Moon data.
                                                             (line  470)
* Moon, Julian Ephemeris date '%(*zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1530)
* Moon, Julian Ephemeris date '%(zARGUMENT' special text: Moon data.
                                                             (line  470)
* Moon, Julian Ephemeris date '%(zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1530)
* Moon, Julian Ephemeris date '%)*zARGUMENT' special text: Moon data.
                                                             (line  470)
* Moon, Julian Ephemeris date '%)*zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1530)
* Moon, Julian Ephemeris date '%)zARGUMENT' special text: Moon data.
                                                             (line  470)
* Moon, Julian Ephemeris date '%)zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1530)
* Moon, local sidereal time '%(*wARGUMENT' special text: Moon data.
                                                             (line  440)
* Moon, local sidereal time '%(*wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1508)
* Moon, local sidereal time '%(wARGUMENT' special text: Moon data.
                                                             (line  440)
* Moon, local sidereal time '%(wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1504)
* Moon, local sidereal time '%)*wARGUMENT' special text: Moon data.
                                                             (line  440)
* Moon, local sidereal time '%)*wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1508)
* Moon, local sidereal time '%)wARGUMENT' special text: Moon data.
                                                             (line  440)
* Moon, local sidereal time '%)wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1504)
* Moon, lowest culmination point:        Moon data.          (line   38)
* Moon, lunation:                        Moon data.          (line   38)
* Moon, magnitude units:                 Moon data.          (line  285)
* Moon, mathematical-geocentric horizon: Moon data.          (line   71)
* Moon, midnight height geocentric:      Moon data.          (line  727)
* Moon, midnight height topocentric:     Moon data.          (line  651)
* Moon, midnight phase angle geocentric: Moon data.          (line  734)
* Moon, midnight phase angle topocentric: Moon data.         (line  658)
* Moon, noon height geocentric:          Moon data.          (line  741)
* Moon, noon height topocentric:         Moon data.          (line  665)
* Moon, noon phase angle geocentric:     Moon data.          (line  748)
* Moon, noon phase angle topocentric:    Moon data.          (line  672)
* Moon, refraction '%(*iARGUMENT' special text: Moon data.   (line  367)
* Moon, refraction '%(*iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1378)
* Moon, refraction '%(iARGUMENT' special text: Moon data.    (line  367)
* Moon, refraction '%(iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1373)
* Moon, refraction '%)*iARGUMENT' special text: Moon data.   (line  367)
* Moon, refraction '%)*iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1378)
* Moon, refraction '%)iARGUMENT' special text: Moon data.    (line  367)
* Moon, refraction '%)iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1373)
* Moon, rise azimuth geocentric:         Moon data.          (line  769)
* Moon, rise azimuth topocentric:        Moon data.          (line  693)
* Moon, rise height geocentric:          Moon data.          (line  755)
* Moon, rise height topocentric:         Moon data.          (line  679)
* Moon, rise phase angle geocentric:     Moon data.          (line  789)
* Moon, rise phase angle topocentric:    Moon data.          (line  713)
* Moon, rise width geocentric:           Moon data.          (line  769)
* Moon, rise width topocentric:          Moon data.          (line  693)
* Moon, set azimuth geocentric:          Moon data.          (line  779)
* Moon, set azimuth topocentric:         Moon data.          (line  703)
* Moon, set height geocentric:           Moon data.          (line  762)
* Moon, set height topocentric:          Moon data.          (line  686)
* Moon, set phase angle geocentric:      Moon data.          (line  796)
* Moon, set phase angle topocentric:     Moon data.          (line  720)
* Moon, set width geocentric:            Moon data.          (line  779)
* Moon, set width topocentric:           Moon data.          (line  703)
* Moon, standard non-visibility period:  Moon data.          (line  252)
* Moon, standard rise time:              Moon data.          (line  195)
* Moon, standard set time:               Moon data.          (line  225)
* Moon, standard visibility period:      Moon data.          (line  244)
* Moon, synodic month:                   Moon data.          (line   38)
* Moon, topocentric azimuth '%(*bARGUMENT' special text: Moon data.
                                                             (line  314)
* Moon, topocentric azimuth '%(*bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1309)
* Moon, topocentric azimuth '%(bARGUMENT' special text: Moon data.
                                                             (line  314)
* Moon, topocentric azimuth '%(bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1304)
* Moon, topocentric azimuth '%)*bARGUMENT' special text: Moon data.
                                                             (line  314)
* Moon, topocentric azimuth '%)*bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1309)
* Moon, topocentric azimuth '%)bARGUMENT' special text: Moon data.
                                                             (line  314)
* Moon, topocentric azimuth '%)bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1304)
* Moon, topocentric azimuth at standard rise time '%(*QARGUMENT' special text: Moon data.
                                                             (line  693)
* Moon, topocentric azimuth at standard rise time '%(*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1734)
* Moon, topocentric azimuth at standard rise time '%(QARGUMENT' special text: Moon data.
                                                             (line  693)
* Moon, topocentric azimuth at standard rise time '%(QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1730)
* Moon, topocentric azimuth at standard set time '%)*QARGUMENT' special text: Moon data.
                                                             (line  703)
* Moon, topocentric azimuth at standard set time '%)*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1742)
* Moon, topocentric azimuth at standard set time '%)QARGUMENT' special text: Moon data.
                                                             (line  703)
* Moon, topocentric azimuth at standard set time '%)QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1738)
* Moon, topocentric brightness '%(*8ARGUMENT' special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric brightness '%(8ARGUMENT' special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric brightness '%)*8ARGUMENT' special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric brightness '%)8ARGUMENT' special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric data:                Moon data.          (line  260)
* Moon, topocentric declination '%(*cARGUMENT' special text: Moon data.
                                                             (line  318)
* Moon, topocentric declination '%(*cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1319)
* Moon, topocentric declination '%(cARGUMENT' special text: Moon data.
                                                             (line  318)
* Moon, topocentric declination '%(cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1314)
* Moon, topocentric declination '%)*cARGUMENT' special text: Moon data.
                                                             (line  318)
* Moon, topocentric declination '%)*cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1319)
* Moon, topocentric declination '%)cARGUMENT' special text: Moon data.
                                                             (line  318)
* Moon, topocentric declination '%)cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1314)
* Moon, topocentric distance '%(*gARGUMENT' special text: Moon data.
                                                             (line  355)
* Moon, topocentric distance '%(*gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1359)
* Moon, topocentric distance '%(gARGUMENT' special text: Moon data.
                                                             (line  355)
* Moon, topocentric distance '%(gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1354)
* Moon, topocentric distance '%)*gARGUMENT' special text: Moon data.
                                                             (line  355)
* Moon, topocentric distance '%)*gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1359)
* Moon, topocentric distance '%)gARGUMENT' special text: Moon data.
                                                             (line  355)
* Moon, topocentric distance '%)gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1354)
* Moon, topocentric ecliptic latitude '%(*eARGUMENT' special text: Moon data.
                                                             (line  337)
* Moon, topocentric ecliptic latitude '%(*eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1339)
* Moon, topocentric ecliptic latitude '%(eARGUMENT' special text: Moon data.
                                                             (line  337)
* Moon, topocentric ecliptic latitude '%(eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1334)
* Moon, topocentric ecliptic latitude '%)*eARGUMENT' special text: Moon data.
                                                             (line  337)
* Moon, topocentric ecliptic latitude '%)*eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1339)
* Moon, topocentric ecliptic latitude '%)eARGUMENT' special text: Moon data.
                                                             (line  337)
* Moon, topocentric ecliptic latitude '%)eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1334)
* Moon, topocentric ecliptic longitude '%(*dARGUMENT' special text: Moon data.
                                                             (line  329)
* Moon, topocentric ecliptic longitude '%(*dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1329)
* Moon, topocentric ecliptic longitude '%(dARGUMENT' special text: Moon data.
                                                             (line  329)
* Moon, topocentric ecliptic longitude '%(dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1324)
* Moon, topocentric ecliptic longitude '%)*dARGUMENT' special text: Moon data.
                                                             (line  329)
* Moon, topocentric ecliptic longitude '%)*dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1329)
* Moon, topocentric ecliptic longitude '%)dARGUMENT' special text: Moon data.
                                                             (line  329)
* Moon, topocentric ecliptic longitude '%)dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1324)
* Moon, topocentric elevation '%(*aARGUMENT' special text: Moon data.
                                                             (line  304)
* Moon, topocentric elevation '%(*aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1299)
* Moon, topocentric elevation '%(aARGUMENT' special text: Moon data.
                                                             (line  304)
* Moon, topocentric elevation '%(aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1294)
* Moon, topocentric elevation '%)*aARGUMENT' special text: Moon data.
                                                             (line  304)
* Moon, topocentric elevation '%)*aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1299)
* Moon, topocentric elevation '%)aARGUMENT' special text: Moon data.
                                                             (line  304)
* Moon, topocentric elevation '%)aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1294)
* Moon, topocentric elevation at Moon's astronomical midnight time '%(*LARGUMENT' special text: Moon data.
                                                             (line  651)
* Moon, topocentric elevation at Moon's astronomical midnight time '%(*LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1679)
* Moon, topocentric elevation at Moon's astronomical midnight time '%(LARGUMENT' special text: Moon data.
                                                             (line  651)
* Moon, topocentric elevation at Moon's astronomical midnight time '%(LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1674)
* Moon, topocentric elevation at Moon's astronomical midnight time '%)*LARGUMENT' special text: Moon data.
                                                             (line  651)
* Moon, topocentric elevation at Moon's astronomical midnight time '%)*LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1679)
* Moon, topocentric elevation at Moon's astronomical midnight time '%)LARGUMENT' special text: Moon data.
                                                             (line  651)
* Moon, topocentric elevation at Moon's astronomical midnight time '%)LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1674)
* Moon, topocentric elevation at Moon's astronomical noon time '%(*NARGUMENT' special text: Moon data.
                                                             (line  665)
* Moon, topocentric elevation at Moon's astronomical noon time '%(*NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric elevation at Moon's astronomical noon time '%(NARGUMENT' special text: Moon data.
                                                             (line  665)
* Moon, topocentric elevation at Moon's astronomical noon time '%(NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric elevation at Moon's astronomical noon time '%)*NARGUMENT' special text: Moon data.
                                                             (line  665)
* Moon, topocentric elevation at Moon's astronomical noon time '%)*NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric elevation at Moon's astronomical noon time '%)NARGUMENT' special text: Moon data.
                                                             (line  665)
* Moon, topocentric elevation at Moon's astronomical noon time '%)NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric elevation at standard rise time '%(*PARGUMENT' special text: Moon data.
                                                             (line  679)
* Moon, topocentric elevation at standard rise time '%(*PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1718)
* Moon, topocentric elevation at standard rise time '%(PARGUMENT' special text: Moon data.
                                                             (line  679)
* Moon, topocentric elevation at standard rise time '%(PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1714)
* Moon, topocentric elevation at standard set time '%)*PARGUMENT' special text: Moon data.
                                                             (line  686)
* Moon, topocentric elevation at standard set time '%)*PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1726)
* Moon, topocentric elevation at standard set time '%)PARGUMENT' special text: Moon data.
                                                             (line  686)
* Moon, topocentric elevation at standard set time '%)PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1722)
* Moon, topocentric elongation '%(*hARGUMENT' special text: Moon data.
                                                             (line  361)
* Moon, topocentric elongation '%(*hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, topocentric elongation '%(hARGUMENT' special text: Moon data.
                                                             (line  361)
* Moon, topocentric elongation '%(hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, topocentric elongation '%)*hARGUMENT' special text: Moon data.
                                                             (line  361)
* Moon, topocentric elongation '%)*hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, topocentric elongation '%)hARGUMENT' special text: Moon data.
                                                             (line  361)
* Moon, topocentric elongation '%)hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, topocentric horizontal parallax '%(*6ARGUMENT' special text: Special Texts Summary.
                                                             (line 1262)
* Moon, topocentric horizontal parallax '%(6ARGUMENT' special text: Special Texts Summary.
                                                             (line 1257)
* Moon, topocentric horizontal parallax '%)*6ARGUMENT' special text: Special Texts Summary.
                                                             (line 1262)
* Moon, topocentric horizontal parallax '%)6ARGUMENT' special text: Special Texts Summary.
                                                             (line 1257)
* Moon, topocentric phase angle '%(*9ARGUMENT' special text: Special Texts Summary.
                                                             (line 1289)
* Moon, topocentric phase angle '%(9ARGUMENT' special text: Special Texts Summary.
                                                             (line 1284)
* Moon, topocentric phase angle '%)*9ARGUMENT' special text: Special Texts Summary.
                                                             (line 1289)
* Moon, topocentric phase angle '%)9ARGUMENT' special text: Special Texts Summary.
                                                             (line 1284)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%(*MARGUMENT' special text: Moon data.
                                                             (line  658)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%(*MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1689)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%(MARGUMENT' special text: Moon data.
                                                             (line  658)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%(MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1684)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%)*MARGUMENT' special text: Moon data.
                                                             (line  658)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%)*MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1689)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%)MARGUMENT' special text: Moon data.
                                                             (line  658)
* Moon, topocentric phase angle at Moon's astronomical midnight time '%)MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1684)
* Moon, topocentric phase angle at Moon's astronomical noon time '%(*OARGUMENT' special text: Moon data.
                                                             (line  672)
* Moon, topocentric phase angle at Moon's astronomical noon time '%(*OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1710)
* Moon, topocentric phase angle at Moon's astronomical noon time '%(OARGUMENT' special text: Moon data.
                                                             (line  672)
* Moon, topocentric phase angle at Moon's astronomical noon time '%(OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1705)
* Moon, topocentric phase angle at Moon's astronomical noon time '%)*OARGUMENT' special text: Moon data.
                                                             (line  672)
* Moon, topocentric phase angle at Moon's astronomical noon time '%)*OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1710)
* Moon, topocentric phase angle at Moon's astronomical noon time '%)OARGUMENT' special text: Moon data.
                                                             (line  672)
* Moon, topocentric phase angle at Moon's astronomical noon time '%)OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1705)
* Moon, topocentric phase angle at standard rise time '%(*RARGUMENT' special text: Moon data.
                                                             (line  713)
* Moon, topocentric phase angle at standard rise time '%(*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1751)
* Moon, topocentric phase angle at standard rise time '%(RARGUMENT' special text: Moon data.
                                                             (line  713)
* Moon, topocentric phase angle at standard rise time '%(RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1746)
* Moon, topocentric phase angle at standard set time '%)*RARGUMENT' special text: Moon data.
                                                             (line  720)
* Moon, topocentric phase angle at standard set time '%)*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1760)
* Moon, topocentric phase angle at standard set time '%)RARGUMENT' special text: Moon data.
                                                             (line  720)
* Moon, topocentric phase angle at standard set time '%)RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1755)
* Moon, topocentric right ascension '%(*fARGUMENT' special text: Moon data.
                                                             (line  348)
* Moon, topocentric right ascension '%(*fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1349)
* Moon, topocentric right ascension '%(fARGUMENT' special text: Moon data.
                                                             (line  348)
* Moon, topocentric right ascension '%(fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1344)
* Moon, topocentric right ascension '%)*fARGUMENT' special text: Moon data.
                                                             (line  348)
* Moon, topocentric right ascension '%)*fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1349)
* Moon, topocentric right ascension '%)fARGUMENT' special text: Moon data.
                                                             (line  348)
* Moon, topocentric right ascension '%)fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1344)
* Moon, topocentric semidiameter '%(*7ARGUMENT' special text: Special Texts Summary.
                                                             (line 1272)
* Moon, topocentric semidiameter '%(7ARGUMENT' special text: Special Texts Summary.
                                                             (line 1267)
* Moon, topocentric semidiameter '%)*7ARGUMENT' special text: Special Texts Summary.
                                                             (line 1272)
* Moon, topocentric semidiameter '%)7ARGUMENT' special text: Special Texts Summary.
                                                             (line 1267)
* Moon/Sun, delta astronomical midnight time '%(*IARGUMENT' special text: Moon data.
                                                             (line  585)
* Moon/Sun, delta astronomical midnight time '%(*IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1643)
* Moon/Sun, delta astronomical midnight time '%(IARGUMENT' special text: Moon data.
                                                             (line  585)
* Moon/Sun, delta astronomical midnight time '%(IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1638)
* Moon/Sun, delta astronomical midnight time '%)*IARGUMENT' special text: Moon data.
                                                             (line  585)
* Moon/Sun, delta astronomical midnight time '%)*IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1643)
* Moon/Sun, delta astronomical midnight time '%)IARGUMENT' special text: Moon data.
                                                             (line  585)
* Moon/Sun, delta astronomical midnight time '%)IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1638)
* Moon/Sun, delta astronomical noon time '%(*JARGUMENT' special text: Moon data.
                                                             (line  603)
* Moon/Sun, delta astronomical noon time '%(*JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1653)
* Moon/Sun, delta astronomical noon time '%(JARGUMENT' special text: Moon data.
                                                             (line  603)
* Moon/Sun, delta astronomical noon time '%(JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1648)
* Moon/Sun, delta astronomical noon time '%)*JARGUMENT' special text: Moon data.
                                                             (line  603)
* Moon/Sun, delta astronomical noon time '%)*JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1653)
* Moon/Sun, delta astronomical noon time '%)JARGUMENT' special text: Moon data.
                                                             (line  603)
* Moon/Sun, delta astronomical noon time '%)JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1648)
* Moon/Sun, delta geocentric azimuth '%(*DARGUMENT' special text: Moon data.
                                                             (line  515)
* Moon/Sun, delta geocentric azimuth '%(*DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1569)
* Moon/Sun, delta geocentric azimuth '%(DARGUMENT' special text: Moon data.
                                                             (line  515)
* Moon/Sun, delta geocentric azimuth '%(DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1564)
* Moon/Sun, delta geocentric azimuth '%)*DARGUMENT' special text: Moon data.
                                                             (line  515)
* Moon/Sun, delta geocentric azimuth '%)*DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1569)
* Moon/Sun, delta geocentric azimuth '%)DARGUMENT' special text: Moon data.
                                                             (line  515)
* Moon/Sun, delta geocentric azimuth '%)DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1564)
* Moon/Sun, delta geocentric azimuth at standard moonrise time '%(*HARGUMENT' special text: Moon data.
                                                             (line  569)
* Moon/Sun, delta geocentric azimuth at standard moonrise time '%(*HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1625)
* Moon/Sun, delta geocentric azimuth at standard moonrise time '%(HARGUMENT' special text: Moon data.
                                                             (line  569)
* Moon/Sun, delta geocentric azimuth at standard moonrise time '%(HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1621)
* Moon/Sun, delta geocentric azimuth at standard moonset time '%)*HARGUMENT' special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta geocentric azimuth at standard moonset time '%)*HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1633)
* Moon/Sun, delta geocentric azimuth at standard moonset time '%)HARGUMENT' special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta geocentric azimuth at standard moonset time '%)HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1629)
* Moon/Sun, delta geocentric elevation '%(*CARGUMENT' special text: Moon data.
                                                             (line  509)
* Moon/Sun, delta geocentric elevation '%(*CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1559)
* Moon/Sun, delta geocentric elevation '%(CARGUMENT' special text: Moon data.
                                                             (line  509)
* Moon/Sun, delta geocentric elevation '%(CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1554)
* Moon/Sun, delta geocentric elevation '%)*CARGUMENT' special text: Moon data.
                                                             (line  509)
* Moon/Sun, delta geocentric elevation '%)*CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1559)
* Moon/Sun, delta geocentric elevation '%)CARGUMENT' special text: Moon data.
                                                             (line  509)
* Moon/Sun, delta geocentric elevation '%)CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1554)
* Moon/Sun, delta geocentric elevation at standard moonrise time '%(*GARGUMENT' special text: Moon data.
                                                             (line  553)
* Moon/Sun, delta geocentric elevation at standard moonrise time '%(*GARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1609)
* Moon/Sun, delta geocentric elevation at standard moonrise time '%(GARGUMENT' special text: Moon data.
                                                             (line  553)
* Moon/Sun, delta geocentric elevation at standard moonrise time '%(GARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1605)
* Moon/Sun, delta geocentric elevation at standard moonset time '%)*GARGUMENT' special text: Moon data.
                                                             (line  561)
* Moon/Sun, delta geocentric elevation at standard moonset time '%)*GARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1617)
* Moon/Sun, delta geocentric elevation at standard moonset time '%)GARGUMENT' special text: Moon data.
                                                             (line  561)
* Moon/Sun, delta geocentric elevation at standard moonset time '%)GARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1613)
* Moon/Sun, delta standard rise time '%(*KARGUMENT' special text: Special Texts Summary.
                                                             (line 1661)
* Moon/Sun, delta standard rise time '%(KARGUMENT' special text: Special Texts Summary.
                                                             (line 1657)
* Moon/Sun, delta standard set time '%)*KARGUMENT' special text: Special Texts Summary.
                                                             (line 1669)
* Moon/Sun, delta standard set time '%)KARGUMENT' special text: Special Texts Summary.
                                                             (line 1665)
* Moon/Sun, delta topocentric azimuth '%(*BARGUMENT' special text: Moon data.
                                                             (line  489)
* Moon/Sun, delta topocentric azimuth '%(*BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1549)
* Moon/Sun, delta topocentric azimuth '%(BARGUMENT' special text: Moon data.
                                                             (line  489)
* Moon/Sun, delta topocentric azimuth '%(BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1544)
* Moon/Sun, delta topocentric azimuth '%)*BARGUMENT' special text: Moon data.
                                                             (line  489)
* Moon/Sun, delta topocentric azimuth '%)*BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1549)
* Moon/Sun, delta topocentric azimuth '%)BARGUMENT' special text: Moon data.
                                                             (line  489)
* Moon/Sun, delta topocentric azimuth '%)BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1544)
* Moon/Sun, delta topocentric azimuth at standard moonrise time '%(*FARGUMENT' special text: Moon data.
                                                             (line  537)
* Moon/Sun, delta topocentric azimuth at standard moonrise time '%(*FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1593)
* Moon/Sun, delta topocentric azimuth at standard moonrise time '%(FARGUMENT' special text: Moon data.
                                                             (line  537)
* Moon/Sun, delta topocentric azimuth at standard moonrise time '%(FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1589)
* Moon/Sun, delta topocentric azimuth at standard moonset time '%)*FARGUMENT' special text: Moon data.
                                                             (line  545)
* Moon/Sun, delta topocentric azimuth at standard moonset time '%)*FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1601)
* Moon/Sun, delta topocentric azimuth at standard moonset time '%)FARGUMENT' special text: Moon data.
                                                             (line  545)
* Moon/Sun, delta topocentric azimuth at standard moonset time '%)FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1597)
* Moon/Sun, delta topocentric elevation '%(*AARGUMENT' special text: Moon data.
                                                             (line  475)
* Moon/Sun, delta topocentric elevation '%(*AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1539)
* Moon/Sun, delta topocentric elevation '%(AARGUMENT' special text: Moon data.
                                                             (line  475)
* Moon/Sun, delta topocentric elevation '%(AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1534)
* Moon/Sun, delta topocentric elevation '%)*AARGUMENT' special text: Moon data.
                                                             (line  475)
* Moon/Sun, delta topocentric elevation '%)*AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1539)
* Moon/Sun, delta topocentric elevation '%)AARGUMENT' special text: Moon data.
                                                             (line  475)
* Moon/Sun, delta topocentric elevation '%)AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1534)
* Moon/Sun, delta topocentric elevation at standard moonrise time '%(*EARGUMENT' special text: Moon data.
                                                             (line  521)
* Moon/Sun, delta topocentric elevation at standard moonrise time '%(*EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1577)
* Moon/Sun, delta topocentric elevation at standard moonrise time '%(EARGUMENT' special text: Moon data.
                                                             (line  521)
* Moon/Sun, delta topocentric elevation at standard moonrise time '%(EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1573)
* Moon/Sun, delta topocentric elevation at standard moonset time '%)*EARGUMENT' special text: Moon data.
                                                             (line  529)
* Moon/Sun, delta topocentric elevation at standard moonset time '%)*EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1585)
* Moon/Sun, delta topocentric elevation at standard moonset time '%)EARGUMENT' special text: Moon data.
                                                             (line  529)
* Moon/Sun, delta topocentric elevation at standard moonset time '%)EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1581)
* 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  338)
* More precise representation of geographical data: Fixed date options.
                                                             (line  338)
* Morning width:                         Glossary.           (line  485)
* Morning width geocentric, Sun:         Sun data.           (line  785)
* Morning width topocentric, Sun:        Sun data.           (line  737)
* Move leap day to 1st March:            Fixed date options. (line  875)
* Move leap day to 28th February:        Fixed date options. (line  870)
* 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   56)
* 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  489)
* Nautical twilight, Sun:                Sun data.           (line  262)
* Nautical twilight, Sun <1>:            Sun data.           (line  271)
* Negated character list:                Glossary.           (line  494)
* Negated character list, regexp:        Regexp Operators.   (line  163)
* Negated regular expression:            Fixed date options. (line  423)
* Negative day:                          Glossary.           (line  498)
* 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  503)
* Noon height geocentric, Moon:          Moon data.          (line  741)
* Noon height geocentric, Sun:           Sun data.           (line  764)
* Noon height topocentric, Moon:         Moon data.          (line  665)
* Noon height topocentric, Sun:          Sun data.           (line  716)
* Noon line:                             Glossary.           (line  507)
* Noon line, Sun:                        Sun data.           (line   38)
* Noon phase angle:                      Glossary.           (line  510)
* Noon phase angle geocentric, Moon:     Moon data.          (line  748)
* Noon phase angle topocentric, Moon:    Moon data.          (line  672)
* 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  232)
* 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  232)
* 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  211)
* 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  211)
* 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  514)
* 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  118)
* 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  304)
* Operator, '\<' regexp:                 Regexp Operators.   (line  271)
* Operator, '\>' regexp:                 Regexp Operators.   (line  275)
* Operator, '\b' regexp:                 Regexp Operators.   (line  279)
* Operator, '\B' regexp:                 Regexp Operators.   (line  284)
* Operator, '\w' regexp:                 Regexp Operators.   (line  259)
* Operator, '\W' regexp:                 Regexp Operators.   (line  266)
* Operator, '\`' regexp:                 Regexp Operators.   (line  300)
* Operator, '|' regexp:                  Regexp Operators.   (line  173)
* Operators, regexp:                     Regexp Operators.   (line    6)
* Opposition:                            Glossary.           (line  517)
* Option:                                Glossary.           (line  522)
* 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  863)
* Options, fixed date text:              Fixed date options. (line  617)
* Options, long-style:                   Options.            (line   21)
* Options, short-style:                  Options.            (line   21)
* Options, single character:             Fixed date options. (line  587)
* Options, single character <1>:         Fixed date options. (line  598)
* Orbit, Sun's:                          Sun data.           (line  388)
* Orbit, Sun's <1>:                      Moon data.          (line  329)
* Orbit, Sun's <2>:                      Moon data.          (line  337)
* 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  526)
* Other resource file:                   Fixed date options. (line  471)
* Output of base time of astronomical functions: Sun data.   (line  489)
* Output of base time of astronomical functions <1>: Moon data.
                                                             (line  455)
* Output, pipelining:                    Global options.     (line  173)
* Output, redirection:                   Global options.     (line  173)
* 'PAGER' environment variable:          Global options.     (line   48)
* 'PAGER' environment variable <1>:      Environment Variables.
                                                             (line  100)
* 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  105)
* Pattern:                               Fixed date options. (line  394)
* Pattern <1>:                           Glossary.           (line  531)
* Pattern, regular expressions:          Regular Expressions.
                                                             (line    6)
* Period of double or shorter shadow length: Sun data.       (line  866)
* Period of Gregorian Reformation, set:  Calendar options.   (line 1560)
* Period of longer than double shadow length: Sun data.      (line  872)
* Period of longer than single shadow length: Sun data.      (line  835)
* Period of single or shorter shadow length: Sun data.       (line  829)
* 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  571)
* Persian Jalaali holidays in eternal holiday list: Calendar options.
                                                             (line  125)
* Phase angle:                           Glossary.           (line  537)
* Pipelining:                            Global options.     (line   91)
* Pipelining <1>:                        Glossary.           (line  541)
* Pipelining of output:                  Global options.     (line  173)
* Positive day:                          Glossary.           (line  545)
* Positive day, biorhythm:               Biorhythm.          (line   20)
* POSIX:                                 Glossary.           (line  550)
* 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  813)
* Prayer time Asr, Islamic <2>:          Sun data.           (line  850)
* Prayer time Fajr, Islamic:             Sun data.           (line  314)
* Prayer time Isha, Islamic:             Sun data.           (line  328)
* Prayer time Maghrib, Islamic:          Sun data.           (line  200)
* Prayer time Zuhr, Islamic:             Sun data.           (line   50)
* Precedence, regexp operators:          Regexp Operators.   (line  306)
* 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 1592)
* Proleptic calendar mode <1>:           Glossary.           (line  555)
* Proleptic Gregorian calendar:          Calendar options.   (line 1599)
* Proleptic Julian calendar:             Calendar options.   (line 1604)
* 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  411)
* Protection character, '\' <4>:         Fixed date options. (line  499)
* Protection character, '\' <5>:         Fixed date options. (line  508)
* Protection character, '\' <6>:         Fixed date options. (line  543)
* Protection character, '\' <7>:         Fixed date options. (line  744)
* Protection character, '\' <8>:         Fixed date options. (line  754)
* Protection character, '\' <9>:         Fixed date options. (line  838)
* Protection character, '\' <10>:        Fixed date options. (line  848)
* Protection character, '\' <11>:        Text part of a line.
                                                             (line   51)
* Protection character, '\' <12>:        Text part of a line.
                                                             (line   92)
* 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  411)
* Protection of special characters <5>:  Fixed date options. (line  499)
* Protection of special characters <6>:  Fixed date options. (line  508)
* Protection of special characters <7>:  Fixed date options. (line  543)
* Protection of special characters <8>:  Fixed date options. (line  744)
* Protection of special characters <9>:  Fixed date options. (line  754)
* Protection of special characters <10>: Fixed date options. (line  838)
* Protection of special characters <11>: Fixed date options. (line  848)
* Protection of special characters <12>: Response file.      (line    6)
* Protection of special characters <13>: Text part of a line.
                                                             (line   51)
* Protection of special characters <14>: Text part of a line.
                                                             (line   92)
* 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  407)
* Pseudo space character, '_' <2>:       Fixed date options. (line  505)
* Pseudo space character, '_' <3>:       Fixed date options. (line  540)
* Pseudo space character, '_' <4>:       Fixed date options. (line  751)
* Pseudo space character, '_' <5>:       Fixed date options. (line  845)
* 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  391)
* 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  561)
* Redirection:                           Global options.     (line   91)
* Redirection <1>:                       Glossary.           (line  567)
* Redirection of output:                 Global options.     (line  173)
* 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  944)
* Reference systems used, Sun oriented special texts: Sun data.
                                                             (line 1204)
* References of text variables:          Structure of resource file.
                                                             (line   83)
* Refraction:                            Glossary.           (line  571)
* Refraction, atmospheric:               Fixed date options. (line  149)
* Regexp:                                Regular Expressions.
                                                             (line    6)
* Regexp <1>:                            Glossary.           (line  578)
* 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  304)
* Regexp operator, '\<':                 Regexp Operators.   (line  271)
* Regexp operator, '\>':                 Regexp Operators.   (line  275)
* Regexp operator, '\b':                 Regexp Operators.   (line  279)
* Regexp operator, '\B':                 Regexp Operators.   (line  284)
* Regexp operator, '\w':                 Regexp Operators.   (line  259)
* Regexp operator, '\W':                 Regexp Operators.   (line  266)
* Regexp operator, '\`':                 Regexp Operators.   (line  300)
* 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  306)
* Regexp, anchors:                       Regexp Operators.   (line   22)
* Regexp, buffer:                        Regexp Operators.   (line  290)
* Regexp, buffer matching operators:     Regexp Operators.   (line  299)
* Regexp, case sensitivity in matching:  Regexp Operators.   (line  311)
* 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  418)
* Regexp, ignoring case <1>:             Regexp Operators.   (line  316)
* Regexp, interval expressions:          Regexp Operators.   (line  235)
* Regexp, matching word boundaries:      Regexp Operators.   (line  279)
* 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  394)
* Regular expression <1>:                Regular Expressions.
                                                             (line    6)
* Regular expression <2>:                Glossary.           (line  578)
* 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  304)
* Regular expression operator, '\<':     Regexp Operators.   (line  271)
* Regular expression operator, '\>':     Regexp Operators.   (line  275)
* Regular expression operator, '\b':     Regexp Operators.   (line  279)
* Regular expression operator, '\B':     Regexp Operators.   (line  284)
* Regular expression operator, '\w':     Regexp Operators.   (line  259)
* Regular expression operator, '\W':     Regexp Operators.   (line  266)
* Regular expression operator, '\`':     Regexp Operators.   (line  300)
* Regular expression operator, '|':      Regexp Operators.   (line  173)
* Regular expression operators:          Regexp Operators.   (line    6)
* Regular expression operators <1>:      Glossary.           (line  469)
* Regular expression, complemented:      Fixed date options. (line  423)
* Regular expression, ignoring case distinctions: Fixed date options.
                                                             (line  418)
* Regular expression, ignoring case distinctions <1>: Regexp Operators.
                                                             (line  316)
* Regular expression, negated:           Fixed date options. (line  423)
* Regular expression, reverted:          Fixed date options. (line  423)
* 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 1859)
* Relative month number '%m' special text: Other difference values.
                                                             (line   34)
* Relative month number '%m' special text <1>: Special Texts Summary.
                                                             (line 1865)
* Relative time offset value:            Calendar options.   (line 1505)
* Relative time offset value <1>:        Calendar options.   (line 1532)
* Relative time offset value <2>:        Glossary.           (line  581)
* Relative week number '%w' special text: Other difference values.
                                                             (line   29)
* Relative week number '%w' special text <1>: Special Texts Summary.
                                                             (line 1862)
* Relative year number '%y' special text: Other difference values.
                                                             (line   39)
* Relative year number '%y' special text <1>: Special Texts Summary.
                                                             (line 1868)
* 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  584)
* 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  568)
* Resource file:                         Fixed Dates.        (line   11)
* Resource file <1>:                     Glossary.           (line  587)
* Resource file examples:                Resource file examples.
                                                             (line    6)
* Resource file line, additional:        Fixed date options. (line  516)
* 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  516)
* Resource file line, long text part:    Text part of a line.
                                                             (line   41)
* 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  471)
* 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   41)
* Resource file, include directives:     Include directives. (line    6)
* Resource file, limitations:            Global options.     (line  216)
* 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  471)
* 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  590)
* Response file, '@FILE':                Response file.      (line    6)
* Response file, creation:               Global options.     (line    8)
* Reverted regular expression:           Fixed date options. (line  423)
* RFC:                                   Glossary.           (line  564)
* RFC-822, numerical local time timezone offset value: Actual clocktime.
                                                             (line  232)
* RFC-822, numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  211)
* Right ascension:                       Glossary.           (line  595)
* Right ascension, Moon:                 Moon data.          (line  348)
* Right ascension, Sun:                  Sun data.           (line  396)
* Rise azimuth:                          Glossary.           (line  600)
* Rise azimuth geocentric, Moon:         Moon data.          (line  769)
* Rise azimuth geocentric, Sun:          Sun data.           (line  785)
* Rise azimuth topocentric, Moon:        Moon data.          (line  693)
* Rise azimuth topocentric, Sun:         Sun data.           (line  737)
* Rise height:                           Glossary.           (line  604)
* Rise height geocentric, Moon:          Moon data.          (line  755)
* Rise height geocentric, Sun:           Sun data.           (line  771)
* Rise height topocentric, Moon:         Moon data.          (line  679)
* Rise height topocentric, Sun:          Sun data.           (line  723)
* Rise phase angle:                      Glossary.           (line  608)
* Rise phase angle geocentric, Moon:     Moon data.          (line  789)
* Rise phase angle topocentric, Moon:    Moon data.          (line  713)
* Rise width:                            Glossary.           (line  485)
* Rise width geocentric, Moon:           Moon data.          (line  769)
* Rise width topocentric, Moon:          Moon data.          (line  693)
* 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  129)
* 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  186)
* 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  484)
* Separator character, ':':              Global options.     (line  107)
* Separator character, ':' <1>:          Global options.     (line  169)
* 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  612)
* Set azimuth geocentric, Moon:          Moon data.          (line  779)
* Set azimuth geocentric, Sun:           Sun data.           (line  795)
* Set azimuth topocentric, Moon:         Moon data.          (line  703)
* Set azimuth topocentric, Sun:          Sun data.           (line  747)
* Set cycle displacement value for Sun and Moon data and times: Fixed date options.
                                                             (line  288)
* Set cycle ending time value for Sun and Moon data and times: Fixed date options.
                                                             (line  222)
* Set cycle timestep value for Sun and Moon data and times: Fixed date options.
                                                             (line  288)
* Set height:                            Glossary.           (line  616)
* Set height geocentric, Moon:           Moon data.          (line  762)
* Set height geocentric, Sun:            Sun data.           (line  778)
* Set height topocentric, Moon:          Moon data.          (line  686)
* Set height topocentric, Sun:           Sun data.           (line  730)
* Set highlighting sequences:            Global options.     (line  107)
* Set marking characters:                Global options.     (line  107)
* Set phase angle:                       Glossary.           (line  620)
* Set phase angle geocentric, Moon:      Moon data.          (line  796)
* Set phase angle topocentric, Moon:     Moon data.          (line  720)
* Set shadow length factor:              Fixed date options. (line  135)
* Set starting day of week:              Calendar options.   (line 1470)
* Set width:                             Glossary.           (line  218)
* Set width geocentric, Moon:            Moon data.          (line  779)
* Set width topocentric, Moon:           Moon data.          (line  703)
* Shadow length at afternoon, double:    Sun data.           (line  850)
* Shadow length at afternoon, single:    Sun data.           (line  813)
* Shadow length at forenoon, double:     Sun data.           (line  841)
* Shadow length at forenoon, single:     Sun data.           (line  804)
* Shadow length factor, set:             Fixed date options. (line  135)
* Shell:                                 Invoking Gcal.      (line   11)
* Shell <1>:                             Command line arguments.
                                                             (line   28)
* Shell <2>:                             Fixed date options. (line  350)
* Shell <3>:                             Text variables.     (line   96)
* Shell <4>:                             Glossary.           (line  624)
* Shell command '%![ARGUMENT]' special text: Shell Command.  (line    6)
* Shell command '%![ARGUMENT]' special text <1>: Special Texts Summary.
                                                             (line 1911)
* 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  628)
* Sidereal time, Moon:                   Moon data.          (line  440)
* Sidereal time, Sun:                    Sun data.           (line  474)
* Signed angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line 1008)
* Signed decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  910)
* Signed time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  977)
* Simple decrement of date variables:    Date variables.     (line  123)
* Simple decrement of text variables:    Text variables.     (line  298)
* Simple file name:                      Resource file.      (line   87)
* Simple file name <1>:                  Glossary.           (line  631)
* Simple increment of date variables:    Date variables.     (line  122)
* Simple increment of text variables:    Text variables.     (line  297)
* Simple language code information:      Internationalization.
                                                             (line   46)
* Simple language code information <1>:  Glossary.           (line  636)
* Single character options:              Options.            (line   21)
* Single character options <1>:          Fixed date options. (line  587)
* Single character options <2>:          Fixed date options. (line  598)
* Single command:                        Glossary.           (line  642)
* Single command line word:              Options.            (line   21)
* Single command line word <1>:          Fixed date options. (line  587)
* Single command line word <2>:          Fixed date options. (line  598)
* 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  829)
* Single shadow length at afternoon:     Sun data.           (line  813)
* Single shadow length at forenoon:      Sun data.           (line  804)
* Single year mode:                      Single commands.    (line   18)
* Software license, finding:             Common options.     (line   33)
* Solar Arctic Circle:                   Sun data.           (line 1237)
* Solar Arctic Circle <1>:               Glossary.           (line  645)
* Solar day length:                      Sun data.           (line    6)
* Solar day, mean:                       Sun data.           (line  509)
* Solar day, true:                       Sun data.           (line  509)
* Solar eclipse:                         Calendar options.   (line   48)
* Solar night length:                    Sun data.           (line    6)
* Solar time, mean:                      Sun data.           (line  509)
* Solar time, true:                      Sun data.           (line  509)
* Solstice in summer:                    Glossary.           (line  667)
* Solstice in winter:                    Glossary.           (line  753)
* 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 1728)
* 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  411)
* Special characters, depreciation <5>:  Fixed date options. (line  499)
* Special characters, depreciation <6>:  Fixed date options. (line  508)
* Special characters, depreciation <7>:  Fixed date options. (line  543)
* Special characters, depreciation <8>:  Fixed date options. (line  744)
* Special characters, depreciation <9>:  Fixed date options. (line  754)
* Special characters, depreciation <10>: Fixed date options. (line  838)
* Special characters, depreciation <11>: Fixed date options. (line  848)
* Special characters, depreciation <12>: Response file.      (line    6)
* Special characters, depreciation <13>: Text part of a line.
                                                             (line   51)
* Special characters, depreciation <14>: Text part of a line.
                                                             (line   92)
* 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  411)
* Special characters, protection <5>:    Fixed date options. (line  499)
* Special characters, protection <6>:    Fixed date options. (line  508)
* Special characters, protection <7>:    Fixed date options. (line  543)
* Special characters, protection <8>:    Fixed date options. (line  744)
* Special characters, protection <9>:    Fixed date options. (line  754)
* Special characters, protection <10>:   Fixed date options. (line  838)
* Special characters, protection <11>:   Fixed date options. (line  848)
* Special characters, protection <12>:   Response file.      (line    6)
* Special characters, protection <13>:   Text part of a line.
                                                             (line   51)
* Special characters, protection <14>:   Text part of a line.
                                                             (line   92)
* 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 1423)
* Special date format in eternal holiday list: Calendar options.
                                                             (line 1441)
* Special date format in fixed date list: Calendar options.  (line 1459)
* Special event oriented texts, Moon data and times: Sun data.
                                                             (line  934)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  934)
* Special text:                          Glossary.           (line  659)
* Special text '%![ARGUMENT]', shell command: Shell Command. (line    6)
* Special text '%"[ARGUMENT]', numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  211)
* 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  232)
* 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  127)
* 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   63)
* Special text '%[FORMAT]-[ARGUMENT]', environment varibale: Contents of Environment variable.
                                                             (line    6)
* Special text '%[FORMAT].[ARGUMENT]', actual Universal time hour: Actual clocktime.
                                                             (line  161)
* Special text '%[FORMAT]/[ARGUMENT]', actual Universal time minute: Actual clocktime.
                                                             (line  177)
* Special text '%[FORMAT]?[ARGUMENT]', actual local time minute: Actual clocktime.
                                                             (line   95)
* 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   79)
* Special text '%[FORMAT]`[ARGUMENT]', actual Universal time in 'M[M...]/DATE' format: Actual clocktime.
                                                             (line  144)
* Special text '%[FORMAT]{[ARGUMENT]', actual local time 12-hour format suffix: Actual clocktime.
                                                             (line  111)
* Special text '%[FORMAT]}[ARGUMENT]', actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  194)
* 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 1429)
* Standard and special date format in eternal holiday list: Calendar options.
                                                             (line 1447)
* Standard and special date format in fixed date list: Calendar options.
                                                             (line 1465)
* Standard calendar format:              Calendar options.   (line 1286)
* Standard non-visibility period, Moon:  Moon data.          (line  252)
* Standard non-visibility period, Sun:   Sun data.           (line  228)
* Standard rise time, Moon:              Moon data.          (line  195)
* Standard rise time, Sun:               Sun data.           (line  174)
* Standard set time, Moon:               Moon data.          (line  225)
* Standard set time, Sun:                Sun data.           (line  200)
* Standard visibility period, Moon:      Moon data.          (line  244)
* Standard visibility period, Sun:       Sun data.           (line  220)
* Standard week number:                  Calendar options.   (line 1372)
* Standard week number <1>:              Fixed date options. (line  762)
* Standard week number <2>:              Fixed date options. (line  942)
* Standard week number <3>:              Fixed date options. (line  972)
* Standard week number <4>:              Fixed date options. (line 1085)
* Standard week number <5>:              Fixed date options. (line 1119)
* 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  672)
* Star day:                              Sun data.           (line  474)
* Star day <1>:                          Moon data.          (line  440)
* Star day <2>:                          Glossary.           (line  678)
* Star time:                             Sun data.           (line  474)
* Star time <1>:                         Moon data.          (line  440)
* Start of highlighting sequence 1 '%1' special text: Highlighting.
                                                             (line    9)
* Start of highlighting sequence 1 '%1' special text <1>: Special Texts Summary.
                                                             (line 1873)
* Start of highlighting sequence 1 '%5' special text: Highlighting.
                                                             (line   65)
* Start of highlighting sequence 1 '%5' special text <1>: Special Texts Summary.
                                                             (line 1885)
* 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 1901)
* Start of highlighting sequence 2 '%3' special text: Highlighting.
                                                             (line   37)
* Start of highlighting sequence 2 '%3' special text <1>: Special Texts Summary.
                                                             (line 1879)
* Start of highlighting sequence 2 '%7' special text: Highlighting.
                                                             (line   87)
* Start of highlighting sequence 2 '%7' special text <1>: Special Texts Summary.
                                                             (line 1893)
* Starting date:                         Glossary.           (line  683)
* 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 1470)
* Statute mile:                          Geographical distance and course angle.
                                                             (line   16)
* Statute mile <1>:                      Glossary.           (line  687)
* String:                                Glossary.           (line  690)
* 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  885)
* Style of representation of Moon data and times <1>: Moon data.
                                                             (line  810)
* Style of representation of Sun data and times: Sun data.   (line  885)
* Style of representation, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   16)
* Subtraction by days of date variables: Date variables.     (line  126)
* Subtraction by weekdays of date variables: Date variables. (line  128)
* 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  667)
* Summer solstice:                       Calendar options.   (line   48)
* Summer solstice <1>:                   Glossary.           (line  667)
* Summertime:                            Sun data.           (line 1074)
* Sun and Moon data and times, set cycle displacement value: Fixed date options.
                                                             (line  288)
* Sun and Moon data and times, set cycle ending time value: Fixed date options.
                                                             (line  222)
* Sun and Moon data and times, set cycle timestep value: Fixed date options.
                                                             (line  288)
* Sun and Moon oriented special texts, Clocktime value: Sun data.
                                                             (line  925)
* Sun and Moon oriented special texts, signed angular value: Sun data.
                                                             (line 1008)
* Sun and Moon oriented special texts, signed decimal based rational number value: Sun data.
                                                             (line  910)
* Sun and Moon oriented special texts, signed time value: Sun data.
                                                             (line  977)
* Sun and Moon oriented special texts, unsigned angular value: Sun data.
                                                             (line  993)
* Sun and Moon oriented special texts, unsigned decimal based rational number value: Sun data.
                                                             (line  889)
* Sun and Moon oriented special texts, unsigned time value: Sun data.
                                                             (line  961)
* 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  878)
* Sun data and times, mode characters:   Sun data.           (line   23)
* Sun data and times, special event oriented texts: Sun data.
                                                             (line  934)
* Sun data and times, style of representation: Sun data.     (line  885)
* Sun data and times, type of representation: Sun data.      (line  885)
* Sun oriented special texts, limitations: Sun data.         (line 1204)
* Sun oriented special texts, reference systems used: Sun data.
                                                             (line 1204)
* Sun oriented special texts, table of modes: Sun data.      (line   35)
* Sun oriented special texts, table of representation types: Sun data.
                                                             (line 1105)
* Sun's center, begin of amateur-astronomical '%o*8ARGUMENT' special text: Special Texts Summary.
                                                             (line  520)
* Sun's center, begin of amateur-astronomical '%o8ARGUMENT' special text: Special Texts Summary.
                                                             (line  515)
* Sun's center, begin of amateur-astronomical twilight '%o*8ARGUMENT' special text: Sun data.
                                                             (line  288)
* Sun's center, begin of amateur-astronomical twilight '%o8ARGUMENT' special text: Sun data.
                                                             (line  288)
* Sun's center, begin of astronomical twilight '%o*9ARGUMENT' special text: Sun data.
                                                             (line  314)
* 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  314)
* 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  236)
* Sun's center, begin of civil twilight '%o*6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  455)
* Sun's center, begin of civil twilight '%o6ARGUMENT' special text: Sun data.
                                                             (line  236)
* Sun's center, begin of civil twilight '%o6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  451)
* Sun's center, begin of nautical twilight '%o*7ARGUMENT' special text: Sun data.
                                                             (line  262)
* Sun's center, begin of nautical twilight '%o*7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  487)
* Sun's center, begin of nautical twilight '%o7ARGUMENT' special text: Sun data.
                                                             (line  262)
* Sun's center, begin of nautical twilight '%o7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  483)
* Sun's center, end of amateur-astronomical '%s*8ARGUMENT' special text: Special Texts Summary.
                                                             (line  530)
* Sun's center, end of amateur-astronomical '%s8ARGUMENT' special text: Special Texts Summary.
                                                             (line  525)
* Sun's center, end of amateur-astronomical twilight '%s*8ARGUMENT' special text: Sun data.
                                                             (line  297)
* Sun's center, end of amateur-astronomical twilight '%s8ARGUMENT' special text: Sun data.
                                                             (line  297)
* Sun's center, end of astronomical twilight '%s*9ARGUMENT' special text: Sun data.
                                                             (line  328)
* 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  328)
* 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  245)
* Sun's center, end of civil twilight '%s*6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  463)
* Sun's center, end of civil twilight '%s6ARGUMENT' special text: Sun data.
                                                             (line  245)
* Sun's center, end of civil twilight '%s6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  459)
* Sun's center, end of nautical twilight '%s*7ARGUMENT' special text: Sun data.
                                                             (line  271)
* Sun's center, end of nautical twilight '%s*7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  495)
* Sun's center, end of nautical twilight '%s7ARGUMENT' special text: Sun data.
                                                             (line  271)
* Sun's center, end of nautical twilight '%s7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  491)
* Sun's center, geometrical non-visibility '%z*2ARGUMENT' special text: Sun data.
                                                             (line  104)
* 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  104)
* 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   80)
* 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   80)
* 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   94)
* 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   94)
* 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   99)
* 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   99)
* 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  169)
* Sun's center, non-visibility '%z*4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  415)
* Sun's center, non-visibility '%z4ARGUMENT' special text: Sun data.
                                                             (line  169)
* Sun's center, non-visibility '%z4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  411)
* Sun's center, period above amateur-astronomical twilight reference altitude '%u*8ARGUMENT' special text: Sun data.
                                                             (line  302)
* 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  302)
* 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  337)
* 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  337)
* 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  250)
* Sun's center, period above civil twilight reference altitude '%u*6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  471)
* Sun's center, period above civil twilight reference altitude '%u6ARGUMENT' special text: Sun data.
                                                             (line  250)
* Sun's center, period above civil twilight reference altitude '%u6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  467)
* Sun's center, period above nautical twilight reference altitude '%u*7ARGUMENT' special text: Sun data.
                                                             (line  276)
* Sun's center, period above nautical twilight reference altitude '%u*7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  503)
* Sun's center, period above nautical twilight reference altitude '%u7ARGUMENT' special text: Sun data.
                                                             (line  276)
* Sun's center, period above nautical twilight reference altitude '%u7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  499)
* Sun's center, period below amateur-astronomical twilight reference altitude '%z*8ARGUMENT' special text: Sun data.
                                                             (line  308)
* 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  308)
* 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  343)
* 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  343)
* 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  256)
* Sun's center, period below civil twilight reference altitude '%z*6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  479)
* Sun's center, period below civil twilight reference altitude '%z6ARGUMENT' special text: Sun data.
                                                             (line  256)
* Sun's center, period below civil twilight reference altitude '%z6ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  475)
* Sun's center, period below nautical twilight reference altitude '%z*7ARGUMENT' special text: Sun data.
                                                             (line  282)
* Sun's center, period below nautical twilight reference altitude '%z*7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  511)
* Sun's center, period below nautical twilight reference altitude '%z7ARGUMENT' special text: Sun data.
                                                             (line  282)
* Sun's center, period below nautical twilight reference altitude '%z7ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  507)
* Sun's center, rise time '%o*4ARGUMENT' special text: Sun data.
                                                             (line  138)
* Sun's center, rise time '%o*4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  392)
* Sun's center, rise time '%o4ARGUMENT' special text: Sun data.
                                                             (line  138)
* Sun's center, rise time '%o4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  389)
* Sun's center, set time '%s*4ARGUMENT' special text: Sun data.
                                                             (line  154)
* Sun's center, set time '%s*4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  399)
* Sun's center, set time '%s4ARGUMENT' special text: Sun data.
                                                             (line  154)
* Sun's center, set time '%s4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  396)
* Sun's center, visibility '%u*4ARGUMENT' special text: Sun data.
                                                             (line  164)
* Sun's center, visibility '%u*4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  407)
* Sun's center, visibility '%u4ARGUMENT' special text: Sun data.
                                                             (line  164)
* Sun's center, visibility '%u4ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  403)
* Sun's orbit:                           Sun data.           (line  388)
* Sun's orbit <1>:                       Moon data.          (line  329)
* Sun's orbit <2>:                       Moon data.          (line  337)
* Sun's upper limb, geometrical non-visibility '%z*3ARGUMENT' special text: Sun data.
                                                             (line  133)
* Sun's upper limb, geometrical non-visibility '%z*3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  385)
* Sun's upper limb, geometrical non-visibility '%z3ARGUMENT' special text: Sun data.
                                                             (line  133)
* Sun's upper limb, geometrical non-visibility '%z3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  381)
* Sun's upper limb, geometrical rise time '%o*3ARGUMENT' special text: Sun data.
                                                             (line  109)
* Sun's upper limb, geometrical rise time '%o*3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  361)
* Sun's upper limb, geometrical rise time '%o3ARGUMENT' special text: Sun data.
                                                             (line  109)
* 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  121)
* Sun's upper limb, geometrical set time '%s*3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  369)
* Sun's upper limb, geometrical set time '%s3ARGUMENT' special text: Sun data.
                                                             (line  121)
* Sun's upper limb, geometrical set time '%s3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  365)
* Sun's upper limb, geometrical visibility '%u*3ARGUMENT' special text: Sun data.
                                                             (line  128)
* Sun's upper limb, geometrical visibility '%u*3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  377)
* Sun's upper limb, geometrical visibility '%u3ARGUMENT' special text: Sun data.
                                                             (line  128)
* Sun's upper limb, geometrical visibility '%u3ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  373)
* Sun's upper limb, standard non-visibility '%z*5ARGUMENT' special text: Sun data.
                                                             (line  228)
* Sun's upper limb, standard non-visibility '%z*5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  447)
* Sun's upper limb, standard non-visibility '%z5ARGUMENT' special text: Sun data.
                                                             (line  228)
* Sun's upper limb, standard non-visibility '%z5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  443)
* Sun's upper limb, standard rise time '%o*5ARGUMENT' special text: Sun data.
                                                             (line  174)
* Sun's upper limb, standard rise time '%o*5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  423)
* Sun's upper limb, standard rise time '%o5ARGUMENT' special text: Sun data.
                                                             (line  174)
* Sun's upper limb, standard rise time '%o5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  419)
* Sun's upper limb, standard set time '%s*5ARGUMENT' special text: Sun data.
                                                             (line  200)
* Sun's upper limb, standard set time '%s*5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  431)
* Sun's upper limb, standard set time '%s5ARGUMENT' special text: Sun data.
                                                             (line  200)
* Sun's upper limb, standard set time '%s5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  427)
* Sun's upper limb, standard visibility '%u*5ARGUMENT' special text: Sun data.
                                                             (line  220)
* Sun's upper limb, standard visibility '%u*5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  439)
* Sun's upper limb, standard visibility '%u5ARGUMENT' special text: Sun data.
                                                             (line  220)
* Sun's upper limb, standard visibility '%u5ARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  435)
* Sun, amateur-astronomical twilight:    Sun data.           (line  288)
* Sun, amateur-astronomical twilight <1>: Sun data.          (line  297)
* 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  314)
* Sun, astronomical twilight <1>:        Sun data.           (line  328)
* Sun, astronomical unit:                Sun data.           (line  403)
* Sun, azimuth:                          Sun data.           (line   38)
* Sun, base time '%o*tARGUMENT' special text: Sun data.      (line  489)
* Sun, base time '%o*tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  775)
* Sun, base time '%otARGUMENT' special text: Sun data.       (line  489)
* Sun, base time '%otARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  770)
* Sun, base time '%s*tARGUMENT' special text: Sun data.      (line  489)
* Sun, base time '%s*tARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  775)
* Sun, base time '%stARGUMENT' special text: Sun data.       (line  489)
* Sun, base time '%stARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  770)
* Sun, civil twilight:                   Sun data.           (line  236)
* Sun, civil twilight <1>:               Sun data.           (line  245)
* Sun, delta-t '%o*rARGUMENT' special text: Sun data.        (line  467)
* Sun, delta-t '%o*rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, delta-t '%orARGUMENT' special text: Sun data.         (line  467)
* Sun, delta-t '%orARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, delta-t '%s*rARGUMENT' special text: Sun data.        (line  467)
* Sun, delta-t '%s*rARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, delta-t '%srARGUMENT' special text: Sun data.         (line  467)
* Sun, delta-t '%srARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, double shadow length time at afternoon '%s*RARGUMENT' special text: Sun data.
                                                             (line  850)
* Sun, double shadow length time at afternoon '%s*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1089)
* Sun, double shadow length time at afternoon '%sRARGUMENT' special text: Sun data.
                                                             (line  850)
* Sun, double shadow length time at afternoon '%sRARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1085)
* Sun, double shadow length time at forenoon '%o*RARGUMENT' special text: Sun data.
                                                             (line  841)
* Sun, double shadow length time at forenoon '%o*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1081)
* Sun, double shadow length time at forenoon '%oRARGUMENT' special text: Sun data.
                                                             (line  841)
* Sun, double shadow length time at forenoon '%oRARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1077)
* Sun, equation of time '%o*wARGUMENT' special text: Sun data.
                                                             (line  509)
* Sun, equation of time '%o*wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  796)
* Sun, equation of time '%owARGUMENT' special text: Sun data.
                                                             (line  509)
* Sun, equation of time '%owARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  791)
* Sun, equation of time '%s*wARGUMENT' special text: Sun data.
                                                             (line  509)
* Sun, equation of time '%s*wARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  796)
* Sun, equation of time '%swARGUMENT' special text: Sun data.
                                                             (line  509)
* Sun, equation of time '%swARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  791)
* Sun, evening width geocentric:         Sun data.           (line  795)
* Sun, evening width topocentric:        Sun data.           (line  747)
* Sun, geocentric azimuth '%o*kARGUMENT' special text: Sun data.
                                                             (line  434)
* Sun, geocentric azimuth '%o*kARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  691)
* Sun, geocentric azimuth '%okARGUMENT' special text: Sun data.
                                                             (line  434)
* Sun, geocentric azimuth '%okARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  686)
* Sun, geocentric azimuth '%s*kARGUMENT' special text: Sun data.
                                                             (line  434)
* Sun, geocentric azimuth '%s*kARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  691)
* Sun, geocentric azimuth '%skARGUMENT' special text: Sun data.
                                                             (line  434)
* Sun, geocentric azimuth '%skARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  686)
* Sun, geocentric azimuth at standard rise time '%o*PARGUMENT' special text: Sun data.
                                                             (line  785)
* Sun, geocentric azimuth at standard rise time '%o*PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1032)
* Sun, geocentric azimuth at standard rise time '%oPARGUMENT' special text: Sun data.
                                                             (line  785)
* Sun, geocentric azimuth at standard rise time '%oPARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1028)
* Sun, geocentric azimuth at standard set time '%s*PARGUMENT' special text: Sun data.
                                                             (line  795)
* Sun, geocentric azimuth at standard set time '%s*PARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1040)
* Sun, geocentric azimuth at standard set time '%sPARGUMENT' special text: Sun data.
                                                             (line  795)
* Sun, geocentric azimuth at standard set time '%sPARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1036)
* Sun, geocentric data:                  Sun data.           (line  349)
* Sun, geocentric declination '%o*lARGUMENT' special text: Sun data.
                                                             (line  438)
* Sun, geocentric declination '%o*lARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  701)
* Sun, geocentric declination '%olARGUMENT' special text: Sun data.
                                                             (line  438)
* Sun, geocentric declination '%olARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  696)
* Sun, geocentric declination '%s*lARGUMENT' special text: Sun data.
                                                             (line  438)
* Sun, geocentric declination '%s*lARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  701)
* Sun, geocentric declination '%slARGUMENT' special text: Sun data.
                                                             (line  438)
* Sun, geocentric declination '%slARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  696)
* Sun, geocentric distance '%o*oARGUMENT' special text: Sun data.
                                                             (line  455)
* Sun, geocentric distance '%o*oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  731)
* Sun, geocentric distance '%ooARGUMENT' special text: Sun data.
                                                             (line  455)
* Sun, geocentric distance '%ooARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  726)
* Sun, geocentric distance '%s*oARGUMENT' special text: Sun data.
                                                             (line  455)
* Sun, geocentric distance '%s*oARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  731)
* Sun, geocentric distance '%soARGUMENT' special text: Sun data.
                                                             (line  455)
* Sun, geocentric distance '%soARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  726)
* Sun, geocentric ecliptic longitude '%o*mARGUMENT' special text: Sun data.
                                                             (line  447)
* Sun, geocentric ecliptic longitude '%o*mARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  711)
* Sun, geocentric ecliptic longitude '%omARGUMENT' special text: Sun data.
                                                             (line  447)
* Sun, geocentric ecliptic longitude '%omARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  706)
* Sun, geocentric ecliptic longitude '%s*mARGUMENT' special text: Sun data.
                                                             (line  447)
* Sun, geocentric ecliptic longitude '%s*mARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  711)
* Sun, geocentric ecliptic longitude '%smARGUMENT' special text: Sun data.
                                                             (line  447)
* Sun, geocentric ecliptic longitude '%smARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  706)
* Sun, geocentric elevation '%o*jARGUMENT' special text: Sun data.
                                                             (line  426)
* Sun, geocentric elevation '%o*jARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  681)
* Sun, geocentric elevation '%ojARGUMENT' special text: Sun data.
                                                             (line  426)
* Sun, geocentric elevation '%ojARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  676)
* Sun, geocentric elevation '%s*jARGUMENT' special text: Sun data.
                                                             (line  426)
* Sun, geocentric elevation '%s*jARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  681)
* Sun, geocentric elevation '%sjARGUMENT' special text: Sun data.
                                                             (line  426)
* 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  771)
* Sun, geocentric elevation at standard rise time '%o*OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1016)
* Sun, geocentric elevation at standard rise time '%oOARGUMENT' special text: Sun data.
                                                             (line  771)
* Sun, geocentric elevation at standard rise time '%oOARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1012)
* Sun, geocentric elevation at standard set time '%s*OARGUMENT' special text: Sun data.
                                                             (line  778)
* Sun, geocentric elevation at standard set time '%s*OARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1024)
* Sun, geocentric elevation at standard set time '%sOARGUMENT' special text: Sun data.
                                                             (line  778)
* Sun, geocentric elevation at standard set time '%sOARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1020)
* Sun, geocentric elevation at Sun's astronomical midnight time '%o*MARGUMENT' special text: Sun data.
                                                             (line  757)
* Sun, geocentric elevation at Sun's astronomical midnight time '%o*MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  998)
* Sun, geocentric elevation at Sun's astronomical midnight time '%oMARGUMENT' special text: Sun data.
                                                             (line  757)
* Sun, geocentric elevation at Sun's astronomical midnight time '%oMARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  993)
* Sun, geocentric elevation at Sun's astronomical midnight time '%s*MARGUMENT' special text: Sun data.
                                                             (line  757)
* Sun, geocentric elevation at Sun's astronomical midnight time '%s*MARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  998)
* Sun, geocentric elevation at Sun's astronomical midnight time '%sMARGUMENT' special text: Sun data.
                                                             (line  757)
* Sun, geocentric elevation at Sun's astronomical midnight time '%sMARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  993)
* Sun, geocentric elevation at Sun's astronomical noon time '%o*NARGUMENT' special text: Sun data.
                                                             (line  764)
* Sun, geocentric elevation at Sun's astronomical noon time '%o*NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1008)
* Sun, geocentric elevation at Sun's astronomical noon time '%oNARGUMENT' special text: Sun data.
                                                             (line  764)
* Sun, geocentric elevation at Sun's astronomical noon time '%oNARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1003)
* Sun, geocentric elevation at Sun's astronomical noon time '%s*NARGUMENT' special text: Sun data.
                                                             (line  764)
* Sun, geocentric elevation at Sun's astronomical noon time '%s*NARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1008)
* Sun, geocentric elevation at Sun's astronomical noon time '%sNARGUMENT' special text: Sun data.
                                                             (line  764)
* Sun, geocentric elevation at Sun's astronomical noon time '%sNARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1003)
* Sun, geocentric horizontal parallax '%o*pARGUMENT' special text: Sun data.
                                                             (line  459)
* Sun, geocentric horizontal parallax '%o*pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  740)
* Sun, geocentric horizontal parallax '%opARGUMENT' special text: Sun data.
                                                             (line  459)
* Sun, geocentric horizontal parallax '%opARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  735)
* Sun, geocentric horizontal parallax '%s*pARGUMENT' special text: Sun data.
                                                             (line  459)
* Sun, geocentric horizontal parallax '%s*pARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  740)
* Sun, geocentric horizontal parallax '%spARGUMENT' special text: Sun data.
                                                             (line  459)
* Sun, geocentric horizontal parallax '%spARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  735)
* Sun, geocentric right ascension '%o*nARGUMENT' special text: Sun data.
                                                             (line  451)
* Sun, geocentric right ascension '%o*nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  721)
* Sun, geocentric right ascension '%onARGUMENT' special text: Sun data.
                                                             (line  451)
* Sun, geocentric right ascension '%onARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  716)
* Sun, geocentric right ascension '%s*nARGUMENT' special text: Sun data.
                                                             (line  451)
* Sun, geocentric right ascension '%s*nARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  721)
* Sun, geocentric right ascension '%snARGUMENT' special text: Sun data.
                                                             (line  451)
* Sun, geocentric right ascension '%snARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  716)
* Sun, geocentric semidiameter '%o*qARGUMENT' special text: Sun data.
                                                             (line  463)
* Sun, geocentric semidiameter '%o*qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  750)
* Sun, geocentric semidiameter '%oqARGUMENT' special text: Sun data.
                                                             (line  463)
* Sun, geocentric semidiameter '%oqARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  745)
* Sun, geocentric semidiameter '%s*qARGUMENT' special text: Sun data.
                                                             (line  463)
* Sun, geocentric semidiameter '%s*qARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  750)
* Sun, geocentric semidiameter '%sqARGUMENT' special text: Sun data.
                                                             (line  463)
* Sun, geocentric semidiameter '%sqARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  745)
* Sun, highest culmination point:        Sun data.           (line   50)
* Sun, Julian date '%o*uARGUMENT' special text: Sun data.    (line  499)
* Sun, Julian date '%o*uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  781)
* Sun, Julian date '%ouARGUMENT' special text: Sun data.     (line  499)
* Sun, Julian date '%ouARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  781)
* Sun, Julian date '%s*uARGUMENT' special text: Sun data.    (line  499)
* Sun, Julian date '%s*uARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  781)
* Sun, Julian date '%suARGUMENT' special text: Sun data.     (line  499)
* Sun, Julian date '%suARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  781)
* Sun, Julian Ephemeris date '%o*vARGUMENT' special text: Sun data.
                                                             (line  504)
* Sun, Julian Ephemeris date '%o*vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  787)
* Sun, Julian Ephemeris date '%ovARGUMENT' special text: Sun data.
                                                             (line  504)
* Sun, Julian Ephemeris date '%ovARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  787)
* Sun, Julian Ephemeris date '%s*vARGUMENT' special text: Sun data.
                                                             (line  504)
* Sun, Julian Ephemeris date '%s*vARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  787)
* Sun, Julian Ephemeris date '%svARGUMENT' special text: Sun data.
                                                             (line  504)
* Sun, Julian Ephemeris date '%svARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  787)
* Sun, local sidereal time '%o*sARGUMENT' special text: Sun data.
                                                             (line  474)
* Sun, local sidereal time '%o*sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  765)
* Sun, local sidereal time '%osARGUMENT' special text: Sun data.
                                                             (line  474)
* Sun, local sidereal time '%osARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  761)
* Sun, local sidereal time '%s*sARGUMENT' special text: Sun data.
                                                             (line  474)
* Sun, local sidereal time '%s*sARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  765)
* Sun, local sidereal time '%ssARGUMENT' special text: Sun data.
                                                             (line  474)
* Sun, local sidereal time '%ssARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  761)
* Sun, lowest culmination point:         Sun data.           (line   38)
* Sun, mean:                             Sun data.           (line  509)
* Sun, midnight height geocentric:       Sun data.           (line  757)
* Sun, midnight height topocentric:      Sun data.           (line  709)
* Sun, morning width geocentric:         Sun data.           (line  785)
* Sun, morning width topocentric:        Sun data.           (line  737)
* Sun, nautical twilight:                Sun data.           (line  262)
* Sun, nautical twilight <1>:            Sun data.           (line  271)
* Sun, noon height geocentric:           Sun data.           (line  764)
* Sun, noon height topocentric:          Sun data.           (line  716)
* Sun, noon line:                        Sun data.           (line   38)
* Sun, period of double or shorter shadow length '%u*RARGUMENT' special text: Sun data.
                                                             (line  866)
* Sun, period of double or shorter shadow length '%u*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1097)
* Sun, period of double or shorter shadow length '%uRARGUMENT' special text: Sun data.
                                                             (line  866)
* Sun, period of double or shorter shadow length '%uRARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1093)
* Sun, period of longer than double shadow length '%z*RARGUMENT' special text: Sun data.
                                                             (line  872)
* Sun, period of longer than double shadow length '%z*RARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1105)
* Sun, period of longer than double shadow length '%zRARGUMENT' special text: Sun data.
                                                             (line  872)
* Sun, period of longer than double shadow length '%zRARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1101)
* Sun, period of longer than single shadow length '%z*QARGUMENT' special text: Sun data.
                                                             (line  835)
* Sun, period of longer than single shadow length '%z*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1072)
* Sun, period of longer than single shadow length '%zQARGUMENT' special text: Sun data.
                                                             (line  835)
* Sun, period of longer than single shadow length '%zQARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1068)
* Sun, period of single or shorter shadow length '%u*QARGUMENT' special text: Sun data.
                                                             (line  829)
* Sun, period of single or shorter shadow length '%u*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1064)
* Sun, period of single or shorter shadow length '%uQARGUMENT' special text: Sun data.
                                                             (line  829)
* Sun, period of single or shorter shadow length '%uQARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1060)
* Sun, refraction '%o*iARGUMENT' special text: Sun data.     (line  422)
* Sun, refraction '%o*iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  672)
* Sun, refraction '%oiARGUMENT' special text: Sun data.      (line  422)
* Sun, refraction '%oiARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  667)
* Sun, refraction '%s*iARGUMENT' special text: Sun data.     (line  422)
* Sun, refraction '%s*iARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  672)
* Sun, refraction '%siARGUMENT' special text: Sun data.      (line  422)
* Sun, refraction '%siARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  667)
* Sun, rise azimuth geocentric:          Sun data.           (line  785)
* Sun, rise azimuth topocentric:         Sun data.           (line  737)
* Sun, rise height geocentric:           Sun data.           (line  771)
* Sun, rise height topocentric:          Sun data.           (line  723)
* Sun, set azimuth geocentric:           Sun data.           (line  795)
* Sun, set azimuth topocentric:          Sun data.           (line  747)
* Sun, set height geocentric:            Sun data.           (line  778)
* Sun, set height topocentric:           Sun data.           (line  730)
* Sun, single shadow length time at afternoon '%s*QARGUMENT' special text: Sun data.
                                                             (line  813)
* Sun, single shadow length time at afternoon '%s*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1056)
* Sun, single shadow length time at afternoon '%sQARGUMENT' special text: Sun data.
                                                             (line  813)
* Sun, single shadow length time at afternoon '%sQARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1052)
* Sun, single shadow length time at forenoon '%o*QARGUMENT' special text: Sun data.
                                                             (line  804)
* Sun, single shadow length time at forenoon '%o*QARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1048)
* Sun, single shadow length time at forenoon '%oQARGUMENT' special text: Sun data.
                                                             (line  804)
* Sun, single shadow length time at forenoon '%oQARGUMENT' special text <1>: Special Texts Summary.
                                                             (line 1044)
* Sun, standard non-visibility period:   Sun data.           (line  228)
* Sun, standard rise time:               Sun data.           (line  174)
* Sun, standard set time:                Sun data.           (line  200)
* Sun, standard visibility period:       Sun data.           (line  220)
* Sun, topocentric azimuth '%o*bARGUMENT' special text: Sun data.
                                                             (line  373)
* Sun, topocentric azimuth '%o*bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  603)
* Sun, topocentric azimuth '%obARGUMENT' special text: Sun data.
                                                             (line  373)
* Sun, topocentric azimuth '%obARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  598)
* Sun, topocentric azimuth '%s*bARGUMENT' special text: Sun data.
                                                             (line  373)
* Sun, topocentric azimuth '%s*bARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  603)
* Sun, topocentric azimuth '%sbARGUMENT' special text: Sun data.
                                                             (line  373)
* 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  737)
* Sun, topocentric azimuth at standard rise time '%o*LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  980)
* Sun, topocentric azimuth at standard rise time '%oLARGUMENT' special text: Sun data.
                                                             (line  737)
* Sun, topocentric azimuth at standard rise time '%oLARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  976)
* Sun, topocentric azimuth at standard set time '%s*LARGUMENT' special text: Sun data.
                                                             (line  747)
* Sun, topocentric azimuth at standard set time '%s*LARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  988)
* Sun, topocentric azimuth at standard set time '%sLARGUMENT' special text: Sun data.
                                                             (line  747)
* Sun, topocentric azimuth at standard set time '%sLARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  984)
* Sun, topocentric data:                 Sun data.           (line  349)
* Sun, topocentric declination '%o*cARGUMENT' special text: Sun data.
                                                             (line  377)
* Sun, topocentric declination '%o*cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  613)
* Sun, topocentric declination '%ocARGUMENT' special text: Sun data.
                                                             (line  377)
* Sun, topocentric declination '%ocARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  608)
* Sun, topocentric declination '%s*cARGUMENT' special text: Sun data.
                                                             (line  377)
* Sun, topocentric declination '%s*cARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  613)
* Sun, topocentric declination '%scARGUMENT' special text: Sun data.
                                                             (line  377)
* Sun, topocentric declination '%scARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  608)
* Sun, topocentric distance '%o*fARGUMENT' special text: Sun data.
                                                             (line  403)
* Sun, topocentric distance '%o*fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  643)
* Sun, topocentric distance '%ofARGUMENT' special text: Sun data.
                                                             (line  403)
* Sun, topocentric distance '%ofARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  638)
* Sun, topocentric distance '%s*fARGUMENT' special text: Sun data.
                                                             (line  403)
* Sun, topocentric distance '%s*fARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  643)
* Sun, topocentric distance '%sfARGUMENT' special text: Sun data.
                                                             (line  403)
* Sun, topocentric distance '%sfARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  638)
* Sun, topocentric ecliptic longitude '%o*dARGUMENT' special text: Sun data.
                                                             (line  388)
* Sun, topocentric ecliptic longitude '%o*dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  623)
* Sun, topocentric ecliptic longitude '%odARGUMENT' special text: Sun data.
                                                             (line  388)
* Sun, topocentric ecliptic longitude '%odARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  618)
* Sun, topocentric ecliptic longitude '%s*dARGUMENT' special text: Sun data.
                                                             (line  388)
* Sun, topocentric ecliptic longitude '%s*dARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  623)
* Sun, topocentric ecliptic longitude '%sdARGUMENT' special text: Sun data.
                                                             (line  388)
* Sun, topocentric ecliptic longitude '%sdARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  618)
* Sun, topocentric elevation '%o*aARGUMENT' special text: Sun data.
                                                             (line  349)
* Sun, topocentric elevation '%o*aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  593)
* Sun, topocentric elevation '%oaARGUMENT' special text: Sun data.
                                                             (line  349)
* Sun, topocentric elevation '%oaARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  588)
* Sun, topocentric elevation '%s*aARGUMENT' special text: Sun data.
                                                             (line  349)
* Sun, topocentric elevation '%s*aARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  593)
* Sun, topocentric elevation '%saARGUMENT' special text: Sun data.
                                                             (line  349)
* 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  723)
* Sun, topocentric elevation at standard rise time '%o*KARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  964)
* Sun, topocentric elevation at standard rise time '%oKARGUMENT' special text: Sun data.
                                                             (line  723)
* Sun, topocentric elevation at standard rise time '%oKARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  960)
* Sun, topocentric elevation at standard set time '%s*KARGUMENT' special text: Sun data.
                                                             (line  730)
* Sun, topocentric elevation at standard set time '%s*KARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  972)
* Sun, topocentric elevation at standard set time '%sKARGUMENT' special text: Sun data.
                                                             (line  730)
* Sun, topocentric elevation at standard set time '%sKARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  968)
* Sun, topocentric elevation at Sun's astronomical midnight time '%o*IARGUMENT' special text: Sun data.
                                                             (line  709)
* Sun, topocentric elevation at Sun's astronomical midnight time '%o*IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  946)
* Sun, topocentric elevation at Sun's astronomical midnight time '%oIARGUMENT' special text: Sun data.
                                                             (line  709)
* Sun, topocentric elevation at Sun's astronomical midnight time '%oIARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  941)
* Sun, topocentric elevation at Sun's astronomical midnight time '%s*IARGUMENT' special text: Sun data.
                                                             (line  709)
* Sun, topocentric elevation at Sun's astronomical midnight time '%s*IARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  946)
* Sun, topocentric elevation at Sun's astronomical midnight time '%sIARGUMENT' special text: Sun data.
                                                             (line  709)
* Sun, topocentric elevation at Sun's astronomical midnight time '%sIARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  941)
* Sun, topocentric elevation at Sun's astronomical noon time '%o*JARGUMENT' special text: Sun data.
                                                             (line  716)
* Sun, topocentric elevation at Sun's astronomical noon time '%o*JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  956)
* Sun, topocentric elevation at Sun's astronomical noon time '%oJARGUMENT' special text: Sun data.
                                                             (line  716)
* Sun, topocentric elevation at Sun's astronomical noon time '%oJARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  951)
* Sun, topocentric elevation at Sun's astronomical noon time '%s*JARGUMENT' special text: Sun data.
                                                             (line  716)
* Sun, topocentric elevation at Sun's astronomical noon time '%s*JARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  956)
* Sun, topocentric elevation at Sun's astronomical noon time '%sJARGUMENT' special text: Sun data.
                                                             (line  716)
* Sun, topocentric elevation at Sun's astronomical noon time '%sJARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  951)
* Sun, topocentric horizontal parallax '%o*gARGUMENT' special text: Sun data.
                                                             (line  411)
* Sun, topocentric horizontal parallax '%o*gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  652)
* Sun, topocentric horizontal parallax '%ogARGUMENT' special text: Sun data.
                                                             (line  411)
* Sun, topocentric horizontal parallax '%ogARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  647)
* Sun, topocentric horizontal parallax '%s*gARGUMENT' special text: Sun data.
                                                             (line  411)
* Sun, topocentric horizontal parallax '%s*gARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  652)
* Sun, topocentric horizontal parallax '%sgARGUMENT' special text: Sun data.
                                                             (line  411)
* Sun, topocentric horizontal parallax '%sgARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  647)
* Sun, topocentric right ascension '%o*eARGUMENT' special text: Sun data.
                                                             (line  396)
* Sun, topocentric right ascension '%o*eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  633)
* Sun, topocentric right ascension '%oeARGUMENT' special text: Sun data.
                                                             (line  396)
* Sun, topocentric right ascension '%oeARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  628)
* Sun, topocentric right ascension '%s*eARGUMENT' special text: Sun data.
                                                             (line  396)
* Sun, topocentric right ascension '%s*eARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  633)
* Sun, topocentric right ascension '%seARGUMENT' special text: Sun data.
                                                             (line  396)
* Sun, topocentric right ascension '%seARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  628)
* Sun, topocentric semidiameter '%o*hARGUMENT' special text: Sun data.
                                                             (line  418)
* Sun, topocentric semidiameter '%o*hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  662)
* Sun, topocentric semidiameter '%ohARGUMENT' special text: Sun data.
                                                             (line  418)
* Sun, topocentric semidiameter '%ohARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  657)
* Sun, topocentric semidiameter '%s*hARGUMENT' special text: Sun data.
                                                             (line  418)
* Sun, topocentric semidiameter '%s*hARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  662)
* Sun, topocentric semidiameter '%shARGUMENT' special text: Sun data.
                                                             (line  418)
* 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  643)
* Sun/Moon, delta astronomical midnight time '%o*FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  910)
* Sun/Moon, delta astronomical midnight time '%oFARGUMENT' special text: Sun data.
                                                             (line  643)
* Sun/Moon, delta astronomical midnight time '%oFARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  905)
* Sun/Moon, delta astronomical midnight time '%s*FARGUMENT' special text: Sun data.
                                                             (line  643)
* Sun/Moon, delta astronomical midnight time '%s*FARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  910)
* Sun/Moon, delta astronomical midnight time '%sFARGUMENT' special text: Sun data.
                                                             (line  643)
* Sun/Moon, delta astronomical midnight time '%sFARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  905)
* 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  920)
* 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  915)
* 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  920)
* 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  915)
* Sun/Moon, delta geocentric azimuth '%o*AARGUMENT' special text: Sun data.
                                                             (line  573)
* Sun/Moon, delta geocentric azimuth '%o*AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  836)
* Sun/Moon, delta geocentric azimuth '%oAARGUMENT' special text: Sun data.
                                                             (line  573)
* Sun/Moon, delta geocentric azimuth '%oAARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  831)
* Sun/Moon, delta geocentric azimuth '%s*AARGUMENT' special text: Sun data.
                                                             (line  573)
* Sun/Moon, delta geocentric azimuth '%s*AARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  836)
* Sun/Moon, delta geocentric azimuth '%sAARGUMENT' special text: Sun data.
                                                             (line  573)
* Sun/Moon, delta geocentric azimuth '%sAARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  831)
* Sun/Moon, delta geocentric azimuth at standard sunrise time '%o*EARGUMENT' special text: Sun data.
                                                             (line  627)
* Sun/Moon, delta geocentric azimuth at standard sunrise time '%o*EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  892)
* Sun/Moon, delta geocentric azimuth at standard sunrise time '%oEARGUMENT' special text: Sun data.
                                                             (line  627)
* Sun/Moon, delta geocentric azimuth at standard sunrise time '%oEARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  888)
* Sun/Moon, delta geocentric azimuth at standard sunset time '%s*EARGUMENT' special text: Sun data.
                                                             (line  635)
* Sun/Moon, delta geocentric azimuth at standard sunset time '%s*EARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  900)
* Sun/Moon, delta geocentric azimuth at standard sunset time '%sEARGUMENT' special text: Sun data.
                                                             (line  635)
* Sun/Moon, delta geocentric azimuth at standard sunset time '%sEARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  896)
* Sun/Moon, delta geocentric elevation '%o*zARGUMENT' special text: Sun data.
                                                             (line  567)
* Sun/Moon, delta geocentric elevation '%o*zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  826)
* Sun/Moon, delta geocentric elevation '%ozARGUMENT' special text: Sun data.
                                                             (line  567)
* Sun/Moon, delta geocentric elevation '%ozARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  821)
* Sun/Moon, delta geocentric elevation '%s*zARGUMENT' special text: Sun data.
                                                             (line  567)
* Sun/Moon, delta geocentric elevation '%s*zARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  826)
* Sun/Moon, delta geocentric elevation '%szARGUMENT' special text: Sun data.
                                                             (line  567)
* Sun/Moon, delta geocentric elevation '%szARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  821)
* Sun/Moon, delta geocentric elevation at standard sunrise time '%o*DARGUMENT' special text: Sun data.
                                                             (line  611)
* Sun/Moon, delta geocentric elevation at standard sunrise time '%o*DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  876)
* Sun/Moon, delta geocentric elevation at standard sunrise time '%oDARGUMENT' special text: Sun data.
                                                             (line  611)
* Sun/Moon, delta geocentric elevation at standard sunrise time '%oDARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  872)
* Sun/Moon, delta geocentric elevation at standard sunset time '%s*DARGUMENT' special text: Sun data.
                                                             (line  619)
* Sun/Moon, delta geocentric elevation at standard sunset time '%s*DARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  884)
* Sun/Moon, delta geocentric elevation at standard sunset time '%sDARGUMENT' special text: Sun data.
                                                             (line  619)
* Sun/Moon, delta geocentric elevation at standard sunset time '%sDARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  880)
* Sun/Moon, delta standard rise time '%(*KARGUMENT' special text: Moon data.
                                                             (line  619)
* Sun/Moon, delta standard rise time '%(KARGUMENT' special text: Moon data.
                                                             (line  619)
* Sun/Moon, delta standard rise time '%o*HARGUMENT' special text: Sun data.
                                                             (line  677)
* Sun/Moon, delta standard rise time '%o*HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  928)
* Sun/Moon, delta standard rise time '%oHARGUMENT' special text: Sun data.
                                                             (line  677)
* Sun/Moon, delta standard rise time '%oHARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  924)
* Sun/Moon, delta standard set time '%)*KARGUMENT' special text: Moon data.
                                                             (line  635)
* Sun/Moon, delta standard set time '%)KARGUMENT' special text: Moon data.
                                                             (line  635)
* Sun/Moon, delta standard set time '%s*HARGUMENT' special text: Sun data.
                                                             (line  693)
* Sun/Moon, delta standard set time '%s*HARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  936)
* Sun/Moon, delta standard set time '%sHARGUMENT' special text: Sun data.
                                                             (line  693)
* Sun/Moon, delta standard set time '%sHARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  932)
* Sun/Moon, delta topocentric azimuth '%o*yARGUMENT' special text: Sun data.
                                                             (line  547)
* Sun/Moon, delta topocentric azimuth '%o*yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  816)
* Sun/Moon, delta topocentric azimuth '%oyARGUMENT' special text: Sun data.
                                                             (line  547)
* Sun/Moon, delta topocentric azimuth '%oyARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  811)
* Sun/Moon, delta topocentric azimuth '%s*yARGUMENT' special text: Sun data.
                                                             (line  547)
* Sun/Moon, delta topocentric azimuth '%s*yARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  816)
* Sun/Moon, delta topocentric azimuth '%syARGUMENT' special text: Sun data.
                                                             (line  547)
* Sun/Moon, delta topocentric azimuth '%syARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  811)
* Sun/Moon, delta topocentric azimuth at standard sunrise time '%o*CARGUMENT' special text: Sun data.
                                                             (line  595)
* Sun/Moon, delta topocentric azimuth at standard sunrise time '%o*CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  860)
* Sun/Moon, delta topocentric azimuth at standard sunrise time '%oCARGUMENT' special text: Sun data.
                                                             (line  595)
* Sun/Moon, delta topocentric azimuth at standard sunrise time '%oCARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  856)
* Sun/Moon, delta topocentric azimuth at standard sunset time '%s*CARGUMENT' special text: Sun data.
                                                             (line  603)
* Sun/Moon, delta topocentric azimuth at standard sunset time '%s*CARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  868)
* Sun/Moon, delta topocentric azimuth at standard sunset time '%sCARGUMENT' special text: Sun data.
                                                             (line  603)
* Sun/Moon, delta topocentric azimuth at standard sunset time '%sCARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  864)
* Sun/Moon, delta topocentric elevation '%o*xARGUMENT' special text: Sun data.
                                                             (line  533)
* Sun/Moon, delta topocentric elevation '%o*xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  806)
* Sun/Moon, delta topocentric elevation '%oxARGUMENT' special text: Sun data.
                                                             (line  533)
* Sun/Moon, delta topocentric elevation '%oxARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  801)
* Sun/Moon, delta topocentric elevation '%s*xARGUMENT' special text: Sun data.
                                                             (line  533)
* Sun/Moon, delta topocentric elevation '%s*xARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  806)
* Sun/Moon, delta topocentric elevation '%sxARGUMENT' special text: Sun data.
                                                             (line  533)
* Sun/Moon, delta topocentric elevation '%sxARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  801)
* Sun/Moon, delta topocentric elevation at standard sunrise time '%o*BARGUMENT' special text: Sun data.
                                                             (line  579)
* Sun/Moon, delta topocentric elevation at standard sunrise time '%o*BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  844)
* Sun/Moon, delta topocentric elevation at standard sunrise time '%oBARGUMENT' special text: Sun data.
                                                             (line  579)
* Sun/Moon, delta topocentric elevation at standard sunrise time '%oBARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  840)
* Sun/Moon, delta topocentric elevation at standard sunset time '%s*BARGUMENT' special text: Sun data.
                                                             (line  587)
* Sun/Moon, delta topocentric elevation at standard sunset time '%s*BARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  852)
* Sun/Moon, delta topocentric elevation at standard sunset time '%sBARGUMENT' special text: Sun data.
                                                             (line  587)
* Sun/Moon, delta topocentric elevation at standard sunset time '%sBARGUMENT' special text <1>: Special Texts Summary.
                                                             (line  848)
* Sundial:                               Sun data.           (line  509)
* Sunrise:                               Sun data.           (line    6)
* Sunrise and sunset, limit to actual day: Fixed date options.
                                                             (line  170)
* 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  782)
* Suppress title text of eternal holiday list: Calendar options.
                                                             (line   45)
* Suppress title text of fixed date list: Fixed date options.
                                                             (line  812)
* Switch character:                      Glossary.           (line  693)
* 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  424)
* 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  838)
* Table of representation types of the Sun oriented special texts: Sun data.
                                                             (line 1105)
* 'tcal', options:                       Invoking tcal.      (line    6)
* 'tcal', utility:                       Invoking tcal.      (line    6)
* Temperature of Earth's atmosphere, set: Fixed date options.
                                                             (line  149)
* 'TERM' environment variable:           Environment Variables.
                                                             (line  110)
* Terrestrial Dynamical time (TDT):      Sun data.           (line  467)
* Terrestrial Dynamical time (TDT) <1>:  Moon data.          (line  433)
* Territory code:                        Calendar options.   (line  150)
* Territory code <1>:                    Internationalization.
                                                             (line  122)
* Text part:                             Glossary.           (line  699)
* 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 1505)
* 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 1074)
* Timezone <1>:                          Moon data.          (line  818)
* Today's fixed dates:                   Fixed date options. (line  431)
* Tomorrows' fixed dates:                Fixed date options. (line 1333)
* Topocentric data:                      Glossary.           (line  703)
* Topocentric data, Moon:                Moon data.          (line  260)
* Topocentric data, Sun:                 Sun data.           (line  349)
* Total number of date variables:        Date variables.     (line    6)
* Total number of text variables:        Text variables.     (line    6)
* True solar day:                        Sun data.           (line  509)
* True solar day <1>:                    Glossary.           (line  708)
* True solar time:                       Sun data.           (line  509)
* True solar time <1>:                   Glossary.           (line  708)
* True track:                            Glossary.           (line  715)
* Twilight:                              Glossary.           (line  728)
* Twilight, amateur-astronomical:        Sun data.           (line  288)
* Twilight, amateur-astronomical <1>:    Sun data.           (line  297)
* Twilight, astronomical:                Sun data.           (line  314)
* Twilight, astronomical <1>:            Sun data.           (line  328)
* Twilight, civil:                       Sun data.           (line  236)
* Twilight, civil <1>:                   Sun data.           (line  245)
* Twilight, nautical:                    Sun data.           (line  262)
* Twilight, nautical <1>:                Sun data.           (line  271)
* '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  113)
* Type of representation of Moon data and times: Sun data.   (line  885)
* Type of representation of Moon data and times <1>: Moon data.
                                                             (line  810)
* Type of representation of Sun data and times: Sun data.    (line  885)
* 'TZ' environment variable:             Environment Variables.
                                                             (line  123)
* Unit, Earth equator radius:            Moon data.          (line  355)
* 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  127)
* Universal time (UTC) <4>:              Actual clocktime.   (line  144)
* Universal time (UTC) <5>:              Actual clocktime.   (line  161)
* Universal time (UTC) <6>:              Actual clocktime.   (line  177)
* Universal time (UTC) <7>:              Actual clocktime.   (line  194)
* Universal time (UTC) <8>:              Actual clocktime.   (line  211)
* Universal time (UTC) <9>:              Julian day number.  (line    6)
* Universal time (UTC) <10>:             Sun data.           (line  489)
* Universal time (UTC) <11>:             Sun data.           (line 1074)
* Universal time (UTC) <12>:             Moon data.          (line  455)
* Universal time 12-hour format suffix, display: Actual clocktime.
                                                             (line  194)
* Universal time hour, display:          Actual clocktime.   (line  161)
* Universal time in 'HH:MM/DATE' format, display: Actual clocktime.
                                                             (line  127)
* Universal time in 'M[M...]/DATE' format, display: Actual clocktime.
                                                             (line  144)
* Universal time minute, display:        Actual clocktime.   (line  177)
* Unix:                                  Glossary.           (line  734)
* Unsigned angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line  993)
* Unsigned decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  889)
* Unsigned time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  961)
* Use Eastern Orthodox churches' leap year rule: Calendar options.
                                                             (line 1320)
* 'USER' environment variable:           Global options.     (line  199)
* 'USER' environment variable <1>:       Environment Variables.
                                                             (line  127)
* 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  388)
* Vernal equinox point on the ecliptic <1>: Sun data.        (line  396)
* Vernal equinox point on the ecliptic <2>: Sun data.        (line  474)
* Vernal equinox point on the ecliptic <3>: Moon data.       (line  329)
* Vernal equinox point on the ecliptic <4>: Moon data.       (line  348)
* Vernal equinox point on the ecliptic <5>: Moon data.       (line  440)
* Vernal equinox point on the ecliptic <6>: Glossary.        (line  744)
* Version number, finding:               Common options.     (line   37)
* Visibility of date variables:          Date variables.     (line   56)
* Visibility of local date variables:    Fixed date options. (line   28)
* Visibility of local date variables <1>: Date variables.    (line  105)
* 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  762)
* Week number, ISO-8601:1988 <2>:        Fixed date options. (line  942)
* Week number, ISO-8601:1988 <3>:        Fixed date options. (line  972)
* Week number, ISO-8601:1988 <4>:        Fixed date options. (line 1085)
* Week number, ISO-8601:1988 <5>:        Fixed date options. (line 1119)
* 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  762)
* Week number, standard <2>:             Fixed date options. (line  942)
* Week number, standard <3>:             Fixed date options. (line  972)
* Week number, standard <4>:             Fixed date options. (line 1085)
* Week number, standard <5>:             Fixed date options. (line 1119)
* 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 1345)
* Whitespace character:                  Text part of a line.
                                                             (line   92)
* Whitespace character <1>:              Comment line.       (line    6)
* Whitespace character <2>:              Error Codes.        (line    6)
* Whitespace character <3>:              Glossary.           (line  748)
* 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  753)
* Winter solstice:                       Calendar options.   (line   48)
* Winter solstice <1>:                   Glossary.           (line  753)
* Wintertime:                            Sun data.           (line 1074)
* Word:                                  Glossary.           (line  758)
* Word boundaries, matching in regexp:   Regexp Operators.   (line  279)
* 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 1420)
* Zodiacal line:                         Sun data.           (line  388)
* Zodiacal line <1>:                     Moon data.          (line  329)
* Zodiacal line <2>:                     Moon data.          (line  337)
* Zodiacal marker holidays in eternal holiday list: Calendar options.
                                                             (line  132)
* Zuhr prayer time:                      Glossary.           (line  762)
* 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-day72762
Ref: x-time-offset73417
Ref: x-date-format80049
Ref: x-translate-string83872
Node: Calendar options-Footnotes85589
Ref: Calendar options-Footnote-185666
Ref: Calendar options-Footnote-285751
Ref: Calendar options-Footnote-385790
Ref: Calendar options-Footnote-485860
Ref: Calendar options-Footnote-586058
Node: Fixed date options86160
Ref: x-date-variable86341
Ref: x-text-variable87430
Ref: x-adjust-value91992
Ref: x-atmosphere93200
Ref: x-limit94281
Ref: x-cycle-end96879
Ref: x-cycle-step100065
Ref: x-precise102553
Ref: x-execute-command103189
Ref: x-filter-text105345
Ref: x-ignore-case106519
Ref: x-list-of-fixed-dates107046
Ref: x-resource-file108883
Ref: x-biorhythm-axis115715
Ref: x-moonimage-lines117012
Ref: x-list-mode125658
Ref: x-period-of-fixed-dates125945
Node: Fixed date options-Footnotes150162
Ref: Fixed date options-Footnote-1150243
Ref: Fixed date options-Footnote-2150510
Ref: Fixed date options-Footnote-3150669
Ref: Fixed date options-Footnote-4150921
Ref: Fixed date options-Footnote-5151043
Ref: Fixed date options-Footnote-6151221
Ref: Fixed date options-Footnote-7151397
Ref: Fixed date options-Footnote-8151454
Ref: Fixed date options-Footnote-9151526
Ref: Fixed date options-Footnote-10151573
Ref: Fixed date options-Footnote-11151620
Ref: Fixed date options-Footnote-12151705
Ref: Fixed date options-Footnote-13151733
Ref: Fixed date options-Footnote-14151788
Ref: Fixed date options-Footnote-15151843
Ref: Fixed date options-Footnote-16151910
Node: Response file151977
Node: Actual date modifier154121
Node: Commands163270
Node: Single commands165446
Ref: x-mm-yyyy166310
Node: 3-Month mode commands167423
Node: Lists of commands168288
Node: Ranges of commands169473
Node: The GCAL environment variable170579
Node: Eternal Holidays171536
Node: Fixed Dates176231
Node: Resource file181170
Ref: x-File-searching-mechanism182101
Node: Resource file-Footnotes185553
Ref: Resource file-Footnote-1185624
Ref: Resource file-Footnote-2185765
Ref: Resource file-Footnote-3185884
Ref: Resource file-Footnote-4185920
Ref: Resource file-Footnote-5185986
Node: Structure of resource file186116
Node: Structure of resource file-Footnotes188759
Ref: Structure of resource file-Footnote-1188856
Ref: Structure of resource file-Footnote-2188928
Node: Date part of a line189122
Node: Further date part attributes195570
Node: Lists of days196941
Node: Ranges of days200093
Node: Ranges of days-Footnotes204664
Ref: Ranges of days-Footnote-1204737
Ref: Ranges of days-Footnote-2204821
Node: Repetition factor of days204848
Node: Repetition factor of days-Footnotes208919
Ref: Repetition factor of days-Footnote-1209014
Ref: Repetition factor of days-Footnote-2209046
Node: Appearance factor of days209141
Node: Appearance factor of days-Footnotes215762
Ref: Appearance factor of days-Footnote-1215857
Node: Text part of a line215941
Node: Text part of a line-Footnotes221743
Ref: Text part of a line-Footnote-1221826
Ref: Text part of a line-Footnote-2221853
Ref: Text part of a line-Footnote-3221898
Ref: Text part of a line-Footnote-4221993
Node: Special Texts processed222064
Node: Special Texts processed-Footnotes224308
Ref: Special Texts processed-Footnote-1224399
Node: Comment line224417
Node: Comment line-Footnotes226867
Ref: Comment line-Footnote-1226936
Node: Include directives226970
Node: Include directives-Footnotes229869
Ref: Include directives-Footnote-1229950
Ref: Include directives-Footnote-2230026
Ref: Include directives-Footnote-3230087
Ref: Include directives-Footnote-4230195
Ref: Include directives-Footnote-5230278
Ref: Include directives-Footnote-6230335
Node: Date variables230442
Node: Date variables-Footnotes236828
Ref: Date variables-Footnote-1236901
Ref: Date variables-Footnote-2237168
Ref: Date variables-Footnote-3237240
Ref: Date variables-Footnote-4237315
Node: Text variables237351
Node: Text variables-Footnotes251704
Ref: Text variables-Footnote-1251777
Ref: Text variables-Footnote-2251852
Node: Resource file examples251888
Node: Resource file examples-Footnotes265231
Ref: Resource file examples-Footnote-1265320
Node: Todays Calendar265387
Node: Gcal Utilities270066
Node: Invoking tcal270772
Node: Invoking tcal-Footnotes272613
Ref: Invoking tcal-Footnote-1272684
Node: Invoking txt2gcal272735
Node: Invoking gcal2txt275093
Node: Internationalization277082
Node: Internationalization-Footnotes282865
Ref: Internationalization-Footnote-1282950
Ref: Internationalization-Footnote-2283011
Ref: Internationalization-Footnote-3283068
Ref: Internationalization-Footnote-4283134
Ref: Internationalization-Footnote-5283240
Ref: Internationalization-Footnote-6283322
Node: Metasymbols283429
Node: Regular Expressions284892
Node: Regexp Usage286506
Node: Regexp Usage-Footnotes287129
Ref: Regexp Usage-Footnote-1287198
Node: Regexp Operators287282
Node: Regexp Operators-Footnotes298796
Ref: Regexp Operators-Footnote-1298873
Ref: Regexp Operators-Footnote-2298942
Ref: Regexp Operators-Footnote-3298994
Ref: Regexp Operators-Footnote-4299083
Ref: Regexp Operators-Footnote-5299141
Node: Regexp Summary299203
Node: Regexp Summary-Footnotes301419
Ref: Regexp Summary-Footnote-1301492
Node: Special Texts301559
Node: Exclusions305238
Node: Exclusions with date argument305783
Node: Inclusive date period306944
Node: Exclusive date period310390
Node: Exclusions without any argument313800
Node: Inclusive day period314862
Node: Exclusive day period316024
Node: Replacements317127
Node: Replacements with date argument318019
Node: Replacements with date argument-Footnotes319622
Ref: Replacements with date argument-Footnote-1319729
Node: Weekday name319818
Node: Weekday number320882
Node: Day-of-year number326348
Node: Day number327890
Node: Week number329257
Node: Month name330078
Node: Month number330843
Node: Year number332244
Node: Moon phase332997
Node: Biorhythm336099
Node: Difference value340392
Ref: x-Age-value340964
Node: Replacements with other argument341934
Node: Actual clocktime343092
Ref: x-Actual-local-time344681
Node: Actual clocktime-Footnotes352630
Ref: Actual clocktime-Footnote-1352707
Node: Textual date352766
Node: Julian day number353460
Node: Geographical distance and course angle355252
Node: Geographical distance and course angle-Footnotes359979
Ref: Geographical distance and course angle-Footnote-1360100
Node: Sun data360799
Ref: x-Sun-midnight362647
Ref: x-Sun-noon363437
Ref: x-Sun-standard-rise370821
Ref: x-Sun-standard-set372531
Ref: x-Sun-asr-1409005
Ref: x-Sun-asr-2411265
Ref: x-Sun-representation413260
Ref: x-Sun-event-texts415614
Ref: x-Sun-arguments420112
Node: Moon data433303
Ref: x-Moon-midnight435152
Ref: x-Moon-noon436473
Ref: x-Moon-standard-rise444965
Ref: x-Moon-standard-set446937
Node: Contents of Environment variable492815
Node: Replacements without any argument493388
Node: Other difference values493814
Node: Highlighting496565
Node: Shell Command503658
Node: Special Texts Summary505077
Node: Obsolete Special Texts581528
Node: Table of Obsolete Special Texts582520
Node: Table of Obsolete Date Format Elements585556
Node: Table of Obsolete Date Formats587197
Node: Format Instruction588006
Node: Coding Scheme590716
Node: Coding Scheme Table 1592198
Node: Coding Scheme Table 2595173
Node: Environment Variables597381
Ref: x-GCAL597637
Ref: x-GCAL_COLUMNS597726
Ref: x-COLUMNS597726
Ref: x-GCAL_DATE_FORMAT597915
Ref: x-GCAL_LINES598083
Ref: x-LINES598083
Ref: x-GCAL_SYS_DATADIR598268
Ref: x-GCAL_USR_DATADIR598467
Ref: x-GCALANSI598698
Ref: x-GCALPATH598932
Ref: x-GCALPROG599127
Ref: x-HOME599602
Ref: x-LOGNAME600362
Ref: x-MAILPROG600515
Ref: x-MAILTO600798
Ref: x-PAGER600998
Ref: x-PATH601163
Ref: x-TERM601349
Ref: x-TXT2GCALPROG601431
Ref: x-USER602129
Node: Error Codes602310
Ref: x-126-Error-code602594
Ref: x-119-Error-code603049
Ref: x-118-Error-code603149
Ref: x-113-Error-code603481
Ref: x-2-Error-code604138
Ref: x-1-Error-code604205
Node: Glossary604355
Node: Argument Index631774
Node: Variable Index659953
Node: Table Index666339
Node: GNU Free Documentation License674095
Node: Concept Index699267

End Tag Table
