This is gcal.info, produced by makeinfo version 4.13 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 Free Software Foundation, Inc.

  This edition is for Gcal version 3.01.

     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.01 of `Gcal, an Extended Calendar Program',
24 June 2000, for the 3.01 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/Nordwest 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 Islands

    `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.01 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.01 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 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 Type*  *Dynamical*    *Co-ordinate*  *Timezone*

`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 Type*  *Dynamical*    *Co-ordinate*  *Timezone*

`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.01 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.01 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.01 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.01 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.01 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.01 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  512)
* -*dN:                                  Fixed date options. (line  895)
* -*dNWWW:                               Fixed date options. (line 1029)
* -*wN[WWW]:                             Fixed date options. (line 1081)
* --adjust-value=ARGUMENT:               Fixed date options. (line  130)
* --alternative-format:                  Fixed date options. (line  675)
* --astronomical-holidays:               Calendar options.   (line   48)
* --atmosphere=AIR-PRESSURE[,TEMPERATURE]: Fixed date options.
                                                             (line  152)
* --bahai-holidays:                      Calendar options.   (line   57)
* --bahai-months:                        Calendar options.   (line 1207)
* --biorhythm-axis=NUMBER:               Fixed date options. (line  615)
* --blocks=1:                            Calendar options.   (line 1394)
* --blocks=12:                           Calendar options.   (line 1414)
* --blocks=2:                            Calendar options.   (line 1398)
* --blocks=3:                            Calendar options.   (line 1402)
* --blocks=4:                            Calendar options.   (line 1406)
* --blocks=6:                            Calendar options.   (line 1410)
* --blocks=NUMBER:                       Calendar options.   (line 1386)
* --calendar-dates=both:                 Calendar options.   (line 1430)
* --calendar-dates=special:              Calendar options.   (line 1424)
* --calendar-dates=special|both:         Calendar options.   (line 1418)
* --cc-holidays=CC[_TT][+...]:           Calendar options.   (line  143)
* --celtic-holidays:                     Calendar options.   (line   61)
* --chinese-flexible-holidays:           Calendar options.   (line   67)
* --chinese-flexible-months:             Calendar options.   (line 1213)
* --chinese-holidays:                    Calendar options.   (line   75)
* --chinese-months:                      Calendar options.   (line 1220)
* --christian-holidays:                  Calendar options.   (line   82)
* --coptic-months:                       Calendar options.   (line 1226)
* --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  283)
* --date-format=de|us|gb|TEXT:           Calendar options.   (line 1619)
* --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  456)
* --descending-fixed-dates=short:        Fixed date options. (line  439)
* --descending-fixed-dates[=short|long]: Fixed date options. (line  424)
* --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 1390)
* --end-of-week:                         Fixed date options. (line 1342)
* --end-of-year:                         Fixed date options. (line 1427)
* --ethiopic-months:                     Calendar options.   (line 1231)
* --exclude-fixed-dates-list-title:      Fixed date options. (line  808)
* --exclude-holiday-list-title:          Calendar options.   (line   45)
* --execute-command:                     Fixed date options. (line  342)
* --exit-status-help-non-zero:           Common options.     (line   41)
* --export-date-variables <1>:           Date variables.     (line  104)
* --export-date-variables:               Fixed date options. (line   29)
* --export-text-variables <1>:           Text variables.     (line  279)
* --export-text-variables:               Fixed date options. (line  125)
* --filter-day=ARGUMENT:                 Fixed date options. (line  353)
* --filter-period=ARGUMENT:              Fixed date options. (line  368)
* --filter-text=PATTERN:                 Fixed date options. (line  386)
* --fixed-dates=both:                    Calendar options.   (line 1466)
* --fixed-dates=special:                 Calendar options.   (line 1460)
* --fixed-dates=special|both:            Calendar options.   (line 1453)
* --force-highlighting:                  Global options.     (line   91)
* --french-revolutionary-months:         Calendar options.   (line 1236)
* --gregorian-reform=1582|1700|1752|1753|ARGUMENT: Calendar options.
                                                             (line 1556)
* --grouping-text[=TEXT]:                Fixed date options. (line  700)
* --heading-text=TEXT:                   Fixed date options. (line  811)
* --hebrew-holidays:                     Calendar options.   (line   86)
* --hebrew-months:                       Calendar options.   (line 1241)
* --help <1>:                            Invoking gcal2txt.  (line   23)
* --help <2>:                            Invoking txt2gcal.  (line   21)
* --help <3>:                            Invoking tcal.      (line   34)
* --help:                                Common options.     (line    9)
* --here=LINE:                           Fixed date options. (line  512)
* --highlighting=no:                     Global options.     (line  102)
* --highlighting=TEXT:                   Global options.     (line  107)
* --highlighting=yes:                    Global options.     (line   91)
* --holiday-dates=both:                  Calendar options.   (line 1448)
* --holiday-dates=special:               Calendar options.   (line 1442)
* --holiday-dates=special|both:          Calendar options.   (line 1435)
* --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  411)
* --include-consecutive-number:          Fixed date options. (line  853)
* --include-holidays=long:               Fixed date options. (line  690)
* --include-holidays=short:              Fixed date options. (line  695)
* --include-resource-file-name:          Fixed date options. (line  666)
* --include-today:                       Fixed date options. (line  878)
* --include-week-number:                 Fixed date options. (line  757)
* --indian-civil-months:                 Calendar options.   (line 1246)
* --islamic-civil-holidays:              Calendar options.   (line   89)
* --islamic-civil-months:                Calendar options.   (line 1251)
* --iso-week-number=no:                  Calendar options.   (line 1374)
* --iso-week-number=yes:                 Calendar options.   (line 1363)
* --iso-week-number=yes|no:              Calendar options.   (line 1356)
* --japanese-flexible-holidays:          Calendar options.   (line   94)
* --japanese-flexible-months:            Calendar options.   (line 1258)
* --japanese-holidays:                   Calendar options.   (line  101)
* --japanese-months:                     Calendar options.   (line 1265)
* --leap-day=february:                   Fixed date options. (line  867)
* --leap-day=february|march:             Fixed date options. (line  863)
* --leap-day=march:                      Fixed date options. (line  872)
* --license:                             Common options.     (line   33)
* --limit:                               Fixed date options. (line  171)
* --list-mode:                           Fixed date options. (line  884)
* --list-of-fixed-dates=long:            Fixed date options. (line  448)
* --list-of-fixed-dates=short:           Fixed date options. (line  430)
* --list-of-fixed-dates[=short|long]:    Fixed date options. (line  424)
* --long-help=?:                         Common options.     (line   25)
* --long-help[=ARGUMENT]:                Common options.     (line   16)
* --mail[=ADDRESS]:                      Global options.     (line  183)
* --month:                               Fixed date options. (line 1383)
* --moonimage-lines=NUMBER:              Fixed date options. (line  643)
* --multicultural-new-year-holidays:     Calendar options.   (line  107)
* --old-armenic-months:                  Calendar options.   (line 1271)
* --old-egyptic-months:                  Calendar options.   (line 1276)
* --omit-multiple-date-part:             Fixed date options. (line  766)
* --orthodox-calendar:                   Calendar options.   (line 1322)
* --orthodox-new-holidays:               Calendar options.   (line  114)
* --orthodox-old-holidays:               Calendar options.   (line  121)
* --pager:                               Global options.     (line   48)
* --period-of-fixed-dates=ARGUMENT:      Fixed date options. (line  892)
* --persian-jalaali-holidays:            Calendar options.   (line  128)
* --persian-jalaali-months:              Calendar options.   (line 1281)
* --precise:                             Fixed date options. (line  330)
* --resource-file=NAME[+...]:            Fixed date options. (line  465)
* --response-file=NAME:                  Global options.     (line    8)
* --revert-match:                        Fixed date options. (line  416)
* --shell-script=NAME:                   Global options.     (line   15)
* --shift=[+|-]NUMBER:                   Invoking tcal.      (line   41)
* --start-of-month:                      Fixed date options. (line 1402)
* --start-of-week:                       Fixed date options. (line 1342)
* --start-of-year:                       Fixed date options. (line 1439)
* --starting-day=ARGUMENT:               Calendar options.   (line 1471)
* --suppress-calendar:                   Calendar options.   (line 1382)
* --suppress-date-part:                  Fixed date options. (line  788)
* --suppress-fixed-dates-list-separator: Fixed date options. (line  778)
* --suppress-holiday-list-separator:     Calendar options.   (line   40)
* --suppress-text-part:                  Fixed date options. (line  798)
* --text-variable=ARGUMENT:              Fixed date options. (line   35)
* --time-offset=ARGUMENT:                Calendar options.   (line 1492)
* --today:                               Fixed date options. (line  424)
* --tomorrow:                            Fixed date options. (line 1330)
* --transform-year=ARGUMENT:             Calendar options.   (line 1535)
* --translate-string=TEXT:               Calendar options.   (line 1718)
* --type=special|standard:               Calendar options.   (line 1289)
* --usage=?:                             Common options.     (line   25)
* --usage[=ARGUMENT]:                    Common options.     (line   16)
* --version <1>:                         Invoking gcal2txt.  (line   27)
* --version <2>:                         Invoking txt2gcal.  (line   25)
* --version <3>:                         Invoking tcal.      (line   38)
* --version:                             Common options.     (line   37)
* --week:                                Fixed date options. (line 1342)
* --with-week-number:                    Calendar options.   (line 1349)
* --year:                                Fixed date options. (line 1420)
* --zero-dates-only:                     Fixed date options. (line  857)
* --zodical-marker-holidays:             Calendar options.   (line  134)
* -?:                                    Common options.     (line    9)
* -??:                                   Common options.     (line   16)
* -@DVAR[+|-]NWWW:                       Fixed date options. (line 1302)
* -@DVAR[[+|-]N]:                        Fixed date options. (line 1269)
* -@e[+|-]NWWW:                          Fixed date options. (line 1188)
* -@e[[+|-]N]:                           Fixed date options. (line 1155)
* -@t[+|-]NWWW:                          Fixed date options. (line 1243)
* -@t[[+|-]N]:                           Fixed date options. (line 1214)
* -A:                                    Fixed date options. (line  675)
* -a:                                    Fixed date options. (line  666)
* -b 1:                                  Calendar options.   (line 1394)
* -b 12:                                 Calendar options.   (line 1414)
* -b 2:                                  Calendar options.   (line 1398)
* -b 3:                                  Calendar options.   (line 1402)
* -b 4:                                  Calendar options.   (line 1406)
* -b 6:                                  Calendar options.   (line 1410)
* -b NUMBER:                             Calendar options.   (line 1386)
* -C:                                    Fixed date options. (line  448)
* -c:                                    Fixed date options. (line  430)
* -c*dN:                                 Fixed date options. (line  895)
* -c*dNWWW:                              Fixed date options. (line 1029)
* -c*wN[WWW]:                            Fixed date options. (line 1081)
* -C-:                                   Fixed date options. (line  456)
* -c-:                                   Fixed date options. (line  439)
* -c@DVAR[+|-]NWWW:                      Fixed date options. (line 1302)
* -c@DVAR[[+|-]N]:                       Fixed date options. (line 1269)
* -c@e[+|-]NWWW:                         Fixed date options. (line 1188)
* -c@e[[+|-]N]:                          Fixed date options. (line 1155)
* -c@t[+|-]NWWW:                         Fixed date options. (line 1243)
* -c@t[[+|-]N]:                          Fixed date options. (line 1214)
* -c[m|M[+|-]]:                          Fixed date options. (line 1380)
* -c[t|T]:                               Fixed date options. (line 1330)
* -c[w|W[+|-]]:                          Fixed date options. (line 1342)
* -c[y|Y[+|-]]:                          Fixed date options. (line 1417)
* -cA:                                   Fixed date options. (line  675)
* -ca:                                   Fixed date options. (line  666)
* -cd:                                   Fixed date options. (line  878)
* -cE:                                   Fixed date options. (line  695)
* -ce:                                   Fixed date options. (line  690)
* -cg[TEXT]:                             Fixed date options. (line  700)
* -cJ:                                   Fixed date options. (line  798)
* -ck:                                   Fixed date options. (line  757)
* -cl:                                   Fixed date options. (line  884)
* -cl*dN:                                Fixed date options. (line  907)
* -cl*dNWWW:                             Fixed date options. (line 1052)
* -cl*wN[WWW]:                           Fixed date options. (line 1115)
* -cl@DVAR[+|-]NWWW:                     Fixed date options. (line 1314)
* -cl@DVAR[[+|-]N]:                      Fixed date options. (line 1284)
* -cl@e[+|-]NWWW:                        Fixed date options. (line 1200)
* -cl@e[[+|-]N]:                         Fixed date options. (line 1170)
* -cl@t[+|-]NWWW:                        Fixed date options. (line 1255)
* -cl@t[[+|-]N]:                         Fixed date options. (line 1228)
* -clMMDD:                               Fixed date options. (line  993)
* -clMMWWWN:                             Fixed date options. (line 1015)
* -clN+|-:                               Fixed date options. (line  926)
* -clNd:                                 Fixed date options. (line  907)
* -clNw:                                 Fixed date options. (line  968)
* -cm:                                   Fixed date options. (line 1383)
* -cm+:                                  Fixed date options. (line 1390)
* -cm-:                                  Fixed date options. (line 1402)
* -cMMDD:                                Fixed date options. (line  986)
* -cMMWWWN:                              Fixed date options. (line 1004)
* -cN+|-:                                Fixed date options. (line  916)
* -cNd:                                  Fixed date options. (line  895)
* -cNw:                                  Fixed date options. (line  938)
* -co:                                   Fixed date options. (line  766)
* -cQ:                                   Fixed date options. (line  778)
* -cT:                                   Fixed date options. (line 1330)
* -ct:                                   Fixed date options. (line 1330)
* -cU:                                   Fixed date options. (line  788)
* -cw:                                   Fixed date options. (line 1346)
* -cw+:                                  Fixed date options. (line 1353)
* -cw-:                                  Fixed date options. (line 1365)
* -cx:                                   Fixed date options. (line  808)
* -cy:                                   Fixed date options. (line 1420)
* -cy+:                                  Fixed date options. (line 1427)
* -cy-:                                  Fixed date options. (line 1439)
* -cZ:                                   Fixed date options. (line  857)
* -cz:                                   Fixed date options. (line  853)
* -c|C[-]:                               Fixed date options. (line  424)
* -d:                                    Fixed date options. (line  878)
* -D ARGUMENT:                           Fixed date options. (line  353)
* -E:                                    Fixed date options. (line  695)
* -e:                                    Fixed date options. (line  690)
* -f|F NAME[+...]:                       Fixed date options. (line  465)
* -G:                                    Calendar options.   (line   40)
* -g[TEXT]:                              Fixed date options. (line  700)
* -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 1289)
* -I PATTERN:                            Fixed date options. (line  386)
* -i[-]:                                 Calendar options.   (line 1289)
* -J:                                    Fixed date options. (line  798)
* -j:                                    Calendar options.   (line 1424)
* -j[b]:                                 Calendar options.   (line 1418)
* -jb:                                   Calendar options.   (line 1430)
* -jc:                                   Calendar options.   (line 1460)
* -jc[b]:                                Calendar options.   (line 1453)
* -jcb:                                  Calendar options.   (line 1466)
* -jn:                                   Calendar options.   (line 1442)
* -jn[b]:                                Calendar options.   (line 1435)
* -jnb:                                  Calendar options.   (line 1448)
* -k:                                    Fixed date options. (line  757)
* -K:                                    Calendar options.   (line 1349)
* -l:                                    Fixed date options. (line  884)
* -L:                                    Common options.     (line   33)
* -l*dN:                                 Fixed date options. (line  907)
* -l*dNWWW:                              Fixed date options. (line 1052)
* -l*wN[WWW]:                            Fixed date options. (line 1115)
* -l@DVAR[+|-]NWWW:                      Fixed date options. (line 1314)
* -l@DVAR[[+|-]N]:                       Fixed date options. (line 1284)
* -l@e[+|-]NWWW:                         Fixed date options. (line 1200)
* -l@e[[+|-]N]:                          Fixed date options. (line 1170)
* -l@t[+|-]NWWW:                         Fixed date options. (line 1255)
* -l@t[[+|-]N]:                          Fixed date options. (line 1228)
* -lMMDD:                                Fixed date options. (line  993)
* -lMMWWWN:                              Fixed date options. (line 1015)
* -lN+|-:                                Fixed date options. (line  926)
* -lNd:                                  Fixed date options. (line  907)
* -lNw:                                  Fixed date options. (line  968)
* -m:                                    Fixed date options. (line 1383)
* -M:                                    Fixed date options. (line 1380)
* -m:                                    Fixed date options. (line 1380)
* -m+:                                   Fixed date options. (line 1390)
* -m-:                                   Fixed date options. (line 1402)
* -M[+|-]]:                              Fixed date options. (line 1380)
* -m[+|-]]:                              Fixed date options. (line 1380)
* -m|M[+|-]]:                            Fixed date options. (line 1380)
* -N:                                    Calendar options.   (line   30)
* -n:                                    Calendar options.   (line   18)
* -N-:                                   Calendar options.   (line   35)
* -n-:                                   Calendar options.   (line   24)
* -n|N[-]:                               Calendar options.   (line    9)
* -o:                                    Fixed date options. (line  766)
* -O:                                    Calendar options.   (line 1322)
* -p:                                    Global options.     (line   48)
* -P ARGUMENT:                           Fixed date options. (line  368)
* -Q:                                    Fixed date options. (line  778)
* -q CC[_TT][+...]:                      Calendar options.   (line  143)
* -r ARGUMENT:                           Fixed date options. (line   35)
* -R NAME:                               Global options.     (line    8)
* -s ARGUMENT:                           Calendar options.   (line 1471)
* -S NAME:                               Global options.     (line   15)
* -T:                                    Fixed date options. (line 1330)
* -t:                                    Fixed date options. (line 1330)
* -U:                                    Fixed date options. (line  788)
* -u:                                    Calendar options.   (line 1382)
* -V:                                    Common options.     (line   37)
* -v ARGUMENT:                           Fixed date options. (line    8)
* -w:                                    Fixed date options. (line 1346)
* -W:                                    Fixed date options. (line 1342)
* -w:                                    Fixed date options. (line 1342)
* -w+:                                   Fixed date options. (line 1353)
* -w-:                                   Fixed date options. (line 1365)
* -W[+|-]]:                              Fixed date options. (line 1342)
* -w[+|-]]:                              Fixed date options. (line 1342)
* -w|W[+|-]]:                            Fixed date options. (line 1342)
* -X:                                    Calendar options.   (line   45)
* -y:                                    Fixed date options. (line 1420)
* -Y:                                    Fixed date options. (line 1417)
* -y:                                    Fixed date options. (line 1417)
* -y+:                                   Fixed date options. (line 1427)
* -y-:                                   Fixed date options. (line 1439)
* -Y[+|-]]:                              Fixed date options. (line 1417)
* -y[+|-]]:                              Fixed date options. (line 1417)
* -y|Y[+|-]]:                            Fixed date options. (line 1417)
* -Z:                                    Fixed date options. (line  857)
* -z:                                    Fixed date options. (line  853)
* @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 <1>:                           Environment Variables.
                                                             (line   14)
* COLUMNS:                               Global options.     (line   70)
* GCAL <1>:                              Environment Variables.
                                                             (line   10)
* GCAL <2>:                              The GCAL environment variable.
                                                             (line    6)
* GCAL:                                  Global options.     (line    8)
* GCAL_COLUMNS <1>:                      Environment Variables.
                                                             (line   14)
* GCAL_COLUMNS:                          Global options.     (line   65)
* GCAL_DATE_FORMAT <1>:                  Environment Variables.
                                                             (line   19)
* GCAL_DATE_FORMAT:                      Calendar options.   (line 1647)
* GCAL_LINES <1>:                        Environment Variables.
                                                             (line   25)
* GCAL_LINES:                            Global options.     (line   65)
* GCAL_OPT <1>:                          Environment Variables.
                                                             (line   10)
* GCAL_OPT:                              The GCAL environment variable.
                                                             (line   24)
* GCAL_SYS_DATADIR <1>:                  Environment Variables.
                                                             (line   30)
* GCAL_SYS_DATADIR:                      Resource file.      (line   50)
* GCAL_USR_DATADIR <1>:                  Environment Variables.
                                                             (line   35)
* GCAL_USR_DATADIR:                      Resource file.      (line   38)
* GCALANSI <1>:                          Environment Variables.
                                                             (line   41)
* GCALANSI:                              Global options.     (line  176)
* GCALPATH <1>:                          Environment Variables.
                                                             (line   47)
* GCALPATH:                              Resource file.      (line   24)
* GCALPROG <1>:                          Environment Variables.
                                                             (line   52)
* GCALPROG:                              Invoking tcal.      (line   20)
* HOME <1>:                              Environment Variables.
                                                             (line   61)
* HOME <2>:                              Resource file.      (line   32)
* HOME:                                  Fixed date options. (line  478)
* LANG <1>:                              Environment Variables.
                                                             (line   80)
* LANG:                                  Internationalization.
                                                             (line   33)
* LANGUAGE <1>:                          Environment Variables.
                                                             (line   66)
* LANGUAGE:                              Internationalization.
                                                             (line   30)
* LC_ALL <1>:                            Environment Variables.
                                                             (line   71)
* LC_ALL:                                Internationalization.
                                                             (line   31)
* LC_MESSAGES <1>:                       Environment Variables.
                                                             (line   76)
* LC_MESSAGES:                           Internationalization.
                                                             (line   32)
* LINES <1>:                             Environment Variables.
                                                             (line   25)
* LINES:                                 Global options.     (line   70)
* LOGNAME <1>:                           Environment Variables.
                                                             (line   84)
* LOGNAME:                               Global options.     (line  201)
* MAILPROG <1>:                          Environment Variables.
                                                             (line   88)
* MAILPROG:                              Global options.     (line  223)
* MAILTO <1>:                            Environment Variables.
                                                             (line   94)
* MAILTO:                                Global options.     (line  191)
* PAGER <1>:                             Environment Variables.
                                                             (line   99)
* PAGER:                                 Global options.     (line   48)
* PATH <1>:                              Environment Variables.
                                                             (line  104)
* PATH:                                  Global options.     (line   53)
* TERM <1>:                              Environment Variables.
                                                             (line  109)
* TERM:                                  Global options.     (line   75)
* TXT2GCALPROG <1>:                      Environment Variables.
                                                             (line  112)
* TXT2GCALPROG:                          Text variables.     (line  112)
* TZ:                                    Environment Variables.
                                                             (line  122)
* USER <1>:                              Environment Variables.
                                                             (line  126)
* USER:                                  Global options.     (line  196)


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 1012)
* 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  167)
* 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 1670)
* 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   43)
* 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  917)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  917)
* Exit codes:                            Error Codes.        (line    6)
* Fixed date, line structure:            Structure of resource file.
                                                             (line   31)
* Format elements and character replacement instructions in date format text: Calendar options.
                                                             (line 1670)
* Format Instruction:                    Format Instruction. (line    6)
* Geographical distance and course angle, modes: Geographical distance and course angle.
                                                             (line   15)
* Glossary:                              Glossary.           (line    6)
* GNU long-style options:                Options.            (line   36)
* Holidays, country specific:            Calendar options.   (line  167)
* ISO-6709:1983 co-ordinate:             Sun data.           (line 1012)
* Line structure of fixed date:          Structure of resource file.
                                                             (line   31)
* 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   15)
* Modes, Moon oriented special texts:    Moon data.          (line   34)
* Modes, Sun oriented special texts:     Sun data.           (line   34)
* Moon data and times, special event oriented texts: Sun data.
                                                             (line  917)
* Moon oriented special texts, modes:    Moon data.          (line   34)
* Moon oriented special texts, representation types: Moon data.
                                                             (line  826)
* 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  293)
* Regular expression programming libraries, supported: Regular Expressions.
                                                             (line   21)
* Regular expressions:                   Regexp Summary.     (line    6)
* Representation types of the Moon oriented special texts: Moon data.
                                                             (line  826)
* Representation types of the Sun oriented special texts: Sun data.
                                                             (line 1089)
* Resource file, entries:                Structure of resource file.
                                                             (line   43)
* 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  917)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  917)
* 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  917)
* Sun oriented special texts, modes:     Sun data.           (line   34)
* Sun oriented special texts, representation types: Sun data.
                                                             (line 1089)
* Supported native languages:            Internationalization.
                                                             (line   11)
* Supported regular expression programming libraries: Regular Expressions.
                                                             (line   21)
* Text variables, operations:            Text variables.     (line  293)
* 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 A GNU Free Documentation License
*****************************************

                     Version 1.3, 3 November 2008

     Copyright (C) 2000, 2001, 2002, 2007, 2008, 2010 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  175)
* %,[DATE] special text, biorhythm text: Biorhythm.          (line   34)
* %0 special text, end of highlighting sequence 1 or 2: Highlighting.
                                                             (line  126)
* %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   62)
* %=[ARGUMENT] special text, numerical local time timezone offset value: Actual clocktime.
                                                             (line  191)
* %>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   29)
* %>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  119)
* %>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  104)
* %[FORMAT]'[ARGUMENT] special text, actual local time in M[M...] format: Actual clocktime.
                                                             (line   51)
* %[FORMAT]-[ARGUMENT] special text, environment variable: Contents of Environment variable.
                                                             (line    6)
* %[FORMAT].[ARGUMENT] special text, actual Universal time hour: Actual clocktime.
                                                             (line  134)
* %[FORMAT]/[ARGUMENT] special text, actual Universal time minute: Actual clocktime.
                                                             (line  147)
* %[FORMAT]? special texts, difference value: Other difference values.
                                                             (line    6)
* %[FORMAT]?[ARGUMENT] special text, actual local time minute: Actual clocktime.
                                                             (line   78)
* %[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]?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 hour: Actual clocktime.
                                                             (line   65)
* %[FORMAT]`[ARGUMENT] special text, actual Universal time in M[M...]/DATE format: Actual clocktime.
                                                             (line  119)
* %[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 12-hour format suffix: Actual clocktime.
                                                             (line   91)
* %[FORMAT]}[ARGUMENT] special text, actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  161)
* %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)
* %D[DATE] special text, day number:     Day number.         (line    7)
* %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)
* %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   14)
* %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   27)
* %t[ARGUMENT] special text, actual local time in HH:MM format: Actual clocktime.
                                                             (line   19)
* %T[DATE] special text, weekday number: Weekday number.     (line  108)
* %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)
* %Y[DATE] special text, year number:    Year number.        (line    7)
* %yDATE special text, relative year number: Difference value.
                                                             (line   10)
* %Z[DATE] special text, Moon phase text graphics: Moon phase.
                                                             (line   44)
* (...) regexp, grouping:                Regexp Operators.   (line  184)
* * regexp, operator:                    Regexp Operators.   (line  191)
* + regexp, operator:                    Regexp Operators.   (line  211)
* + separator character <1>:             Fixed date options. (line  478)
* + separator character:                 Calendar options.   (line  157)
* , 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   54)
* / switch character:                    Command line arguments.
                                                             (line   22)
* 12-hours display format of time:       Actual clocktime.   (line   27)
* 2-letter weekday name %>2#K[DATE] special text <1>: Special Texts Summary.
                                                             (line   98)
* 2-letter weekday name %>2#K[DATE] special text: Weekday name.
                                                             (line   23)
* 24-hours display format of time:       Actual clocktime.   (line   27)
* 3-letter month name %>3#U[DATE] special text <1>: Special Texts Summary.
                                                             (line  177)
* 3-letter month name %>3#U[DATE] special text: Month name.  (line   15)
* 3-letter weekday name %>3#K[DATE] special text <1>: Special Texts Summary.
                                                             (line   95)
* 3-letter weekday name %>3#K[DATE] special text: Weekday name.
                                                             (line   15)
* 3-Month mode command:                  Glossary.           (line  634)
* 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 <1>:             3-Month mode commands.
                                                             (line    6)
* 3-Month mode commands:                 Commands.           (line    6)
* 3-Month mode, limitations <1>:         Date variables.     (line   49)
* 3-Month mode, limitations:             Further date part attributes.
                                                             (line   29)
* : separator character <1>:             Fixed date options. (line    8)
* : separator character:                 Global options.     (line  107)
* :N repetition factor of days:          Repetition factor of days.
                                                             (line    6)
* ; comment character <1>:               Comment line.       (line    6)
* ; comment character:                   Response file.      (line   21)
* ; remark character <1>:                Comment line.       (line    6)
* ; remark character:                    Response file.      (line   21)
* ? regexp, operator:                    Regexp Operators.   (line  223)
* @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   50)
* [.ELEMENT.] regexp, collating symbols: Regexp Operators.   (line  140)
* [:alnum:] regexp, character class:     Regexp Operators.   (line   88)
* [:alpha:] regexp, character class:     Regexp Operators.   (line   91)
* [:blank:] regexp, character class:     Regexp Operators.   (line   94)
* [:cntrl:] regexp, character class:     Regexp Operators.   (line   97)
* [:digit:] regexp, character class:     Regexp Operators.   (line  100)
* [:graph:] regexp, character class:     Regexp Operators.   (line  103)
* [:KEYWORD:] regexp, character classes: Regexp Operators.   (line   74)
* [:lower:] regexp, character class:     Regexp Operators.   (line  107)
* [:print:] regexp, character class:     Regexp Operators.   (line  110)
* [:punct:] regexp, character class:     Regexp Operators.   (line  113)
* [:space:] regexp, character class:     Regexp Operators.   (line  117)
* [:upper:] regexp, character class:     Regexp Operators.   (line  120)
* [:xdigit:] regexp, character class:    Regexp Operators.   (line  123)
* [=LIST=] regexp, equivalence classes:  Regexp Operators.   (line  147)
* [^ ...] regexp, complemented character list: Regexp Operators.
                                                             (line  160)
* \ depreciation character <1>:          Other difference values.
                                                             (line   11)
* \ depreciation character <2>:          Text variables.     (line   91)
* \ depreciation character <3>:          Special Texts processed.
                                                             (line    6)
* \ depreciation character <4>:          Text part of a line.
                                                             (line   52)
* \ depreciation character:              Fixed date options. (line  101)
* \ line continuation character:         Text part of a line.
                                                             (line   29)
* \ protection character <1>:            Other difference values.
                                                             (line   11)
* \ protection character <2>:            Text variables.     (line   91)
* \ protection character <3>:            Special Texts processed.
                                                             (line    6)
* \ protection character <4>:            Text part of a line.
                                                             (line   52)
* \ protection character:                Fixed date options. (line  101)
* \ regexp, metacharacter:               Regexp Operators.   (line   14)
* \' regexp, operator:                   Regexp Operators.   (line  299)
* \< regexp, operator:                   Regexp Operators.   (line  266)
* \> regexp, operator:                   Regexp Operators.   (line  270)
* \` regexp, operator:                   Regexp Operators.   (line  295)
* \B regexp, operator:                   Regexp Operators.   (line  279)
* \b regexp, operator:                   Regexp Operators.   (line  274)
* \W regexp, operator:                   Regexp Operators.   (line  262)
* \w regexp, operator:                   Regexp Operators.   (line  257)
* ^ line break-up character <1>:         Text part of a line.
                                                             (line    6)
* ^ line break-up character:             Fixed date options. (line  386)
* ^ regexp, anchor metacharacter:        Regexp Operators.   (line   22)
* _ pseudo space character:              Fixed date options. (line  115)
* Accuracy of astronomical calculations: Preface.            (line   20)
* Activate fixed date function:          Fixed date options. (line  424)
* Actual clocktime %[FORMAT]?[ARGUMENT] special texts <1>: Special Texts Summary.
                                                             (line  233)
* Actual clocktime %[FORMAT]?[ARGUMENT] special texts: Actual clocktime.
                                                             (line    6)
* 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]{[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  247)
* Actual local time 12-hour format suffix %[FORMAT]{[ARGUMENT] special text: Actual clocktime.
                                                             (line   91)
* 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   65)
* Actual local time in HH:MM format %t[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  235)
* Actual local time in HH:MM format %t[ARGUMENT] special text: Actual clocktime.
                                                             (line   19)
* Actual local time in M[M...] format %[FORMAT]'[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  238)
* Actual local time in M[M...] format %[FORMAT]'[ARGUMENT] special text: Actual clocktime.
                                                             (line   51)
* Actual local time minute %[FORMAT]?[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  244)
* Actual local time minute %[FORMAT]?[ARGUMENT] special text: Actual clocktime.
                                                             (line   78)
* Actual Universal time 12-hour format suffix %[FORMAT]}[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  262)
* Actual Universal time 12-hour format suffix %[FORMAT]}[ARGUMENT] special text: Actual clocktime.
                                                             (line  161)
* 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  134)
* Actual Universal time in HH:MM/DATE format %@[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  250)
* Actual Universal time in HH:MM/DATE format %@[ARGUMENT] special text: Actual clocktime.
                                                             (line  104)
* Actual Universal time in M[M...]/DATE format %[FORMAT]`[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  253)
* Actual Universal time in M[M...]/DATE format %[FORMAT]`[ARGUMENT] special text: Actual clocktime.
                                                             (line  119)
* Actual Universal time minute %[FORMAT]/[[+|-]MMMM|HH:[MM]] special text: Special Texts Summary.
                                                             (line  259)
* Actual Universal time minute %[FORMAT]/[ARGUMENT] special text: Actual clocktime.
                                                             (line  147)
* Addition by days of date variables:    Date variables.     (line  124)
* Addition by weekdays of date variables: Date variables.    (line  126)
* Addition of text variables:            Text variables.     (line  300)
* Additional resource file:              Fixed date options. (line  465)
* Additional resource file line:         Fixed date options. (line  512)
* Age value %>1&*B[DATE] special text:   Difference value.   (line   30)
* Age value %B[DATE] special text <1>:   Special Texts Summary.
                                                             (line  230)
* Age value %B[DATE] special text:       Difference value.   (line   18)
* Age value (birthday) %b[DATE] special text: Special Texts Summary.
                                                             (line  227)
* Air pressure of Earth's atmosphere, set: Fixed date options.
                                                             (line  152)
* Alternation operator:                  Glossary.           (line   15)
* Alternative date format in calendar sheet: Calendar options.
                                                             (line 1418)
* Alternative date format in eternal holiday list: Calendar options.
                                                             (line 1435)
* Alternative date format in fixed date list: Calendar options.
                                                             (line 1453)
* Amateur-astronomical twilight:         Glossary.           (line   19)
* Amateur-astronomical twilight, Sun:    Sun data.           (line  283)
* 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   49)
* Assignment of special texts to text variables, limitations: Special Texts.
                                                             (line   20)
* Assignments to date variables <1>:     Date variables.     (line    6)
* Assignments to date variables <2>:     Structure of resource file.
                                                             (line   57)
* Assignments to date variables:         Fixed date options. (line    8)
* Assignments to text variables <1>:     Text variables.     (line    6)
* Assignments to text variables <2>:     Structure of resource file.
                                                             (line   72)
* Assignments to text variables:         Fixed date options. (line   35)
* Astronomical calculations, accuracy:   Preface.            (line   20)
* Astronomical calculations, precision:  Preface.            (line   20)
* Astronomical data and times, more precise representation: Fixed date options.
                                                             (line  330)
* Astronomical data in eternal holiday list: Calendar options.
                                                             (line   48)
* Astronomical midnight time, Moon:      Moon data.          (line   37)
* Astronomical midnight time, Sun:       Sun data.           (line   37)
* Astronomical noon time, Moon:          Moon data.          (line   57)
* Astronomical noon time, Sun:           Sun data.           (line   49)
* Astronomical twilight:                 Glossary.           (line   36)
* Astronomical twilight, Sun:            Sun data.           (line  309)
* Astronomical unit:                     Glossary.           (line   40)
* Astronomical unit, Sun:                Sun data.           (line  397)
* Atmospheric refraction:                Fixed date options. (line  152)
* Autumnal equinox:                      Calendar options.   (line   48)
* Autumnal equinox point on the ecliptic: Glossary.          (line   45)
* Azimuth:                               Glossary.           (line   49)
* Azimuth, Moon:                         Moon data.          (line   37)
* Azimuth, Sun:                          Sun data.           (line   37)
* Baha''i` holidays in eternal holiday list: Calendar options.
                                                             (line   57)
