Gcal 3.6

Gcal

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

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

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

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

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

• 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