* Base data of Earth's atmosphere to calculate refraction, set: Fixed date options.
                                                             (line  152)
* Base time of astronomical functions, output <1>: Moon data.
                                                             (line  450)
* Base time of astronomical functions, output: Sun data.     (line  482)
* Base time of the astronomical functions, change: Calendar options.
                                                             (line 1492)
* Base year of calendar, change:         Calendar options.   (line 1535)
* Biorhythm:                             Glossary.           (line   53)
* Biorhythm %?[DATE] special texts <1>:  Special Texts Summary.
                                                             (line  214)
* Biorhythm %?[DATE] special texts:      Biorhythm.          (line    6)
* Biorhythm text %,[DATE] special text <1>: Special Texts Summary.
                                                             (line  216)
* Biorhythm text %,[DATE] special text:  Biorhythm.          (line   34)
* Biorhythm text graphics %;[DATE] special text <1>: Special Texts Summary.
                                                             (line  219)
* Biorhythm text graphics %;[DATE] special text: Biorhythm.  (line   62)
* Biorhythm, critical day:               Biorhythm.          (line   21)
* Biorhythm, negative day:               Biorhythm.          (line   21)
* Biorhythm, positive day:               Biorhythm.          (line   21)
* Birthday:                              Difference value.   (line   18)
* BSD:                                   Glossary.           (line   58)
* Buffer matching operators, regexp:     Regexp Operators.   (line  294)
* Buffer, regexp:                        Regexp Operators.   (line  285)
* C:                                     Glossary.           (line   62)
* C Preprocessor symbol USE_PAGER:       Global options.     (line  170)
* Calendar format, special:              Calendar options.   (line 1289)
* Calendar format, standard:             Calendar options.   (line 1289)
* Calendar mode, hybrid:                 Calendar options.   (line 1556)
* Calendar mode, proleptic:              Calendar options.   (line 1589)
* Calendar option class <1>:             Glossary.           (line   66)
* Calendar option class:                 Options.            (line   13)
* Calendar options:                      Calendar options.   (line    6)
* Calendar sheet, alternative date format: Calendar options. (line 1418)
* Calendar sheet, provide with week numbers: Calendar options.
                                                             (line 1349)
* Calendar sheet, special date format:   Calendar options.   (line 1424)
* Calendar sheet, standard and special date format: Calendar options.
                                                             (line 1430)
* Calendar sheet, suppress:              Calendar options.   (line 1382)
* Calendar, Chinese:                     Preface.            (line  187)
* Calendar, Gregorian:                   Todays Calendar.    (line    6)
* Calendar, Japanese:                    Preface.            (line  187)
* Calendar, Julian:                      Todays Calendar.    (line    6)
* Calendar, leap year rule as used by Eastern churches: Calendar options.
                                                             (line 1322)
* Case sensitivity in matching, regexp:  Regexp Operators.   (line  306)
* Celestial axis:                        Glossary.           (line   69)
* Celestial body elevation:              Glossary.           (line   73)
* Celestial equator <1>:                 Glossary.           (line   77)
* Celestial equator <2>:                 Moon data.          (line  313)
* Celestial equator:                     Sun data.           (line  372)
* Celestial Pole:                        Glossary.           (line   82)
* Celtic holidays in eternal holiday list: Calendar options. (line   61)
* Change base time of the astronomical functions: Calendar options.
                                                             (line 1492)
* Change base year of calendar:          Calendar options.   (line 1535)
* Character class:                       Glossary.           (line   86)
* Character class, [:alnum:] regexp:     Regexp Operators.   (line   88)
* Character class, [:alpha:] regexp:     Regexp Operators.   (line   91)
* Character class, [:blank:] regexp:     Regexp Operators.   (line   94)
* Character class, [:cntrl:] regexp:     Regexp Operators.   (line   97)
* Character class, [:digit:] regexp:     Regexp Operators.   (line  100)
* Character class, [:graph:] regexp:     Regexp Operators.   (line  103)
* Character class, [:lower:] regexp:     Regexp Operators.   (line  107)
* Character class, [:print:] regexp:     Regexp Operators.   (line  110)
* Character class, [:punct:] regexp:     Regexp Operators.   (line  113)
* Character class, [:space:] regexp:     Regexp Operators.   (line  117)
* Character class, [:upper:] regexp:     Regexp Operators.   (line  120)
* Character class, [:xdigit:] regexp:    Regexp Operators.   (line  123)
* Character classes, [:KEYWORD:] regexp: Regexp Operators.   (line   74)
* Character classes, regexp:             Regexp Operators.   (line   74)
* Character list:                        Glossary.           (line   92)
* Character list in regexp, complemented: Regexp Operators.  (line  160)
* Character list in regexp, negated:     Regexp Operators.   (line  160)
* Character list, [...] regexp:          Regexp Operators.   (line   50)
* Character list, regexp:                Regexp Operators.   (line   50)
* Character replacement instruction:     Calendar options.   (line 1656)
* Character set:                         Glossary.           (line   96)
* Characters, command separator:         Commands.           (line   37)
* Chinese calendar:                      Preface.            (line  187)
* Chinese holidays in eternal holiday list: Calendar options.
                                                             (line   75)
* Christian holidays in eternal holiday list: Calendar options.
                                                             (line   82)
* Civil Islamic calendar <1>:            Glossary.           (line  104)
* Civil Islamic calendar:                Preface.            (line  164)
* Civil midnight time <1>:               Glossary.           (line  107)
* Civil midnight time:                   Calendar options.   (line 1492)
* Civil twilight:                        Glossary.           (line  112)
* Civil twilight, Sun:                   Sun data.           (line  231)
* Clocktime value, Sun and Moon oriented special texts: Sun data.
                                                             (line  909)
* Co-ordinate termination character, /:  Geographical distance and course angle.
                                                             (line   54)
* Co-ordinate, ISO-6709:1983 <1>:        Moon data.          (line  807)
* Co-ordinate, ISO-6709:1983 <2>:        Sun data.           (line 1006)
* Co-ordinate, ISO-6709:1983:            Geographical distance and course angle.
                                                             (line   54)
* 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  116)
* Collating elements, regexp:            Regexp Operators.   (line  132)
* Collating symbol:                      Glossary.           (line  123)
* Collating symbols, [.ELEMENT.] regexp: Regexp Operators.   (line  140)
* Collating symbols, regexp:             Regexp Operators.   (line  140)
* COLUMNS environment variable:          Environment Variables.
                                                             (line   14)
* Command:                               Glossary.           (line  131)
* Command execution <1>:                 Shell Command.      (line   24)
* Command execution <2>:                 Text variables.     (line   42)
* Command execution:                     Fixed date options. (line   73)
* Command line argument:                 Glossary.           (line  127)
* Command line argument %DATE:           Actual date modifier.
                                                             (line    6)
* Command line argument @FILE:           Response file.      (line    6)
* Command line interpreter <1>:          Shell Command.      (line    6)
* Command line interpreter <2>:          Text variables.     (line   97)
* Command line interpreter <3>:          Fixed date options. (line  342)
* Command line interpreter:              Invoking Gcal.      (line   11)
* 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  582)
* Command line, arguments:               Command line arguments.
                                                             (line    6)
* Command separator characters:          Commands.           (line   37)
* Command separator characters, table:   Commands.           (line   37)
* 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 <1>:                  Single commands.    (line    6)
* Commands, single:                      Commands.           (line    6)
* Comment character, ; <1>:              Comment line.       (line    6)
* Comment character, ;:                  Response file.      (line   21)
* Comment line in resource file <1>:     Comment line.       (line    6)
* Comment line in resource file:         Structure of resource file.
                                                             (line   46)
* Common option class <1>:               Glossary.           (line  135)
* Common option class:                   Options.            (line   13)
* Common options:                        Common options.     (line    6)
* Complemented character list:           Glossary.           (line  487)
* Complemented character list, [^ ...] regexp: Regexp Operators.
                                                             (line  160)
* Complemented character list, regexp:   Regexp Operators.   (line  160)
* Complemented regular expression:       Fixed date options. (line  416)
* Complete month name %U[DATE] special text <1>: Special Texts Summary.
                                                             (line  174)
* Complete month name %U[DATE] special text: Month name.     (line    7)
* Complete weekday name %K[DATE] special text <1>: Special Texts Summary.
                                                             (line   92)
* Complete weekday name %K[DATE] special text: Weekday name. (line    7)
* Conjunction:                           Glossary.           (line  139)
* Conjunction, Moon:                     Moon data.          (line   37)
* Continue line in resource file:        Text part of a line.
                                                             (line   29)
* Control character sequence:            Global options.     (line  107)
* Copyleft:                              Common options.     (line   33)
* Copyright:                             Common options.     (line   33)
* Country code <1>:                      Internationalization.
                                                             (line  122)
* Country code:                          Calendar options.   (line  148)
* Country specific holidays in eternal holiday list: Calendar options.
                                                             (line  143)
* Country specific special characters:   Calendar options.   (line 1718)
* Course angle:                          Glossary.           (line  707)
* Course angle (true track) %b*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  289)
* Course angle (true track) %b*1ARGUMENT special text: Geographical distance and course angle.
                                                             (line   29)
* Course angle (true track) %b*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  297)
* Course angle (true track) %b*2ARGUMENT special text: Geographical distance and course angle.
                                                             (line   44)
* Course angle (true track) %b1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  285)
* Course angle (true track) %b1ARGUMENT special text: Geographical distance and course angle.
                                                             (line   29)
* Course angle (true track) %b2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  293)
* Course angle (true track) %b2ARGUMENT special text: Geographical distance and course angle.
                                                             (line   44)
* Critical day:                          Glossary.           (line  144)
* Critical day, biorhythm:               Biorhythm.          (line   21)
* 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  283)
* Cycle ending time value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  222)
* Cycle mode <1>:                        Glossary.           (line  150)
* Cycle mode:                            Fixed date options. (line  222)
* Cycle timestep value for Sun and Moon data and times, set: Fixed date options.
                                                             (line  283)
* Date exclusion %?... special texts:    Exclusions.         (line    6)
* Date format elements <1>:              Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date format elements:                  Calendar options.   (line 1656)
* Date format texts, fixed default <1>:  Table of Obsolete Date Formats.
                                                             (line    6)
* Date format texts, fixed default:      Calendar options.   (line 1628)
* Date format texts, individual <1>:     Table of Obsolete Date Format Elements.
                                                             (line    6)
* Date format texts, individual:         Calendar options.   (line 1647)
* Date formats:                          Calendar options.   (line 1628)
* Date formats, fixed default:           Calendar options.   (line 1628)
* Date formats, individual:              Calendar options.   (line 1647)
* Date part:                             Glossary.           (line  156)
* Date part of a resource file line:     Date part of a line.
                                                             (line    6)
* Date part, appearance factor of days:  Appearance factor of days.
                                                             (line    6)
* Date part, further attributes:         Further date part attributes.
                                                             (line    6)
* Date part, lists of days:              Lists of days.      (line    6)
* Date part, ranges of days:             Ranges of days.     (line    6)
* Date part, repetition factor of days:  Repetition factor of days.
                                                             (line    6)
* Date part, structure:                  Date part of a line.
                                                             (line    6)
* Date part, validity of omission values: Date part of a line.
                                                             (line  146)
* Date variables:                        Date variables.     (line    6)
* Date variables, addition by days:      Date variables.     (line  124)
* Date variables, addition by weekdays:  Date variables.     (line  126)
* Date variables, assignments <1>:       Date variables.     (line    6)
* Date variables, assignments <2>:       Structure of resource file.
                                                             (line   57)
* Date variables, assignments:           Fixed date options. (line    8)
* Date variables, definition <1>:        Date variables.     (line    6)
* Date variables, definition:            Fixed date options. (line    8)
* Date variables, export of local <1>:   Date variables.     (line  104)
* Date variables, export of local:       Fixed date options. (line   29)
* Date variables, global <1>:            Date variables.     (line    6)
* Date variables, global:                Fixed date options. (line    8)
* Date variables, local:                 Date variables.     (line    6)
* Date variables, management <1>:        Date variables.     (line    6)
* Date variables, management:            Fixed date options. (line    8)
* Date variables, name space <1>:        Date variables.     (line   55)
* Date variables, name space:            Fixed date options. (line    8)
* Date variables, operations <1>:        Date variables.     (line  118)
* Date variables, operations <2>:        Structure of resource file.
                                                             (line   57)
* Date variables, operations:            Fixed date options. (line    8)
* Date variables, scope <1>:             Date variables.     (line  129)
* Date variables, scope:                 Fixed date options. (line    8)
* Date variables, simple decrement:      Date variables.     (line  123)
* Date variables, simple increment:      Date variables.     (line  122)
* Date variables, subtraction by days:   Date variables.     (line  125)
* Date variables, subtraction by weekdays: Date variables.   (line  127)
* Date variables, total number:          Date variables.     (line    6)
* Date variables, visibility:            Date variables.     (line   55)
* Date variables, visibility of local <1>: Date variables.   (line  104)
* Date variables, visibility of local:   Fixed date options. (line   29)
* Day number %>02&*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  165)
* Day number %>02&*D[DATE] special text: Day number.         (line   30)
* Day number %>02*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  159)
* Day number %>02*D[DATE] special text:  Day number.         (line   14)
* Day number %>1&*D[DATE] special text <1>: Special Texts Summary.
                                                             (line  162)
* Day number %>1&*D[DATE] special text:  Day number.         (line   22)
* Day number %[FORMAT]D[DATE] special text <1>: Special Texts Summary.
                                                             (line  154)
* Day number %[FORMAT]D[DATE] special text: Day number.      (line    6)
* Day number %[FORMAT]N[DATE] special text: Special Texts Summary.
                                                             (line  139)
* Day number %D[DATE] special text <1>:  Special Texts Summary.
                                                             (line  156)
* Day number %D[DATE] special text:      Day number.         (line    7)
* 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   32)
* Day-of-year number %>03*N[DATE] special text <1>: Special Texts Summary.
                                                             (line  144)
* Day-of-year number %>03*N[DATE] special text: Day-of-year number.
                                                             (line   15)
* Day-of-year number %>1&*N[DATE] special text <1>: Special Texts Summary.
                                                             (line  147)
* Day-of-year number %>1&*N[DATE] special text: Day-of-year number.
                                                             (line   24)
* Day-of-year number %[FORMAT]N[DATE] special text: Day-of-year number.
                                                             (line    6)
* Day-of-year number %N[DATE] special text <1>: Special Texts Summary.
                                                             (line  141)
* Day-of-year number %N[DATE] special text: Day-of-year number.
                                                             (line    7)
* Daylight Savings:                      Sun data.           (line 1058)
* Decimal system:                        Glossary.           (line  160)
* Declination:                           Glossary.           (line  163)
* Declination, Moon:                     Moon data.          (line  313)
* Declination, Sun:                      Sun data.           (line  372)
* Default mode, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   48)
* Default mode, Moon data and times:     Moon data.          (line  793)
* Default mode, Sun data and times:      Sun data.           (line  864)
* Defaults of native language:           Internationalization.
                                                             (line   53)
* Definition of date variables <1>:      Date variables.     (line    6)
* Definition of date variables:          Fixed date options. (line    8)
* Definition of global date variables:   Fixed date options. (line    8)
* Definition of global text variables:   Fixed date options. (line   35)
* Definition of local date variables:    Date variables.     (line    6)
* Definition of local text variables:    Text variables.     (line    6)
* Definition of text variables <1>:      Text variables.     (line    6)
* Definition of text variables:          Fixed date options. (line   35)
* Deletion of local date variables:      Date variables.     (line   75)
* Delta-t:                               Glossary.           (line  167)
* Delta-t, Moon:                         Moon data.          (line  428)
* Delta-t, Sun:                          Sun data.           (line  460)
* Depreciation character, \ <1>:         Other difference values.
                                                             (line   11)
* Depreciation character, \ <2>:         Text variables.     (line   91)
* Depreciation character, \ <3>:         Special Texts processed.
                                                             (line    6)
* Depreciation character, \ <4>:         Text part of a line.
                                                             (line   52)
* Depreciation character, \:             Fixed date options. (line  101)
* Depreciation of special characters <1>: Other difference values.
                                                             (line   11)
* Depreciation of special characters <2>: Text variables.    (line   91)
* Depreciation of special characters <3>: Special Texts processed.
                                                             (line    6)
* Depreciation of special characters <4>: Text part of a line.
                                                             (line   52)
* Depreciation of special characters <5>: Response file.     (line    6)
* Depreciation of special characters <6>: Fixed date options.
                                                             (line  101)
* Depreciation of special characters:    Command line arguments.
                                                             (line   28)
* 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 1356)
* Difference value %[FORMAT]? special texts <1>: Special Texts Summary.
                                                             (line 1844)
* Difference value %[FORMAT]? special texts: Other difference values.
                                                             (line    6)
* Difference value %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  222)
* Difference value %[FORMAT]?[DATE] special texts: Difference value.
                                                             (line    6)
* Direction to Makkah, Islamic prayer:   Geographical distance and course angle.
                                                             (line   84)
* 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  853)
* Double shadow length at afternoon:     Sun data.           (line  837)
* Double shadow length at forenoon:      Sun data.           (line  828)
* Early years:                           Glossary.           (line  173)
* Earth equator radius, unit:            Moon data.          (line  350)
* Earth's atmosphere, set air pressure:  Fixed date options. (line  152)
* Earth's atmosphere, set base data to calculate refraction: Fixed date options.
                                                             (line  152)
* Earth's atmosphere, set temperature:   Fixed date options. (line  152)
* Eastern churches' leap year rule, use: Calendar options.   (line 1322)
* Eclipse, lunar:                        Calendar options.   (line   48)
* Eclipse, solar:                        Calendar options.   (line   48)
* Ecliptic <1>:                          Glossary.           (line  186)
* Ecliptic <2>:                          Moon data.          (line  324)
* Ecliptic:                              Sun data.           (line  382)
* Ecliptic latitude:                     Glossary.           (line  178)
* Ecliptic latitude, Moon:               Moon data.          (line  332)
* Ecliptic longitude:                    Glossary.           (line  182)
* Ecliptic longitude, Moon:              Moon data.          (line  324)
* Ecliptic longitude, Sun:               Sun data.           (line  382)
* Electronic Mail:                       Global options.     (line  183)
* Elevation, Moon:                       Moon data.          (line  299)
* Elevation, Sun:                        Sun data.           (line  344)
* Elongation:                            Glossary.           (line  189)
* Elongation, Moon:                      Moon data.          (line  356)
* EMail, empty message body:             Global options.     (line  209)
* EMail, error code:                     Error Codes.        (line    6)
* EMail, methods of sending:             Global options.     (line  188)
* EMail, option:                         Global options.     (line  183)
* Empty local text variables:            Text variables.     (line   56)
* Empty message body in Mail:            Global options.     (line  209)
* End of highlighting sequence 1 %2 special text <1>: Special Texts Summary.
                                                             (line 1863)
* End of highlighting sequence 1 %2 special text: Highlighting.
                                                             (line   28)
* End of highlighting sequence 1 %6 special text <1>: Special Texts Summary.
                                                             (line 1876)
* End of highlighting sequence 1 %6 special text: Highlighting.
                                                             (line   78)
* End of highlighting sequence 1 or 2 %0 special text <1>: Special Texts Summary.
                                                             (line 1893)
* End of highlighting sequence 1 or 2 %0 special text: Highlighting.
                                                             (line  126)
* End of highlighting sequence 2 %4 special text <1>: Special Texts Summary.
                                                             (line 1869)
* End of highlighting sequence 2 %4 special text: Highlighting.
                                                             (line   56)
* End of highlighting sequence 2 %8 special text <1>: Special Texts Summary.
                                                             (line 1884)
* End of highlighting sequence 2 %8 special text: Highlighting.
                                                             (line  100)
* Ending date:                           Glossary.           (line  193)
* Ending date of fixed date <1>:         Exclusive date period.
                                                             (line   32)
* Ending date of fixed date:             Inclusive date period.
                                                             (line   31)
* Environment:                           Glossary.           (line  197)
* Environment variable %[FORMAT]-[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line 1841)
* Environment variable %[FORMAT]-[ARGUMENT] special text: Contents of Environment variable.
                                                             (line    6)
* Environment variable, COLUMNS:         Environment Variables.
                                                             (line   14)
* Environment variable, GCAL <1>:        Environment Variables.
                                                             (line   10)
* Environment variable, GCAL <2>:        The GCAL environment variable.
                                                             (line    6)
* Environment variable, GCAL:            Global options.     (line    8)
* 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 <1>:    Environment Variables.
                                                             (line   10)
* Environment variable, GCAL_OPT:        The GCAL environment variable.
                                                             (line   24)
* Environment variable, GCAL_SYS_DATADIR <1>: Environment Variables.
                                                             (line   30)
* Environment variable, GCAL_SYS_DATADIR: Resource file.     (line   50)
* Environment variable, GCAL_USR_DATADIR <1>: Environment Variables.
                                                             (line   35)
* Environment variable, GCAL_USR_DATADIR: Resource file.     (line   38)
* Environment variable, GCALANSI <1>:    Environment Variables.
                                                             (line   41)
* Environment variable, GCALANSI:        Global options.     (line  176)
* Environment variable, GCALPATH <1>:    Environment Variables.
                                                             (line   47)
* Environment variable, GCALPATH:        Resource file.      (line   24)
* Environment variable, GCALPROG <1>:    Environment Variables.
                                                             (line   52)
* Environment variable, GCALPROG:        Invoking tcal.      (line   20)
* Environment variable, HOME <1>:        Environment Variables.
                                                             (line   61)
* Environment variable, HOME:            Resource file.      (line   32)
* Environment variable, LANG <1>:        Environment Variables.
                                                             (line   80)
* Environment variable, LANG:            Internationalization.
                                                             (line   33)
* Environment variable, LANGUAGE <1>:    Environment Variables.
                                                             (line   66)
* Environment variable, LANGUAGE:        Internationalization.
                                                             (line   30)
* Environment variable, LC_ALL <1>:      Environment Variables.
                                                             (line   71)
* Environment variable, LC_ALL:          Internationalization.
                                                             (line   31)
* Environment variable, LC_MESSAGES <1>: Environment Variables.
                                                             (line   76)
* Environment variable, LC_MESSAGES:     Internationalization.
                                                             (line   32)
* Environment variable, LINES:           Environment Variables.
                                                             (line   25)
* Environment variable, LOGNAME <1>:     Environment Variables.
                                                             (line   84)
* Environment variable, LOGNAME:         Global options.     (line  201)
* Environment variable, MAILPROG <1>:    Environment Variables.
                                                             (line   88)
* Environment variable, MAILPROG:        Global options.     (line  223)
* Environment variable, MAILTO <1>:      Environment Variables.
                                                             (line   94)
* Environment variable, MAILTO:          Global options.     (line  191)
* Environment variable, PAGER <1>:       Environment Variables.
                                                             (line   99)
* Environment variable, PAGER:           Global options.     (line   48)
* Environment variable, PATH <1>:        Environment Variables.
                                                             (line  104)
* Environment variable, PATH:            Global options.     (line   53)
* Environment variable, TERM:            Environment Variables.
                                                             (line  109)
* Environment variable, TXT2GCALPROG <1>: Environment Variables.
                                                             (line  112)
* Environment variable, TXT2GCALPROG:    Text variables.     (line  112)
* Environment variable, TZ:              Environment Variables.
                                                             (line  122)
* Environment variable, USER <1>:        Environment Variables.
                                                             (line  126)
* Environment variable, USER:            Global options.     (line  196)
* Environment variables, table:          Environment Variables.
                                                             (line    6)
* Ephemeris date, Julian <1>:            Moon data.          (line  465)
* Ephemeris date, Julian:                Sun data.           (line  497)
* Ephemeris time (ET) <1>:               Moon data.          (line  428)
* Ephemeris time (ET):                   Sun data.           (line  460)
* Equation of time <1>:                  Glossary.           (line  204)
* Equation of time:                      Sun data.           (line  501)
* Equinox, autumnal:                     Calendar options.   (line   48)
* Equinox, vernal:                       Calendar options.   (line   48)
* Equivalence class:                     Glossary.           (line  208)
* Equivalence classes, [=LIST=] regexp:  Regexp Operators.   (line  147)
* Equivalence classes, regexp:           Regexp Operators.   (line  147)
* Error code 1:                          Fixed date options. (line  430)
* Error code 113:                        Date variables.     (line   55)
* Error code 118:                        Resource file.      (line   62)
* Error code 119:                        Include directives. (line   51)
* Error code 126:                        Fixed date options. (line  957)
* Error code 127:                        Common options.     (line   41)
* Error code 2 <1>:                      Shell Command.      (line   18)
* Error code 2:                          Text variables.     (line  134)
* Error code of executed commands:       Shell Command.      (line    6)
* Error codes, table:                    Error Codes.        (line    6)
* Escape sequence <1>:                   Glossary.           (line  212)
* Escape sequence:                       Global options.     (line  107)
* Eternal holiday list, alternative date format: Calendar options.
                                                             (line 1435)
* 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  143)
* 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 1207)
* Eternal holiday list, months from flexible Chinese calendar: Calendar options.
                                                             (line 1213)
* Eternal holiday list, months from flexible Japanese calendar: Calendar options.
                                                             (line 1258)
* Eternal holiday list, months from the Chinese calendar: Calendar options.
                                                             (line 1220)
* Eternal holiday list, months from the civil Indian calendar: Calendar options.
                                                             (line 1246)
* Eternal holiday list, months from the civil Islamic calendar: Calendar options.
                                                             (line 1251)
* Eternal holiday list, months from the Coptic calendar: Calendar options.
                                                             (line 1226)
* Eternal holiday list, months from the Ethiopic calendar: Calendar options.
                                                             (line 1231)
* Eternal holiday list, months from the French Revolutionary calendar: Calendar options.
                                                             (line 1236)
* Eternal holiday list, months from the Hebrew calendar: Calendar options.
                                                             (line 1241)
* Eternal holiday list, months from the Japanese calendar: Calendar options.
                                                             (line 1265)
* Eternal holiday list, months from the Old-Armenic calendar: Calendar options.
                                                             (line 1271)
* Eternal holiday list, months from the Old-Egyptic calendar: Calendar options.
                                                             (line 1276)
* Eternal holiday list, months from the Persian Jalaali calendar: Calendar options.
                                                             (line 1281)
* 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  114)
* Eternal holiday list, Orthodox old calendar holidays: Calendar options.
                                                             (line  121)
* Eternal holiday list, Persian Jalaali holidays: Calendar options.
                                                             (line  128)
* Eternal holiday list, special date format: Calendar options.
                                                             (line 1442)
* Eternal holiday list, standard and special date format: Calendar options.
                                                             (line 1448)
* 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  134)
* Eternal Holidays:                      Eternal Holidays.   (line    6)
* Evening width:                         Glossary.           (line  218)
* Evening width geocentric, Sun:         Sun data.           (line  783)
* Evening width topocentric, Sun:        Sun data.           (line  738)
* Event oriented texts of Moon data and times, special: Sun data.
                                                             (line  917)
* Event oriented texts of Sun data and times, special: Sun data.
                                                             (line  917)
* 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   57)
* 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 <1>: Special Texts Summary.
                                                             (line   60)
* Exclusive all holidays %X special text: Exclusive day period.
                                                             (line   14)
* Exclusive date period <1>:             Glossary.           (line  223)
* Exclusive date period:                 Exclusions with date argument.
                                                             (line   11)
* Exclusive date period %e[DATE][#[DATE]] special text <1>: Special Texts Summary.
                                                             (line   17)
* Exclusive date period %e[DATE][#[DATE]] special text: Exclusive date period.
                                                             (line    6)
* Exclusive day period <1>:              Glossary.           (line  223)
* Exclusive day period:                  Exclusions without any argument.
                                                             (line   11)
* Exclusive day period %? special texts <1>: Special Texts Summary.
                                                             (line   55)
* Exclusive day period %? special texts: Exclusive day period.
                                                             (line    6)
* Exclusive Friday %H special text <1>:  Special Texts Summary.
                                                             (line   75)
* Exclusive Friday %H special text:      Exclusive day period.
                                                             (line   30)
* Exclusive legal holidays %V special text <1>: Special Texts Summary.
                                                             (line   57)
* Exclusive legal holidays %V special text: Exclusive day period.
                                                             (line   10)
* Exclusive Monday %A special text <1>:  Special Texts Summary.
                                                             (line   63)
* Exclusive Monday %A special text:      Exclusive day period.
                                                             (line   18)
* Exclusive Monday...Friday %R special text <1>: Special Texts Summary.
                                                             (line   87)
* Exclusive Monday...Friday %R special text: Exclusive day period.
                                                             (line   42)
* Exclusive Monday...Thursday %Q special text <1>: Special Texts Summary.
                                                             (line   84)
* Exclusive Monday...Thursday %Q special text: Exclusive day period.
                                                             (line   39)
* Exclusive Saturday %L special text <1>: Special Texts Summary.
                                                             (line   78)
* Exclusive Saturday %L special text:    Exclusive day period.
                                                             (line   33)
* Exclusive Sunday %P special text <1>:  Special Texts Summary.
                                                             (line   81)
* Exclusive Sunday %P special text:      Exclusive day period.
                                                             (line   36)
* Exclusive Thursday %G special text <1>: Special Texts Summary.
                                                             (line   72)
* Exclusive Thursday %G special text:    Exclusive day period.
                                                             (line   27)
* Exclusive Tuesday %C special text <1>: Special Texts Summary.
                                                             (line   66)
* Exclusive Tuesday %C special text:     Exclusive day period.
                                                             (line   21)
* Exclusive Wednesday %F special text <1>: Special Texts Summary.
                                                             (line   69)
* Exclusive Wednesday %F special text:   Exclusive day period.
                                                             (line   24)
* Execute command <1>:                   Shell Command.      (line   24)
* Execute command <2>:                   Text variables.     (line   42)
* Execute command:                       Fixed date options. (line   73)
* Executed commands, error code:         Shell Command.      (line    6)
* Executed commands, exit code:          Shell Command.      (line    6)
* Exit code 1:                           Fixed date options. (line  430)
* Exit code 113:                         Date variables.     (line   55)
* Exit code 118:                         Resource file.      (line   62)
* Exit code 119:                         Include directives. (line   51)
* Exit code 126:                         Fixed date options. (line  957)
* Exit code 127:                         Common options.     (line   41)
* Exit code 2 <1>:                       Shell Command.      (line   18)
* Exit code 2:                           Text variables.     (line  134)
* Exit code of executed commands:        Shell Command.      (line    6)
* Exit codes, table:                     Error Codes.        (line    6)
* Explicit fiscal year:                  Single commands.    (line   53)
* Export of local date variables <1>:    Date variables.     (line  104)
* Export of local date variables:        Fixed date options. (line   29)
* Export of local text variables <1>:    Text variables.     (line  279)
* Export of local text variables:        Fixed date options. (line  125)
* Extended file name <1>:                Glossary.           (line  228)
* Extended file name:                    Resource file.      (line   75)
* Extended help text:                    Common options.     (line   16)
* Extended language code information <1>: Glossary.          (line  234)
* Extended language code information:    Internationalization.
                                                             (line  122)
* External pager program:                Global options.     (line   48)
* Fajr prayer time:                      Glossary.           (line  239)
* Fajr, Islamic prayer time:             Sun data.           (line  309)
* File directory, actual:                Resource file.      (line   32)
* File name, extended:                   Resource file.      (line   75)
* File name, simple:                     Resource file.      (line   85)
* File searching mechanism:              Resource file.      (line    6)
* Filtration, days of fixed dates:       Fixed date options. (line  353)
* Filtration, fixed date texts:          Fixed date options. (line  386)
* Filtration, periods of fixed dates:    Fixed date options. (line  368)
* Fiscal year, explicit:                 Single commands.    (line   53)
* Fiscal year, implicit:                 Single commands.    (line   46)
* Fiscal year, limitations <1>:          Date variables.     (line   49)
* Fiscal year, limitations:              Further date part attributes.
                                                             (line   29)
* Fiscal year, single:                   Single commands.    (line   46)
* 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  424)
* Fixed date list, alternative date format: Calendar options.
                                                             (line 1453)
* Fixed date list, special date format:  Calendar options.   (line 1460)
* Fixed date list, standard and special date format: Calendar options.
                                                             (line 1466)
* Fixed date list, suppression of leading blank line: Fixed date options.
                                                             (line  778)
* Fixed date list, suppression of title text: Fixed date options.
                                                             (line  808)
* Fixed date option class <1>:           Glossary.           (line  243)
* Fixed date option class:               Options.            (line   13)
* Fixed date option, --heading-text=TEXT: Fixed date options.
                                                             (line  811)
* Fixed date options:                    Fixed date options. (line    6)
* Fixed date period long-style option, --end-of-month: Fixed date options.
                                                             (line 1380)
* Fixed date period long-style option, --end-of-week: Fixed date options.
                                                             (line 1342)
* Fixed date period long-style option, --end-of-year: Fixed date options.
                                                             (line 1417)
* Fixed date period long-style option, --month: Fixed date options.
                                                             (line 1380)
* Fixed date period long-style option, --start-of-month: Fixed date options.
                                                             (line 1380)
* Fixed date period long-style option, --start-of-week: Fixed date options.
                                                             (line 1342)
* Fixed date period long-style option, --start-of-year: Fixed date options.
                                                             (line 1417)
* Fixed date period long-style option, --today: Fixed date options.
                                                             (line  424)
* Fixed date period long-style option, --tomorrow: Fixed date options.
                                                             (line 1330)
* Fixed date period long-style option, --week: Fixed date options.
                                                             (line 1342)
* Fixed date period long-style option, --year: Fixed date options.
                                                             (line 1417)
* Fixed date period modifier, *dN:       Fixed date options. (line  895)
* Fixed date period modifier, *dNWWW:    Fixed date options. (line 1029)
* Fixed date period modifier, *wN[WWW]:  Fixed date options. (line 1081)
* Fixed date period modifier, 0MMDD:     Fixed date options. (line  993)
* Fixed date period modifier, @DVAR[+|-]NWWW: Fixed date options.
                                                             (line 1302)
* Fixed date period modifier, @DVAR[[+|-]N]: Fixed date options.
                                                             (line 1269)
* Fixed date period modifier, @e[+|-]NWWW: Fixed date options.
                                                             (line 1188)
* Fixed date period modifier, @e[[+|-]N]: Fixed date options.
                                                             (line 1155)
* Fixed date period modifier, @t[+|-]NWWW: Fixed date options.
                                                             (line 1243)
* Fixed date period modifier, @t[[+|-]N]: Fixed date options.
                                                             (line 1214)
* Fixed date period modifier, d:         Fixed date options. (line  579)
* Fixed date period modifier, l:         Fixed date options. (line  579)
* Fixed date period modifier, l*dN:      Fixed date options. (line  907)
* Fixed date period modifier, l*dNWWW:   Fixed date options. (line 1052)
* Fixed date period modifier, l*wN[WWW]: Fixed date options. (line 1115)
* Fixed date period modifier, l@DVAR[+|-]NWWW: Fixed date options.
                                                             (line 1314)
* Fixed date period modifier, l@DVAR[[+|-]N]: Fixed date options.
                                                             (line 1284)
* Fixed date period modifier, l@e[+|-]NWWW: Fixed date options.
                                                             (line 1200)
* Fixed date period modifier, l@e[[+|-]N]: Fixed date options.
                                                             (line 1170)
* Fixed date period modifier, l@t[+|-]NWWW: Fixed date options.
                                                             (line 1255)
* Fixed date period modifier, l@t[[+|-]N]: Fixed date options.
                                                             (line 1228)
* Fixed date period modifier, lMMWWWN:   Fixed date options. (line 1015)
* Fixed date period modifier, lN+|-:     Fixed date options. (line  926)
* Fixed date period modifier, lNd:       Fixed date options. (line  907)
* Fixed date period modifier, lNw:       Fixed date options. (line  968)
* Fixed date period modifier, MMDD:      Fixed date options. (line  986)
* Fixed date period modifier, MMWWWN:    Fixed date options. (line 1004)
* Fixed date period modifier, m|M[+|-]:  Fixed date options. (line 1380)
* Fixed date period modifier, N+|-:      Fixed date options. (line  916)
* Fixed date period modifier, Nd:        Fixed date options. (line  895)
* Fixed date period modifier, Nw:        Fixed date options. (line  938)
* Fixed date period modifier, t|T:       Fixed date options. (line 1330)
* Fixed date period modifier, w|W[+|-]:  Fixed date options. (line 1342)
* Fixed date period modifier, y|Y[+|-]:  Fixed date options. (line 1417)
* Fixed date period modifiers and options: Fixed date options.
                                                             (line  860)
* Fixed date period option, --leap-day=february: Fixed date options.
                                                             (line  867)
* Fixed date period option, --leap-day=february|march: Fixed date options.
                                                             (line  579)
* Fixed date period option, --leap-day=march: Fixed date options.
                                                             (line  872)
* Fixed date text modifier, A:           Fixed date options. (line  675)
* Fixed date text modifier, a:           Fixed date options. (line  666)
* Fixed date text modifier, alternative list format: Fixed date options.
                                                             (line  675)
* Fixed date text modifier, E:           Fixed date options. (line  695)
* Fixed date text modifier, e:           Fixed date options. (line  690)
* Fixed date text modifier, g[TEXT]:     Fixed date options. (line  700)
* Fixed date text modifier, J:           Fixed date options. (line  798)
* Fixed date text modifier, k:           Fixed date options. (line  757)
* Fixed date text modifier, o:           Fixed date options. (line  766)
* Fixed date text modifier, Q:           Fixed date options. (line  778)
* Fixed date text modifier, U:           Fixed date options. (line  788)
* Fixed date text modifier, x:           Fixed date options. (line  808)
* Fixed date text modifier, Z:           Fixed date options. (line  857)
* Fixed date text modifier, z:           Fixed date options. (line  853)
* Fixed date text modifiers:             Fixed date options. (line  612)
* Fixed date text option, --biorhythm-axis=NUMBER: Fixed date options.
                                                             (line  615)
* Fixed date text option, --moonimage-lines=NUMBER: Fixed date options.
                                                             (line  643)
* Fixed date texts, filtration:          Fixed date options. (line  386)
* Fixed date, ending date <1>:           Exclusive date period.
                                                             (line   32)
* Fixed date, ending date:               Inclusive date period.
                                                             (line   31)
* Fixed date, line structure:            Structure of resource file.
                                                             (line   31)
* Fixed date, option:                    Fixed date options. (line  424)
* Fixed date, starting date <1>:         Exclusive date period.
                                                             (line   12)
* Fixed date, starting date:             Inclusive date period.
                                                             (line   11)
* Fixed dates <1>:                       Fixed Dates.        (line    6)
* Fixed dates:                           Fixed date options. (line  424)
* Fixed dates for _today_:               Fixed date options. (line  424)
* Fixed dates for _tomorrow_:            Fixed date options. (line 1330)
* Fixed dates for the _month_:           Fixed date options. (line 1380)
* Fixed dates for the _week_:            Fixed date options. (line 1342)
* Fixed dates for the _year_:            Fixed date options. (line 1417)
* Fixed dates, filtration of days:       Fixed date options. (line  353)
* Fixed dates, filtration of periods:    Fixed date options. (line  368)
* Fixed default date format texts <1>:   Table of Obsolete Date Formats.
                                                             (line    6)
* Fixed default date format texts:       Calendar options.   (line 1628)
* Fixed default date formats:            Calendar options.   (line 1628)
* Fixed format date text:                Textual date.       (line    6)
* Floating Point number:                 Glossary.           (line  554)
* Force line break-up:                   Fixed date options. (line  735)
* Force line break-up in resource file:  Text part of a line.
                                                             (line   42)
* Force year calendar sheet:             Calendar options.   (line 1386)
* Forcing highlighting sequences:        Global options.     (line   91)
* Format elements <1>:                   Table of Obsolete Date Formats.
                                                             (line    6)
* Format elements:                       Calendar options.   (line 1656)
* Format elements, obsolete:             Obsolete Special Texts.
                                                             (line    6)
* Format instruction <1>:                Glossary.           (line  246)
* Format instruction <2>:                Special Texts.      (line   20)
* Format instruction <3>:                Text variables.     (line   60)
* Format instruction <4>:                Special Texts processed.
                                                             (line    6)
* Format instruction:                    Calendar options.   (line 1656)
* 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  512)
* GCAL environment variable <1>:         Environment Variables.
                                                             (line   10)
* GCAL environment variable <2>:         The GCAL environment variable.
                                                             (line    6)
* GCAL environment variable:             Global options.     (line    8)
* 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)
* 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 <1>:     Environment Variables.
                                                             (line   10)
* GCAL_OPT environment variable:         The GCAL environment variable.
                                                             (line   24)
* GCAL_SYS_DATADIR environment variable <1>: Environment Variables.
                                                             (line   30)
* GCAL_SYS_DATADIR environment variable: Resource file.      (line   50)
* GCAL_USR_DATADIR environment variable <1>: Environment Variables.
                                                             (line   35)
* GCAL_USR_DATADIR environment variable: Resource file.      (line   38)
* GCALANSI environment variable <1>:     Environment Variables.
                                                             (line   41)
* GCALANSI environment variable:         Global options.     (line  176)
* GCALPATH environment variable <1>:     Environment Variables.
                                                             (line   47)
* GCALPATH environment variable:         Resource file.      (line   24)
* GCALPROG environment variable <1>:     Environment Variables.
                                                             (line   52)
* GCALPROG environment variable:         Invoking tcal.      (line   20)
* General Public License:                Glossary.           (line  293)
* Geocentric data:                       Glossary.           (line  258)
* Geocentric data, Moon:                 Moon data.          (line  256)
* Geocentric data, Sun:                  Sun data.           (line  344)
* Geocentrical horizon:                  Glossary.           (line  262)
* Geographical data, more precise representation: Fixed date options.
                                                             (line  330)
* Geographical distance %b*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  282)
* Geographical distance %b*0ARGUMENT special text: Geographical distance and course angle.
                                                             (line   17)
* Geographical distance %b0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  279)
* Geographical distance %b0ARGUMENT special text: Geographical distance and course angle.
                                                             (line   17)
* Geographical distance and course angle %[FORMAT]b[ARGUMENT] special text: Geographical distance and course angle.
                                                             (line    6)
* Geographical distance and course angle %[FORMAT]bARGUMENT special texts: Special Texts Summary.
                                                             (line  277)
* Geographical distance and course angle, default mode: Geographical distance and course angle.
                                                             (line   48)
* Geographical distance and course angle, mode characters: Geographical distance and course angle.
                                                             (line   15)
* Geographical distance and course angle, style of representation: Geographical distance and course angle.
                                                             (line   15)
* Geometric horizon, Moon:               Moon data.          (line   69)
* Geometrical horizon:                   Glossary.           (line  268)
* Global date variable:                  Glossary.           (line  273)
* Global date variables, definition:     Fixed date options. (line    8)
* Global option class <1>:               Glossary.           (line  277)
* Global option class:                   Options.            (line   13)
* Global options:                        Global options.     (line    6)
* Global text variable:                  Glossary.           (line  280)
* Global text variables, definition:     Fixed date options. (line   35)
* Glossary:                              Glossary.           (line    6)
* Gnomon <1>:                            Glossary.           (line  284)
* Gnomon:                                Sun data.           (line   49)
* GNU:                                   Glossary.           (line  287)
* GNU specific regexp operators:         Regexp Operators.   (line  249)
* GNU style options:                     Options.            (line   21)
* GPL:                                   Glossary.           (line  293)
* Greenwich Mean time (GMT) <1>:         Moon data.          (line  450)
* Greenwich Mean time (GMT) <2>:         Sun data.           (line  482)
* Greenwich Mean time (GMT) <3>:         Julian day number.  (line    6)
* Greenwich Mean time (GMT) <4>:         Actual clocktime.   (line    6)
* Greenwich Mean time (GMT) <5>:         Moon phase.         (line    6)
* Greenwich Mean time (GMT):             Calendar options.   (line 1492)
* Gregorian calendar:                    Glossary.           (line  296)
* Gregorian calendar, genesis:           Todays Calendar.    (line    6)
* Gregorian Reformation, set period:     Calendar options.   (line 1556)
* Grouping, (...) regexp:                Regexp Operators.   (line  184)
* 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)
* Hexadecimal system:                    Glossary.           (line  301)
* Highest culmination point:             Glossary.           (line  306)
* Highest culmination point, Moon:       Moon data.          (line   57)
* Highest culmination point, Sun:        Sun data.           (line   49)
* Highlighting %? special texts <1>:     Special Texts Summary.
                                                             (line 1858)
* Highlighting %? special texts:         Highlighting.       (line    6)
* Highlighting sequence:                 Glossary.           (line  310)
* 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  142)
* 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 <1>:         Environment Variables.
                                                             (line   61)
* HOME environment variable:             Resource file.      (line   32)
* Horizontal parallax:                   Glossary.           (line  317)
* Horizontal parallax, moon:             Moon data.          (line  256)
* Horizontal parallax, Sun:              Sun data.           (line  404)
* How to use regular expressions:        Regexp Usage.       (line    6)
* Hybrid calendar mode <1>:              Glossary.           (line  321)
* Hybrid calendar mode:                  Calendar options.   (line 1556)
* Ignoring case distinctions in regular expression <1>: Regexp Operators.
                                                             (line  311)
* Ignoring case distinctions in regular expression: Fixed date options.
                                                             (line  411)
* Ignoring case, regexp <1>:             Regexp Operators.   (line  311)
* Ignoring case, regexp:                 Fixed date options. (line  411)
* Implicit fiscal year:                  Single commands.    (line   46)
* Include directives <1>:                Include directives. (line    6)
* Include directives:                    Structure of resource file.
                                                             (line   52)
* Inclusive all holidays %x special text <1>: Special Texts Summary.
                                                             (line   25)
* Inclusive all holidays %x special text: Inclusive day period.
                                                             (line   14)
* Inclusive date period <1>:             Glossary.           (line  329)
* Inclusive date period:                 Exclusions with date argument.
                                                             (line   11)
* Inclusive date period %i[DATE][#[DATE]] special text <1>: Special Texts Summary.
                                                             (line   14)
* Inclusive date period %i[DATE][#[DATE]] special text: Inclusive date period.
                                                             (line    6)
* Inclusive day period <1>:              Glossary.           (line  329)
* Inclusive day period:                  Exclusions without any argument.
                                                             (line   11)
* Inclusive day period %? special texts <1>: Special Texts Summary.
                                                             (line   20)
* Inclusive day period %? special texts: Inclusive day period.
                                                             (line    6)
* Inclusive Friday %h special text <1>:  Special Texts Summary.
                                                             (line   40)
* Inclusive Friday %h special text:      Inclusive day period.
                                                             (line   30)
* Inclusive legal holidays %v special text <1>: Special Texts Summary.
                                                             (line   22)
* Inclusive legal holidays %v special text: Inclusive day period.
                                                             (line   10)
* Inclusive Monday %a special text <1>:  Special Texts Summary.
                                                             (line   28)
* Inclusive Monday %a special text:      Inclusive day period.
                                                             (line   18)
* Inclusive Monday...Friday %r special text <1>: Special Texts Summary.
                                                             (line   52)
* Inclusive Monday...Friday %r special text: Inclusive day period.
                                                             (line   42)
* Inclusive Monday...Thursday %q special text <1>: Special Texts Summary.
                                                             (line   49)
* Inclusive Monday...Thursday %q special text: Inclusive day period.
                                                             (line   39)
* Inclusive Saturday %l special text <1>: Special Texts Summary.
                                                             (line   43)
* Inclusive Saturday %l special text:    Inclusive day period.
                                                             (line   33)
* Inclusive Sunday %p special text <1>:  Special Texts Summary.
                                                             (line   46)
* Inclusive Sunday %p special text:      Inclusive day period.
                                                             (line   36)
* Inclusive Thursday %g special text <1>: Special Texts Summary.
                                                             (line   37)
* Inclusive Thursday %g special text:    Inclusive day period.
                                                             (line   27)
* Inclusive Tuesday %c special text <1>: Special Texts Summary.
                                                             (line   31)
* Inclusive Tuesday %c special text:     Inclusive day period.
                                                             (line   21)
* Inclusive Wednesday %f special text <1>: Special Texts Summary.
                                                             (line   34)
* Inclusive Wednesday %f special text:   Inclusive day period.
                                                             (line   24)
* Individual date format texts <1>:      Table of Obsolete Date Format Elements.
                                                             (line    6)
* Individual date format texts:          Calendar options.   (line 1647)
* Individual date formats:               Calendar options.   (line 1647)
* Integer number:                        Glossary.           (line  334)
* Internal pager, simple:                Global options.     (line   60)
* Internationalization aspects:          Internationalization.
                                                             (line    6)
* Interval expression:                   Glossary.           (line  337)
* Interval expressions, regexp:          Regexp Operators.   (line  233)
* Interval expressions, {EXPRESSION} regexp: Regexp Operators.
                                                             (line  233)
* 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  340)
* Isha, Islamic prayer time:             Sun data.           (line  323)
* Islamic calendar, civil:               Preface.            (line  164)
* Islamic calendar, religious:           Preface.            (line  164)
* Islamic holidays in eternal holiday list: Calendar options.
                                                             (line   89)
* Islamic prayer time, Asr:              Sun data.           (line   49)
* Islamic prayer time, Fajr:             Sun data.           (line  309)
* Islamic prayer time, Isha:             Sun data.           (line  323)
* Islamic prayer time, Maghrib:          Sun data.           (line  195)
* Islamic prayer time, Zuhr:             Sun data.           (line   49)
* Islamic prayer, direction to Makkah:   Geographical distance and course angle.
                                                             (line   84)
* ISO:                                   Glossary.           (line  345)
* ISO week number:                       Glossary.           (line  349)
* ISO-3166 <1>:                          Internationalization.
                                                             (line  122)
* ISO-3166:                              Calendar options.   (line  148)
* ISO-639:1988:                          Internationalization.
                                                             (line   46)
* ISO-6709:1983 co-ordinate <1>:         Moon data.          (line  807)
* ISO-6709:1983 co-ordinate <2>:         Sun data.           (line 1006)
* ISO-6709:1983 co-ordinate:             Geographical distance and course angle.
                                                             (line   54)
* ISO-8601:1988 week number <1>:         Week number.        (line    7)
* ISO-8601:1988 week number <2>:         Date part of a line.
                                                             (line   57)
* ISO-8601:1988 week number <3>:         Fixed date options. (line  757)
* ISO-8601:1988 week number:             Calendar options.   (line 1363)
* Japanese calendar:                     Preface.            (line  187)
* Japanese holidays in eternal holiday list: Calendar options.
                                                             (line  101)
* Julian calendar <1>:                   Glossary.           (line  357)
* Julian calendar:                       Todays Calendar.    (line    6)
* Julian date:                           Glossary.           (line  364)
* Julian day number:                     Glossary.           (line  364)
* Julian day number %[FORMAT]j[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  274)
* Julian day number %[FORMAT]j[ARGUMENT] special text: Julian day number.
                                                             (line    6)
* Julian Ephemeris date <1>:             Glossary.           (line  354)
* Julian Ephemeris date <2>:             Moon data.          (line  465)
* Julian Ephemeris date:                 Sun data.           (line  497)
* LANG environment variable <1>:         Environment Variables.
                                                             (line   80)
* LANG environment variable:             Internationalization.
                                                             (line   33)
* Language code information, extended:   Internationalization.
                                                             (line  122)
* Language code information, simple:     Internationalization.
                                                             (line   46)
* Language codes:                        Internationalization.
                                                             (line   46)
* LANGUAGE environment variable <1>:     Environment Variables.
                                                             (line   66)
* LANGUAGE environment variable:         Internationalization.
                                                             (line   30)
* LC_ALL environment variable <1>:       Environment Variables.
                                                             (line   71)
* LC_ALL environment variable:           Internationalization.
                                                             (line   31)
* LC_MESSAGES environment variable <1>:  Environment Variables.
                                                             (line   76)
* LC_MESSAGES environment variable:      Internationalization.
                                                             (line   32)
* Leap day <1>:                          Glossary.           (line  371)
* Leap day:                              Fixed date options. (line  863)
* Leap year:                             Glossary.           (line  374)
* Leap year rule as used by Eastern Orthodox churches: Calendar options.
                                                             (line 1322)
* Legal holiday <1>:                     Glossary.           (line  384)
* Legal holiday:                         Preface.            (line  142)
* Length preserving behavior of numerical text variables: Text variables.
                                                             (line  349)
* Limit sunrise and sunset to actual day: Fixed date options.
                                                             (line  171)
* Limitations concerning the assignment of special texts to text variables: Special Texts.
                                                             (line   20)
* Limitations in a resource file <1>:    Date variables.     (line    6)
* Limitations in a resource file <2>:    Text part of a line.
                                                             (line    6)
* Limitations in a resource file <3>:    Structure of resource file.
                                                             (line    6)
* Limitations in a resource file:        Global options.     (line  213)
* Limitations in the text part of a line: Text part of a line.
                                                             (line    6)
* Limitations of use of 3-Month modes <1>: Date variables.   (line   49)
* Limitations of use of 3-Month modes:   Further date part attributes.
                                                             (line   29)
* Limitations of use of fiscal years <1>: Date variables.    (line   49)
* Limitations of use of fiscal years:    Further date part attributes.
                                                             (line   29)
* Limitations, Moon oriented special texts: Moon data.       (line  929)
* Limitations, Sun oriented special texts: Sun data.         (line 1185)
* Line break-up character, ^ <1>:        Text part of a line.
                                                             (line    6)
* Line break-up character, ^:            Fixed date options. (line  386)
* Line break-up character, ~ <1>:        Text part of a line.
                                                             (line    6)
* Line break-up character, ~:            Fixed date options. (line  386)
* Line continuation character, \:        Text part of a line.
                                                             (line   29)
* Line structure of fixed date:          Structure of resource file.
                                                             (line   31)
* 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 <1>:                 Glossary.           (line  389)
* Lists of commands <2>:                 Lists of commands.  (line    6)
* Lists of commands:                     Commands.           (line    6)
* 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  392)
* Local date variables:                  Date variables.     (line    6)
* Local date variables, definition:      Date variables.     (line    6)
* Local date variables, deletion:        Date variables.     (line   75)
* Local sidereal time:                   Glossary.           (line  398)
* Local star time:                       Glossary.           (line  398)
* Local text variable:                   Glossary.           (line  405)
* Local text variables:                  Text variables.     (line    6)
* Local text variables, definition:      Text variables.     (line    6)
* Local text variables, empty:           Text variables.     (line   56)
* Local time:                            Sun data.           (line 1058)
* Local time 12-hour format suffix, display: Actual clocktime.
                                                             (line   91)
* Local time hour, display:              Actual clocktime.   (line   65)
* Local time in HH:MM format, display:   Actual clocktime.   (line   19)
* Local time in M[M...] format, display: Actual clocktime.   (line   51)
* Local time minute, display:            Actual clocktime.   (line   78)
* LOGNAME environment variable <1>:      Environment Variables.
                                                             (line   84)
* LOGNAME environment variable:          Global options.     (line  201)
* Long help text:                        Common options.     (line   16)
* Long text part in resource file line:  Text part of a line.
                                                             (line   42)
* Long-style option <1>:                 Glossary.           (line  410)
* Long-style option:                     Options.            (line   21)
* Long-style option names, list:         Common options.     (line   25)
* Longer than double shadow length, period: Sun data.        (line  858)
* Longer than single shadow length, period: Sun data.        (line  822)
* Lowest culmination point:              Glossary.           (line  413)
* Lowest culmination point, Moon:        Moon data.          (line   37)
* Lowest culmination point, Sun:         Sun data.           (line   37)
* Lunar Arctic Circle <1>:               Glossary.           (line  417)
* Lunar Arctic Circle:                   Moon data.          (line  962)
* Lunar day length:                      Moon data.          (line    6)
* Lunar eclipse:                         Calendar options.   (line   48)
* Lunar night length:                    Moon data.          (line    6)
* Lunation:                              Glossary.           (line  422)
* Lunation, Moon:                        Moon data.          (line   37)
* Maghrib prayer time:                   Glossary.           (line  425)
* Maghrib, Islamic prayer time:          Sun data.           (line  195)
* Magnitude unit:                        Glossary.           (line  429)
* Magnitude units, Moon:                 Moon data.          (line  281)
* Mail, empty message body:              Global options.     (line  209)
* Mail, methods of sending:              Global options.     (line  188)
* Mail, sending:                         Global options.     (line  183)
* MAILPROG environment variable <1>:     Environment Variables.
                                                             (line   88)
* MAILPROG environment variable:         Global options.     (line  223)
* MAILTO environment variable <1>:       Environment Variables.
                                                             (line   94)
* MAILTO environment variable:           Global options.     (line  191)
* Management of date variables <1>:      Date variables.     (line    6)
* Management of date variables:          Fixed date options. (line    8)
* Management of text variables <1>:      Text variables.     (line    6)
* Management of text variables:          Fixed date options. (line   35)
* Marking character:                     Glossary.           (line  439)
* Marking characters, disabling:         Global options.     (line  102)
* Marking characters, setting:           Global options.     (line  107)
* Matching word boundaries in regexp:    Regexp Operators.   (line  274)
* Mathematical horizon:                  Glossary.           (line  268)
* Mathematical-geocentric horizon:       Glossary.           (line  268)
* Mathematical-geocentric horizon, Moon: Moon data.          (line   69)
* Mean Earth equator radius:             Glossary.           (line  443)
* Mean solar day <1>:                    Glossary.           (line  449)
* Mean solar day:                        Sun data.           (line  501)
* Mean solar time <1>:                   Glossary.           (line  449)
* Mean solar time:                       Sun data.           (line  501)
* Mean sun:                              Glossary.           (line  449)
* Mean Sun:                              Sun data.           (line  501)
* Meridian <1>:                          Glossary.           (line  458)
* Meridian:                              Geographical distance and course angle.
                                                             (line    6)
* Message catalog:                       Internationalization.
                                                             (line   11)
* Metacharacter, . regexp:               Regexp Operators.   (line   40)
* Metacharacter, \ regexp:               Regexp Operators.   (line   14)
* Metacharacters:                        Glossary.           (line  462)
* Metacharacters, regexp:                Regexp Operators.   (line    6)
* Metasymbols within this document, table: Metasymbols.      (line    6)
* Methods of sending Mail:               Global options.     (line  188)
* Midnight height:                       Glossary.           (line  465)
* Midnight height geocentric, Moon:      Moon data.          (line  719)
* Midnight height geocentric, Sun:       Sun data.           (line  747)
* Midnight height topocentric, Moon:     Moon data.          (line  643)
* Midnight height topocentric, Sun:      Sun data.           (line  700)
* Midnight phase angle:                  Glossary.           (line  469)
* Midnight phase angle geocentric, Moon: Moon data.          (line  726)
* Midnight phase angle topocentric, Moon: Moon data.         (line  650)
* Midnight time of Moon, astronomical:   Moon data.          (line   37)
* Midnight time of Sun, astronomical:    Sun data.           (line   37)
* 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   15)
* Mode characters, Moon data and times:  Moon data.          (line   23)
* Mode characters, Sun data and times:   Sun data.           (line   23)
* Modifier <1>:                          Glossary.           (line  473)
* Modifier:                              Options.            (line   73)
* Modifiers, fixed date period:          Fixed date options. (line  860)
* Modifiers, fixed date text:            Fixed date options. (line  612)
* 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 <1>: Special Texts Summary.
                                                             (line  172)
* Month name %[FORMAT]U[DATE] special text: Month name.      (line    6)
* Month number %>02&*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  191)
* Month number %>02&*M[DATE] special text: Month number.     (line   31)
* Month number %>02*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  185)
* Month number %>02*M[DATE] special text: Month number.      (line   15)
* Month number %>1&*M[DATE] special text <1>: Special Texts Summary.
                                                             (line  188)
* Month number %>1&*M[DATE] special text: Month number.      (line   23)
* Month number %[FORMAT]M[DATE] special text: Month number.  (line    6)
* Month number %M[DATE] special text <1>: Special Texts Summary.
                                                             (line  182)
* Month number %M[DATE] special text:    Month number.       (line    7)
* Months from the Baha''i` calendar in eternal holiday list: Calendar options.
                                                             (line 1207)
* Months from the Chinese calendar in eternal holiday list: Calendar options.
                                                             (line 1220)
* Months from the civil Indian calendar in eternal holiday list: Calendar options.
                                                             (line 1246)
* Months from the civil Islamic calendar in eternal holiday list: Calendar options.
                                                             (line 1251)
* Months from the Coptic calendar in eternal holiday list: Calendar options.
                                                             (line 1226)
* Months from the Ethiopic calendar in eternal holiday list: Calendar options.
                                                             (line 1231)
* Months from the flexible Chinese calendar in eternal holiday list: Calendar options.
                                                             (line 1213)
* Months from the flexible Japanese calendar in eternal holiday list: Calendar options.
                                                             (line 1258)
* Months from the French Revolutionary calendar in eternal holiday list: Calendar options.
                                                             (line 1236)
* Months from the Hebrew calendar in eternal holiday list: Calendar options.
                                                             (line 1241)
* Months from the Japanese calendar in eternal holiday list: Calendar options.
                                                             (line 1265)
* Months from the Old-Armenic calendar in eternal holiday list: Calendar options.
                                                             (line 1271)
* Months from the Old-Egyptic calendar in eternal holiday list: Calendar options.
                                                             (line 1276)
* Months from the Persian Jalaali calendar in eternal holiday list: Calendar options.
                                                             (line 1281)
* 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 1380)
* Months, mixed list:                    Lists of commands.  (line   38)
* Moon data %[FORMAT]?ARGUMENT special texts <1>: Special Texts Summary.
                                                             (line 1100)
* Moon data %[FORMAT]?ARGUMENT special texts: Moon data.     (line    6)
* Moon data and times, default mode:     Moon data.          (line  793)
* Moon data and times, mode characters:  Moon data.          (line   23)
* Moon data and times, special event oriented texts: Sun data.
                                                             (line  917)
* Moon data and times, style of representation <1>: Moon data.
                                                             (line  799)
* Moon data and times, style of representation: Sun data.    (line  870)
* Moon data and times, type of representation <1>: Moon data.
                                                             (line  799)
* Moon data and times, type of representation: Sun data.     (line  870)
* Moon oriented special texts, limitations: Moon data.       (line  929)
* Moon oriented special texts, reference systems used: Moon data.
                                                             (line  929)
* Moon oriented special texts, table of modes: Moon data.    (line   34)
* Moon oriented special texts, table of representation types: Moon data.
                                                             (line  826)
* Moon phase %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  203)
* Moon phase %[FORMAT]?[DATE] special texts: Moon phase.     (line    6)
* Moon phase text %>03*O[DATE] special text <1>: Special Texts Summary.
                                                             (line  208)
* Moon phase text %>03*O[DATE] special text: Moon phase.     (line   29)
* Moon phase text %O[DATE] special text <1>: Special Texts Summary.
                                                             (line  205)
* Moon phase text %O[DATE] special text: Moon phase.         (line   14)
* Moon phase text graphics %Z[DATE] special text <1>: Special Texts Summary.
                                                             (line  211)
* Moon phase text graphics %Z[DATE] special text: Moon phase.
                                                             (line   44)
* 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  374)
* Moon's center, geocentric brightness %(lARGUMENT special text: Moon data.
                                                             (line  374)
* Moon's center, geocentric brightness %)*lARGUMENT special text: Moon data.
                                                             (line  374)
* Moon's center, geocentric brightness %)lARGUMENT special text: Moon data.
                                                             (line  374)
* Moon's center, geocentric horizontal parallax %(*jARGUMENT special text: Moon data.
                                                             (line  366)
* Moon's center, geocentric horizontal parallax %(jARGUMENT special text: Moon data.
                                                             (line  366)
* Moon's center, geocentric horizontal parallax %)*jARGUMENT special text: Moon data.
                                                             (line  366)
* Moon's center, geocentric horizontal parallax %)jARGUMENT special text: Moon data.
                                                             (line  366)
* Moon's center, geocentric phase angle %(*mARGUMENT special text: Moon data.
                                                             (line  378)
* Moon's center, geocentric phase angle %(mARGUMENT special text: Moon data.
                                                             (line  378)
* Moon's center, geocentric phase angle %)*mARGUMENT special text: Moon data.
                                                             (line  378)
* Moon's center, geocentric phase angle %)mARGUMENT special text: Moon data.
                                                             (line  378)
* Moon's center, geocentric semidiameter %(*kARGUMENT special text: Moon data.
                                                             (line  370)
* Moon's center, geocentric semidiameter %(kARGUMENT special text: Moon data.
                                                             (line  370)
* Moon's center, geocentric semidiameter %)*kARGUMENT special text: Moon data.
                                                             (line  370)
* Moon's center, geocentric semidiameter %)kARGUMENT special text: Moon data.
                                                             (line  370)
* Moon's center, geometrical non-visibility %]*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1148)
* Moon's center, geometrical non-visibility %]*2ARGUMENT special text: Moon data.
                                                             (line  104)
* Moon's center, geometrical non-visibility %]2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1144)
* Moon's center, geometrical non-visibility %]2ARGUMENT special text: Moon data.
                                                             (line  104)
* Moon's center, geometrical rise time %(*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1124)
* Moon's center, geometrical rise time %(*2ARGUMENT special text: Moon data.
                                                             (line   69)
* Moon's center, geometrical rise time %(2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1120)
* Moon's center, geometrical rise time %(2ARGUMENT special text: Moon data.
                                                             (line   69)
* Moon's center, geometrical set time %)*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1132)
* Moon's center, geometrical set time %)*2ARGUMENT special text: Moon data.
                                                             (line   89)
* Moon's center, geometrical set time %)2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1128)
* Moon's center, geometrical set time %)2ARGUMENT special text: Moon data.
                                                             (line   89)
* Moon's center, geometrical visibility %[*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1140)
* Moon's center, geometrical visibility %[*2ARGUMENT special text: Moon data.
                                                             (line   99)
* Moon's center, geometrical visibility %[2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1136)
* Moon's center, geometrical visibility %[2ARGUMENT special text: Moon data.
                                                             (line   99)
* Moon's center, non-visibility %]*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1210)
* Moon's center, non-visibility %]*4ARGUMENT special text: Moon data.
                                                             (line  188)
* Moon's center, non-visibility %]4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1206)
* Moon's center, non-visibility %]4ARGUMENT special text: Moon data.
                                                             (line  188)
* Moon's center, rise time %(*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1187)
* Moon's center, rise time %(*4ARGUMENT special text: Moon data.
                                                             (line  146)
* Moon's center, rise time %(4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1184)
* Moon's center, rise time %(4ARGUMENT special text: Moon data.
                                                             (line  146)
* Moon's center, set time %)*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1194)
* Moon's center, set time %)*4ARGUMENT special text: Moon data.
                                                             (line  167)
* Moon's center, set time %)4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1191)
* Moon's center, set time %)4ARGUMENT special text: Moon data.
                                                             (line  167)
* Moon's center, topocentric brightness %(*8ARGUMENT special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric brightness %(8ARGUMENT special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric brightness %)*8ARGUMENT special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric brightness %)8ARGUMENT special text: Moon data.
                                                             (line  281)
* Moon's center, topocentric horizontal parallax %(*6ARGUMENT special text: Moon data.
                                                             (line  256)
* Moon's center, topocentric horizontal parallax %(6ARGUMENT special text: Moon data.
                                                             (line  256)
* Moon's center, topocentric horizontal parallax %)*6ARGUMENT special text: Moon data.
                                                             (line  256)
* Moon's center, topocentric horizontal parallax %)6ARGUMENT special text: Moon data.
                                                             (line  256)
* Moon's center, topocentric phase angle %(*9ARGUMENT special text: Moon data.
                                                             (line  295)
* Moon's center, topocentric phase angle %(9ARGUMENT special text: Moon data.
                                                             (line  295)
* Moon's center, topocentric phase angle %)*9ARGUMENT special text: Moon data.
                                                             (line  295)
* Moon's center, topocentric phase angle %)9ARGUMENT special text: Moon data.
                                                             (line  295)
* Moon's center, topocentric semidiameter %(*7ARGUMENT special text: Moon data.
                                                             (line  277)
* Moon's center, topocentric semidiameter %(7ARGUMENT special text: Moon data.
                                                             (line  277)
* Moon's center, topocentric semidiameter %)*7ARGUMENT special text: Moon data.
                                                             (line  277)
* Moon's center, topocentric semidiameter %)7ARGUMENT special text: Moon data.
                                                             (line  277)
* Moon's center, visibility %[*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1202)
* Moon's center, visibility %[*4ARGUMENT special text: Moon data.
                                                             (line  183)
* Moon's center, visibility %[4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1198)
* Moon's center, visibility %[4ARGUMENT special text: Moon data.
                                                             (line  183)
* Moon's upper limb, geometrical non-visibility %]*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1180)
* Moon's upper limb, geometrical non-visibility %]*3ARGUMENT special text: Moon data.
                                                             (line  141)
* Moon's upper limb, geometrical non-visibility %]3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1176)
* Moon's upper limb, geometrical non-visibility %]3ARGUMENT special text: Moon data.
                                                             (line  141)
* Moon's upper limb, geometrical rise time %(*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1156)
* Moon's upper limb, geometrical rise time %(*3ARGUMENT special text: Moon data.
                                                             (line  109)
* Moon's upper limb, geometrical rise time %(3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1152)
* Moon's upper limb, geometrical rise time %(3ARGUMENT special text: Moon data.
                                                             (line  109)
* Moon's upper limb, geometrical set time %)*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1164)
* Moon's upper limb, geometrical set time %)*3ARGUMENT special text: Moon data.
                                                             (line  125)
* Moon's upper limb, geometrical set time %)3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1160)
* Moon's upper limb, geometrical set time %)3ARGUMENT special text: Moon data.
                                                             (line  125)
* Moon's upper limb, geometrical visibility %[*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1172)
* Moon's upper limb, geometrical visibility %[*3ARGUMENT special text: Moon data.
                                                             (line  136)
* Moon's upper limb, geometrical visibility %[3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1168)
* Moon's upper limb, geometrical visibility %[3ARGUMENT special text: Moon data.
                                                             (line  136)
* Moon's upper limb, non-visibility standard %]*5ARGUMENT special text: Special Texts Summary.
                                                             (line 1242)
* Moon's upper limb, non-visibility standard %]5ARGUMENT special text: Special Texts Summary.
                                                             (line 1238)
* Moon's upper limb, standard non-visibility %]*5ARGUMENT special text: Moon data.
                                                             (line  248)
* Moon's upper limb, standard non-visibility %]5ARGUMENT special text: Moon data.
                                                             (line  248)
* Moon's upper limb, standard rise time %(*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1218)
* Moon's upper limb, standard rise time %(*5ARGUMENT special text: Moon data.
                                                             (line  193)
* Moon's upper limb, standard rise time %(5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1214)
* Moon's upper limb, standard rise time %(5ARGUMENT special text: Moon data.
                                                             (line  193)
* Moon's upper limb, standard set time %)*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1226)
* Moon's upper limb, standard set time %)*5ARGUMENT special text: Moon data.
                                                             (line  221)
* Moon's upper limb, standard set time %)5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1222)
* Moon's upper limb, standard set time %)5ARGUMENT special text: Moon data.
                                                             (line  221)
* Moon's upper limb, standard visibility %[*5ARGUMENT special text: Moon data.
                                                             (line  240)
* Moon's upper limb, standard visibility %[5ARGUMENT special text: Moon data.
                                                             (line  240)
* Moon's upper limb, visibility standard %[*5ARGUMENT special text: Special Texts Summary.
                                                             (line 1234)
* Moon's upper limb, visibility standard %[5ARGUMENT special text: Special Texts Summary.
                                                             (line 1230)
* Moon, astronomical midnight time %(*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1107)
* Moon, astronomical midnight time %(*0ARGUMENT special text: Moon data.
                                                             (line   37)
* Moon, astronomical midnight time %(0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1103)
* Moon, astronomical midnight time %(0ARGUMENT special text: Moon data.
                                                             (line   37)
* Moon, astronomical midnight time %)*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1107)
* Moon, astronomical midnight time %)*0ARGUMENT special text: Moon data.
                                                             (line   37)
* Moon, astronomical midnight time %)0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1103)
* Moon, astronomical midnight time %)0ARGUMENT special text: Moon data.
                                                             (line   37)
* Moon, astronomical noon time %(*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1116)
* Moon, astronomical noon time %(*1ARGUMENT special text: Moon data.
                                                             (line   57)
* Moon, astronomical noon time %(1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1112)
* Moon, astronomical noon time %(1ARGUMENT special text: Moon data.
                                                             (line   57)
* Moon, astronomical noon time %)*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1116)
* Moon, astronomical noon time %)*1ARGUMENT special text: Moon data.
                                                             (line   57)
* Moon, astronomical noon time %)1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1112)
* Moon, astronomical noon time %)1ARGUMENT special text: Moon data.
                                                             (line   57)
* Moon, azimuth:                         Moon data.          (line   37)
* Moon, base time %(*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1508)
* Moon, base time %(*xARGUMENT special text: Moon data.      (line  450)
* Moon, base time %(xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1503)
* Moon, base time %(xARGUMENT special text: Moon data.       (line  450)
* Moon, base time %)*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1508)
* Moon, base time %)*xARGUMENT special text: Moon data.      (line  450)
* Moon, base time %)xARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1503)
* Moon, base time %)xARGUMENT special text: Moon data.       (line  450)
* Moon, conjunction:                     Moon data.          (line   37)
* Moon, delta-t %(*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, delta-t %(*vARGUMENT special text: Moon data.        (line  428)
* Moon, delta-t %(vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, delta-t %(vARGUMENT special text: Moon data.         (line  428)
* Moon, delta-t %)*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, delta-t %)*vARGUMENT special text: Moon data.        (line  428)
* Moon, delta-t %)vARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1490)
* Moon, delta-t %)vARGUMENT special text: Moon data.         (line  428)
* Moon, geocentric azimuth %(*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1424)
* Moon, geocentric azimuth %(*oARGUMENT special text: Moon data.
                                                             (line  390)
* Moon, geocentric azimuth %(oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1419)
* Moon, geocentric azimuth %(oARGUMENT special text: Moon data.
                                                             (line  390)
* Moon, geocentric azimuth %)*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1424)
* Moon, geocentric azimuth %)*oARGUMENT special text: Moon data.
                                                             (line  390)
* Moon, geocentric azimuth %)oARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1419)
* Moon, geocentric azimuth %)oARGUMENT special text: Moon data.
                                                             (line  390)
* Moon, geocentric azimuth at standard rise time %(*XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1813)
* Moon, geocentric azimuth at standard rise time %(*XARGUMENT special text: Moon data.
                                                             (line  761)
* Moon, geocentric azimuth at standard rise time %(XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1809)
* Moon, geocentric azimuth at standard rise time %(XARGUMENT special text: Moon data.
                                                             (line  761)
* Moon, geocentric azimuth at standard set time %)*XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1821)
* Moon, geocentric azimuth at standard set time %)*XARGUMENT special text: Moon data.
                                                             (line  771)
* Moon, geocentric azimuth at standard set time %)XARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1817)
* Moon, geocentric azimuth at standard set time %)XARGUMENT special text: Moon data.
                                                             (line  771)
* Moon, geocentric brightness %(*lARGUMENT special text: Special Texts Summary.
                                                             (line 1394)
* Moon, geocentric brightness %(lARGUMENT special text: Special Texts Summary.
                                                             (line 1394)
* Moon, geocentric brightness %)*lARGUMENT special text: Special Texts Summary.
                                                             (line 1394)
* Moon, geocentric brightness %)lARGUMENT special text: Special Texts Summary.
                                                             (line 1394)
* Moon, geocentric data:                 Moon data.          (line  256)
* Moon, geocentric declination %(*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1434)
* Moon, geocentric declination %(*pARGUMENT special text: Moon data.
                                                             (line  394)
* Moon, geocentric declination %(pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1429)
* Moon, geocentric declination %(pARGUMENT special text: Moon data.
                                                             (line  394)
* Moon, geocentric declination %)*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1434)
* Moon, geocentric declination %)*pARGUMENT special text: Moon data.
                                                             (line  394)
* Moon, geocentric declination %)pARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1429)
* Moon, geocentric declination %)pARGUMENT special text: Moon data.
                                                             (line  394)
* Moon, geocentric distance %(*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1474)
* Moon, geocentric distance %(*tARGUMENT special text: Moon data.
                                                             (line  420)
* Moon, geocentric distance %(tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1469)
* Moon, geocentric distance %(tARGUMENT special text: Moon data.
                                                             (line  420)
* Moon, geocentric distance %)*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1474)
* Moon, geocentric distance %)*tARGUMENT special text: Moon data.
                                                             (line  420)
* Moon, geocentric distance %)tARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1469)
* Moon, geocentric distance %)tARGUMENT special text: Moon data.
                                                             (line  420)
* Moon, geocentric ecliptic latitude %(*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1454)
* Moon, geocentric ecliptic latitude %(*rARGUMENT special text: Moon data.
                                                             (line  407)
* Moon, geocentric ecliptic latitude %(rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1449)
* Moon, geocentric ecliptic latitude %(rARGUMENT special text: Moon data.
                                                             (line  407)
* Moon, geocentric ecliptic latitude %)*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1454)
* Moon, geocentric ecliptic latitude %)*rARGUMENT special text: Moon data.
                                                             (line  407)
* Moon, geocentric ecliptic latitude %)rARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1449)
* Moon, geocentric ecliptic latitude %)rARGUMENT special text: Moon data.
                                                             (line  407)
* Moon, geocentric ecliptic longitude %(*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1444)
* Moon, geocentric ecliptic longitude %(*qARGUMENT special text: Moon data.
                                                             (line  403)
* Moon, geocentric ecliptic longitude %(qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1439)
* Moon, geocentric ecliptic longitude %(qARGUMENT special text: Moon data.
                                                             (line  403)
* Moon, geocentric ecliptic longitude %)*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1444)
* Moon, geocentric ecliptic longitude %)*qARGUMENT special text: Moon data.
                                                             (line  403)
* Moon, geocentric ecliptic longitude %)qARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1439)
* Moon, geocentric ecliptic longitude %)qARGUMENT special text: Moon data.
                                                             (line  403)
* Moon, geocentric elevation %(*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric elevation %(*nARGUMENT special text: Moon data.
                                                             (line  382)
* Moon, geocentric elevation %(nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1409)
* Moon, geocentric elevation %(nARGUMENT special text: Moon data.
                                                             (line  382)
* Moon, geocentric elevation %)*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1414)
* Moon, geocentric elevation %)*nARGUMENT special text: Moon data.
                                                             (line  382)
* Moon, geocentric elevation %)nARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1409)
* Moon, geocentric elevation %)nARGUMENT special text: Moon data.
                                                             (line  382)
* Moon, geocentric elevation at Moon's astronomical midnight time %(*SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1758)
* Moon, geocentric elevation at Moon's astronomical midnight time %(*SARGUMENT special text: Moon data.
                                                             (line  719)
* Moon, geocentric elevation at Moon's astronomical midnight time %(SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1753)
* Moon, geocentric elevation at Moon's astronomical midnight time %(SARGUMENT special text: Moon data.
                                                             (line  719)
* Moon, geocentric elevation at Moon's astronomical midnight time %)*SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1758)
* Moon, geocentric elevation at Moon's astronomical midnight time %)*SARGUMENT special text: Moon data.
                                                             (line  719)
* Moon, geocentric elevation at Moon's astronomical midnight time %)SARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1753)
* Moon, geocentric elevation at Moon's astronomical midnight time %)SARGUMENT special text: Moon data.
                                                             (line  719)
* Moon, geocentric elevation at Moon's astronomical noon time %(*UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1779)
* Moon, geocentric elevation at Moon's astronomical noon time %(*UARGUMENT special text: Moon data.
                                                             (line  733)
* Moon, geocentric elevation at Moon's astronomical noon time %(UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1774)
* Moon, geocentric elevation at Moon's astronomical noon time %(UARGUMENT special text: Moon data.
                                                             (line  733)
* Moon, geocentric elevation at Moon's astronomical noon time %)*UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1779)
* Moon, geocentric elevation at Moon's astronomical noon time %)*UARGUMENT special text: Moon data.
                                                             (line  733)
* Moon, geocentric elevation at Moon's astronomical noon time %)UARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1774)
* Moon, geocentric elevation at Moon's astronomical noon time %)UARGUMENT special text: Moon data.
                                                             (line  733)
* Moon, geocentric elevation at standard rise time %(*WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1797)
* Moon, geocentric elevation at standard rise time %(*WARGUMENT special text: Moon data.
                                                             (line  747)
* Moon, geocentric elevation at standard rise time %(WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1793)
* Moon, geocentric elevation at standard rise time %(WARGUMENT special text: Moon data.
                                                             (line  747)
* Moon, geocentric elevation at standard set time %)*WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1805)
* Moon, geocentric elevation at standard set time %)*WARGUMENT special text: Moon data.
                                                             (line  754)
* Moon, geocentric elevation at standard set time %)WARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1801)
* Moon, geocentric elevation at standard set time %)WARGUMENT special text: Moon data.
                                                             (line  754)
* Moon, geocentric elongation %(*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1483)
* Moon, geocentric elongation %(*uARGUMENT special text: Moon data.
                                                             (line  424)
* Moon, geocentric elongation %(uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1478)
* Moon, geocentric elongation %(uARGUMENT special text: Moon data.
                                                             (line  424)
* Moon, geocentric elongation %)*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1483)
* Moon, geocentric elongation %)*uARGUMENT special text: Moon data.
                                                             (line  424)
* Moon, geocentric elongation %)uARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1478)
* Moon, geocentric elongation %)uARGUMENT special text: Moon data.
                                                             (line  424)
* Moon, geocentric horizontal parallax %(*jARGUMENT special text: Special Texts Summary.
                                                             (line 1377)
* Moon, geocentric horizontal parallax %(jARGUMENT special text: Special Texts Summary.
                                                             (line 1372)
* Moon, geocentric horizontal parallax %)*jARGUMENT special text: Special Texts Summary.
                                                             (line 1377)
* Moon, geocentric horizontal parallax %)jARGUMENT special text: Special Texts Summary.
                                                             (line 1372)
* Moon, geocentric phase angle %(*mARGUMENT special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric phase angle %(mARGUMENT special text: Special Texts Summary.
                                                             (line 1399)
* Moon, geocentric phase angle %)*mARGUMENT special text: Special Texts Summary.
                                                             (line 1404)
* Moon, geocentric phase angle %)mARGUMENT special text: Special Texts Summary.
                                                             (line 1399)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(*TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1768)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(*TARGUMENT special text: Moon data.
                                                             (line  726)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1763)
* Moon, geocentric phase angle at Moon's astronomical midnight time %(TARGUMENT special text: Moon data.
                                                             (line  726)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)*TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1768)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)*TARGUMENT special text: Moon data.
                                                             (line  726)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)TARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1763)
* Moon, geocentric phase angle at Moon's astronomical midnight time %)TARGUMENT special text: Moon data.
                                                             (line  726)
* Moon, geocentric phase angle at Moon's astronomical noon time %(*VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1789)
* Moon, geocentric phase angle at Moon's astronomical noon time %(*VARGUMENT special text: Moon data.
                                                             (line  740)
* Moon, geocentric phase angle at Moon's astronomical noon time %(VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1784)
* Moon, geocentric phase angle at Moon's astronomical noon time %(VARGUMENT special text: Moon data.
                                                             (line  740)
* Moon, geocentric phase angle at Moon's astronomical noon time %)*VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1789)
* Moon, geocentric phase angle at Moon's astronomical noon time %)*VARGUMENT special text: Moon data.
                                                             (line  740)
* Moon, geocentric phase angle at Moon's astronomical noon time %)VARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1784)
* Moon, geocentric phase angle at Moon's astronomical noon time %)VARGUMENT special text: Moon data.
                                                             (line  740)
* Moon, geocentric phase angle at standard rise time %(*YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1829)
* Moon, geocentric phase angle at standard rise time %(*YARGUMENT special text: Moon data.
                                                             (line  780)
* Moon, geocentric phase angle at standard rise time %(YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1825)
* Moon, geocentric phase angle at standard rise time %(YARGUMENT special text: Moon data.
                                                             (line  780)
* Moon, geocentric phase angle at standard set time %)*YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1837)
* Moon, geocentric phase angle at standard set time %)*YARGUMENT special text: Moon data.
                                                             (line  787)
* Moon, geocentric phase angle at standard set time %)YARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1833)
* Moon, geocentric phase angle at standard set time %)YARGUMENT special text: Moon data.
                                                             (line  787)
* Moon, geocentric right ascension %(*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1464)
* Moon, geocentric right ascension %(*sARGUMENT special text: Moon data.
                                                             (line  416)
* Moon, geocentric right ascension %(sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1459)
* Moon, geocentric right ascension %(sARGUMENT special text: Moon data.
                                                             (line  416)
* Moon, geocentric right ascension %)*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1464)
* Moon, geocentric right ascension %)*sARGUMENT special text: Moon data.
                                                             (line  416)
* Moon, geocentric right ascension %)sARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1459)
* Moon, geocentric right ascension %)sARGUMENT special text: Moon data.
                                                             (line  416)
* Moon, geocentric semidiameter %(*kARGUMENT special text: Special Texts Summary.
                                                             (line 1387)
* Moon, geocentric semidiameter %(kARGUMENT special text: Special Texts Summary.
                                                             (line 1382)
* Moon, geocentric semidiameter %)*kARGUMENT special text: Special Texts Summary.
                                                             (line 1387)
* Moon, geocentric semidiameter %)kARGUMENT special text: Special Texts Summary.
                                                             (line 1382)
* Moon, geometric horizon:               Moon data.          (line   69)
* Moon, highest culmination point:       Moon data.          (line   57)
* Moon, Julian date %(*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1514)
* Moon, Julian date %(*yARGUMENT special text: Moon data.    (line  460)
* Moon, Julian date %(yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1514)
* Moon, Julian date %(yARGUMENT special text: Moon data.     (line  460)
* Moon, Julian date %)*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1514)
* Moon, Julian date %)*yARGUMENT special text: Moon data.    (line  460)
* Moon, Julian date %)yARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1514)
* Moon, Julian date %)yARGUMENT special text: Moon data.     (line  460)
* Moon, Julian Ephemeris date %(*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1520)
* Moon, Julian Ephemeris date %(*zARGUMENT special text: Moon data.
                                                             (line  465)
* Moon, Julian Ephemeris date %(zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1520)
* Moon, Julian Ephemeris date %(zARGUMENT special text: Moon data.
                                                             (line  465)
* Moon, Julian Ephemeris date %)*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1520)
* Moon, Julian Ephemeris date %)*zARGUMENT special text: Moon data.
                                                             (line  465)
* Moon, Julian Ephemeris date %)zARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1520)
* Moon, Julian Ephemeris date %)zARGUMENT special text: Moon data.
                                                             (line  465)
* Moon, local sidereal time %(*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1498)
* Moon, local sidereal time %(*wARGUMENT special text: Moon data.
                                                             (line  435)
* Moon, local sidereal time %(wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1494)
* Moon, local sidereal time %(wARGUMENT special text: Moon data.
                                                             (line  435)
* Moon, local sidereal time %)*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1498)
* Moon, local sidereal time %)*wARGUMENT special text: Moon data.
                                                             (line  435)
* Moon, local sidereal time %)wARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1494)
* Moon, local sidereal time %)wARGUMENT special text: Moon data.
                                                             (line  435)
* Moon, lowest culmination point:        Moon data.          (line   37)
* Moon, lunation:                        Moon data.          (line   37)
* Moon, magnitude units:                 Moon data.          (line  281)
* Moon, mathematical-geocentric horizon: Moon data.          (line   69)
* Moon, midnight height geocentric:      Moon data.          (line  719)
* Moon, midnight height topocentric:     Moon data.          (line  643)
* Moon, midnight phase angle geocentric: Moon data.          (line  726)
* Moon, midnight phase angle topocentric: Moon data.         (line  650)
* Moon, noon height geocentric:          Moon data.          (line  733)
* Moon, noon height topocentric:         Moon data.          (line  657)
* Moon, noon phase angle geocentric:     Moon data.          (line  740)
* Moon, noon phase angle topocentric:    Moon data.          (line  664)
* Moon, refraction %(*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, refraction %(*iARGUMENT special text: Moon data.     (line  362)
* Moon, refraction %(iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, refraction %(iARGUMENT special text: Moon data.      (line  362)
* Moon, refraction %)*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1368)
* Moon, refraction %)*iARGUMENT special text: Moon data.     (line  362)
* Moon, refraction %)iARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1363)
* Moon, refraction %)iARGUMENT special text: Moon data.      (line  362)
* Moon, rise azimuth geocentric:         Moon data.          (line  761)
* Moon, rise azimuth topocentric:        Moon data.          (line  685)
* Moon, rise height geocentric:          Moon data.          (line  747)
* Moon, rise height topocentric:         Moon data.          (line  671)
* Moon, rise phase angle geocentric:     Moon data.          (line  780)
* Moon, rise phase angle topocentric:    Moon data.          (line  705)
* Moon, rise width geocentric:           Moon data.          (line  761)
* Moon, rise width topocentric:          Moon data.          (line  685)
* Moon, set azimuth geocentric:          Moon data.          (line  771)
* Moon, set azimuth topocentric:         Moon data.          (line  695)
* Moon, set height geocentric:           Moon data.          (line  754)
* Moon, set height topocentric:          Moon data.          (line  678)
* Moon, set phase angle geocentric:      Moon data.          (line  787)
* Moon, set phase angle topocentric:     Moon data.          (line  712)
* Moon, set width geocentric:            Moon data.          (line  771)
* Moon, set width topocentric:           Moon data.          (line  695)
* Moon, standard non-visibility period:  Moon data.          (line  248)
* Moon, standard rise time:              Moon data.          (line  193)
* Moon, standard set time:               Moon data.          (line  221)
* Moon, standard visibility period:      Moon data.          (line  240)
* Moon, synodic month:                   Moon data.          (line   37)
* Moon, topocentric azimuth %(*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1299)
* Moon, topocentric azimuth %(*bARGUMENT special text: Moon data.
                                                             (line  309)
* Moon, topocentric azimuth %(bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1294)
* Moon, topocentric azimuth %(bARGUMENT special text: Moon data.
                                                             (line  309)
* Moon, topocentric azimuth %)*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1299)
* Moon, topocentric azimuth %)*bARGUMENT special text: Moon data.
                                                             (line  309)
* Moon, topocentric azimuth %)bARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1294)
* Moon, topocentric azimuth %)bARGUMENT special text: Moon data.
                                                             (line  309)
* Moon, topocentric azimuth at standard rise time %(*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1724)
* Moon, topocentric azimuth at standard rise time %(*QARGUMENT special text: Moon data.
                                                             (line  685)
* Moon, topocentric azimuth at standard rise time %(QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1720)
* Moon, topocentric azimuth at standard rise time %(QARGUMENT special text: Moon data.
                                                             (line  685)
* Moon, topocentric azimuth at standard set time %)*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1732)
* Moon, topocentric azimuth at standard set time %)*QARGUMENT special text: Moon data.
                                                             (line  695)
* Moon, topocentric azimuth at standard set time %)QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1728)
* Moon, topocentric azimuth at standard set time %)QARGUMENT special text: Moon data.
                                                             (line  695)
* Moon, topocentric brightness %(*8ARGUMENT special text: Special Texts Summary.
                                                             (line 1269)
* Moon, topocentric brightness %(8ARGUMENT special text: Special Texts Summary.
                                                             (line 1269)
* Moon, topocentric brightness %)*8ARGUMENT special text: Special Texts Summary.
                                                             (line 1269)
* Moon, topocentric brightness %)8ARGUMENT special text: Special Texts Summary.
                                                             (line 1269)
* Moon, topocentric data:                Moon data.          (line  256)
* Moon, topocentric declination %(*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1309)
* Moon, topocentric declination %(*cARGUMENT special text: Moon data.
                                                             (line  313)
* Moon, topocentric declination %(cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1304)
* Moon, topocentric declination %(cARGUMENT special text: Moon data.
                                                             (line  313)
* Moon, topocentric declination %)*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1309)
* Moon, topocentric declination %)*cARGUMENT special text: Moon data.
                                                             (line  313)
* Moon, topocentric declination %)cARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1304)
* Moon, topocentric declination %)cARGUMENT special text: Moon data.
                                                             (line  313)
* Moon, topocentric distance %(*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1349)
* Moon, topocentric distance %(*gARGUMENT special text: Moon data.
                                                             (line  350)
* Moon, topocentric distance %(gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1344)
* Moon, topocentric distance %(gARGUMENT special text: Moon data.
                                                             (line  350)
* Moon, topocentric distance %)*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1349)
* Moon, topocentric distance %)*gARGUMENT special text: Moon data.
                                                             (line  350)
* Moon, topocentric distance %)gARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1344)
* Moon, topocentric distance %)gARGUMENT special text: Moon data.
                                                             (line  350)
* Moon, topocentric ecliptic latitude %(*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1329)
* Moon, topocentric ecliptic latitude %(*eARGUMENT special text: Moon data.
                                                             (line  332)
* Moon, topocentric ecliptic latitude %(eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1324)
* Moon, topocentric ecliptic latitude %(eARGUMENT special text: Moon data.
                                                             (line  332)
* Moon, topocentric ecliptic latitude %)*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1329)
* Moon, topocentric ecliptic latitude %)*eARGUMENT special text: Moon data.
                                                             (line  332)
* Moon, topocentric ecliptic latitude %)eARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1324)
* Moon, topocentric ecliptic latitude %)eARGUMENT special text: Moon data.
                                                             (line  332)
* Moon, topocentric ecliptic longitude %(*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1319)
* Moon, topocentric ecliptic longitude %(*dARGUMENT special text: Moon data.
                                                             (line  324)
* Moon, topocentric ecliptic longitude %(dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1314)
* Moon, topocentric ecliptic longitude %(dARGUMENT special text: Moon data.
                                                             (line  324)
* Moon, topocentric ecliptic longitude %)*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1319)
* Moon, topocentric ecliptic longitude %)*dARGUMENT special text: Moon data.
                                                             (line  324)
* Moon, topocentric ecliptic longitude %)dARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1314)
* Moon, topocentric ecliptic longitude %)dARGUMENT special text: Moon data.
                                                             (line  324)
* Moon, topocentric elevation %(*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1289)
* Moon, topocentric elevation %(*aARGUMENT special text: Moon data.
                                                             (line  299)
* Moon, topocentric elevation %(aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1284)
* Moon, topocentric elevation %(aARGUMENT special text: Moon data.
                                                             (line  299)
* Moon, topocentric elevation %)*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1289)
* Moon, topocentric elevation %)*aARGUMENT special text: Moon data.
                                                             (line  299)
* Moon, topocentric elevation %)aARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1284)
* Moon, topocentric elevation %)aARGUMENT special text: Moon data.
                                                             (line  299)
* Moon, topocentric elevation at Moon's astronomical midnight time %(*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1669)
* Moon, topocentric elevation at Moon's astronomical midnight time %(*LARGUMENT special text: Moon data.
                                                             (line  643)
* Moon, topocentric elevation at Moon's astronomical midnight time %(LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1664)
* Moon, topocentric elevation at Moon's astronomical midnight time %(LARGUMENT special text: Moon data.
                                                             (line  643)
* Moon, topocentric elevation at Moon's astronomical midnight time %)*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1669)
* Moon, topocentric elevation at Moon's astronomical midnight time %)*LARGUMENT special text: Moon data.
                                                             (line  643)
* Moon, topocentric elevation at Moon's astronomical midnight time %)LARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1664)
* Moon, topocentric elevation at Moon's astronomical midnight time %)LARGUMENT special text: Moon data.
                                                             (line  643)
* Moon, topocentric elevation at Moon's astronomical noon time %(*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1690)
* Moon, topocentric elevation at Moon's astronomical noon time %(*NARGUMENT special text: Moon data.
                                                             (line  657)
* Moon, topocentric elevation at Moon's astronomical noon time %(NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1685)
* Moon, topocentric elevation at Moon's astronomical noon time %(NARGUMENT special text: Moon data.
                                                             (line  657)
* Moon, topocentric elevation at Moon's astronomical noon time %)*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1690)
* Moon, topocentric elevation at Moon's astronomical noon time %)*NARGUMENT special text: Moon data.
                                                             (line  657)
* Moon, topocentric elevation at Moon's astronomical noon time %)NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1685)
* Moon, topocentric elevation at Moon's astronomical noon time %)NARGUMENT special text: Moon data.
                                                             (line  657)
* Moon, topocentric elevation at standard rise time %(*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1708)
* Moon, topocentric elevation at standard rise time %(*PARGUMENT special text: Moon data.
                                                             (line  671)
* Moon, topocentric elevation at standard rise time %(PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1704)
* Moon, topocentric elevation at standard rise time %(PARGUMENT special text: Moon data.
                                                             (line  671)
* Moon, topocentric elevation at standard set time %)*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1716)
* Moon, topocentric elevation at standard set time %)*PARGUMENT special text: Moon data.
                                                             (line  678)
* Moon, topocentric elevation at standard set time %)PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1712)
* Moon, topocentric elevation at standard set time %)PARGUMENT special text: Moon data.
                                                             (line  678)
* Moon, topocentric elongation %(*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1358)
* Moon, topocentric elongation %(*hARGUMENT special text: Moon data.
                                                             (line  356)
* Moon, topocentric elongation %(hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1353)
* Moon, topocentric elongation %(hARGUMENT special text: Moon data.
                                                             (line  356)
* Moon, topocentric elongation %)*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1358)
* Moon, topocentric elongation %)*hARGUMENT special text: Moon data.
                                                             (line  356)
* Moon, topocentric elongation %)hARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1353)
* Moon, topocentric elongation %)hARGUMENT special text: Moon data.
                                                             (line  356)
* Moon, topocentric horizontal parallax %(*6ARGUMENT special text: Special Texts Summary.
                                                             (line 1252)
* Moon, topocentric horizontal parallax %(6ARGUMENT special text: Special Texts Summary.
                                                             (line 1247)
* Moon, topocentric horizontal parallax %)*6ARGUMENT special text: Special Texts Summary.
                                                             (line 1252)
* Moon, topocentric horizontal parallax %)6ARGUMENT special text: Special Texts Summary.
                                                             (line 1247)
* Moon, topocentric phase angle %(*9ARGUMENT special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric phase angle %(9ARGUMENT special text: Special Texts Summary.
                                                             (line 1274)
* Moon, topocentric phase angle %)*9ARGUMENT special text: Special Texts Summary.
                                                             (line 1279)
* Moon, topocentric phase angle %)9ARGUMENT special text: Special Texts Summary.
                                                             (line 1274)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1679)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(*MARGUMENT special text: Moon data.
                                                             (line  650)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1674)
* Moon, topocentric phase angle at Moon's astronomical midnight time %(MARGUMENT special text: Moon data.
                                                             (line  650)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1679)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)*MARGUMENT special text: Moon data.
                                                             (line  650)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)MARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1674)
* Moon, topocentric phase angle at Moon's astronomical midnight time %)MARGUMENT special text: Moon data.
                                                             (line  650)
* Moon, topocentric phase angle at Moon's astronomical noon time %(*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric phase angle at Moon's astronomical noon time %(*OARGUMENT special text: Moon data.
                                                             (line  664)
* Moon, topocentric phase angle at Moon's astronomical noon time %(OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric phase angle at Moon's astronomical noon time %(OARGUMENT special text: Moon data.
                                                             (line  664)
* Moon, topocentric phase angle at Moon's astronomical noon time %)*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1700)
* Moon, topocentric phase angle at Moon's astronomical noon time %)*OARGUMENT special text: Moon data.
                                                             (line  664)
* Moon, topocentric phase angle at Moon's astronomical noon time %)OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1695)
* Moon, topocentric phase angle at Moon's astronomical noon time %)OARGUMENT special text: Moon data.
                                                             (line  664)
* Moon, topocentric phase angle at standard rise time %(*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1740)
* Moon, topocentric phase angle at standard rise time %(*RARGUMENT special text: Moon data.
                                                             (line  705)
* Moon, topocentric phase angle at standard rise time %(RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1736)
* Moon, topocentric phase angle at standard rise time %(RARGUMENT special text: Moon data.
                                                             (line  705)
* Moon, topocentric phase angle at standard set time %)*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1748)
* Moon, topocentric phase angle at standard set time %)*RARGUMENT special text: Moon data.
                                                             (line  712)
* Moon, topocentric phase angle at standard set time %)RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1744)
* Moon, topocentric phase angle at standard set time %)RARGUMENT special text: Moon data.
                                                             (line  712)
* Moon, topocentric right ascension %(*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1339)
* Moon, topocentric right ascension %(*fARGUMENT special text: Moon data.
                                                             (line  343)
* Moon, topocentric right ascension %(fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1334)
* Moon, topocentric right ascension %(fARGUMENT special text: Moon data.
                                                             (line  343)
* Moon, topocentric right ascension %)*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1339)
* Moon, topocentric right ascension %)*fARGUMENT special text: Moon data.
                                                             (line  343)
* Moon, topocentric right ascension %)fARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1334)
* Moon, topocentric right ascension %)fARGUMENT special text: Moon data.
                                                             (line  343)
* Moon, topocentric semidiameter %(*7ARGUMENT special text: Special Texts Summary.
                                                             (line 1262)
* Moon, topocentric semidiameter %(7ARGUMENT special text: Special Texts Summary.
                                                             (line 1257)
* Moon, topocentric semidiameter %)*7ARGUMENT special text: Special Texts Summary.
                                                             (line 1262)
* Moon, topocentric semidiameter %)7ARGUMENT special text: Special Texts Summary.
                                                             (line 1257)
* Moon/Sun, delta astronomical midnight time %(*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1633)
* Moon/Sun, delta astronomical midnight time %(*IARGUMENT special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta astronomical midnight time %(IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1628)
* Moon/Sun, delta astronomical midnight time %(IARGUMENT special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta astronomical midnight time %)*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1633)
* Moon/Sun, delta astronomical midnight time %)*IARGUMENT special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta astronomical midnight time %)IARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1628)
* Moon/Sun, delta astronomical midnight time %)IARGUMENT special text: Moon data.
                                                             (line  577)
* Moon/Sun, delta astronomical noon time %(*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1643)
* Moon/Sun, delta astronomical noon time %(*JARGUMENT special text: Moon data.
                                                             (line  595)
* Moon/Sun, delta astronomical noon time %(JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1638)
* Moon/Sun, delta astronomical noon time %(JARGUMENT special text: Moon data.
                                                             (line  595)
* Moon/Sun, delta astronomical noon time %)*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1643)
* Moon/Sun, delta astronomical noon time %)*JARGUMENT special text: Moon data.
                                                             (line  595)
* Moon/Sun, delta astronomical noon time %)JARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1638)
* Moon/Sun, delta astronomical noon time %)JARGUMENT special text: Moon data.
                                                             (line  595)
* Moon/Sun, delta geocentric azimuth %(*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1559)
* Moon/Sun, delta geocentric azimuth %(*DARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric azimuth %(DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1554)
* Moon/Sun, delta geocentric azimuth %(DARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric azimuth %)*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1559)
* Moon/Sun, delta geocentric azimuth %)*DARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric azimuth %)DARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1554)
* Moon/Sun, delta geocentric azimuth %)DARGUMENT special text: Moon data.
                                                             (line  507)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1615)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(*HARGUMENT special text: Moon data.
                                                             (line  561)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1611)
* Moon/Sun, delta geocentric azimuth at standard moonrise time %(HARGUMENT special text: Moon data.
                                                             (line  561)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1623)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)*HARGUMENT special text: Moon data.
                                                             (line  569)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)HARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1619)
* Moon/Sun, delta geocentric azimuth at standard moonset time %)HARGUMENT special text: Moon data.
                                                             (line  569)
* Moon/Sun, delta geocentric elevation %(*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1549)
* Moon/Sun, delta geocentric elevation %(*CARGUMENT special text: Moon data.
                                                             (line  501)
* Moon/Sun, delta geocentric elevation %(CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1544)
* Moon/Sun, delta geocentric elevation %(CARGUMENT special text: Moon data.
                                                             (line  501)
* Moon/Sun, delta geocentric elevation %)*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1549)
* Moon/Sun, delta geocentric elevation %)*CARGUMENT special text: Moon data.
                                                             (line  501)
* Moon/Sun, delta geocentric elevation %)CARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1544)
* Moon/Sun, delta geocentric elevation %)CARGUMENT special text: Moon data.
                                                             (line  501)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1599)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(*GARGUMENT special text: Moon data.
                                                             (line  545)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1595)
* Moon/Sun, delta geocentric elevation at standard moonrise time %(GARGUMENT special text: Moon data.
                                                             (line  545)
* Moon/Sun, delta geocentric elevation at standard moonset time %)*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1607)
* Moon/Sun, delta geocentric elevation at standard moonset time %)*GARGUMENT special text: Moon data.
                                                             (line  553)
* Moon/Sun, delta geocentric elevation at standard moonset time %)GARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1603)
* Moon/Sun, delta geocentric elevation at standard moonset time %)GARGUMENT special text: Moon data.
                                                             (line  553)
* Moon/Sun, delta standard rise time %(*KARGUMENT special text: Special Texts Summary.
                                                             (line 1651)
* Moon/Sun, delta standard rise time %(KARGUMENT special text: Special Texts Summary.
                                                             (line 1647)
* Moon/Sun, delta standard set time %)*KARGUMENT special text: Special Texts Summary.
                                                             (line 1659)
* Moon/Sun, delta standard set time %)KARGUMENT special text: Special Texts Summary.
                                                             (line 1655)
* Moon/Sun, delta topocentric azimuth %(*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1539)
* Moon/Sun, delta topocentric azimuth %(*BARGUMENT special text: Moon data.
                                                             (line  482)
* Moon/Sun, delta topocentric azimuth %(BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1534)
* Moon/Sun, delta topocentric azimuth %(BARGUMENT special text: Moon data.
                                                             (line  482)
* Moon/Sun, delta topocentric azimuth %)*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1539)
* Moon/Sun, delta topocentric azimuth %)*BARGUMENT special text: Moon data.
                                                             (line  482)
* Moon/Sun, delta topocentric azimuth %)BARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1534)
* Moon/Sun, delta topocentric azimuth %)BARGUMENT special text: Moon data.
                                                             (line  482)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1583)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(*FARGUMENT special text: Moon data.
                                                             (line  529)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1579)
* Moon/Sun, delta topocentric azimuth at standard moonrise time %(FARGUMENT special text: Moon data.
                                                             (line  529)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1591)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)*FARGUMENT special text: Moon data.
                                                             (line  537)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)FARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1587)
* Moon/Sun, delta topocentric azimuth at standard moonset time %)FARGUMENT special text: Moon data.
                                                             (line  537)
* Moon/Sun, delta topocentric elevation %(*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1529)
* Moon/Sun, delta topocentric elevation %(*AARGUMENT special text: Moon data.
                                                             (line  469)
* Moon/Sun, delta topocentric elevation %(AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon/Sun, delta topocentric elevation %(AARGUMENT special text: Moon data.
                                                             (line  469)
* Moon/Sun, delta topocentric elevation %)*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1529)
* Moon/Sun, delta topocentric elevation %)*AARGUMENT special text: Moon data.
                                                             (line  469)
* Moon/Sun, delta topocentric elevation %)AARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1524)
* Moon/Sun, delta topocentric elevation %)AARGUMENT special text: Moon data.
                                                             (line  469)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1567)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(*EARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1563)
* Moon/Sun, delta topocentric elevation at standard moonrise time %(EARGUMENT special text: Moon data.
                                                             (line  513)
* Moon/Sun, delta topocentric elevation at standard moonset time %)*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1575)
* Moon/Sun, delta topocentric elevation at standard moonset time %)*EARGUMENT special text: Moon data.
                                                             (line  521)
* Moon/Sun, delta topocentric elevation at standard moonset time %)EARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1571)
* Moon/Sun, delta topocentric elevation at standard moonset time %)EARGUMENT special text: Moon data.
                                                             (line  521)
* Moonrise:                              Moon data.          (line    6)
* Moonrise and moonset, set reference altitude: Fixed date options.
                                                             (line  130)
* Moonset:                               Moon data.          (line    6)
* More precise representation of astronomical data and times: Fixed date options.
                                                             (line  330)
* More precise representation of geographical data: Fixed date options.
                                                             (line  330)
* Morning width:                         Glossary.           (line  478)
* Morning width geocentric, Sun:         Sun data.           (line  774)
* Morning width topocentric, Sun:        Sun data.           (line  728)
* Move leap day to 1st March:            Fixed date options. (line  872)
* Move leap day to 28th February:        Fixed date options. (line  867)
* Multicultural New Year holidays in eternal holiday list: Calendar options.
                                                             (line  107)
* Name space of date variables <1>:      Date variables.     (line   55)
* Name space of date variables:          Fixed date options. (line    8)
* Name space of text variables <1>:      Text variables.     (line  242)
* Name space of text variables:          Fixed date options. (line   35)
* Native language defaults:              Internationalization.
                                                             (line   53)
* Native language, selection:            Internationalization.
                                                             (line   27)
* Native language, used:                 Internationalization.
                                                             (line    6)
* Nautical twilight:                     Glossary.           (line  482)
* Nautical twilight, Sun:                Sun data.           (line  257)
* Negated character list:                Glossary.           (line  487)
* Negated character list, regexp:        Regexp Operators.   (line  160)
* Negated regular expression:            Fixed date options. (line  416)
* Negative day:                          Glossary.           (line  491)
* Negative day, biorhythm:               Biorhythm.          (line   21)
* 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  496)
* Noon height geocentric, Moon:          Moon data.          (line  733)
* Noon height geocentric, Sun:           Sun data.           (line  754)
* Noon height topocentric, Moon:         Moon data.          (line  657)
* Noon height topocentric, Sun:          Sun data.           (line  707)
* Noon line:                             Glossary.           (line  500)
* Noon line, Sun:                        Sun data.           (line   37)
* Noon phase angle:                      Glossary.           (line  503)
* Noon phase angle geocentric, Moon:     Moon data.          (line  740)
* Noon phase angle topocentric, Moon:    Moon data.          (line  664)
* Noon time of Moon, astronomical:       Moon data.          (line   57)
* Noon time of Sun, astronomical:        Sun data.           (line   49)
* NUL characters in the text part, handling: Text part of a line.
                                                             (line   21)
* Number of year calendar sheet blocks:  Calendar options.   (line 1386)
* Numerical local time timezone offset value %=[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  268)
* Numerical local time timezone offset value %=[ARGUMENT] special text: Actual clocktime.
                                                             (line  191)
* Numerical local time timezone offset value using RFC-822 style, display: Actual clocktime.
                                                             (line  191)
* Numerical text variables:              Text variables.     (line  293)
* Numerical text variables, length preserving behavior: Text variables.
                                                             (line  349)
* Numerical Universal time timezone offset value %"[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  265)
* Numerical Universal time timezone offset value %"[ARGUMENT] special text: Actual clocktime.
                                                             (line  175)
* Numerical Universal time timezone offset value using RFC-822 style, display: Actual clocktime.
                                                             (line  175)
* 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  507)
* Omission values in date part, validity: Date part of a line.
                                                             (line  146)
* Operations on date variables <1>:      Date variables.     (line  118)
* Operations on date variables <2>:      Structure of resource file.
                                                             (line   57)
* Operations on date variables:          Fixed date options. (line    8)
* Operations on text variables <1>:      Text variables.     (line  293)
* Operations on text variables:          Structure of resource file.
                                                             (line   72)
* Operator, * regexp:                    Regexp Operators.   (line  191)
* Operator, + regexp:                    Regexp Operators.   (line  211)
* Operator, ? regexp:                    Regexp Operators.   (line  223)
* Operator, \' regexp:                   Regexp Operators.   (line  299)
* Operator, \< regexp:                   Regexp Operators.   (line  266)
* Operator, \> regexp:                   Regexp Operators.   (line  270)
* Operator, \` regexp:                   Regexp Operators.   (line  295)
* Operator, \B regexp:                   Regexp Operators.   (line  279)
* Operator, \b regexp:                   Regexp Operators.   (line  274)
* Operator, \W regexp:                   Regexp Operators.   (line  262)
* Operator, \w regexp:                   Regexp Operators.   (line  257)
* Operator, | regexp:                    Regexp Operators.   (line  170)
* Operators, regexp:                     Regexp Operators.   (line    6)
* Opposition:                            Glossary.           (line  510)
* Option:                                Glossary.           (line  515)
* 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 <1>:                           Options.            (line    6)
* Options:                               Command line arguments.
                                                             (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  860)
* Options, fixed date text:              Fixed date options. (line  612)
* Options, long-style:                   Options.            (line   21)
* Options, short-style:                  Options.            (line   21)
* Options, single character:             Fixed date options. (line  582)
* Orbit, Sun's <1>:                      Moon data.          (line  324)
* Orbit, Sun's:                          Sun data.           (line  382)
* Orthodox new calendar holidays in eternal holiday list: Calendar options.
                                                             (line  114)
* Orthodox old calendar holidays in eternal holiday list: Calendar options.
                                                             (line  121)
* Orthodrome <1>:                        Glossary.           (line  519)
* Orthodrome:                            Geographical distance and course angle.
                                                             (line    6)
* Other resource file:                   Fixed date options. (line  465)
* Output of base time of astronomical functions <1>: Moon data.
                                                             (line  450)
* Output of base time of astronomical functions: Sun data.   (line  482)
* Output, pipelining:                    Global options.     (line  170)
* Output, redirection:                   Global options.     (line  170)
* PAGER environment variable <1>:        Environment Variables.
                                                             (line   99)
* PAGER environment variable:            Global options.     (line   48)
* 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 <1>:         Environment Variables.
                                                             (line  104)
* PATH environment variable:             Global options.     (line   53)
* Pattern <1>:                           Glossary.           (line  524)
* Pattern:                               Fixed date options. (line  386)
* Pattern, regular expressions:          Regular Expressions.
                                                             (line    6)
* Period of double or shorter shadow length: Sun data.       (line  853)
* Period of Gregorian Reformation, set:  Calendar options.   (line 1556)
* Period of longer than double shadow length: Sun data.      (line  858)
* Period of longer than single shadow length: Sun data.      (line  822)
* Period of single or shorter shadow length: Sun data.       (line  817)
* 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  568)
* Persian Jalaali holidays in eternal holiday list: Calendar options.
                                                             (line  128)
* Phase angle:                           Glossary.           (line  530)
* Pipelining <1>:                        Glossary.           (line  534)
* Pipelining:                            Global options.     (line   91)
* Pipelining of output:                  Global options.     (line  170)
* Positive day:                          Glossary.           (line  538)
* Positive day, biorhythm:               Biorhythm.          (line   21)
* POSIX:                                 Glossary.           (line  543)
* POSIX regexp:                          Regexp Operators.   (line   74)
* Prayer time Asr, Islamic:              Sun data.           (line   49)
* Prayer time Fajr, Islamic:             Sun data.           (line  309)
* Prayer time Isha, Islamic:             Sun data.           (line  323)
* Prayer time Maghrib, Islamic:          Sun data.           (line  195)
* Prayer time Zuhr, Islamic:             Sun data.           (line   49)
* Precedence, regexp operators:          Regexp Operators.   (line  301)
* Precision of astronomical calculations: Preface.           (line   20)
* 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 <1>:           Glossary.           (line  548)
* Proleptic calendar mode:               Calendar options.   (line 1589)
* Proleptic Gregorian calendar:          Calendar options.   (line 1596)
* Proleptic Julian calendar:             Calendar options.   (line 1601)
* Protection character, \ <1>:           Other difference values.
                                                             (line   11)
* Protection character, \ <2>:           Text variables.     (line   91)
* Protection character, \ <3>:           Special Texts processed.
                                                             (line    6)
* Protection character, \ <4>:           Text part of a line.
                                                             (line   52)
* Protection character, \:               Fixed date options. (line  101)
* Protection of special characters <1>:  Other difference values.
                                                             (line   11)
* Protection of special characters <2>:  Text variables.     (line   91)
* Protection of special characters <3>:  Special Texts processed.
                                                             (line    6)
* Protection of special characters <4>:  Text part of a line.
                                                             (line   52)
* Protection of special characters <5>:  Response file.      (line    6)
* Protection of special characters <6>:  Fixed date options. (line  101)
* Protection of special characters:      Command line arguments.
                                                             (line   28)
* Provide calendar sheet with week numbers: Calendar options.
                                                             (line 1349)
* Pseudo space character, _:             Fixed date options. (line  115)
* Public-access resource files:          Environment Variables.
                                                             (line   30)
* Quotation of special characters <1>:   Response file.      (line    6)
* Quotation of special characters:       Command line arguments.
                                                             (line   28)
* 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 <1>:                Glossary.           (line  389)
* Ranges of commands <2>:                Ranges of commands. (line    6)
* Ranges of commands:                    Commands.           (line    6)
* 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  554)
* Redirection <1>:                       Glossary.           (line  560)
* Redirection:                           Global options.     (line   91)
* Redirection of output:                 Global options.     (line  170)
* 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  130)
* Reference altitude used for sunrise and sunset, set: Fixed date options.
                                                             (line  130)
* Reference systems used, Moon oriented special texts: Moon data.
                                                             (line  929)
* Reference systems used, Sun oriented special texts: Sun data.
                                                             (line 1185)
* References of text variables:          Structure of resource file.
                                                             (line   82)
* Refraction:                            Glossary.           (line  564)
* Refraction, atmospheric:               Fixed date options. (line  152)
* Regexp <1>:                            Glossary.           (line  571)
* Regexp:                                Regular Expressions.
                                                             (line    6)
* Regexp anchor metacharacter, $:        Regexp Operators.   (line   32)
* Regexp anchor metacharacter, ^:        Regexp Operators.   (line   22)
* Regexp character class, [:alnum:]:     Regexp Operators.   (line   88)
* Regexp character class, [:alpha:]:     Regexp Operators.   (line   91)
* Regexp character class, [:blank:]:     Regexp Operators.   (line   94)
* Regexp character class, [:cntrl:]:     Regexp Operators.   (line   97)
* Regexp character class, [:digit:]:     Regexp Operators.   (line  100)
* Regexp character class, [:graph:]:     Regexp Operators.   (line  103)
* Regexp character class, [:lower:]:     Regexp Operators.   (line  107)
* Regexp character class, [:print:]:     Regexp Operators.   (line  110)
* Regexp character class, [:punct:]:     Regexp Operators.   (line  113)
* Regexp character class, [:space:]:     Regexp Operators.   (line  117)
* Regexp character class, [:upper:]:     Regexp Operators.   (line  120)
* Regexp character class, [:xdigit:]:    Regexp Operators.   (line  123)
* Regexp character classes, [:KEYWORD:]: Regexp Operators.   (line   74)
* Regexp character list, [...]:          Regexp Operators.   (line   50)
* Regexp collating symbols, [.ELEMENT.]: Regexp Operators.   (line  140)
* Regexp complemented character list, [^ ...]: Regexp Operators.
                                                             (line  160)
* Regexp equivalence classes, [=LIST=]:  Regexp Operators.   (line  147)
* Regexp grouping, (...):                Regexp Operators.   (line  184)
* Regexp interval expressions, {EXPRESSION}: Regexp Operators.
                                                             (line  233)
* Regexp metacharacter, .:               Regexp Operators.   (line   40)
* Regexp metacharacter, \:               Regexp Operators.   (line   14)
* Regexp metacharacters:                 Regexp Operators.   (line    6)
* Regexp operator, *:                    Regexp Operators.   (line  191)
* Regexp operator, +:                    Regexp Operators.   (line  211)
* Regexp operator, ?:                    Regexp Operators.   (line  223)
* Regexp operator, \':                   Regexp Operators.   (line  299)
* Regexp operator, \<:                   Regexp Operators.   (line  266)
* Regexp operator, \>:                   Regexp Operators.   (line  270)
* Regexp operator, \`:                   Regexp Operators.   (line  295)
* Regexp operator, \B:                   Regexp Operators.   (line  279)
* Regexp operator, \b:                   Regexp Operators.   (line  274)
* Regexp operator, \W:                   Regexp Operators.   (line  262)
* Regexp operator, \w:                   Regexp Operators.   (line  257)
* Regexp operator, |:                    Regexp Operators.   (line  170)
* Regexp operators:                      Regexp Operators.   (line    6)
* Regexp operators, GNU specific:        Regexp Operators.   (line  249)
* Regexp operators, precedence:          Regexp Operators.   (line  301)
* Regexp, anchors:                       Regexp Operators.   (line   22)
* Regexp, buffer:                        Regexp Operators.   (line  285)
* Regexp, buffer matching operators:     Regexp Operators.   (line  294)
* Regexp, case sensitivity in matching:  Regexp Operators.   (line  306)
* Regexp, character classes:             Regexp Operators.   (line   74)
* Regexp, character list:                Regexp Operators.   (line   50)
* Regexp, collating elements:            Regexp Operators.   (line  132)
* Regexp, collating symbols:             Regexp Operators.   (line  140)
* Regexp, complemented character list:   Regexp Operators.   (line  160)
* Regexp, definition of a word:          Regexp Operators.   (line  252)
* Regexp, equivalence classes:           Regexp Operators.   (line  147)
* Regexp, ignoring case <1>:             Regexp Operators.   (line  311)
* Regexp, ignoring case:                 Fixed date options. (line  411)
* Regexp, interval expressions:          Regexp Operators.   (line  233)
* Regexp, matching word boundaries:      Regexp Operators.   (line  274)
* Regexp, negated character list:        Regexp Operators.   (line  160)
* Regexp, POSIX:                         Regexp Operators.   (line   74)
* Regular expression <1>:                Glossary.           (line  571)
* Regular expression <2>:                Regular Expressions.
                                                             (line    6)
* Regular expression:                    Fixed date options. (line  386)
* Regular expression anchor metacharacter, $: Regexp Operators.
                                                             (line   32)
* Regular expression anchor metacharacter, ^: Regexp Operators.
                                                             (line   22)
* Regular expression character class, [:alnum:]: Regexp Operators.
                                                             (line   88)
* Regular expression character class, [:alpha:]: Regexp Operators.
                                                             (line   91)
* Regular expression character class, [:blank:]: Regexp Operators.
                                                             (line   94)
* Regular expression character class, [:cntrl:]: Regexp Operators.
                                                             (line   97)
* Regular expression character class, [:digit:]: Regexp Operators.
                                                             (line  100)
* Regular expression character class, [:graph:]: Regexp Operators.
                                                             (line  103)
* Regular expression character class, [:lower:]: Regexp Operators.
                                                             (line  107)
* Regular expression character class, [:print:]: Regexp Operators.
                                                             (line  110)
* Regular expression character class, [:punct:]: Regexp Operators.
                                                             (line  113)
* Regular expression character class, [:space:]: Regexp Operators.
                                                             (line  117)
* Regular expression character class, [:upper:]: Regexp Operators.
                                                             (line  120)
* Regular expression character class, [:xdigit:]: Regexp Operators.
                                                             (line  123)
* Regular expression character classes, [:KEYWORD:]: Regexp Operators.
                                                             (line   74)
* Regular expression character list, [...]: Regexp Operators.
                                                             (line   50)
* Regular expression collating symbols, [.ELEMENT.]: Regexp Operators.
                                                             (line  140)
* Regular expression complemented character list, [^ ...]: Regexp Operators.
                                                             (line  160)
* Regular expression equivalence class, [=LIST=]: Regexp Operators.
                                                             (line  147)
* Regular expression grouping, (...):    Regexp Operators.   (line  184)
* Regular expression interval expressions, {EXPRESSION}: Regexp Operators.
                                                             (line  233)
* 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  191)
* Regular expression operator, +:        Regexp Operators.   (line  211)
* Regular expression operator, ?:        Regexp Operators.   (line  223)
* Regular expression operator, \':       Regexp Operators.   (line  299)
* Regular expression operator, \<:       Regexp Operators.   (line  266)
* Regular expression operator, \>:       Regexp Operators.   (line  270)
* Regular expression operator, \`:       Regexp Operators.   (line  295)
* Regular expression operator, \B:       Regexp Operators.   (line  279)
* Regular expression operator, \b:       Regexp Operators.   (line  274)
* Regular expression operator, \W:       Regexp Operators.   (line  262)
* Regular expression operator, \w:       Regexp Operators.   (line  257)
* Regular expression operator, |:        Regexp Operators.   (line  170)
* Regular expression operators <1>:      Glossary.           (line  462)
* Regular expression operators:          Regexp Operators.   (line    6)
* Regular expression, complemented:      Fixed date options. (line  416)
* Regular expression, ignoring case distinctions <1>: Regexp Operators.
                                                             (line  311)
* Regular expression, ignoring case distinctions: Fixed date options.
                                                             (line  411)
* Regular expression, negated:           Fixed date options. (line  416)
* Regular expression, reverted:          Fixed date options. (line  416)
* 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 <1>: Special Texts Summary.
                                                             (line 1846)
* Relative day number %d special text:   Other difference values.
                                                             (line   21)
* Relative month number %m special text <1>: Special Texts Summary.
                                                             (line 1852)
* Relative month number %m special text: Other difference values.
                                                             (line   34)
* Relative time offset value <1>:        Glossary.           (line  574)
* Relative time offset value:            Calendar options.   (line 1505)
* Relative week number %w special text <1>: Special Texts Summary.
                                                             (line 1849)
* Relative week number %w special text:  Other difference values.
                                                             (line   29)
* Relative year number %y special text <1>: Special Texts Summary.
                                                             (line 1855)
* Relative year number %y special text:  Other difference values.
                                                             (line   39)
* Relative year number %yDATE special text <1>: Special Texts Summary.
                                                             (line  224)
* Relative year number %yDATE special text: Difference value.
                                                             (line   10)
* Religious Islamic calendar <1>:        Glossary.           (line  577)
* Religious Islamic calendar:            Preface.            (line  164)
* Remark character, ; <1>:               Comment line.       (line    6)
* Remark character, ;:                   Response file.      (line   21)
* Remarked line in resource file <1>:    Comment line.       (line    6)
* Remarked line in resource file:        Structure of resource file.
                                                             (line   46)
* Repetition factor of days, :N:         Repetition factor of days.
                                                             (line    6)
* Repetition factors of days, examples:  Repetition factor of days.
                                                             (line   57)
* Repetition factors of days, valid date parts: Repetition factor of days.
                                                             (line   42)
* 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  565)
* Resource file <1>:                     Glossary.           (line  580)
* Resource file:                         Fixed Dates.        (line   11)
* Resource file examples:                Resource file examples.
                                                             (line    6)
* Resource file line, additional:        Fixed date options. (line  512)
* Resource file line, commented <1>:     Comment line.       (line    6)
* Resource file line, commented:         Structure of resource file.
                                                             (line   46)
* Resource file line, further:           Fixed date options. (line  512)
* Resource file line, long text part:    Text part of a line.
                                                             (line   42)
* Resource file line, remarked <1>:      Comment line.       (line    6)
* Resource file line, remarked:          Structure of resource file.
                                                             (line   46)
* Resource file, .gcalrc:                Resource file.      (line    6)
* Resource file, additional <1>:         Resource file.      (line    6)
* Resource file, additional:             Fixed date options. (line  465)
* Resource file, coding scheme:          Coding Scheme.      (line    6)
* Resource file, commented line <1>:     Comment line.       (line    6)
* Resource file, commented line:         Structure of resource file.
                                                             (line   46)
* Resource file, date part:              Coding Scheme.      (line    6)
* Resource file, date part of a line:    Date part of a line.
                                                             (line    6)
* Resource file, force line break-up:    Text part of a line.
                                                             (line   42)
* Resource file, include directives:     Include directives. (line    6)
* Resource file, limitations <1>:        Date variables.     (line    6)
* Resource file, limitations <2>:        Text part of a line.
                                                             (line    6)
* Resource file, limitations <3>:        Structure of resource file.
                                                             (line    6)
* Resource file, limitations:            Global options.     (line  213)
* Resource file, line continuation:      Text part of a line.
                                                             (line   29)
* Resource file, loading:                Resource file.      (line    6)
* Resource file, name:                   Resource file.      (line    6)
* Resource file, other:                  Fixed date options. (line  465)
* Resource file, remarked line <1>:      Comment line.       (line    6)
* Resource file, remarked line:          Structure of resource file.
                                                             (line   46)
* 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  583)
* Response file, @FILE:                  Response file.      (line    6)
* Response file, creation:               Global options.     (line    8)
* Reverted regular expression:           Fixed date options. (line  416)
* RFC:                                   Glossary.           (line  557)
* RFC-822, numerical local time timezone offset value: Actual clocktime.
                                                             (line  191)
* RFC-822, numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  175)
* Right ascension:                       Glossary.           (line  588)
* Right ascension, Moon:                 Moon data.          (line  343)
* Right ascension, Sun:                  Sun data.           (line  390)
* Rise azimuth:                          Glossary.           (line  593)
* Rise azimuth geocentric, Moon:         Moon data.          (line  761)
* Rise azimuth geocentric, Sun:          Sun data.           (line  774)
* Rise azimuth topocentric, Moon:        Moon data.          (line  685)
* Rise azimuth topocentric, Sun:         Sun data.           (line  728)
* Rise height:                           Glossary.           (line  597)
* Rise height geocentric, Moon:          Moon data.          (line  747)
* Rise height geocentric, Sun:           Sun data.           (line  761)
* Rise height topocentric, Moon:         Moon data.          (line  671)
* Rise height topocentric, Sun:          Sun data.           (line  714)
* Rise phase angle:                      Glossary.           (line  601)
* Rise phase angle geocentric, Moon:     Moon data.          (line  780)
* Rise phase angle topocentric, Moon:    Moon data.          (line  705)
* Rise width:                            Glossary.           (line  478)
* Rise width geocentric, Moon:           Moon data.          (line  761)
* Rise width topocentric, Moon:          Moon data.          (line  685)
* Run-time error codes, table:           Error Codes.        (line    6)
* Scope of date variables <1>:           Date variables.     (line  129)
* Scope of date variables:               Fixed date options. (line    8)
* Scope of text variables <1>:           Text variables.     (line  357)
* Scope of text variables:               Fixed date options. (line   35)
* 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  183)
* Separator character of lists of days, ,: Lists of days.    (line    6)
* Separator character of ranges of days, #: Ranges of days.  (line    6)
* Separator character, + <1>:            Fixed date options. (line  478)
* Separator character, +:                Calendar options.   (line  157)
* Separator character, : <1>:            Fixed date options. (line    8)
* Separator character, ::                Global options.     (line  107)
* Separator character, whitespace <1>:   Include directives. (line   23)
* Separator character, whitespace <2>:   Structure of resource file.
                                                             (line    6)
* Separator character, whitespace:       Options.            (line   66)
* Sequence of control characters:        Global options.     (line  107)
* Set azimuth:                           Glossary.           (line  605)
* Set azimuth geocentric, Moon:          Moon data.          (line  771)
* Set azimuth geocentric, Sun:           Sun data.           (line  783)
* Set azimuth topocentric, Moon:         Moon data.          (line  695)
* Set azimuth topocentric, Sun:          Sun data.           (line  738)
* Set cycle displacement value for Sun and Moon data and times: Fixed date options.
                                                             (line  283)
* 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  283)
* Set height:                            Glossary.           (line  609)
* Set height geocentric, Moon:           Moon data.          (line  754)
* Set height geocentric, Sun:            Sun data.           (line  768)
* Set height topocentric, Moon:          Moon data.          (line  678)
* Set height topocentric, Sun:           Sun data.           (line  721)
* Set highlighting sequences:            Global options.     (line  107)
* Set marking characters:                Global options.     (line  107)
* Set phase angle:                       Glossary.           (line  613)
* Set phase angle geocentric, Moon:      Moon data.          (line  787)
* Set phase angle topocentric, Moon:     Moon data.          (line  712)
* Set shadow length factor:              Fixed date options. (line  140)
* Set starting day of week:              Calendar options.   (line 1471)
* Set width:                             Glossary.           (line  218)
* Set width geocentric, Moon:            Moon data.          (line  771)
* Set width topocentric, Moon:           Moon data.          (line  695)
* Shadow length at afternoon, double:    Sun data.           (line  837)
* Shadow length at afternoon, single:    Sun data.           (line  801)
* Shadow length at forenoon, double:     Sun data.           (line  828)
* Shadow length at forenoon, single:     Sun data.           (line  792)
* Shadow length factor, set:             Fixed date options. (line  140)
* Shell <1>:                             Glossary.           (line  617)
* Shell <2>:                             Text variables.     (line   97)
* Shell <3>:                             Fixed date options. (line  342)
* Shell <4>:                             Command line arguments.
                                                             (line   28)
* Shell:                                 Invoking Gcal.      (line   11)
* Shell command %![ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line 1898)
* Shell command %![ARGUMENT] special text: Shell Command.    (line    6)
* 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 <1>:                Glossary.           (line  621)
* Short-style option:                    Options.            (line   21)
* Sidereal time, Moon:                   Moon data.          (line  435)
* Sidereal time, Sun:                    Sun data.           (line  467)
* Signed angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line  992)
* Signed decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  895)
* Signed time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  961)
* Simple decrement of date variables:    Date variables.     (line  123)
* Simple decrement of text variables:    Text variables.     (line  299)
* Simple file name <1>:                  Glossary.           (line  624)
* Simple file name:                      Resource file.      (line   85)
* Simple increment of date variables:    Date variables.     (line  122)
* Simple increment of text variables:    Text variables.     (line  298)
* Simple language code information <1>:  Glossary.           (line  629)
* Simple language code information:      Internationalization.
                                                             (line   46)
* Single character options <1>:          Fixed date options. (line  582)
* Single character options:              Options.            (line   21)
* Single command:                        Glossary.           (line  634)
* Single command line word <1>:          Fixed date options. (line  582)
* Single command line word:              Options.            (line   21)
* Single Commands:                       Single commands.    (line    6)
* Single commands:                       Commands.           (line    6)
* Single fiscal year:                    Single commands.    (line   46)
* 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  817)
* Single shadow length at afternoon:     Sun data.           (line  801)
* Single shadow length at forenoon:      Sun data.           (line  792)
* Single year mode:                      Single commands.    (line   18)
* Software license, finding:             Common options.     (line   33)
* Solar Arctic Circle <1>:               Glossary.           (line  637)
* Solar Arctic Circle:                   Sun data.           (line 1218)
* Solar day length:                      Sun data.           (line    6)
* Solar day, mean:                       Sun data.           (line  501)
* Solar day, true:                       Sun data.           (line  501)
* Solar eclipse:                         Calendar options.   (line   48)
* Solar night length:                    Sun data.           (line    6)
* Solar time, mean:                      Sun data.           (line  501)
* Solar time, true:                      Sun data.           (line  501)
* Solstice in summer:                    Glossary.           (line  659)
* Solstice in winter:                    Glossary.           (line  744)
* Solstice, summer:                      Calendar options.   (line   48)
* Solstice, winter:                      Calendar options.   (line   48)
* Special 3-Month mode commands <1>:     3-Month mode commands.
                                                             (line    6)
* Special 3-Month mode commands:         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 1289)
* Special character sequences in the text part, handling: Text part of a line.
                                                             (line    6)
* Special characters, country specific:  Calendar options.   (line 1718)
* Special characters, depreciation <1>:  Other difference values.
                                                             (line   11)
* Special characters, depreciation <2>:  Text variables.     (line   91)
* Special characters, depreciation <3>:  Special Texts processed.
                                                             (line    6)
* Special characters, depreciation <4>:  Text part of a line.
                                                             (line   52)
* Special characters, depreciation <5>:  Response file.      (line    6)
* Special characters, depreciation <6>:  Fixed date options. (line  101)
* Special characters, depreciation:      Command line arguments.
                                                             (line   28)
* Special characters, protection <1>:    Other difference values.
                                                             (line   11)
* Special characters, protection <2>:    Text variables.     (line   91)
* Special characters, protection <3>:    Special Texts processed.
                                                             (line    6)
* Special characters, protection <4>:    Text part of a line.
                                                             (line   52)
* Special characters, protection <5>:    Response file.      (line    6)
* Special characters, protection <6>:    Fixed date options. (line  101)
* Special characters, protection:        Command line arguments.
                                                             (line   28)
* Special characters, quotation <1>:     Response file.      (line    6)
* Special characters, quotation:         Command line arguments.
                                                             (line   28)
* Special date format in calendar sheet: Calendar options.   (line 1424)
* Special date format in eternal holiday list: Calendar options.
                                                             (line 1442)
* Special date format in fixed date list: Calendar options.  (line 1460)
* Special event oriented texts, Moon data and times: Sun data.
                                                             (line  917)
* Special event oriented texts, Sun data and times: Sun data.
                                                             (line  917)
* Special text:                          Glossary.           (line  651)
* Special text %![ARGUMENT], shell command: Shell Command.   (line    6)
* Special text %"[ARGUMENT], numerical Universal time timezone offset value: Actual clocktime.
                                                             (line  175)
* Special text %,[DATE], biorhythm text: Biorhythm.          (line   34)
* Special text %0, end of highlighting sequence 1 or 2: Highlighting.
                                                             (line  126)
* 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   62)
* Special text %=[ARGUMENT], numerical local time timezone offset value: Actual clocktime.
                                                             (line  191)
* 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   29)
* 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  119)
* 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  104)
* Special text %[FORMAT]'[ARGUMENT], actual local time in M[M...] format: Actual clocktime.
                                                             (line   51)
* Special text %[FORMAT]-[ARGUMENT], environment varibale: Contents of Environment variable.
                                                             (line    6)
* Special text %[FORMAT].[ARGUMENT], actual Universal time hour: Actual clocktime.
                                                             (line  134)
* Special text %[FORMAT]/[ARGUMENT], actual Universal time minute: Actual clocktime.
                                                             (line  147)
* Special text %[FORMAT]?[ARGUMENT], actual local time minute: Actual clocktime.
                                                             (line   78)
* Special text %[FORMAT]_[ARGUMENT], actual local time hour: Actual clocktime.
                                                             (line   65)
* Special text %[FORMAT]`[ARGUMENT], actual Universal time in M[M...]/DATE format: Actual clocktime.
                                                             (line  119)
* 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 12-hour format suffix: Actual clocktime.
                                                             (line   91)
* Special text %[FORMAT]}[ARGUMENT], actual Universal time 12-hour format suffix: Actual clocktime.
                                                             (line  161)
* 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   14)
* 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   19)
* Special text %T[DATE], weekday number: Weekday number.     (line  108)
* 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 %Y[DATE], year number:    Year number.        (line    7)
* Special text %yDATE, relative year number: Difference value.
                                                             (line   10)
* Special text %Z[DATE], Moon phase text graphics: Moon phase.
                                                             (line   44)
* 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], 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 %[FORMAT]?ARGUMENT, Moon data: Moon data.    (line    6)
* Special texts %[FORMAT]?ARGUMENT, Sun data: Sun data.      (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 1430)
* Standard and special date format in eternal holiday list: Calendar options.
                                                             (line 1448)
* Standard and special date format in fixed date list: Calendar options.
                                                             (line 1466)
* Standard calendar format:              Calendar options.   (line 1289)
* Standard non-visibility period, Moon:  Moon data.          (line  248)
* Standard non-visibility period, Sun:   Sun data.           (line  223)
* Standard rise time, Moon:              Moon data.          (line  193)
* Standard rise time, Sun:               Sun data.           (line  169)
* Standard set time, Moon:               Moon data.          (line  221)
* Standard set time, Sun:                Sun data.           (line  195)
* Standard visibility period, Moon:      Moon data.          (line  240)
* Standard visibility period, Sun:       Sun data.           (line  215)
* Standard week number <1>:              Glossary.           (line  664)
* Standard week number <2>:              Week number.        (line    7)
* Standard week number <3>:              Date part of a line.
                                                             (line   57)
* Standard week number <4>:              Fixed date options. (line  757)
* Standard week number:                  Calendar options.   (line 1374)
* Star day <1>:                          Glossary.           (line  670)
* Star day <2>:                          Moon data.          (line  435)
* Star day:                              Sun data.           (line  467)
* Star time <1>:                         Moon data.          (line  435)
* Star time:                             Sun data.           (line  467)
* Start of highlighting sequence 1 %1 special text <1>: Special Texts Summary.
                                                             (line 1860)
* Start of highlighting sequence 1 %1 special text: Highlighting.
                                                             (line    9)
* Start of highlighting sequence 1 %5 special text <1>: Special Texts Summary.
                                                             (line 1872)
* Start of highlighting sequence 1 %5 special text: Highlighting.
                                                             (line   65)
* Start of highlighting sequence 1 or 2 %9 special text <1>: Special Texts Summary.
                                                             (line 1888)
* Start of highlighting sequence 1 or 2 %9 special text: Highlighting.
                                                             (line  109)
* Start of highlighting sequence 2 %3 special text <1>: Special Texts Summary.
                                                             (line 1866)
* Start of highlighting sequence 2 %3 special text: Highlighting.
                                                             (line   37)
* Start of highlighting sequence 2 %7 special text <1>: Special Texts Summary.
                                                             (line 1880)
* Start of highlighting sequence 2 %7 special text: Highlighting.
                                                             (line   87)
* Starting date:                         Glossary.           (line  675)
* Starting date of fixed date <1>:       Exclusive date period.
                                                             (line   12)
* Starting date of fixed date:           Inclusive date period.
                                                             (line   11)
* Starting day of week, setting:         Calendar options.   (line 1471)
* Statute mile <1>:                      Glossary.           (line  679)
* Statute mile:                          Geographical distance and course angle.
                                                             (line   15)
* String:                                Glossary.           (line  682)
* 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 <1>: Moon data.
                                                             (line  799)
* Style of representation of Moon data and times: Sun data.  (line  870)
* Style of representation of Sun data and times: Sun data.   (line  870)
* Style of representation, geographical distance and course angle: Geographical distance and course angle.
                                                             (line   15)
* Subtraction by days of date variables: Date variables.     (line  125)
* Subtraction by weekdays of date variables: Date variables. (line  127)
* Subtraction of text variables:         Text variables.     (line  301)
* Summary of all %?... special texts:    Special Texts Summary.
                                                             (line    6)
* Summary of all regular expressions:    Regexp Summary.     (line    6)
* Summer point on the ecliptic:          Glossary.           (line  659)
* Summer solstice <1>:                   Glossary.           (line  659)
* Summer solstice:                       Calendar options.   (line   48)
* Summertime:                            Sun data.           (line 1058)
* Sun and Moon data and times, set cycle displacement value: Fixed date options.
                                                             (line  283)
* 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  283)
* Sun and Moon oriented special texts, Clocktime value: Sun data.
                                                             (line  909)
* Sun and Moon oriented special texts, signed angular value: Sun data.
                                                             (line  992)
* Sun and Moon oriented special texts, signed decimal based rational number value: Sun data.
                                                             (line  895)
* Sun and Moon oriented special texts, signed time value: Sun data.
                                                             (line  961)
* Sun and Moon oriented special texts, unsigned angular value: Sun data.
                                                             (line  977)
* Sun and Moon oriented special texts, unsigned decimal based rational number value: Sun data.
                                                             (line  874)
* Sun and Moon oriented special texts, unsigned time value: Sun data.
                                                             (line  945)
* Sun data %[FORMAT]?ARGUMENT special texts <1>: Special Texts Summary.
                                                             (line  301)
* Sun data %[FORMAT]?ARGUMENT special texts: Sun data.       (line    6)
* Sun data and times, default mode:      Sun data.           (line  864)
* Sun data and times, mode characters:   Sun data.           (line   23)
* Sun data and times, special event oriented texts: Sun data.
                                                             (line  917)
* Sun data and times, style of representation: Sun data.     (line  870)
* Sun data and times, type of representation: Sun data.      (line  870)
* Sun oriented special texts, limitations: Sun data.         (line 1185)
* Sun oriented special texts, reference systems used: Sun data.
                                                             (line 1185)
* Sun oriented special texts, table of modes: Sun data.      (line   34)
* Sun oriented special texts, table of representation types: Sun data.
                                                             (line 1089)
* Sun's center, begin of amateur-astronomical %o*8ARGUMENT special text: Special Texts Summary.
                                                             (line  515)
* Sun's center, begin of amateur-astronomical %o8ARGUMENT special text: Special Texts Summary.
                                                             (line  511)
* Sun's center, begin of amateur-astronomical twilight %o*8ARGUMENT special text: Sun data.
                                                             (line  283)
* Sun's center, begin of amateur-astronomical twilight %o8ARGUMENT special text: Sun data.
                                                             (line  283)
* Sun's center, begin of astronomical twilight %o*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  551)
* Sun's center, begin of astronomical twilight %o*9ARGUMENT special text: Sun data.
                                                             (line  309)
* Sun's center, begin of astronomical twilight %o9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  547)
* Sun's center, begin of astronomical twilight %o9ARGUMENT special text: Sun data.
                                                             (line  309)
* Sun's center, begin of civil twilight %o*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  451)
* Sun's center, begin of civil twilight %o*6ARGUMENT special text: Sun data.
                                                             (line  231)
* Sun's center, begin of civil twilight %o6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  447)
* Sun's center, begin of civil twilight %o6ARGUMENT special text: Sun data.
                                                             (line  231)
* Sun's center, begin of nautical twilight %o*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  483)
* Sun's center, begin of nautical twilight %o*7ARGUMENT special text: Sun data.
                                                             (line  257)
* Sun's center, begin of nautical twilight %o7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  479)
* Sun's center, begin of nautical twilight %o7ARGUMENT special text: Sun data.
                                                             (line  257)
* Sun's center, end of amateur-astronomical %s*8ARGUMENT special text: Special Texts Summary.
                                                             (line  523)
* Sun's center, end of amateur-astronomical %s8ARGUMENT special text: Special Texts Summary.
                                                             (line  519)
* Sun's center, end of amateur-astronomical twilight %s*8ARGUMENT special text: Sun data.
                                                             (line  292)
* Sun's center, end of amateur-astronomical twilight %s8ARGUMENT special text: Sun data.
                                                             (line  292)
* Sun's center, end of astronomical twilight %s*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  559)
* Sun's center, end of astronomical twilight %s*9ARGUMENT special text: Sun data.
                                                             (line  323)
* Sun's center, end of astronomical twilight %s9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  555)
* Sun's center, end of astronomical twilight %s9ARGUMENT special text: Sun data.
                                                             (line  323)
* Sun's center, end of civil twilight %s*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  459)
* Sun's center, end of civil twilight %s*6ARGUMENT special text: Sun data.
                                                             (line  240)
* Sun's center, end of civil twilight %s6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  455)
* Sun's center, end of civil twilight %s6ARGUMENT special text: Sun data.
                                                             (line  240)
* Sun's center, end of nautical twilight %s*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  491)
* Sun's center, end of nautical twilight %s*7ARGUMENT special text: Sun data.
                                                             (line  266)
* Sun's center, end of nautical twilight %s7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  487)
* Sun's center, end of nautical twilight %s7ARGUMENT special text: Sun data.
                                                             (line  266)
* Sun's center, geometrical non-visibility %z*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  349)
* Sun's center, geometrical non-visibility %z*2ARGUMENT special text: Sun data.
                                                             (line  101)
* Sun's center, geometrical non-visibility %z2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  345)
* Sun's center, geometrical non-visibility %z2ARGUMENT special text: Sun data.
                                                             (line  101)
* Sun's center, geometrical rise time %o*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  325)
* Sun's center, geometrical rise time %o*2ARGUMENT special text: Sun data.
                                                             (line   79)
* Sun's center, geometrical rise time %o2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  321)
* Sun's center, geometrical rise time %o2ARGUMENT special text: Sun data.
                                                             (line   79)
* Sun's center, geometrical set time %s*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  333)
* Sun's center, geometrical set time %s*2ARGUMENT special text: Sun data.
                                                             (line   93)
* Sun's center, geometrical set time %s2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  329)
* Sun's center, geometrical set time %s2ARGUMENT special text: Sun data.
                                                             (line   93)
* Sun's center, geometrical visibility %u*2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  341)
* Sun's center, geometrical visibility %u*2ARGUMENT special text: Sun data.
                                                             (line   97)
* Sun's center, geometrical visibility %u2ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  337)
* Sun's center, geometrical visibility %u2ARGUMENT special text: Sun data.
                                                             (line   97)
* Sun's center, non-visibility %z*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  411)
* Sun's center, non-visibility %z*4ARGUMENT special text: Sun data.
                                                             (line  164)
* Sun's center, non-visibility %z4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  407)
* Sun's center, non-visibility %z4ARGUMENT special text: Sun data.
                                                             (line  164)
* Sun's center, period above amateur-astronomical twilight reference altitude %u*8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  532)
* Sun's center, period above amateur-astronomical twilight reference altitude %u*8ARGUMENT special text: Sun data.
                                                             (line  297)
* Sun's center, period above amateur-astronomical twilight reference altitude %u8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  527)
* Sun's center, period above amateur-astronomical twilight reference altitude %u8ARGUMENT special text: Sun data.
                                                             (line  297)
* Sun's center, period above astronomical twilight reference altitude %u*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  567)
* Sun's center, period above astronomical twilight reference altitude %u*9ARGUMENT special text: Sun data.
                                                             (line  332)
* Sun's center, period above astronomical twilight reference altitude %u9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  563)
* Sun's center, period above astronomical twilight reference altitude %u9ARGUMENT special text: Sun data.
                                                             (line  332)
* Sun's center, period above civil twilight reference altitude %u*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  467)
* Sun's center, period above civil twilight reference altitude %u*6ARGUMENT special text: Sun data.
                                                             (line  245)
* Sun's center, period above civil twilight reference altitude %u6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  463)
* Sun's center, period above civil twilight reference altitude %u6ARGUMENT special text: Sun data.
                                                             (line  245)
* Sun's center, period above nautical twilight reference altitude %u*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  499)
* Sun's center, period above nautical twilight reference altitude %u*7ARGUMENT special text: Sun data.
                                                             (line  271)
* Sun's center, period above nautical twilight reference altitude %u7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  495)
* Sun's center, period above nautical twilight reference altitude %u7ARGUMENT special text: Sun data.
                                                             (line  271)
* Sun's center, period below amateur-astronomical twilight reference altitude %z*8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  542)
* Sun's center, period below amateur-astronomical twilight reference altitude %z*8ARGUMENT special text: Sun data.
                                                             (line  303)
* Sun's center, period below amateur-astronomical twilight reference altitude %z8ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  537)
* Sun's center, period below amateur-astronomical twilight reference altitude %z8ARGUMENT special text: Sun data.
                                                             (line  303)
* Sun's center, period below astronomical twilight reference altitude %z*9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  575)
* Sun's center, period below astronomical twilight reference altitude %z*9ARGUMENT special text: Sun data.
                                                             (line  338)
* Sun's center, period below astronomical twilight reference altitude %z9ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  571)
* Sun's center, period below astronomical twilight reference altitude %z9ARGUMENT special text: Sun data.
                                                             (line  338)
* Sun's center, period below civil twilight reference altitude %z*6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  475)
* Sun's center, period below civil twilight reference altitude %z*6ARGUMENT special text: Sun data.
                                                             (line  251)
* Sun's center, period below civil twilight reference altitude %z6ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  471)
* Sun's center, period below civil twilight reference altitude %z6ARGUMENT special text: Sun data.
                                                             (line  251)
* Sun's center, period below nautical twilight reference altitude %z*7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  507)
* Sun's center, period below nautical twilight reference altitude %z*7ARGUMENT special text: Sun data.
                                                             (line  277)
* Sun's center, period below nautical twilight reference altitude %z7ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  503)
* Sun's center, period below nautical twilight reference altitude %z7ARGUMENT special text: Sun data.
                                                             (line  277)
* Sun's center, rise time %o*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  388)
* Sun's center, rise time %o*4ARGUMENT special text: Sun data.
                                                             (line  134)
* Sun's center, rise time %o4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  385)
* Sun's center, rise time %o4ARGUMENT special text: Sun data.
                                                             (line  134)
* Sun's center, set time %s*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  395)
* Sun's center, set time %s*4ARGUMENT special text: Sun data.
                                                             (line  149)
* Sun's center, set time %s4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  392)
* Sun's center, set time %s4ARGUMENT special text: Sun data. (line  149)
* Sun's center, visibility %u*4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  403)
* Sun's center, visibility %u*4ARGUMENT special text: Sun data.
                                                             (line  159)
* Sun's center, visibility %u4ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  399)
* Sun's center, visibility %u4ARGUMENT special text: Sun data.
                                                             (line  159)
* Sun's orbit <1>:                       Moon data.          (line  324)
* Sun's orbit:                           Sun data.           (line  382)
* Sun's upper limb, geometrical non-visibility %z*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  381)
* Sun's upper limb, geometrical non-visibility %z*3ARGUMENT special text: Sun data.
                                                             (line  129)
* Sun's upper limb, geometrical non-visibility %z3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  377)
* Sun's upper limb, geometrical non-visibility %z3ARGUMENT special text: Sun data.
                                                             (line  129)
* Sun's upper limb, geometrical rise time %o*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  357)
* Sun's upper limb, geometrical rise time %o*3ARGUMENT special text: Sun data.
                                                             (line  106)
* Sun's upper limb, geometrical rise time %o3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  353)
* Sun's upper limb, geometrical rise time %o3ARGUMENT special text: Sun data.
                                                             (line  106)
* Sun's upper limb, geometrical set time %s*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  365)
* Sun's upper limb, geometrical set time %s*3ARGUMENT special text: Sun data.
                                                             (line  118)
* Sun's upper limb, geometrical set time %s3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  361)
* Sun's upper limb, geometrical set time %s3ARGUMENT special text: Sun data.
                                                             (line  118)
* Sun's upper limb, geometrical visibility %u*3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  373)
* Sun's upper limb, geometrical visibility %u*3ARGUMENT special text: Sun data.
                                                             (line  125)
* Sun's upper limb, geometrical visibility %u3ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  369)
* Sun's upper limb, geometrical visibility %u3ARGUMENT special text: Sun data.
                                                             (line  125)
* Sun's upper limb, standard non-visibility %z*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  443)
* Sun's upper limb, standard non-visibility %z*5ARGUMENT special text: Sun data.
                                                             (line  223)
* Sun's upper limb, standard non-visibility %z5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  439)
* Sun's upper limb, standard non-visibility %z5ARGUMENT special text: Sun data.
                                                             (line  223)
* Sun's upper limb, standard rise time %o*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  419)
* Sun's upper limb, standard rise time %o*5ARGUMENT special text: Sun data.
                                                             (line  169)
* Sun's upper limb, standard rise time %o5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  415)
* Sun's upper limb, standard rise time %o5ARGUMENT special text: Sun data.
                                                             (line  169)
* Sun's upper limb, standard set time %s*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  427)
* Sun's upper limb, standard set time %s*5ARGUMENT special text: Sun data.
                                                             (line  195)
* Sun's upper limb, standard set time %s5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  423)
* Sun's upper limb, standard set time %s5ARGUMENT special text: Sun data.
                                                             (line  195)
* Sun's upper limb, standard visibility %u*5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  435)
* Sun's upper limb, standard visibility %u*5ARGUMENT special text: Sun data.
                                                             (line  215)
* Sun's upper limb, standard visibility %u5ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  431)
* Sun's upper limb, standard visibility %u5ARGUMENT special text: Sun data.
                                                             (line  215)
* Sun, amateur-astronomical twilight:    Sun data.           (line  283)
* Sun, astronomical midnight time %o*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  308)
* Sun, astronomical midnight time %o*0ARGUMENT special text: Sun data.
                                                             (line   37)
* Sun, astronomical midnight time %o0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  304)
* Sun, astronomical midnight time %o0ARGUMENT special text: Sun data.
                                                             (line   37)
* Sun, astronomical midnight time %s*0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  308)
* Sun, astronomical midnight time %s*0ARGUMENT special text: Sun data.
                                                             (line   37)
* Sun, astronomical midnight time %s0ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  304)
* Sun, astronomical midnight time %s0ARGUMENT special text: Sun data.
                                                             (line   37)
* Sun, astronomical noon time %o*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  317)
* Sun, astronomical noon time %o*1ARGUMENT special text: Sun data.
                                                             (line   49)
* Sun, astronomical noon time %o1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  313)
* Sun, astronomical noon time %o1ARGUMENT special text: Sun data.
                                                             (line   49)
* Sun, astronomical noon time %s*1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  317)
* Sun, astronomical noon time %s*1ARGUMENT special text: Sun data.
                                                             (line   49)
* Sun, astronomical noon time %s1ARGUMENT special text <1>: Special Texts Summary.
                                                             (line  313)
* Sun, astronomical noon time %s1ARGUMENT special text: Sun data.
                                                             (line   49)
* Sun, astronomical twilight:            Sun data.           (line  309)
* Sun, astronomical unit:                Sun data.           (line  397)
* Sun, azimuth:                          Sun data.           (line   37)
* Sun, base time %o*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line  767)
* Sun, base time %o*tARGUMENT special text: Sun data.        (line  482)
* Sun, base time %otARGUMENT special text <1>: Special Texts Summary.
                                                             (line  762)
* Sun, base time %otARGUMENT special text: Sun data.         (line  482)
* Sun, base time %s*tARGUMENT special text <1>: Special Texts Summary.
                                                             (line  767)
* Sun, base time %s*tARGUMENT special text: Sun data.        (line  482)
* Sun, base time %stARGUMENT special text <1>: Special Texts Summary.
                                                             (line  762)
* Sun, base time %stARGUMENT special text: Sun data.         (line  482)
* Sun, civil twilight:                   Sun data.           (line  231)
* Sun, delta-t %o*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line  749)
* Sun, delta-t %o*rARGUMENT special text: Sun data.          (line  460)
* Sun, delta-t %orARGUMENT special text <1>: Special Texts Summary.
                                                             (line  749)
* Sun, delta-t %orARGUMENT special text: Sun data.           (line  460)
* Sun, delta-t %s*rARGUMENT special text <1>: Special Texts Summary.
                                                             (line  749)
* Sun, delta-t %s*rARGUMENT special text: Sun data.          (line  460)
* Sun, delta-t %srARGUMENT special text <1>: Special Texts Summary.
                                                             (line  749)
* Sun, delta-t %srARGUMENT special text: Sun data.           (line  460)
* Sun, double shadow length time at afternoon %s*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1080)
* Sun, double shadow length time at afternoon %s*RARGUMENT special text: Sun data.
                                                             (line  837)
* Sun, double shadow length time at afternoon %sRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1076)
* Sun, double shadow length time at afternoon %sRARGUMENT special text: Sun data.
                                                             (line  837)
* Sun, double shadow length time at forenoon %o*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1072)
* Sun, double shadow length time at forenoon %o*RARGUMENT special text: Sun data.
                                                             (line  828)
* Sun, double shadow length time at forenoon %oRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1068)
* Sun, double shadow length time at forenoon %oRARGUMENT special text: Sun data.
                                                             (line  828)
* Sun, equation of time %o*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line  788)
* Sun, equation of time %o*wARGUMENT special text: Sun data. (line  501)
* Sun, equation of time %owARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, equation of time %owARGUMENT special text: Sun data.  (line  501)
* Sun, equation of time %s*wARGUMENT special text <1>: Special Texts Summary.
                                                             (line  788)
* Sun, equation of time %s*wARGUMENT special text: Sun data. (line  501)
* Sun, equation of time %swARGUMENT special text <1>: Special Texts Summary.
                                                             (line  783)
* Sun, equation of time %swARGUMENT special text: Sun data.  (line  501)
* Sun, evening width geocentric:         Sun data.           (line  783)
* Sun, evening width topocentric:        Sun data.           (line  738)
* Sun, geocentric azimuth %o*kARGUMENT special text <1>: Special Texts Summary.
                                                             (line  683)
* Sun, geocentric azimuth %o*kARGUMENT special text: Sun data.
                                                             (line  427)
* Sun, geocentric azimuth %okARGUMENT special text <1>: Special Texts Summary.
                                                             (line  678)
* Sun, geocentric azimuth %okARGUMENT special text: Sun data.
                                                             (line  427)
* Sun, geocentric azimuth %s*kARGUMENT special text <1>: Special Texts Summary.
                                                             (line  683)
* Sun, geocentric azimuth %s*kARGUMENT special text: Sun data.
                                                             (line  427)
* Sun, geocentric azimuth %skARGUMENT special text <1>: Special Texts Summary.
                                                             (line  678)
* Sun, geocentric azimuth %skARGUMENT special text: Sun data.
                                                             (line  427)
* Sun, geocentric azimuth at standard rise time %o*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1024)
* Sun, geocentric azimuth at standard rise time %o*PARGUMENT special text: Sun data.
                                                             (line  774)
* Sun, geocentric azimuth at standard rise time %oPARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1020)
* Sun, geocentric azimuth at standard rise time %oPARGUMENT special text: Sun data.
                                                             (line  774)
* Sun, geocentric azimuth at standard set time %s*PARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1032)
* Sun, geocentric azimuth at standard set time %s*PARGUMENT special text: Sun data.
                                                             (line  783)
* Sun, geocentric azimuth at standard set time %sPARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1028)
* Sun, geocentric azimuth at standard set time %sPARGUMENT special text: Sun data.
                                                             (line  783)
* Sun, geocentric data:                  Sun data.           (line  344)
* Sun, geocentric declination %o*lARGUMENT special text <1>: Special Texts Summary.
                                                             (line  693)
* Sun, geocentric declination %o*lARGUMENT special text: Sun data.
                                                             (line  431)
* Sun, geocentric declination %olARGUMENT special text <1>: Special Texts Summary.
                                                             (line  688)
* Sun, geocentric declination %olARGUMENT special text: Sun data.
                                                             (line  431)
* Sun, geocentric declination %s*lARGUMENT special text <1>: Special Texts Summary.
                                                             (line  693)
* Sun, geocentric declination %s*lARGUMENT special text: Sun data.
                                                             (line  431)
* Sun, geocentric declination %slARGUMENT special text <1>: Special Texts Summary.
                                                             (line  688)
* Sun, geocentric declination %slARGUMENT special text: Sun data.
                                                             (line  431)
* Sun, geocentric distance %o*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line  723)
* Sun, geocentric distance %o*oARGUMENT special text: Sun data.
                                                             (line  448)
* Sun, geocentric distance %ooARGUMENT special text <1>: Special Texts Summary.
                                                             (line  718)
* Sun, geocentric distance %ooARGUMENT special text: Sun data.
                                                             (line  448)
* Sun, geocentric distance %s*oARGUMENT special text <1>: Special Texts Summary.
                                                             (line  723)
* Sun, geocentric distance %s*oARGUMENT special text: Sun data.
                                                             (line  448)
* Sun, geocentric distance %soARGUMENT special text <1>: Special Texts Summary.
                                                             (line  718)
* Sun, geocentric distance %soARGUMENT special text: Sun data.
                                                             (line  448)
* Sun, geocentric ecliptic longitude %o*mARGUMENT special text <1>: Special Texts Summary.
                                                             (line  703)
* Sun, geocentric ecliptic longitude %o*mARGUMENT special text: Sun data.
                                                             (line  440)
* Sun, geocentric ecliptic longitude %omARGUMENT special text <1>: Special Texts Summary.
                                                             (line  698)
* Sun, geocentric ecliptic longitude %omARGUMENT special text: Sun data.
                                                             (line  440)
* Sun, geocentric ecliptic longitude %s*mARGUMENT special text <1>: Special Texts Summary.
                                                             (line  703)
* Sun, geocentric ecliptic longitude %s*mARGUMENT special text: Sun data.
                                                             (line  440)
* Sun, geocentric ecliptic longitude %smARGUMENT special text <1>: Special Texts Summary.
                                                             (line  698)
* Sun, geocentric ecliptic longitude %smARGUMENT special text: Sun data.
                                                             (line  440)
* Sun, geocentric elevation %o*jARGUMENT special text <1>: Special Texts Summary.
                                                             (line  673)
* Sun, geocentric elevation %o*jARGUMENT special text: Sun data.
                                                             (line  419)
* Sun, geocentric elevation %ojARGUMENT special text <1>: Special Texts Summary.
                                                             (line  668)
* Sun, geocentric elevation %ojARGUMENT special text: Sun data.
                                                             (line  419)
* Sun, geocentric elevation %s*jARGUMENT special text <1>: Special Texts Summary.
                                                             (line  673)
* Sun, geocentric elevation %s*jARGUMENT special text: Sun data.
                                                             (line  419)
* Sun, geocentric elevation %sjARGUMENT special text <1>: Special Texts Summary.
                                                             (line  668)
* Sun, geocentric elevation %sjARGUMENT special text: Sun data.
                                                             (line  419)
* Sun, geocentric elevation at standard rise time %o*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1008)
* Sun, geocentric elevation at standard rise time %o*OARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at standard rise time %oOARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1004)
* Sun, geocentric elevation at standard rise time %oOARGUMENT special text: Sun data.
                                                             (line  761)
* Sun, geocentric elevation at standard set time %s*OARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1016)
* Sun, geocentric elevation at standard set time %s*OARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at standard set time %sOARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1012)
* Sun, geocentric elevation at standard set time %sOARGUMENT special text: Sun data.
                                                             (line  768)
* Sun, geocentric elevation at Sun's astronomical midnight time %o*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line  990)
* Sun, geocentric elevation at Sun's astronomical midnight time %o*MARGUMENT special text: Sun data.
                                                             (line  747)
* Sun, geocentric elevation at Sun's astronomical midnight time %oMARGUMENT special text <1>: Special Texts Summary.
                                                             (line  985)
* Sun, geocentric elevation at Sun's astronomical midnight time %oMARGUMENT special text: Sun data.
                                                             (line  747)
* Sun, geocentric elevation at Sun's astronomical midnight time %s*MARGUMENT special text <1>: Special Texts Summary.
                                                             (line  990)
* Sun, geocentric elevation at Sun's astronomical midnight time %s*MARGUMENT special text: Sun data.
                                                             (line  747)
* Sun, geocentric elevation at Sun's astronomical midnight time %sMARGUMENT special text <1>: Special Texts Summary.
                                                             (line  985)
* Sun, geocentric elevation at Sun's astronomical midnight time %sMARGUMENT special text: Sun data.
                                                             (line  747)
* Sun, geocentric elevation at Sun's astronomical noon time %o*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1000)
* Sun, geocentric elevation at Sun's astronomical noon time %o*NARGUMENT special text: Sun data.
                                                             (line  754)
* Sun, geocentric elevation at Sun's astronomical noon time %oNARGUMENT special text <1>: Special Texts Summary.
                                                             (line  995)
* Sun, geocentric elevation at Sun's astronomical noon time %oNARGUMENT special text: Sun data.
                                                             (line  754)
* Sun, geocentric elevation at Sun's astronomical noon time %s*NARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1000)
* Sun, geocentric elevation at Sun's astronomical noon time %s*NARGUMENT special text: Sun data.
                                                             (line  754)
* Sun, geocentric elevation at Sun's astronomical noon time %sNARGUMENT special text <1>: Special Texts Summary.
                                                             (line  995)
* Sun, geocentric elevation at Sun's astronomical noon time %sNARGUMENT special text: Sun data.
                                                             (line  754)
* Sun, geocentric horizontal parallax %o*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line  732)
* Sun, geocentric horizontal parallax %o*pARGUMENT special text: Sun data.
                                                             (line  452)
* Sun, geocentric horizontal parallax %opARGUMENT special text <1>: Special Texts Summary.
                                                             (line  727)
* Sun, geocentric horizontal parallax %opARGUMENT special text: Sun data.
                                                             (line  452)
* Sun, geocentric horizontal parallax %s*pARGUMENT special text <1>: Special Texts Summary.
                                                             (line  732)
* Sun, geocentric horizontal parallax %s*pARGUMENT special text: Sun data.
                                                             (line  452)
* Sun, geocentric horizontal parallax %spARGUMENT special text <1>: Special Texts Summary.
                                                             (line  727)
* Sun, geocentric horizontal parallax %spARGUMENT special text: Sun data.
                                                             (line  452)
* Sun, geocentric right ascension %o*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line  713)
* Sun, geocentric right ascension %o*nARGUMENT special text: Sun data.
                                                             (line  444)
* Sun, geocentric right ascension %onARGUMENT special text <1>: Special Texts Summary.
                                                             (line  708)
* Sun, geocentric right ascension %onARGUMENT special text: Sun data.
                                                             (line  444)
* Sun, geocentric right ascension %s*nARGUMENT special text <1>: Special Texts Summary.
                                                             (line  713)
* Sun, geocentric right ascension %s*nARGUMENT special text: Sun data.
                                                             (line  444)
* Sun, geocentric right ascension %snARGUMENT special text <1>: Special Texts Summary.
                                                             (line  708)
* Sun, geocentric right ascension %snARGUMENT special text: Sun data.
                                                             (line  444)
* Sun, geocentric semidiameter %o*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line  742)
* Sun, geocentric semidiameter %o*qARGUMENT special text: Sun data.
                                                             (line  456)
* Sun, geocentric semidiameter %oqARGUMENT special text <1>: Special Texts Summary.
                                                             (line  737)
* Sun, geocentric semidiameter %oqARGUMENT special text: Sun data.
                                                             (line  456)
* Sun, geocentric semidiameter %s*qARGUMENT special text <1>: Special Texts Summary.
                                                             (line  742)
* Sun, geocentric semidiameter %s*qARGUMENT special text: Sun data.
                                                             (line  456)
* Sun, geocentric semidiameter %sqARGUMENT special text <1>: Special Texts Summary.
                                                             (line  737)
* Sun, geocentric semidiameter %sqARGUMENT special text: Sun data.
                                                             (line  456)
* Sun, highest culmination point:        Sun data.           (line   49)
* Sun, Julian date %o*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line  773)
* Sun, Julian date %o*uARGUMENT special text: Sun data.      (line  492)
* Sun, Julian date %ouARGUMENT special text <1>: Special Texts Summary.
                                                             (line  773)
* Sun, Julian date %ouARGUMENT special text: Sun data.       (line  492)
* Sun, Julian date %s*uARGUMENT special text <1>: Special Texts Summary.
                                                             (line  773)
* Sun, Julian date %s*uARGUMENT special text: Sun data.      (line  492)
* Sun, Julian date %suARGUMENT special text <1>: Special Texts Summary.
                                                             (line  773)
* Sun, Julian date %suARGUMENT special text: Sun data.       (line  492)
* Sun, Julian Ephemeris date %o*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line  779)
* Sun, Julian Ephemeris date %o*vARGUMENT special text: Sun data.
                                                             (line  497)
* Sun, Julian Ephemeris date %ovARGUMENT special text <1>: Special Texts Summary.
                                                             (line  779)
* Sun, Julian Ephemeris date %ovARGUMENT special text: Sun data.
                                                             (line  497)
* Sun, Julian Ephemeris date %s*vARGUMENT special text <1>: Special Texts Summary.
                                                             (line  779)
* Sun, Julian Ephemeris date %s*vARGUMENT special text: Sun data.
                                                             (line  497)
* Sun, Julian Ephemeris date %svARGUMENT special text <1>: Special Texts Summary.
                                                             (line  779)
* Sun, Julian Ephemeris date %svARGUMENT special text: Sun data.
                                                             (line  497)
* Sun, local sidereal time %o*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, local sidereal time %o*sARGUMENT special text: Sun data.
                                                             (line  467)
* Sun, local sidereal time %osARGUMENT special text <1>: Special Texts Summary.
                                                             (line  753)
* Sun, local sidereal time %osARGUMENT special text: Sun data.
                                                             (line  467)
* Sun, local sidereal time %s*sARGUMENT special text <1>: Special Texts Summary.
                                                             (line  757)
* Sun, local sidereal time %s*sARGUMENT special text: Sun data.
                                                             (line  467)
* Sun, local sidereal time %ssARGUMENT special text <1>: Special Texts Summary.
                                                             (line  753)
* Sun, local sidereal time %ssARGUMENT special text: Sun data.
                                                             (line  467)
* Sun, lowest culmination point:         Sun data.           (line   37)
* Sun, mean:                             Sun data.           (line  501)
* Sun, midnight height geocentric:       Sun data.           (line  747)
* Sun, midnight height topocentric:      Sun data.           (line  700)
* Sun, morning width geocentric:         Sun data.           (line  774)
* Sun, morning width topocentric:        Sun data.           (line  728)
* Sun, nautical twilight:                Sun data.           (line  257)
* Sun, noon height geocentric:           Sun data.           (line  754)
* Sun, noon height topocentric:          Sun data.           (line  707)
* Sun, noon line:                        Sun data.           (line   37)
* Sun, period of double or shorter shadow length %u*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1088)
* Sun, period of double or shorter shadow length %u*RARGUMENT special text: Sun data.
                                                             (line  853)
* Sun, period of double or shorter shadow length %uRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1084)
* Sun, period of double or shorter shadow length %uRARGUMENT special text: Sun data.
                                                             (line  853)
* Sun, period of longer than double shadow length %z*RARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1096)
* Sun, period of longer than double shadow length %z*RARGUMENT special text: Sun data.
                                                             (line  858)
* Sun, period of longer than double shadow length %zRARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1092)
* Sun, period of longer than double shadow length %zRARGUMENT special text: Sun data.
                                                             (line  858)
* Sun, period of longer than single shadow length %z*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1064)
* Sun, period of longer than single shadow length %z*QARGUMENT special text: Sun data.
                                                             (line  822)
* Sun, period of longer than single shadow length %zQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1060)
* Sun, period of longer than single shadow length %zQARGUMENT special text: Sun data.
                                                             (line  822)
* Sun, period of single or shorter shadow length %u*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1056)
* Sun, period of single or shorter shadow length %u*QARGUMENT special text: Sun data.
                                                             (line  817)
* Sun, period of single or shorter shadow length %uQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1052)
* Sun, period of single or shorter shadow length %uQARGUMENT special text: Sun data.
                                                             (line  817)
* Sun, refraction %o*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line  664)
* Sun, refraction %o*iARGUMENT special text: Sun data.       (line  415)
* Sun, refraction %oiARGUMENT special text <1>: Special Texts Summary.
                                                             (line  659)
* Sun, refraction %oiARGUMENT special text: Sun data.        (line  415)
* Sun, refraction %s*iARGUMENT special text <1>: Special Texts Summary.
                                                             (line  664)
* Sun, refraction %s*iARGUMENT special text: Sun data.       (line  415)
* Sun, refraction %siARGUMENT special text <1>: Special Texts Summary.
                                                             (line  659)
* Sun, refraction %siARGUMENT special text: Sun data.        (line  415)
* Sun, rise azimuth geocentric:          Sun data.           (line  774)
* Sun, rise azimuth topocentric:         Sun data.           (line  728)
* Sun, rise height geocentric:           Sun data.           (line  761)
* Sun, rise height topocentric:          Sun data.           (line  714)
* Sun, set azimuth geocentric:           Sun data.           (line  783)
* Sun, set azimuth topocentric:          Sun data.           (line  738)
* Sun, set height geocentric:            Sun data.           (line  768)
* Sun, set height topocentric:           Sun data.           (line  721)
* Sun, single shadow length time at afternoon %s*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1048)
* Sun, single shadow length time at afternoon %s*QARGUMENT special text: Sun data.
                                                             (line  801)
* Sun, single shadow length time at afternoon %sQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1044)
* Sun, single shadow length time at afternoon %sQARGUMENT special text: Sun data.
                                                             (line  801)
* Sun, single shadow length time at forenoon %o*QARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1040)
* Sun, single shadow length time at forenoon %o*QARGUMENT special text: Sun data.
                                                             (line  792)
* Sun, single shadow length time at forenoon %oQARGUMENT special text <1>: Special Texts Summary.
                                                             (line 1036)
* Sun, single shadow length time at forenoon %oQARGUMENT special text: Sun data.
                                                             (line  792)
* Sun, standard non-visibility period:   Sun data.           (line  223)
* Sun, standard rise time:               Sun data.           (line  169)
* Sun, standard set time:                Sun data.           (line  195)
* Sun, standard visibility period:       Sun data.           (line  215)
* Sun, topocentric azimuth %o*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line  595)
* Sun, topocentric azimuth %o*bARGUMENT special text: Sun data.
                                                             (line  368)
* Sun, topocentric azimuth %obARGUMENT special text <1>: Special Texts Summary.
                                                             (line  590)
* Sun, topocentric azimuth %obARGUMENT special text: Sun data.
                                                             (line  368)
* Sun, topocentric azimuth %s*bARGUMENT special text <1>: Special Texts Summary.
                                                             (line  595)
* Sun, topocentric azimuth %s*bARGUMENT special text: Sun data.
                                                             (line  368)
* Sun, topocentric azimuth %sbARGUMENT special text <1>: Special Texts Summary.
                                                             (line  590)
* Sun, topocentric azimuth %sbARGUMENT special text: Sun data.
                                                             (line  368)
* Sun, topocentric azimuth at standard rise time %o*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line  972)
* Sun, topocentric azimuth at standard rise time %o*LARGUMENT special text: Sun data.
                                                             (line  728)
* Sun, topocentric azimuth at standard rise time %oLARGUMENT special text <1>: Special Texts Summary.
                                                             (line  968)
* Sun, topocentric azimuth at standard rise time %oLARGUMENT special text: Sun data.
                                                             (line  728)
* Sun, topocentric azimuth at standard set time %s*LARGUMENT special text <1>: Special Texts Summary.
                                                             (line  980)
* Sun, topocentric azimuth at standard set time %s*LARGUMENT special text: Sun data.
                                                             (line  738)
* Sun, topocentric azimuth at standard set time %sLARGUMENT special text <1>: Special Texts Summary.
                                                             (line  976)
* Sun, topocentric azimuth at standard set time %sLARGUMENT special text: Sun data.
                                                             (line  738)
* Sun, topocentric data:                 Sun data.           (line  344)
* Sun, topocentric declination %o*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line  605)
* Sun, topocentric declination %o*cARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric declination %ocARGUMENT special text <1>: Special Texts Summary.
                                                             (line  600)
* Sun, topocentric declination %ocARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric declination %s*cARGUMENT special text <1>: Special Texts Summary.
                                                             (line  605)
* Sun, topocentric declination %s*cARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric declination %scARGUMENT special text <1>: Special Texts Summary.
                                                             (line  600)
* Sun, topocentric declination %scARGUMENT special text: Sun data.
                                                             (line  372)
* Sun, topocentric distance %o*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line  635)
* Sun, topocentric distance %o*fARGUMENT special text: Sun data.
                                                             (line  397)
* Sun, topocentric distance %ofARGUMENT special text <1>: Special Texts Summary.
                                                             (line  630)
* Sun, topocentric distance %ofARGUMENT special text: Sun data.
                                                             (line  397)
* Sun, topocentric distance %s*fARGUMENT special text <1>: Special Texts Summary.
                                                             (line  635)
* Sun, topocentric distance %s*fARGUMENT special text: Sun data.
                                                             (line  397)
* Sun, topocentric distance %sfARGUMENT special text <1>: Special Texts Summary.
                                                             (line  630)
* Sun, topocentric distance %sfARGUMENT special text: Sun data.
                                                             (line  397)
* Sun, topocentric ecliptic longitude %o*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line  615)
* Sun, topocentric ecliptic longitude %o*dARGUMENT special text: Sun data.
                                                             (line  382)
* Sun, topocentric ecliptic longitude %odARGUMENT special text <1>: Special Texts Summary.
                                                             (line  610)
* Sun, topocentric ecliptic longitude %odARGUMENT special text: Sun data.
                                                             (line  382)
* Sun, topocentric ecliptic longitude %s*dARGUMENT special text <1>: Special Texts Summary.
                                                             (line  615)
* Sun, topocentric ecliptic longitude %s*dARGUMENT special text: Sun data.
                                                             (line  382)
* Sun, topocentric ecliptic longitude %sdARGUMENT special text <1>: Special Texts Summary.
                                                             (line  610)
* Sun, topocentric ecliptic longitude %sdARGUMENT special text: Sun data.
                                                             (line  382)
* Sun, topocentric elevation %o*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line  585)
* Sun, topocentric elevation %o*aARGUMENT special text: Sun data.
                                                             (line  344)
* Sun, topocentric elevation %oaARGUMENT special text <1>: Special Texts Summary.
                                                             (line  580)
* Sun, topocentric elevation %oaARGUMENT special text: Sun data.
                                                             (line  344)
* Sun, topocentric elevation %s*aARGUMENT special text <1>: Special Texts Summary.
                                                             (line  585)
* Sun, topocentric elevation %s*aARGUMENT special text: Sun data.
                                                             (line  344)
* Sun, topocentric elevation %saARGUMENT special text <1>: Special Texts Summary.
                                                             (line  580)
* Sun, topocentric elevation %saARGUMENT special text: Sun data.
                                                             (line  344)
* Sun, topocentric elevation at standard rise time %o*KARGUMENT special text <1>: Special Texts Summary.
                                                             (line  956)
* Sun, topocentric elevation at standard rise time %o*KARGUMENT special text: Sun data.
                                                             (line  714)
* Sun, topocentric elevation at standard rise time %oKARGUMENT special text <1>: Special Texts Summary.
                                                             (line  952)
* Sun, topocentric elevation at standard rise time %oKARGUMENT special text: Sun data.
                                                             (line  714)
* Sun, topocentric elevation at standard set time %s*KARGUMENT special text <1>: Special Texts Summary.
                                                             (line  964)
* Sun, topocentric elevation at standard set time %s*KARGUMENT special text: Sun data.
                                                             (line  721)
* Sun, topocentric elevation at standard set time %sKARGUMENT special text <1>: Special Texts Summary.
                                                             (line  960)
* Sun, topocentric elevation at standard set time %sKARGUMENT special text: Sun data.
                                                             (line  721)
* Sun, topocentric elevation at Sun's astronomical midnight time %o*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line  938)
* Sun, topocentric elevation at Sun's astronomical midnight time %o*IARGUMENT special text: Sun data.
                                                             (line  700)
* Sun, topocentric elevation at Sun's astronomical midnight time %oIARGUMENT special text <1>: Special Texts Summary.
                                                             (line  933)
* Sun, topocentric elevation at Sun's astronomical midnight time %oIARGUMENT special text: Sun data.
                                                             (line  700)
* Sun, topocentric elevation at Sun's astronomical midnight time %s*IARGUMENT special text <1>: Special Texts Summary.
                                                             (line  938)
* Sun, topocentric elevation at Sun's astronomical midnight time %s*IARGUMENT special text: Sun data.
                                                             (line  700)
* Sun, topocentric elevation at Sun's astronomical midnight time %sIARGUMENT special text <1>: Special Texts Summary.
                                                             (line  933)
* Sun, topocentric elevation at Sun's astronomical midnight time %sIARGUMENT special text: Sun data.
                                                             (line  700)
* Sun, topocentric elevation at Sun's astronomical noon time %o*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line  948)
* Sun, topocentric elevation at Sun's astronomical noon time %o*JARGUMENT special text: Sun data.
                                                             (line  707)
* Sun, topocentric elevation at Sun's astronomical noon time %oJARGUMENT special text <1>: Special Texts Summary.
                                                             (line  943)
* Sun, topocentric elevation at Sun's astronomical noon time %oJARGUMENT special text: Sun data.
                                                             (line  707)
* Sun, topocentric elevation at Sun's astronomical noon time %s*JARGUMENT special text <1>: Special Texts Summary.
                                                             (line  948)
* Sun, topocentric elevation at Sun's astronomical noon time %s*JARGUMENT special text: Sun data.
                                                             (line  707)
* Sun, topocentric elevation at Sun's astronomical noon time %sJARGUMENT special text <1>: Special Texts Summary.
                                                             (line  943)
* Sun, topocentric elevation at Sun's astronomical noon time %sJARGUMENT special text: Sun data.
                                                             (line  707)
* Sun, topocentric horizontal parallax %o*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line  644)
* Sun, topocentric horizontal parallax %o*gARGUMENT special text: Sun data.
                                                             (line  404)
* Sun, topocentric horizontal parallax %ogARGUMENT special text <1>: Special Texts Summary.
                                                             (line  639)
* Sun, topocentric horizontal parallax %ogARGUMENT special text: Sun data.
                                                             (line  404)
* Sun, topocentric horizontal parallax %s*gARGUMENT special text <1>: Special Texts Summary.
                                                             (line  644)
* Sun, topocentric horizontal parallax %s*gARGUMENT special text: Sun data.
                                                             (line  404)
* Sun, topocentric horizontal parallax %sgARGUMENT special text <1>: Special Texts Summary.
                                                             (line  639)
* Sun, topocentric horizontal parallax %sgARGUMENT special text: Sun data.
                                                             (line  404)
* Sun, topocentric right ascension %o*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line  625)
* Sun, topocentric right ascension %o*eARGUMENT special text: Sun data.
                                                             (line  390)
* Sun, topocentric right ascension %oeARGUMENT special text <1>: Special Texts Summary.
                                                             (line  620)
* Sun, topocentric right ascension %oeARGUMENT special text: Sun data.
                                                             (line  390)
* Sun, topocentric right ascension %s*eARGUMENT special text <1>: Special Texts Summary.
                                                             (line  625)
* Sun, topocentric right ascension %s*eARGUMENT special text: Sun data.
                                                             (line  390)
* Sun, topocentric right ascension %seARGUMENT special text <1>: Special Texts Summary.
                                                             (line  620)
* Sun, topocentric right ascension %seARGUMENT special text: Sun data.
                                                             (line  390)
* Sun, topocentric semidiameter %o*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line  654)
* Sun, topocentric semidiameter %o*hARGUMENT special text: Sun data.
                                                             (line  411)
* Sun, topocentric semidiameter %ohARGUMENT special text <1>: Special Texts Summary.
                                                             (line  649)
* Sun, topocentric semidiameter %ohARGUMENT special text: Sun data.
                                                             (line  411)
* Sun, topocentric semidiameter %s*hARGUMENT special text <1>: Special Texts Summary.
                                                             (line  654)
* Sun, topocentric semidiameter %s*hARGUMENT special text: Sun data.
                                                             (line  411)
* Sun, topocentric semidiameter %shARGUMENT special text <1>: Special Texts Summary.
                                                             (line  649)
* Sun, topocentric semidiameter %shARGUMENT special text: Sun data.
                                                             (line  411)
* Sun/Moon, delta astronomical midnight time %o*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line  902)
* Sun/Moon, delta astronomical midnight time %o*FARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta astronomical midnight time %oFARGUMENT special text <1>: Special Texts Summary.
                                                             (line  897)
* Sun/Moon, delta astronomical midnight time %oFARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta astronomical midnight time %s*FARGUMENT special text <1>: Special Texts Summary.
                                                             (line  902)
* Sun/Moon, delta astronomical midnight time %s*FARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta astronomical midnight time %sFARGUMENT special text <1>: Special Texts Summary.
                                                             (line  897)
* Sun/Moon, delta astronomical midnight time %sFARGUMENT special text: Sun data.
                                                             (line  634)
* Sun/Moon, delta astronomical noon time %o*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line  912)
* Sun/Moon, delta astronomical noon time %o*GARGUMENT special text: Sun data.
                                                             (line  652)
* Sun/Moon, delta astronomical noon time %oGARGUMENT special text <1>: Special Texts Summary.
                                                             (line  907)
* Sun/Moon, delta astronomical noon time %oGARGUMENT special text: Sun data.
                                                             (line  652)
* Sun/Moon, delta astronomical noon time %s*GARGUMENT special text <1>: Special Texts Summary.
                                                             (line  912)
* Sun/Moon, delta astronomical noon time %s*GARGUMENT special text: Sun data.
                                                             (line  652)
* Sun/Moon, delta astronomical noon time %sGARGUMENT special text <1>: Special Texts Summary.
                                                             (line  907)
* Sun/Moon, delta astronomical noon time %sGARGUMENT special text: Sun data.
                                                             (line  652)
* Sun/Moon, delta geocentric azimuth %o*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line  828)
* Sun/Moon, delta geocentric azimuth %o*AARGUMENT special text: Sun data.
                                                             (line  564)
* Sun/Moon, delta geocentric azimuth %oAARGUMENT special text <1>: Special Texts Summary.
                                                             (line  823)
* Sun/Moon, delta geocentric azimuth %oAARGUMENT special text: Sun data.
                                                             (line  564)
* Sun/Moon, delta geocentric azimuth %s*AARGUMENT special text <1>: Special Texts Summary.
                                                             (line  828)
* Sun/Moon, delta geocentric azimuth %s*AARGUMENT special text: Sun data.
                                                             (line  564)
* Sun/Moon, delta geocentric azimuth %sAARGUMENT special text <1>: Special Texts Summary.
                                                             (line  823)
* Sun/Moon, delta geocentric azimuth %sAARGUMENT special text: Sun data.
                                                             (line  564)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %o*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line  884)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %o*EARGUMENT special text: Sun data.
                                                             (line  618)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %oEARGUMENT special text <1>: Special Texts Summary.
                                                             (line  880)
* Sun/Moon, delta geocentric azimuth at standard sunrise time %oEARGUMENT special text: Sun data.
                                                             (line  618)
* Sun/Moon, delta geocentric azimuth at standard sunset time %s*EARGUMENT special text <1>: Special Texts Summary.
                                                             (line  892)
* Sun/Moon, delta geocentric azimuth at standard sunset time %s*EARGUMENT special text: Sun data.
                                                             (line  626)
* Sun/Moon, delta geocentric azimuth at standard sunset time %sEARGUMENT special text <1>: Special Texts Summary.
                                                             (line  888)
* Sun/Moon, delta geocentric azimuth at standard sunset time %sEARGUMENT special text: Sun data.
                                                             (line  626)
* Sun/Moon, delta geocentric elevation %o*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line  818)
* Sun/Moon, delta geocentric elevation %o*zARGUMENT special text: Sun data.
                                                             (line  558)
* Sun/Moon, delta geocentric elevation %ozARGUMENT special text <1>: Special Texts Summary.
                                                             (line  813)
* Sun/Moon, delta geocentric elevation %ozARGUMENT special text: Sun data.
                                                             (line  558)
* Sun/Moon, delta geocentric elevation %s*zARGUMENT special text <1>: Special Texts Summary.
                                                             (line  818)
* Sun/Moon, delta geocentric elevation %s*zARGUMENT special text: Sun data.
                                                             (line  558)
* Sun/Moon, delta geocentric elevation %szARGUMENT special text <1>: Special Texts Summary.
                                                             (line  813)
* Sun/Moon, delta geocentric elevation %szARGUMENT special text: Sun data.
                                                             (line  558)
* Sun/Moon, delta geocentric elevation at standard sunrise time %o*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line  868)
* Sun/Moon, delta geocentric elevation at standard sunrise time %o*DARGUMENT special text: Sun data.
                                                             (line  602)
* Sun/Moon, delta geocentric elevation at standard sunrise time %oDARGUMENT special text <1>: Special Texts Summary.
                                                             (line  864)
* Sun/Moon, delta geocentric elevation at standard sunrise time %oDARGUMENT special text: Sun data.
                                                             (line  602)
* Sun/Moon, delta geocentric elevation at standard sunset time %s*DARGUMENT special text <1>: Special Texts Summary.
                                                             (line  876)
* Sun/Moon, delta geocentric elevation at standard sunset time %s*DARGUMENT special text: Sun data.
                                                             (line  610)
* Sun/Moon, delta geocentric elevation at standard sunset time %sDARGUMENT special text <1>: Special Texts Summary.
                                                             (line  872)
* Sun/Moon, delta geocentric elevation at standard sunset time %sDARGUMENT special text: Sun data.
                                                             (line  610)
* Sun/Moon, delta standard rise time %(*KARGUMENT special text: Moon data.
                                                             (line  611)
* Sun/Moon, delta standard rise time %(KARGUMENT special text: Moon data.
                                                             (line  611)
* Sun/Moon, delta standard rise time %o*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line  920)
* Sun/Moon, delta standard rise time %o*HARGUMENT special text: Sun data.
                                                             (line  668)
* Sun/Moon, delta standard rise time %oHARGUMENT special text <1>: Special Texts Summary.
                                                             (line  916)
* Sun/Moon, delta standard rise time %oHARGUMENT special text: Sun data.
                                                             (line  668)
* Sun/Moon, delta standard set time %)*KARGUMENT special text: Moon data.
                                                             (line  627)
* Sun/Moon, delta standard set time %)KARGUMENT special text: Moon data.
                                                             (line  627)
* Sun/Moon, delta standard set time %s*HARGUMENT special text <1>: Special Texts Summary.
                                                             (line  928)
* Sun/Moon, delta standard set time %s*HARGUMENT special text: Sun data.
                                                             (line  684)
* Sun/Moon, delta standard set time %sHARGUMENT special text <1>: Special Texts Summary.
                                                             (line  924)
* Sun/Moon, delta standard set time %sHARGUMENT special text: Sun data.
                                                             (line  684)
* Sun/Moon, delta topocentric azimuth %o*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line  808)
* Sun/Moon, delta topocentric azimuth %o*yARGUMENT special text: Sun data.
                                                             (line  539)
* Sun/Moon, delta topocentric azimuth %oyARGUMENT special text <1>: Special Texts Summary.
                                                             (line  803)
* Sun/Moon, delta topocentric azimuth %oyARGUMENT special text: Sun data.
                                                             (line  539)
* Sun/Moon, delta topocentric azimuth %s*yARGUMENT special text <1>: Special Texts Summary.
                                                             (line  808)
* Sun/Moon, delta topocentric azimuth %s*yARGUMENT special text: Sun data.
                                                             (line  539)
* Sun/Moon, delta topocentric azimuth %syARGUMENT special text <1>: Special Texts Summary.
                                                             (line  803)
* Sun/Moon, delta topocentric azimuth %syARGUMENT special text: Sun data.
                                                             (line  539)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %o*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line  852)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %o*CARGUMENT special text: Sun data.
                                                             (line  586)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %oCARGUMENT special text <1>: Special Texts Summary.
                                                             (line  848)
* Sun/Moon, delta topocentric azimuth at standard sunrise time %oCARGUMENT special text: Sun data.
                                                             (line  586)
* Sun/Moon, delta topocentric azimuth at standard sunset time %s*CARGUMENT special text <1>: Special Texts Summary.
                                                             (line  860)
* Sun/Moon, delta topocentric azimuth at standard sunset time %s*CARGUMENT special text: Sun data.
                                                             (line  594)
* Sun/Moon, delta topocentric azimuth at standard sunset time %sCARGUMENT special text <1>: Special Texts Summary.
                                                             (line  856)
* Sun/Moon, delta topocentric azimuth at standard sunset time %sCARGUMENT special text: Sun data.
                                                             (line  594)
* Sun/Moon, delta topocentric elevation %o*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line  798)
* Sun/Moon, delta topocentric elevation %o*xARGUMENT special text: Sun data.
                                                             (line  525)
* Sun/Moon, delta topocentric elevation %oxARGUMENT special text <1>: Special Texts Summary.
                                                             (line  793)
* Sun/Moon, delta topocentric elevation %oxARGUMENT special text: Sun data.
                                                             (line  525)
* Sun/Moon, delta topocentric elevation %s*xARGUMENT special text <1>: Special Texts Summary.
                                                             (line  798)
* Sun/Moon, delta topocentric elevation %s*xARGUMENT special text: Sun data.
                                                             (line  525)
* Sun/Moon, delta topocentric elevation %sxARGUMENT special text <1>: Special Texts Summary.
                                                             (line  793)
* Sun/Moon, delta topocentric elevation %sxARGUMENT special text: Sun data.
                                                             (line  525)
* Sun/Moon, delta topocentric elevation at standard sunrise time %o*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line  836)
* Sun/Moon, delta topocentric elevation at standard sunrise time %o*BARGUMENT special text: Sun data.
                                                             (line  570)
* Sun/Moon, delta topocentric elevation at standard sunrise time %oBARGUMENT special text <1>: Special Texts Summary.
                                                             (line  832)
* Sun/Moon, delta topocentric elevation at standard sunrise time %oBARGUMENT special text: Sun data.
                                                             (line  570)
* Sun/Moon, delta topocentric elevation at standard sunset time %s*BARGUMENT special text <1>: Special Texts Summary.
                                                             (line  844)
* Sun/Moon, delta topocentric elevation at standard sunset time %s*BARGUMENT special text: Sun data.
                                                             (line  578)
* Sun/Moon, delta topocentric elevation at standard sunset time %sBARGUMENT special text <1>: Special Texts Summary.
                                                             (line  840)
* Sun/Moon, delta topocentric elevation at standard sunset time %sBARGUMENT special text: Sun data.
                                                             (line  578)
* Sundial:                               Sun data.           (line  501)
* Sunrise:                               Sun data.           (line    6)
* Sunrise and sunset, limit to actual day: Fixed date options.
                                                             (line  171)
* Sunrise and sunset, set reference altitude: Fixed date options.
                                                             (line  130)
* Sunset:                                Sun data.           (line    6)
* Suppress calendar sheet:               Calendar options.   (line 1382)
* Suppress leading blank line of eternal holiday list: Calendar options.
                                                             (line   40)
* Suppress leading blank line of fixed date list: Fixed date options.
                                                             (line  778)
* Suppress title text of eternal holiday list: Calendar options.
                                                             (line   45)
* Suppress title text of fixed date list: Fixed date options.
                                                             (line  808)
* Switch character:                      Glossary.           (line  685)
* 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  422)
* Synodic month, Moon:                   Moon data.          (line   37)
* 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   37)
* Table of modes of the Moon oriented special texts: Moon data.
                                                             (line   34)
* Table of modes of the Sun oriented special texts: Sun data.
                                                             (line   34)
* 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  826)
* Table of representation types of the Sun oriented special texts: Sun data.
                                                             (line 1089)
* tcal, options:                         Invoking tcal.      (line    6)
* tcal, utility:                         Invoking tcal.      (line    6)
* Temperature of Earth's atmosphere, set: Fixed date options.
                                                             (line  152)
* TERM environment variable:             Environment Variables.
                                                             (line  109)
* Terrestrial Dynamical time (TDT) <1>:  Moon data.          (line  428)
* Terrestrial Dynamical time (TDT):      Sun data.           (line  460)
* Territory code <1>:                    Internationalization.
                                                             (line  122)
* Territory code:                        Calendar options.   (line  153)
* Text part:                             Glossary.           (line  691)
* 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 <1>:       Text variables.     (line    6)
* Text variables, assignments <2>:       Structure of resource file.
                                                             (line   72)
* Text variables, assignments:           Fixed date options. (line   35)
* Text variables, definition <1>:        Text variables.     (line    6)
* Text variables, definition:            Fixed date options. (line   35)
* Text variables, export of local <1>:   Text variables.     (line  279)
* Text variables, export of local:       Fixed date options. (line  125)
* Text variables, global <1>:            Text variables.     (line    6)
* Text variables, global:                Fixed date options. (line   35)
* Text variables, local:                 Text variables.     (line    6)
* Text variables, management <1>:        Text variables.     (line    6)
* Text variables, management:            Fixed date options. (line   35)
* Text variables, name space <1>:        Text variables.     (line  242)
* Text variables, name space:            Fixed date options. (line   35)
* Text variables, numerical:             Text variables.     (line  293)
* Text variables, operations <1>:        Text variables.     (line  293)
* Text variables, operations:            Structure of resource file.
                                                             (line   72)
* Text variables, references:            Structure of resource file.
                                                             (line   82)
* Text variables, scope <1>:             Text variables.     (line  357)
* Text variables, scope:                 Fixed date options. (line   35)
* Text variables, simple decrement:      Text variables.     (line  299)
* Text variables, simple increment:      Text variables.     (line  298)
* 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 <1>: Text variables.   (line  279)
* Text variables, visibility of local:   Fixed date options. (line  125)
* Textual date %n[ARGUMENT] special text <1>: Special Texts Summary.
                                                             (line  271)
* Textual date %n[ARGUMENT] special text: Textual date.      (line    6)
* 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, 12-hours display format:         Actual clocktime.   (line   27)
* Time, 24-hours display format:         Actual clocktime.   (line   27)
* Timezone <1>:                          Moon data.          (line  807)
* Timezone:                              Sun data.           (line 1058)
* Today's fixed dates:                   Fixed date options. (line  424)
* Tomorrows' fixed dates:                Fixed date options. (line 1330)
* Topocentric data:                      Glossary.           (line  695)
* Topocentric data, Moon:                Moon data.          (line  256)
* Topocentric data, Sun:                 Sun data.           (line  344)
* Total number of date variables:        Date variables.     (line    6)
* Total number of text variables:        Text variables.     (line    6)
* True solar day <1>:                    Glossary.           (line  700)
* True solar day:                        Sun data.           (line  501)
* True solar time <1>:                   Glossary.           (line  700)
* True solar time:                       Sun data.           (line  501)
* True track:                            Glossary.           (line  707)
* Twilight:                              Glossary.           (line  720)
* Twilight, amateur-astronomical:        Sun data.           (line  283)
* Twilight, astronomical:                Sun data.           (line  309)
* Twilight, civil:                       Sun data.           (line  231)
* Twilight, nautical:                    Sun data.           (line  257)
* txt2gcal, options:                     Invoking txt2gcal.  (line    6)
* txt2gcal, utility:                     Invoking txt2gcal.  (line    6)
* TXT2GCALPROG environment variable <1>: Environment Variables.
                                                             (line  112)
* TXT2GCALPROG environment variable:     Text variables.     (line  112)
* Type of representation of Moon data and times <1>: Moon data.
                                                             (line  799)
* Type of representation of Moon data and times: Sun data.   (line  870)
* Type of representation of Sun data and times: Sun data.    (line  870)
* TZ environment variable:               Environment Variables.
                                                             (line  122)
* Unit, Earth equator radius:            Moon data.          (line  350)
* Universal time (UTC) <1>:              Moon data.          (line  450)
* Universal time (UTC) <2>:              Sun data.           (line  482)
* Universal time (UTC) <3>:              Julian day number.  (line    6)
* Universal time (UTC) <4>:              Actual clocktime.   (line    6)
* Universal time (UTC) <5>:              Moon phase.         (line    6)
* Universal time (UTC):                  Calendar options.   (line 1492)
* Universal time 12-hour format suffix, display: Actual clocktime.
                                                             (line  161)
* Universal time hour, display:          Actual clocktime.   (line  134)
* Universal time in HH:MM/DATE format, display: Actual clocktime.
                                                             (line  104)
* Universal time in M[M...]/DATE format, display: Actual clocktime.
                                                             (line  119)
* Universal time minute, display:        Actual clocktime.   (line  147)
* Unix:                                  Glossary.           (line  726)
* Unsigned angular value, Sun and Moon oriented special texts: Sun data.
                                                             (line  977)
* Unsigned decimal based rational number value, Sun and Moon oriented special texts: Sun data.
                                                             (line  874)
* Unsigned time value, Sun and Moon oriented special texts: Sun data.
                                                             (line  945)
* Use Eastern Orthodox churches' leap year rule: Calendar options.
                                                             (line 1322)
* USER environment variable <1>:         Environment Variables.
                                                             (line  126)
* USER environment variable:             Global options.     (line  196)
* 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   42)
* 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 <1>: Glossary.        (line  735)
* Vernal equinox point on the ecliptic <2>: Moon data.       (line  324)
* Vernal equinox point on the ecliptic:  Sun data.           (line  382)
* Version number, finding:               Common options.     (line   37)
* Visibility of date variables:          Date variables.     (line   55)
* Visibility of local date variables <1>: Date variables.    (line  104)
* Visibility of local date variables:    Fixed date options. (line   29)
* Visibility of local text variables <1>: Text variables.    (line  279)
* Visibility of local text variables:    Fixed date options. (line  125)
* 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 1356)
* Week number, ISO-8601:1988 <1>:        Week number.        (line    7)
* Week number, ISO-8601:1988 <2>:        Date part of a line.
                                                             (line   57)
* Week number, ISO-8601:1988 <3>:        Fixed date options. (line  757)
* Week number, ISO-8601:1988:            Calendar options.   (line 1363)
* Week number, standard <1>:             Week number.        (line    7)
* Week number, standard <2>:             Date part of a line.
                                                             (line   57)
* Week number, standard <3>:             Fixed date options. (line  757)
* Week number, standard:                 Calendar options.   (line 1374)
* Week numbers in calendar sheet:        Calendar options.   (line 1349)
* Weekday name %[FORMAT]K[DATE] special text <1>: Special Texts Summary.
                                                             (line   90)
* Weekday name %[FORMAT]K[DATE] special text: Weekday name.  (line    6)
* Weekday number %>1&*E[DATE] special text <1>: Special Texts Summary.
                                                             (line  112)
* Weekday number %>1&*E[DATE] special text: Weekday number.  (line   36)
* Weekday number %>1&*I[DATE] special text <1>: Special Texts Summary.
                                                             (line  118)
* Weekday number %>1&*I[DATE] special text: Weekday number.  (line   55)
* Weekday number %>1&*J[DATE] special text <1>: Special Texts Summary.
                                                             (line  124)
* Weekday number %>1&*J[DATE] special text: Weekday number.  (line   74)
* Weekday number %>1&*S[DATE] special text <1>: Special Texts Summary.
                                                             (line  130)
* Weekday number %>1&*S[DATE] special text: Weekday number.  (line   95)
* Weekday number %>1&*T[DATE] special text <1>: Special Texts Summary.
                                                             (line  136)
* Weekday number %>1&*T[DATE] special text: Weekday number.  (line  119)
* Weekday number %>1&*W[DATE] special text <1>: Special Texts Summary.
                                                             (line  106)
* Weekday number %>1&*W[DATE] special text: Weekday number.  (line   18)
* Weekday number %[FORMAT]?[DATE] special texts <1>: Special Texts Summary.
                                                             (line  101)
* Weekday number %[FORMAT]?[DATE] special texts: Weekday number.
                                                             (line    6)
* Weekday number %E[DATE] special text <1>: Special Texts Summary.
                                                             (line  109)
* Weekday number %E[DATE] special text:  Weekday number.     (line   28)
* Weekday number %I[DATE] special text <1>: Special Texts Summary.
                                                             (line  115)
* Weekday number %I[DATE] special text:  Weekday number.     (line   46)
* Weekday number %J[DATE] special text <1>: Special Texts Summary.
                                                             (line  121)
* Weekday number %J[DATE] special text:  Weekday number.     (line   65)
* Weekday number %S[DATE] special text <1>: Special Texts Summary.
                                                             (line  127)
* Weekday number %S[DATE] special text:  Weekday number.     (line   84)
* Weekday number %T[DATE] special text <1>: Special Texts Summary.
                                                             (line  133)
* Weekday number %T[DATE] special text:  Weekday number.     (line  108)
* Weekday number %W[DATE] special text <1>: Special Texts Summary.
                                                             (line  103)
* Weekday number %W[DATE] special text:  Weekday number.     (line   10)
* Weeks' fixed dates:                    Fixed date options. (line 1342)
* Whitespace character <1>:              Glossary.           (line  739)
* Whitespace character <2>:              Error Codes.        (line    6)
* Whitespace character <3>:              Comment line.       (line    6)
* Whitespace character:                  Text part of a line.
                                                             (line   93)
* Whitespace separator character <1>:    Include directives. (line   23)
* Whitespace separator character <2>:    Structure of resource file.
                                                             (line    6)
* Whitespace separator character:        Options.            (line   66)
* Winter point on the ecliptic:          Glossary.           (line  744)
* Winter solstice <1>:                   Glossary.           (line  744)
* Winter solstice:                       Calendar options.   (line   48)
* Wintertime:                            Sun data.           (line 1058)
* Word:                                  Glossary.           (line  749)
* Word boundaries, matching in regexp:   Regexp Operators.   (line  274)
* Word, regexp definition:               Regexp Operators.   (line  252)
* Year calendar sheet blocks, number:    Calendar options.   (line 1386)
* Year calendar sheet, force output:     Calendar options.   (line 1386)
* Year difference value:                 Difference value.   (line   10)
* Year mode, single:                     Single commands.    (line   18)
* Year number %>04*Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  200)
* Year number %>04*Y[DATE] special text: Year number.        (line   14)
* Year number %[FORMAT]Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  195)
* Year number %[FORMAT]Y[DATE] special text: Year number.    (line    6)
* Year number %Y[DATE] special text <1>: Special Texts Summary.
                                                             (line  197)
* Year number %Y[DATE] special text:     Year number.        (line    7)
* Years' fixed dates:                    Fixed date options. (line 1417)
* Zodiacal line <1>:                     Moon data.          (line  324)
* Zodiacal line:                         Sun data.           (line  382)
* Zodiacal marker holidays in eternal holiday list: Calendar options.
                                                             (line  134)
* Zuhr prayer time:                      Glossary.           (line  753)
* Zuhr, Islamic prayer time:             Sun data.           (line   49)
* {EXPRESSION} regexp, interval expressions: Regexp Operators.
                                                             (line  233)
* | regexp, operator:                    Regexp Operators.   (line  170)
* ~ line break-up character <1>:         Text part of a line.
                                                             (line    6)
* ~ line break-up character:             Fixed date options. (line  386)



Tag Table:
Node: Top1609
Node: Preface8118
Node: Preface-Footnotes19196
Ref: Preface-Footnote-119255
Ref: Preface-Footnote-219557
Node: Gcal Introduction19626
Node: Gcal Introduction-Footnotes23191
Ref: Gcal Introduction-Footnote-123270
Ref: Gcal Introduction-Footnote-223301
Ref: Gcal Introduction-Footnote-323322
Node: Invoking Gcal23341
Node: Invoking Gcal-Footnotes24706
Ref: Invoking Gcal-Footnote-124777
Node: Command line arguments24867
Node: Command line arguments-Footnotes26544
Ref: Command line arguments-Footnote-126633
Node: Options26671
Node: Options-Footnotes30008
Ref: Options-Footnote-130067
Node: Common options30104
Node: Global options31347
Ref: x-response-file31531
Ref: x-debug-internal32406
Ref: x-debug-abort32943
Ref: x-pager33159
Ref: x-highlighting35888
Ref: x-mail39867
Node: Global options-Footnotes41994
Ref: Global options-Footnote-142067
Ref: Global options-Footnote-242133
Ref: Global options-Footnote-342183
Ref: Global options-Footnote-442229
Ref: Global options-Footnote-542272
Ref: Global options-Footnote-642341
Ref: Global options-Footnote-742396
Node: Calendar options42445
Ref: x-holiday-list42685
Ref: x-astronomical-holidays44042
Ref: x-bahai-holidays44467
Ref: x-chinese-flexible-holidays44854
Ref: x-chinese-holidays45246
Ref: x-islamic-civil-holidays45772
Ref: x-japanese-flexible-holidays46003
Ref: x-japanese-holidays46354
Ref: x-persian-jalaali-holidays47573
Ref: x-cc-holidays48249
Ref: x-type65569
Ref: x-orthodox-calendar66644
Ref: x-iso-week-number68181
Ref: x-blocks69606
Ref: x-starting-day72422
Ref: x-time-offset73082
Ref: x-date-format79730
Ref: x-translate-string83543
Node: Calendar options-Footnotes85260
Ref: Calendar options-Footnote-185337
Ref: Calendar options-Footnote-285421
Ref: Calendar options-Footnote-385459
Ref: Calendar options-Footnote-485528
Ref: Calendar options-Footnote-585725
Node: Fixed date options85826
Ref: x-date-variable86007
Ref: x-text-variable87107
Ref: x-adjust-value91689
Ref: x-atmosphere92900
Ref: x-limit93981
Ref: x-cycle-end96577
Ref: x-cycle-step99770
Ref: x-precise102258
Ref: x-execute-command102894
Ref: x-filter-text105055
Ref: x-ignore-case106234
Ref: x-list-of-fixed-dates106760
Ref: x-resource-file108598
Ref: x-biorhythm-axis115443
Ref: x-moonimage-lines116740
Ref: x-list-mode125399
Ref: x-period-of-fixed-dates125686
Node: Fixed date options-Footnotes149912
Ref: Fixed date options-Footnote-1149993
Ref: Fixed date options-Footnote-2150259
Ref: Fixed date options-Footnote-3150417
Ref: Fixed date options-Footnote-4150668
Ref: Fixed date options-Footnote-5150789
Ref: Fixed date options-Footnote-6150966
Ref: Fixed date options-Footnote-7151141
Ref: Fixed date options-Footnote-8151197
Ref: Fixed date options-Footnote-9151268
Ref: Fixed date options-Footnote-10151314
Ref: Fixed date options-Footnote-11151360
Ref: Fixed date options-Footnote-12151444
Ref: Fixed date options-Footnote-13151471
Ref: Fixed date options-Footnote-14151525
Ref: Fixed date options-Footnote-15151579
Ref: Fixed date options-Footnote-16151645
Node: Response file151711
Node: Actual date modifier153855
Node: Commands163098
Node: Single commands165277
Ref: x-mm-yyyy166141
Node: 3-Month mode commands167254
Node: Lists of commands168119
Node: Ranges of commands169304
Node: The GCAL environment variable170410
Node: Eternal Holidays171367
Node: Fixed Dates176060
Node: Resource file181001
Ref: x-File-searching-mechanism181936
Node: Resource file-Footnotes185399
Ref: Resource file-Footnote-1185470
Ref: Resource file-Footnote-2185612
Ref: Resource file-Footnote-3185730
Ref: Resource file-Footnote-4185767
Ref: Resource file-Footnote-5185832
Node: Structure of resource file185961
Node: Structure of resource file-Footnotes188604
Ref: Structure of resource file-Footnote-1188701
Ref: Structure of resource file-Footnote-2188772
Node: Date part of a line188965
Node: Further date part attributes195397
Node: Lists of days196770
Node: Ranges of days199922
Node: Ranges of days-Footnotes204492
Ref: Ranges of days-Footnote-1204565
Ref: Ranges of days-Footnote-2204648
Node: Repetition factor of days204674
Node: Repetition factor of days-Footnotes208744
Ref: Repetition factor of days-Footnote-1208839
Ref: Repetition factor of days-Footnote-2208870
Node: Appearance factor of days208964
Node: Appearance factor of days-Footnotes215589
Ref: Appearance factor of days-Footnote-1215684
Node: Text part of a line215767
Node: Text part of a line-Footnotes221568
Ref: Text part of a line-Footnote-1221651
Ref: Text part of a line-Footnote-2221677
Ref: Text part of a line-Footnote-3221721
Ref: Text part of a line-Footnote-4221815
Node: Special Texts processed221885
Node: Special Texts processed-Footnotes224129
Ref: Special Texts processed-Footnote-1224220
Node: Comment line224237
Node: Comment line-Footnotes226687
Ref: Comment line-Footnote-1226756
Node: Include directives226789
Node: Include directives-Footnotes229687
Ref: Include directives-Footnote-1229768
Ref: Include directives-Footnote-2229843
Ref: Include directives-Footnote-3229903
Ref: Include directives-Footnote-4230010
Ref: Include directives-Footnote-5230092
Ref: Include directives-Footnote-6230148
Node: Date variables230254
Node: Date variables-Footnotes236639
Ref: Date variables-Footnote-1236712
Ref: Date variables-Footnote-2236978
Ref: Date variables-Footnote-3237049
Ref: Date variables-Footnote-4237123
Node: Text variables237158
Node: Text variables-Footnotes251510
Ref: Text variables-Footnote-1251583
Ref: Text variables-Footnote-2251657
Node: Resource file examples251692
Node: Resource file examples-Footnotes265036
Ref: Resource file examples-Footnote-1265125
Node: Todays Calendar265191
Node: Gcal Utilities269869
Node: Invoking tcal270577
Node: Invoking tcal-Footnotes272419
Ref: Invoking tcal-Footnote-1272490
Node: Invoking txt2gcal272540
Node: Invoking gcal2txt274898
Node: Internationalization276887
Node: Internationalization-Footnotes282669
Ref: Internationalization-Footnote-1282754
Ref: Internationalization-Footnote-2282814
Ref: Internationalization-Footnote-3282870
Ref: Internationalization-Footnote-4282935
Ref: Internationalization-Footnote-5283040
Ref: Internationalization-Footnote-6283121
Node: Metasymbols283227
Node: Regular Expressions284690
Node: Regexp Usage286349
Node: Regexp Usage-Footnotes286972
Ref: Regexp Usage-Footnote-1287041
Node: Regexp Operators287124
Node: Regexp Operators-Footnotes298620
Ref: Regexp Operators-Footnote-1298697
Ref: Regexp Operators-Footnote-2298765
Ref: Regexp Operators-Footnote-3298816
Ref: Regexp Operators-Footnote-4298904
Ref: Regexp Operators-Footnote-5298961
Node: Regexp Summary299022
Node: Regexp Summary-Footnotes301239
Ref: Regexp Summary-Footnote-1301312
Node: Special Texts301378
Node: Exclusions305060
Node: Exclusions with date argument305607
Node: Inclusive date period306770
Node: Exclusive date period310216
Node: Exclusions without any argument313626
Node: Inclusive day period314690
Node: Exclusive day period315852
Node: Replacements316955
Node: Replacements with date argument317849
Node: Replacements with date argument-Footnotes319454
Ref: Replacements with date argument-Footnote-1319561
Node: Weekday name319649
Node: Weekday number320713
Node: Day-of-year number326189
Node: Day number327731
Node: Week number329098
Node: Month name329919
Node: Month number330684
Node: Year number332085
Node: Moon phase332838
Node: Biorhythm335940
Node: Difference value340235
Ref: x-Age-value340807
Node: Replacements with other argument341777
Node: Actual clocktime342937
Ref: x-Actual-local-time344524
Node: Actual clocktime-Footnotes352462
Ref: Actual clocktime-Footnote-1352539
Node: Textual date352597
Node: Julian day number353291
Node: Geographical distance and course angle355083
Node: Geographical distance and course angle-Footnotes359842
Ref: Geographical distance and course angle-Footnote-1359963
Node: Sun data360661
Ref: x-Sun-midnight362518
Ref: x-Sun-noon363306
Ref: x-Sun-standard-rise370589
Ref: x-Sun-standard-set372298
Ref: x-Sun-asr-1408544
Ref: x-Sun-asr-2410778
Ref: x-Sun-representation412748
Ref: x-Sun-event-texts415102
Ref: x-Sun-arguments419620
Node: Moon data432789
Ref: x-Moon-midnight434647
Ref: x-Moon-noon435966
Ref: x-Moon-standard-rise444421
Ref: x-Moon-standard-set446347
Node: Contents of Environment variable492007
Node: Replacements without any argument492580
Node: Other difference values493008
Node: Highlighting495759
Node: Shell Command502863
Node: Special Texts Summary504282
Node: Obsolete Special Texts580134
Node: Table of Obsolete Special Texts581130
Node: Table of Obsolete Date Format Elements584166
Node: Table of Obsolete Date Formats585807
Node: Format Instruction586619
Node: Coding Scheme589323
Node: Coding Scheme Table 1590806
Node: Coding Scheme Table 2593780
Node: Environment Variables596305
Ref: x-GCAL596561
Ref: x-GCAL_COLUMNS596650
Ref: x-COLUMNS596650
Ref: x-GCAL_DATE_FORMAT596839
Ref: x-GCAL_LINES597007
Ref: x-LINES597007
Ref: x-GCAL_SYS_DATADIR597192
Ref: x-GCAL_USR_DATADIR597391
Ref: x-GCALANSI597622
Ref: x-GCALPATH597856
Ref: x-GCALPROG598051
Ref: x-HOME598526
Ref: x-LOGNAME599286
Ref: x-MAILPROG599439
Ref: x-MAILTO599722
Ref: x-PAGER599922
Ref: x-PATH600087
Ref: x-TERM600273
Ref: x-TXT2GCALPROG600355
Ref: x-USER601053
Node: Error Codes601234
Ref: x-126-Error-code601518
Ref: x-119-Error-code601973
Ref: x-118-Error-code602073
Ref: x-113-Error-code602405
Ref: x-2-Error-code603062
Ref: x-1-Error-code603129
Node: Glossary603279
Node: Argument Index630702
Node: Variable Index658589
Node: Table Index664766
Node: GNU Free Documentation License672522
Node: Concept Index697701

End Tag Table
