This is Info file de/gcal.info, produced by Makeinfo-1.64 from the
input file de/gcal.texi.

START-INFO-DIR-ENTRY
* Gcal: (gcal).              Das GNU Kalenderprogramm.
END-INFO-DIR-ENTRY

Diese Datei beschreibt Gcal, ein Programm um Kalender auszugeben.  Gcal
gibt Monatskalender und Jahreskalender, ewige Feiertagslisten sowie
Terminwarnungslisten auf viele verschiedene Arten und Weisen aus.  Es
berücksichtigt diejenigen Daten korrekt, welche übergangen wurden,
als der derzeitig gültige Gregorianische Kalender den vormals gültigen
Julianischen Kalender ablöste.

Copyright (C) 1994, 1995, 1996 Thomas Esken

Das ist die erste Ausgabe der Gcal Dokumentation.

Hiermit wird die Erlaubnis erteilt, wortgetreue Kopien dieses Handbuchs
zu erstellen und zu vertreiben, sofern alle gemachten Kopien mit dem
Copyrightvermerk und diesem Genehmigungsvermerk ausgestattet sind und
vorgenannte Vermerke erhalten bleiben.

Hiermit wird die Erlaubnis erteilt, veränderte Kopien dieses Handbuchs
wie unter den Bedingungen für wortgetreue Kopien zu erstellen und zu
vertreiben, sofern die ausgeführten Arbeiten in Ableitung und
Gesamtheit innerhalb der Bestimmungen eines Genehmigungvermerks liegen
und zudem mit diesem ausgestattet sind, welcher mit diesem hier
identisch ist.

Hiermit wird die Erlaubnis erteilt, wie unter den vorgenannten
Bedingungen für veränderte Versionen Übersetzungen dieses Handbuchs
in eine andere Sprache zu erstellen und zu vertreiben, mit der
Ausnahme, daß dieser Genehmigungsvermerk in einer Übersetzung
angegeben sein darf, welche von der Free Software Foundation gebilligt
wird.

Jedwede Vorschläge, Verbesserungen, Erweiterungen, Fehlerberichte,
Geld- und Sachspenden, Programmieraufträge usw. sind stets willkommen.
Bitte senden Sie diese direkt an meine Email Adresse.  Wenn Sie dieses
Werkzeug mögen, so würde ich mich sehr über eine Postkarte von Ihnen
freuen!

                                \\\_''/'
-------------------------oOO    (/o-o\)    OOo-------------------------
Thomas Esken                o  (.  "  .)  o   Internet :
Im Hagenfeld 84              \___) ~ (___/      (esken@uni-muenster.de)
D-48147 Muenster; GERMANY                     Phone    : +49 251 232585


File: gcal.info,  Node: Terminwarnung Optionen,  Prev: Kalender Optionen,  Up: Optionen

Terminwarnung Optionen
......................

`-v ARGUMENT'
`--date-variable=ARGUMENT'
     Definiere "globale" Datumvariable, welche in allen referenzierten
     Ressourcendateien sichtbar ist (*note Datumvariablen::.).  Das
     Optionsargument ARGUMENT muß entweder eine einzelne
     Datumvariablen-Definition oder eine durch `:' Doppelpunkt
     voneinander getrennte Liste von Definitionen sein.

     Der Name einer Datumvariablen DVAR besteht aus einem einzelnen
     Buchstaben (Groß- bzw. Kleinbuchstaben werden nicht unterschieden
     und ausgenommen dem Buchstaben `e', welcher intern für das Datum
     des Ostersonntags reserviert ist und welcher deswegen nicht
     zuweisbar/inoperabel ist), und wird bei einer Definition gefolgt
     von dem Zuweisungsoperator `=' und den Zahlenwerten für Monat MM
     (oder einem Monatsnamen im dreistelligen Kurzformat, z.B.  `Jan',
     `Feb', ...) und Tag TT, welche diese Variable aufzunehmen hat
     (oder dem Namen einer anderen globalen Datumvariablen, aber nicht
     einer Datumangabe im `MMWWWN', `DVAR[+|-]N[WWW]' oder `*d|wN[WWW]'
     Format).

     Einige Beispiele:

          `--date-variable=a=1127:c=a' bzw.
          `-v a=1127:c=a'
          speichert den 27'ten November in der globalen Datumvariablen A
          und in der globalen Datumvariablen C.

`--export-date-variables'
     Bewirkt den Export lokaler Datumvariablen von Ressourcendatei zu
     Ressourcendatei.  *Note Datumvariablen::, für weitere Details.

`-r ARGUMENT'
`--text-variable=ARGUMENT'
     Definiere "globale" Textvariable, welche in allen referenzierten
     Ressourcendateien sichtbar ist (*note Textvariablen::.).  Das
     Optionsargument ARGUMENT muß entweder eine einzelne
     Textvariablen-Definition oder eine durch `:' Doppelpunkt
     voneinander getrennte Liste von Definitionen sein.

     Der Name einer Textvariablen TVAR besteht aus einem `$' Präfix
     und einem einzelnen Buchstaben (Groß- bzw. Kleinbuchstaben werden
     nicht unterschieden), und wird bei einer Definition gefolgt von
     dem Zuweisungsoperator `=' und dem Text, welchen diese Variable
     aufzunehmen hat.  Eine globale Textvariable wird mit *leerem*
     Inhalt definiert falls kein Text rechts des Zuweisungsoperators
     angegeben ist.

     Einige Beispiele:

          `--text-variable=$a=foo:$c=$a' bzw.
          `-r $a=foo:$c=$a'
          speichert den Text `foo' in der globalen Textvariablen $A und
          in der globalen Textvariablen $C.

     Falls das `:' Zeichen im Text als Zeichen selbst verwendet werden
     soll, so muß dieses durch ein führendes `\' (Backslash) Zeichen
     quotiert (geschützt/entwertet) werden, z.B. `\:'.

     Wenn die Zeichen `\:' im Text selbst als Zeichenfolge verwendet
     werden sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\:'.

     Falls das `$' Zeichen im Text als Zeichen selbst verwendet werden
     soll, so muß dieses durch ein führendes `\' (Backslash) Zeichen
     quotiert (geschützt/entwertet) werden, z.B. `\$'.

     Wenn die Zeichen `\$' im Text selbst als Zeichenfolge verwendet
     werden sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\$'.

     Jedesmal wenn ein `_' (Unterstrich) Zeichen in ARGUMENT vorgefunden
     wird, so wird dieses Zeichen durch ein echtes ` ' (Leerzeichen)
     Zeichen ersetzt.

     Falls das `_' (Unterstrich) Zeichen als Zeichen selbst verwendet
     werden soll, so muß dieses durch ein führendes `\' (Backslash)
     Zeichen quotiert (geschützt/entwertet) werden, z.B. `\_'.

     Wenn die Zeichen `\_' selbst als Zeichenfolge verwendet werden
     sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\_'.

`--export-text-variables'
     Bewirkt den Export lokaler Textvariablen von Ressourcendatei zu
     Ressourcendatei.  *Note Textvariablen::, für weitere Details.

`-c|C[-]'
`--today'
`--list-of-fixed-dates[=short|long]'
`--descending-fixed-dates[=short|long]'
     Aktivierung der Terminwarnungsfunktion und Ausgabe von
     Terminwarnungen.

    `-c'
    `--today'
    `--list-of-fixed-dates=short'
          Aktivierung der Terminwarnungsfunktion (implizite Benutzung
          der Standard-Ressourcendatei) und alle Daten in aufsteigender
          Reihenfolge ausgeben, die sich auf den heutigen Tag beziehen.
          Wenn keine Daten zum heutigen Tag vorgefunden werden, so
          werden keine Terminwarnungen ausgegeben und das Programm wird
          mit Fehlerkode abgebrochen; siehe auch *Note 1: Fehlerkodes.

    `-c-'
    `--descending-fixed-dates=short'
          Aktivierung der Terminwarnungsfunktion (implizite Benutzung
          der Standard-Ressourcendatei) und alle Daten in absteigender
          Reihenfolge ausgeben, die sich auf den heutigen Tag beziehen.
          Wenn keine Daten zum heutigen Tag vorgefunden werden, so
          werden keine Terminwarnungen ausgegeben und das Programm wird
          mit Fehlerkode abgebrochen; siehe auch *Note 1: Fehlerkodes.

    `-C'
    `--list-of-fixed-dates=long'
          Aktivierung der Terminwarnungsfunktion (implizite Benutzung
          der Standard-Ressourcendatei) und alle Daten in aufsteigender
          Reihenfolge ausgeben, die sich auf den heutigen Tag beziehen.
          Wenn keine Daten zum heutigen Tag vorgefunden werden, so
          wird eine nur aus dem Datum bestehende Terminwarnung
          ausgegeben.

    `-C-'
    `--descending-fixed-dates=long'
          Aktivierung der Terminwarnungsfunktion (implizite Benutzung
          der Standard-Ressourcendatei) und alle Daten in absteigender
          Reihenfolge ausgeben, die sich auf den heutigen Tag beziehen.
          Wenn keine Daten zum heutigen Tag vorgefunden werden, so
          wird eine nur aus dem Datum bestehende Terminwarnung
          ausgegeben.

`-f|F DATEINAME[+...]'
`--resource-file=DATEINAME'
     Aktivierung der Terminwarnungsfunktion und Datei DATEINAME
     anstelle der Standard-Ressourcendatei benutzen.  Sodann alle Daten
     in aufsteigender Reihenfolge ausgeben, die in den
     Terminwarnungszeitraum fallen.  Wurde kein besonderer
     Terminwarnungszeitraum angegeben, so wird der heutige Tag als
     Terminwarnungszeitraum angenommen.  Wurde der Optionsbuchstabe `f'
     bei der Kurzoption benutzt und es werden keine Daten in DATEINAME
     vorgefunden, die in den Terminwarnungszeitraum fallen, so werden
     keine Terminwarnungen ausgegeben und das Programm wird mit
     Fehlerkode abgebrochen; siehe auch *Note 1: Fehlerkodes.  Wurde
     der Optionsbuchstabe `F' bei der Kurzoption benutzt und es werden
     keine Daten in DATEINAME vorgefunden, die in den
     Terminwarnungszeitraum fallen, so wird eine nur aus dem Datum
     bestehende Terminwarnung ausgegeben.

     Es kann mehr als eine Ressourcendatei DATEINAME verwendet werden,
     wenn die zusätzlichen Ressourcendateien, durch ein `+' Zeichen
     getrennt, aufgeführt werden, z.B.:

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

     berücksichtigt alle Dateien, die in dem vorstehenden Argument
     aufgeführt sind; dabei wird ein spezieller Suchmechanismus zum
     Auffinden der Dateien benutzt.  *Note Datei-Suchmechanismus:
     Ressourcendatei, für weitere Details.  Wenn DATEINAME auf
     `/dev/null' gesetzt ist, so wird daß Vorladen einer
     Standard-Ressourcendatei verhindert, was nützlich ist, wenn leere
     Terminwarnungslisten erzeugt werden sollen.

     Falls das `+' Zeichen als Zeichen selbst verwendet werden soll, so
     muß dieses durch ein führendes `\' (Backslash) Zeichen quotiert
     (geschützt/entwertet) werden, z.B. `\+'.

     Wenn die Zeichen `\+' selbst als Zeichenfolge verwendet werden
     sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\+'.

     Jedesmal wenn ein `_' (Unterstrich) Zeichen in DATEINAME
     vorgefunden wird, so wird dieses Zeichen durch ein echtes ` '
     (Leerzeichen) Zeichen ersetzt.

     Falls das `_' (Unterstrich) Zeichen als Zeichen selbst verwendet
     werden soll, so muß dieses durch ein führendes `\' (Backslash)
     Zeichen quotiert (geschützt/entwertet) werden, z.B. `\_'.

     Wenn die Zeichen `\_' selbst als Zeichenfolge verwendet werden
     sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\_'.

*Bitte beachten:*
Wenn die Kurzoption `-c' und/oder ihre Modifizierer `t|[w|m|y[+|-]'
bzw. die Kurzoption `-f' in *Großbuchstaben* angegeben werden, z.B.:

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

so gibt Gcal für *jeden* Tag in der verlangten Periode Terminwarnungen
aus.

Die Modifizierer einer kombinierten/komplexen/gepackten Kurzoption zur
Terminwarnung müssen entsprechend der hier vorgegebenen Reihenfolge
zusammengesetzt werden, da Gcal diese als positionale Parameter
behandelt:

    Erste Stufe: *Repräsentation-des-Textes*
          `a', `A', `e|E', `k', `o', `x', `z'

    Zweite Stufe: *Setzung-der-uu-berücksichtigenden-Periode*
          `d', `l', `t|T', `w|W|m|M|y|Y[+|-]', `N+|-', `Nd', `Nw',
          `*dN[WWW]', `*wN[WWW]', `@e|DVAR[[+|-]N]', `@e|DVAR[+|-]NWWW',
          `MMTT', `MMWWWN'

Wenn mit den folgenden Modifizierern gearbeitet werden möchte, so
*muß* eine explizite `-c|C[-]' Kurzoption zuvor angegeben sein, z.B.:

     -c-t
     -cw-
     -CaAdeklorxz12+

und es darf nur *ein* zeitraumdefinierender
Terminwarnungszeitraum-Modifizierer angegeben werden (davon ausgenommen
sind die `--include-today' Option bzw.  der `d' Modifizierer, die
`--list-mode' Option bzw. der `l' Modifizierer und die
`--leap-day=february|march' Option).

Oder die Modifizierer müssen als Einzelzeichenoption oder
zusammengefasst zu einem einzelnen Kommandozeilenwort angegeben werden,
und es muß zudem entweder die Kurzoption `-c|C[-]' (oder die
entsprechende Langoption) bzw. `-f|F DATEINAME[+...]' (oder die
entsprechende Langoption) angegeben werden, z.B.:

     -c- -t
     -w- -c
     -a -Ad -e -klorxz -C12+
     -F foo.bar -Ad -l*d10

Werden Modifizierer als Einzelzeichenoption oder zu einem einzelnen
Kommandozeilenwort zusammengefasst angegeben und dabei einer der
`t|T|[w|W|m|M|y|Y[+|-]]' Modifizierer benutzt (oder deren entsprechende
Aliasnamen wie `--today', `--tomorrow'...), so ist die Angabe einer
`-c|C[-]' Kurzoption (oder deren entsprechende Langoption) bzw.
`-f|F DATEINAME[+...]' Kurzoption (oder deren entsprechende Langoption)
nicht notwendig um die Terminwarnungsfunktion von Gcal zu aktivieren,
da die Terminwarnungsfunktion durch diese Modifizierer implizit
ausgelöst wird.

*Terminwarnungstext-Modifizierer:*

`a'
`--include-resource-file-name'
     Den Namen der verwendeten Ressourcendatei in der Terminwarnung
     zusätzlich mit ausgeben, z.B.:

          Mo,   1 Jan 1995: (`Ewige Feiertagsliste') Neujahr
          Mo,   1 Jan 1995: (.gcalrc) Keine weiteren Termine
          ...

`A'
`--alternative-format'
     Anstelle der Ausgabe im "Standard" Listenformat, z.B.:

          Mo,   1 Jan 1995: Neujahr
          Mo,   1 Jan 1995: Keine weiteren Termine
          ...

     benutzt Gcal das "Alternative" Listenformat, z.B.:

          Mo,   1 Jan 1995:
          Neujahr
          Keine weiteren Termine
          ...

`e'
`--include-holidays=long'
     Alle Daten aus der eingebauten ewigen Feiertagsliste in die
     Terminwarnungsliste einstreuen, d.h. gesetzliche Feiertage und
     Gedenktage.

`E'
`--include-holidays=short'
     Nur diejenigen Daten aus der eingebauten ewigen Feiertagsliste in
     die Terminwarnungsliste einstreuen, die gesetzliche Feiertage sind.

`g[TEXT]'
`--grouping-text[=TEXT]'
     Gruppiere die Terminwarnungen tageweise mittels des Separators
     TEXT.  Wenn kein TEXT angegeben ist, so wird der eingebaute TEXT
     (`RC_GROUP_SEP' "" == nur Leerzeile) zum Gruppieren verwendet,
     z.B.:

          $ gcal -Cw -cg
          -|
          -| So,   6 Nov 1994: Text 1
          -| So,   6 Nov 1994: Text 2
          -|
          -| Mo,   7 Nov 1994: Text 3
          -|
          -| Di,   8 Nov 1994: Text 4
          ...
          
          
          $ gcal -Cw -g'-Ein_vom\_Benutzer-~-definierter Text-'
          -|
          -| So,   6 Nov 1994: Text 1
          -| So,   6 Nov 1994: Text 2
          -| -Ein vom_Benutzer-
          -| -definierter Text-
          -| Mo,   7 Nov 1994: Text 3
          -| -Ein vom_Benutzer-
          -| -definierter Text-
          -| Di,   8 Nov 1994: Text 4
          ...

     Jedesmal wenn ein `~' (Tilde) Zeichen in TEXT vorgefunden wird, so
     wird dieses Zeichen durch ein echtes `\n' (Newline) Zeichen
     ersetzt.

     Falls das `~' (Tilde) Zeichen als Zeichen selbst verwendet werden
     soll, so muß dieses durch ein führendes `\' (Backslash) Zeichen
     quotiert (geschützt/entwertet) werden, z.B. `\~'.

     Wenn die Zeichen `\~' selbst als Zeichenfolge verwendet werden
     sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\~'.

     Jedesmal wenn ein `_' (Unterstrich) Zeichen in TEXT vorgefunden
     wird, so wird dieses Zeichen durch ein echtes ` ' (Leerzeichen)
     Zeichen ersetzt.

     Falls das `_' (Unterstrich) Zeichen als Zeichen selbst verwendet
     werden soll, so muß dieses durch ein führendes `\' (Backslash)
     Zeichen quotiert (geschützt/entwertet) werden, z.B. `\_'.

     Wenn die Zeichen `\_' selbst als Zeichenfolge verwendet werden
     sollen, so muß das `\' (Backslash) Zeichen mit sich selbst
     quotiert werden, z.B. `\\_'.

`k'
`--include-weeknumber'
     Das führende Datum in einem Terminwarnungstext wird bei Ausgabe
     mit der ISO-8601:1988 Wochennummer von diesem Datum versehen.

     *Bitte beachten:*
     Die Methoden der ISO-8601:1988 werden zur Ermittlung der
     Wochennummern verwendet.  Das bedeutet, daß eine Woche mit einem
     Montag beginnt, und die erste Woche des Jahres ist diejenige
     Woche, in welche der erste Donnerstag fällt, also gleich der
     Woche ist, in welcher der 4'te Januar auftritt.

`o'
`--omit-multiple-date-part'
     Vermeidet die Mehrfachausgabe von einem jede Einzelzeile
     anführendem Datum in der Terminwarnungsliste, falls sich weitere
     Termine auf dieses Datum beziehen (nur falls die
     `--alternative-format' Option bzw. der `A' Modifizierer nicht
     angegeben wurde), z.B.:

          $ gcal -co
          -|
          -| So,   6 Nov 1994: Text 1
          -|                   Text 2
          ...

`x'
`--exclude-fixed-dates-list-title'
     Ausgabe der Überschrift in der Terminwarnungsliste unterdrücken.

`z'
`--include-consecutive-number'
     Laufende Postennummer der Terminwarnung ausgeben.

*Terminwarnungszeitraum-Modifizierer:*

`--leap-day=february|march'
     Den "Schalttag" (d.h. den 29'ten Februar) auch in
     Nicht-Schaltjahren berücksichtigen.

    `--leap-day=february'
          Eine Terminwarnung, die in jedem Jahr gelten soll und sich
          auf den Schalttag bezieht, wird in Nicht-Schaltjahren am
          28'ten Februar ausgegeben.

    `--leap-day=march'
          Eine Terminwarnung, die in jedem Jahr gelten soll und sich
          auf den Schalttag bezieht, wird in Nicht-Schaltjahren am
          1'ten März ausgegeben.

`d'
`--include-today'
     Wenn eine Datumliste erzeugt wird, so wird das aktuelle Datum in
     dieser Liste mit eingeschlossen.  *Note `--list-mode':
     Terminwarnung Optionen, wie eine Datumliste erzeugt wird.

`l'
`--list-mode'
     Erzeugen einer Datumliste anstelle eines Einzeldatum.

     *Bitte beachten:*
     In den folgenden Beispielen wird angenommen, daß das heutige
     Tagesdatum der 17'te Februar eines beliebigen Jahres ist!

`--period-of-fixed-dates=ARGUMENT'
`Nd'
`*dN'
     Alle Daten zum absoluten Tag N == `1...365|366|999' im aktuellen
     Jahr ausgeben; das Warnungsniveau ist wie bei der einfachen `-c'
     Option.  Wenn für N der Wert 999 angegeben ist, so wird der
     letzte Tag im Jahr (31'ter Dezember) angenommen.

        * Z.B. `gcal -c10d' bzw. `gcal --period-of-fixed-dates=10d'
          oder `gcal -c*d10' bzw. `gcal --period-of-fixed-dates=*d10'
          gibt die Termine aus, die am 10'ten Tag des Jahres
          stattfinden.

`lNd'
`l*dN'
     Liste von Daten, in Abhängigkeit des Wertes von N gestern oder
     morgen beginnend, und endend am N'ten absoluten Tag des aktuellen
     Jahres; das Warnungsniveau ist wie bei der `-cy' Option.

        * Z.B. `gcal -cl10d' bzw. `gcal -cl*d10' gibt eine Liste aller
          derjenigen Termine aus, die am 10'ten Tag des Jahres beginnen
          und am 16'ten Februar enden.

`N+|-'
     Alle Daten zum Tag *heute `+/-' N Tage* im aktuellen Jahr
     ausgeben; das Warnungsniveau ist wie bei der einfachen `-c' Option.

        * Z.B. `gcal -c10+' gibt die Termine aus, die 10 Tage nach dem
          17'ten Februar (heute) stattfinden.

        * Z.B. `gcal -c10-' gibt die Termine aus, die 10 Tage vor dem
          17'ten Februar (heute) stattfinden.

`lN+|-'
     Liste von Daten, gestern `-' oder morgen `+' beginnend, und endend
     am Tag *heute `+/-' N Tage* im aktuellen Jahr ausgeben; das
     Warnungsniveau ist wie bei der `-cy' Option.

        * Z.B. `gcal -cl10+' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und 10 Tage danach enden.

        * Z.B. `gcal -cl10-' gibt eine Liste aller derjenigen Termine
          aus, die 10 Tage vor dem 16'ten Februar beginnen und am
          16'ten Februar enden.

`Nw'
     Alle Daten zur Woche Nummer N == `0|1...52|53|99' des aktuellen
     Jahres ausgeben; das Warnungsniveau ist wie bei der `-cw' Option.

        * Z.B. `gcal -c0w' gibt alle diejenigen Termine aus, die falls
          das Vorjahr eine 53'te ISO-Kalenderwoche hat, in der 53'ten
          ISO-Kalenderwoche des Vorjahres liegen oder falls das Vorjahr
          keine 53'te ISO-Kalenderwoche hat, in der 1'ten
          ISO-Kalenderwoche des aktuellen Jahres liegen.

        * Z.B. `gcal -c6w' gibt alle diejenigen Termine aus, die in der
          6'ten ISO-Kalenderwoche liegen.

        * Z.B. `gcal -c52w' gibt alle diejenigen Termine aus, die in
          der 52'ten ISO-Kalenderwoche liegen.

        * Z.B. `gcal -c53w' gibt alle diejenigen Termine aus, die in
          der 53'ten ISO-Kalenderwoche liegen, falls das Jahr eine 53'te
          ISO-Kalenderwoche hat.  Wenn das Jahr keine 53'te
          ISO-Kalenderwoche hat, so werden keine Terminwarnungen
          ausgegeben und das Programm wird mit Fehlerkode abgebrochen;
          siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c99w' gibt alle diejenigen Termine aus, die in
          der letzten ISO-Kalenderwoche liegen, d.h. entweder die 52'te
          oder die 53'te ISO-Kalenderwoche.

`lNw'
     Liste von Daten, in Abhängigkeit der gegebenen Wochennummer
     N == `0|1...52|53|99' gestern oder morgen beginnend und endend am
     ersten bzw. letzten Tag der gegebenen Woche N des aktuellen Jahres
     ausgeben; das Warnungsniveau ist wie bei der `-cy' Option.

        * Z.B. `gcal -cl12w' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und bis zum Ende der
          12'ten ISO-Kalenderwoche reichen.

        * Z.B. `gcal -cl3w' gibt eine Liste aller derjenigen Termine
          aus, die am Anfang der 3'ten ISO-Kalenderwoche beginnen und
          16'ten Februar enden.

`MMTT'
     Alle Daten zum Tag TT im Monat MM des aktuellen Jahres ausgeben;
     das Warnungsniveau ist wie bei der einfachen `-c' Option.

        * Z.B. `gcal -c0225' gibt die Termine aus, die am 25'ten
          Februar stattfinden.

`lMMTT'
     Liste von Daten, in Abhängigkeit des Wertes MMTT gestern bzw.
     morgen beginnend, und endend am Tag TT im Monat MM des aktuellen
     Jahres, ausgeben; das Warnungsniveau ist wie bei der `-cy' Option.

        * Z.B. `gcal -cl0225' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und am 25'ten Februar
          enden.

        * Z.B. `gcal -cl0109' gibt eine Liste aller derjenigen Termine
          aus, die am 9'ten Januar beginnen und am 16'ten Februar enden.

`MMWWWN'
     Alle Daten zum N'ten == `1...5|9' Wochentag WWW im Monat MM des
     aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     einfachen `-c' Option.

        * Z.B. `gcal -c01mon3' gibt die Termine aus, die am dritten
          Montag im Januar stattfinden.

        * Z.B. `gcal -c02fr9' gibt die Termine aus, die am letzten
          Freitag im Februar stattfinden.

`lMMWWWN'
     Liste von Daten, in Abhängigkeit des Wertes in MMWWWN gestern
     bzw. morgen beginnend, und endend am N'ten == `1...5|9' Wochentag
     WWW im Monat MM des aktuellen Jahres ausgeben; das Warnungsniveau
     ist wie bei der `-cy' Option.

        * Z.B. `gcal -cl01mon3' gibt eine Liste aller derjenigen
          Termine aus, die am dritten Montag im Januar beginnen und am
          16'ten Februar enden.

        * Z.B. `gcal -cl02fr9' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und am letzten Freitag im
          Februar enden.

`*dNWWW'
     Alle Daten zum N'ten == `1...51|52|53|99' Wochentag WWW des
     aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     einfachen `-c' Option.

        * Z.B. `gcal -c*d16son' gibt alle diejenigen Termine aus, die
          auf den 16'ten Sonntag des Jahres fallen.

        * Z.B. `gcal -c*d52son' gibt alle diejenigen Termine aus, die
          auf den 52'ten Sonntag des Jahres fallen.  Wenn das Jahr
          keinen 52'ten Sonntag hat, so werden keine Terminwarnungen
          ausgegeben und das Programm wird mit Fehlerkode abgebrochen;
          siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c*d53son' gibt alle diejenigen Termine aus, die
          auf den 53'ten Sonntag des Jahres fallen.  Wenn das Jahr
          keinen 53'ten Sonntag hat, so werden keine Terminwarnungen
          ausgegeben und das Programm wird mit Fehlerkode abgebrochen;
          siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c*d99son' gibt alle diejenigen Termine aus, die
          auf den letzten Sonntag (das ist entweder der 51'te, 52'te
          oder 53'te Sonntag) des Jahres fallen.

`l*dNWWW'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am N'ten == `1...51|52|53|99' Wochentag WWW
     des aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     `-cy' Option.

        * Z.B. `gcal -cl*d16son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am 16'ten
          Sonntag des Jahres enden.

        * Z.B. `gcal -cl*d52son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am 52'ten
          Sonntag des Jahres enden.  Wenn das Jahr keinen 52'ten
          Sonntag hat, so werden keine Terminwarnungen ausgegeben und
          das Programm wird mit Fehlerkode abgebrochen; siehe auch
          *Note 126: Fehlerkodes.

        * Z.B. `gcal -cl*d53son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am 53'ten
          Sonntag des Jahres enden.  Wenn das Jahr keinen 53'ten
          Sonntag hat, so werden keine Terminwarnungen ausgegeben und
          das Programm wird mit Fehlerkode abgebrochen; siehe auch
          *Note 126: Fehlerkodes.

        * Z.B. `gcal -cl*d99son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am letzten
          Sonntag (das ist entweder der 51'te, 52'te oder 53'te
          Sonntag) des Jahres enden.

`*wN[WWW]'
     Alle Daten zum Wochentag WWW der N'ten == `0|1...52|53|99'
     ISO-Kalenderwoche des aktuellen Jahres ausgeben; das
     Warnungsniveau ist wie bei der einfachen `-c' Option.  Wenn kein
     Wochentag WWW angegeben ist, so wird Montag als Wochentag
     angenommen.

        * Z.B. `gcal -c*w0son' gibt alle diejenigen Termine aus, die
          falls das Jahr einen Sonntag hat, der in der 52'ten bzw.
          53'ten ISO-Kalenderwoche des Vorjahres liegt, auf diesen
          Sonntag fallen.  Wenn ein solcher Sonntag nicht existiert, so
          werden keine Terminwarnungen ausgegeben und das Programm wird
          mit Fehlerkode abgebrochen; siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c*w16son' gibt alle diejenigen Termine aus, die
          auf den Sonntag der 16'ten ISO-Kalenderwoche des Jahres
          fallen.

        * Z.B. `gcal -c*w52son' gibt alle diejenigen Termine aus, die
          auf den Sonntag der 52'ten ISO-Kalenderwoche des Jahres
          fallen.  Wenn das Jahr keinen Sonntag der 52'ten
          ISO-Kalenderwoche hat, so werden keine Terminwarnungen
          ausgegeben und das Programm wird mit Fehlerkode abgebrochen;
          siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c*w53son' gibt alle diejenigen Termine aus, die
          auf den Sonntag der 53'ten ISO-Kalenderwoche des Jahres
          fallen.  Wenn das Jahr keinen Sonntag der 53'ten
          ISO-Kalenderwoche hat, so werden keine Terminwarnungen
          ausgegeben und das Programm wird mit Fehlerkode abgebrochen;
          siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -c*w99son' gibt alle diejenigen Termine aus, die
          auf den Sonntag der letzten ISO-Kalenderwoche (das ist
          entweder die 51'te, 52'te oder 53'te ISO-Kalenderwoche) des
          Jahres fallen.

`l*wN[WWW]'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am Wochentag WWW der
     N'ten == `1...51|52|53|99' ISO-Kalenderwoche des aktuellen Jahres
     ausgeben; das Warnungsniveau ist wie bei der `-cy' Option.  Wenn
     kein Wochentag WWW angegeben ist, so wird Montag als Wochentag
     angenommen.

        * Z.B. `gcal -cl*w0son' gibt eine Liste aller derjenigen
          Termine aus, die falls das Jahr einen Sonntag hat, der in der
          52'ten bzw. 53'ten ISO-Kalenderwoche des Vorjahres liegt, an
          diesem Sonntag beginnen und am 16'ten Februar enden.  Wenn
          ein solcher Sonntag nicht existiert, so werden keine
          Terminwarnungen ausgegeben und das Programm wird mit
          Fehlerkode abgebrochen; siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -cl*w16son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am Sonntag
          der 16'ten ISO-Kalenderwoche des Jahres enden.

        * Z.B. `gcal -cl*w52son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am Sonntag
          der 52'ten ISO-Kalenderwoche des Jahres enden.  Wenn das Jahr
          keinen Sonntag der 52'ten ISO-Kalenderwoche hat, so werden
          keine Terminwarnungen ausgegeben und das Programm wird mit
          Fehlerkode abgebrochen; siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -cl*w53son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am Sonntag
          der 53'ten ISO-Kalenderwoche des Jahres enden.  Wenn das Jahr
          keinen Sonntag der 53'ten ISO-Kalenderwoche hat, so werden
          keine Terminwarnungen ausgegeben und das Programm wird mit
          Fehlerkode abgebrochen; siehe auch *Note 126: Fehlerkodes.

        * Z.B. `gcal -cl*w99son' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am Sonntag
          der letzten ISO-Kalenderwoche (das ist entweder der 51'te,
          52'te oder 53'te ISO-Kalenderwoche) des Jahres enden.

`@e[[+|-]N]'
     Alle Daten zum N'ten Tag relativ zum Datum Ostersonntag des
     aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     einfachen `-c' Option.

        * Z.B. `gcal -c@e' gibt die Termine aus, die am Ostersonntag
          stattfinden.

        * Z.B. `gcal -c@e10' bzw. `gcal -c@e+10' gibt die Termine aus,
          die 10 Tage nach Ostersonntag stattfinden.

        * Z.B. `gcal -c@e-10' gibt die Termine aus, die 10 Tage vor
          Ostersonntag stattfinden.

`l@e[[+|-]N]'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am N'ten Tag relativ zum Datum Ostersonntag
     des aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     `-cy' Option.

        * Z.B. `gcal -cl@e' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und am Ostersonntag enden.

        * Z.B. `gcal -cl@e10' bzw. `gcal -cl@e+10' gibt eine Liste aller
          derjenigen Termine aus, die am 18'ten Februar beginnen und 10
          Tage nach Ostersonntag enden.

        * Z.B. `gcal -cl@e-10' gibt eine Liste aller derjenigen Termine
          aus, die am 18'ten Februar beginnen und 10 Tage vor
          Ostersonntag enden.

`@e[+|-]NWWW'
     Alle Daten zum N'ten Wochentag WWW relativ zum Datum Ostersonntag
     des aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     einfachen `-c' Option.

        * Z.B. `gcal -c@e3fr' bzw. `gcal -c@e+3fr' gibt die Termine aus,
          die am 3'ten Freitag nach Ostersonntag stattfinden.

        * Z.B. `gcal -c@e-3fr' gibt die Termine aus, die am 3'ten
          Freitag vor Ostersonntag stattfinden.

`l@e[+|-]NWWW'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am N'ten Wochentag WWW relativ zum Datum
     Ostersonntag des aktuellen Jahres ausgeben; das Warnungsniveau ist
     wie bei der `-cy' Option.

        * Z.B. `gcal -cl@e3fr' bzw. `gcal -cl@e+3fr' gibt eine Liste
          aller derjenigen Termine aus, die am 18'ten Februar beginnen
          und am 3'ten Freitag nach Ostersonntag enden.

        * Z.B. `gcal -cl@e-3fr' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am 3'ten
          Freitag vor Ostersonntag enden.

`@DVAR[[+|-]N]'
     Alle Daten zum N'ten Tag relativ zum Datum der Datumvariablen des
     aktuellen Jahres ausgeben; das Warnungsniveau ist wie bei der
     einfachen `-c' Option.

        * Z.B. `gcal -v a=0422 -c@a' gibt die Termine aus, die am
          22'ten April stattfinden.

        * Z.B. `gcal -v a=0422 -c@a10' bzw. `gcal -v a=0422 -c@a+10'
          gibt die Termine aus, die 10 Tage nach dem 22'ten April
          stattfinden.

        * Z.B. `gcal -v a=0422 -c@a-10' gibt die Termine aus, die 10
          Tage vor dem 22'ten April stattfinden.

`l@DVAR[[+|-]N]'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am N'ten Tag relativ zum Datum der
     Datumvariablen des aktuellen Jahres ausgeben; das Warnungsniveau
     ist wie bei der `-cy' Option.

        * Z.B. `gcal -v a=0422 -cl@a' gibt eine Liste aller derjenigen
          Termine aus, die am 18'ten Februar beginnen und am 22'ten
          April enden.

        * Z.B. `gcal -v a=0422 -cl@a10' bzw. `gcal -v a=0422 -cl@a+10'
          gibt eine Liste aller derjenigen Termine aus, die am 18'ten
          Februar beginnen und 10 Tage nach dem 22'ten April enden.

        * Z.B. `gcal -v a=0422 -cl@a-10' gibt eine Liste aller
          derjenigen Termine aus, die am 18'ten Februar beginnen und 10
          Tage vor dem 22'ten April enden.

`@DVAR[+|-]NWWW'
     Alle Daten zum N'ten Wochentag WWW relativ zum Datum der
     Datumvariablen des aktuellen Jahres ausgeben; das Warnungsniveau
     ist wie bei der einfachen `-c' Option.

        * Z.B. `gcal -v a=0122 -c@a2sa' bzw. `gcal -v a=0122 -c@a+2sa'
          gibt die Termine aus, die zwei Samstage nach dem 22'ten
          Januar stattfinden.

        * Z.B. `gcal -v a=0122 -c@a-2sa' gibt die Termine aus, die zwei
          Samstage vor dem 22'ten Januar stattfinden.

`l@DVAR[+|-]NWWW'
     Liste von Daten, in Abhängigkeit des Wertes N gestern oder morgen
     beginnend, und endend am N'ten Wochentag WWW relativ zum Datum der
     Datumvariablen des aktuellen Jahres ausgeben; das Warnungsniveau
     ist wie bei der `-cy' Option.

        * Z.B. `gcal -v a=0122 -cl@a2sa' bzw. `gcal -v a=0122 -cl@a+2sa'
          gibt eine Liste aller derjenigen Termine aus, die zwei
          Samstage nach dem 22'ten Januar beginnen und am 16'ten
          Februar enden.

        * Z.B. `gcal -v a=0122 -cl@a-2sa' gibt eine Liste aller
          derjenigen Termine aus, die zwei Samstage vor dem 22'ten
          Januar beginnen und am 16'ten Februar enden.

`t|T'
`--tomorrow' Langoption
     Liste von Daten ausgeben, die sich auf den morgigen Tag beziehen.

        * Z.B. `gcal -ct' gibt alle diejenigen Termine aus, die am
          18'ten Februar (morgen) stattfinden.

        * Z.B. `gcal -cdt' gibt alle diejenigen Termine aus, die am
          17'ten Februar (heute) und am 18'ten Februar (morgen)
          stattfinden.

`w|W[+|-]'
`--week' Langoption
`--end-of-week' Langoption
`--start-of-week' Langoption
     Liste von Daten ausgeben, die sich auf die Woche beziehen (*note
     `--starting-day[=ARGUMENT]': Kalender Optionen.).

        * `w' oder `--week' Langoption
          Liste von Daten vom *Starttag* der aktuellen Woche bis zum
          letzten Tag der aktuellen Woche ausgeben.

             - Z.B. `gcal -cw' gibt alle diejenigen Termine aus, die in
               der gesamten Woche, in die der 17'te Februar fällt,
               stattfinden.

        * `w+' oder `--end-of-week' Langoption
          Liste von Daten vom Tag nach dem aktuellen Tag der aktuellen
          Woche bis zum letzten Tag der aktuellen Woche ausgeben.

             - Z.B. `gcal -cw+' gibt alle diejenigen Termine aus, die am
               18'ten Februar (morgen) beginnen und am letzten Tag der
               Woche enden.

             - Z.B. `gcal -cdw+' gibt alle diejenigen Termine aus, die
               am 17'ten Februar (heute) beginnen und am letzten Tag
               der Woche enden.

        * `w-' oder `start-of-week' Langoption
          Liste von Daten vom *Starttag* der aktuellen Woche bis zum Tag
          vor dem aktuellen Tag der aktuellen Woche ausgeben.

             - Z.B. `gcal -cw-' gibt alle diejenigen Termine aus, die am
               ersten Tag der Woche beginnen und am 16'ten (gestern)
               Februar enden.

             - Z.B. `gcal -cdw-' gibt alle diejenigen Termine aus, die
               am ersten Tag der Woche beginnen und am 17'ten Februar
               (heute) enden.

`m|M[+|-]'
`--month' Langoption
`--end-of-month' Langoption
`--start-of-month' Langoption
     Liste von Daten ausgeben, die sich auf den Monat beziehen.

        * `m' oder `--month' Langoption
          Liste von Daten vom ersten Tag des aktuellen Monats bis zum
          letzten Tag des aktuellen Monats ausgeben.

             - Z.B. `gcal -cm' gibt alle diejenigen Termine aus, die im
               gesamten Monat Februar stattfinden.

        * `m+' oder `--end-of-month' Langoption
          Liste von Daten vom Tag nach dem aktuellen Tag des aktuellen
          Monats bis zum letzten Tag des aktuellen Monats ausgeben.

             - Z.B. `gcal -cm+' gibt alle diejenigen Termine aus, die am
               18'ten Februar (morgen) beginnen und am letzten Tag des
               Monats Februar enden.

             - Z.B. `gcal -cdm+' gibt alle diejenigen Termine aus, die
               am 17'ten Februar (heute) beginnen und am letzten Tag
               des Monats Februar enden.

        * `m-' oder `--start-of-month' Langoption
          Liste von Daten vom ersten Tag des aktuellen Monats bis zum
          Tag vor dem aktuellen Tag des aktuellen Monats ausgeben.

             - Z.B. `gcal -cm-' gibt alle diejenigen Termine aus, die am
               ersten Tag des Monats Februar beginnen und am 16'ten
               Februar (gestern) enden.

             - Z.B. `gcal -cdm-' gibt alle diejenigen Termine aus, die
               am ersten Tag des Monats Februar beginnen und am 17'ten
               Februar (heute) enden.

`y|Y[+|-]'
`--year' Langoption
`--end-of-year' Langoption
`--start-of-year' Langoption
     Liste von Daten ausgeben, die sich auf das Jahr beziehen.

        * `y' oder `--year' Langoption
          Liste von Daten vom ersten Tag des aktuellen Jahres bis zum
          letzten Tag des aktuellen Jahres ausgeben.

             - Z.B. `gcal -cy' gibt alle diejenigen Termine aus, die im
               gesamten Jahr stattfinden.

        * `y+' oder `--end-of-year' Langoption
          Liste von Daten vom Tag nach dem aktuellen Tag des aktuellen
          Jahres bis zum letzten Tag des aktuellen Jahres ausgeben.

             - Z.B. `gcal -cy+' gibt alle diejenigen Termine aus, die am
               18'ten Februar (morgen) beginnen und am letzten Tag des
               Jahres enden.

             - Z.B. `gcal -cdy+' gibt alle diejenigen Termine aus, die
               am 17'ten Februar (heute) beginnen und am letzten Tag
               des Jahres enden.

        * `y-' oder `--start-of-year' Langoption
          Liste von Daten vom ersten Tag des aktuellen Jahres bis zum
          Tag vor dem aktuellen Tag des aktuellen Jahres ausgeben.

             - Z.B. `gcal -cy-' gibt alle diejenigen Termine aus, die am
               ersten Tag des Jahres beginnen und am 16'ten Februar
               (gestern) enden.

             - Z.B. `gcal -cdy-' gibt alle diejenigen Termine aus, die
               am ersten Tag des Jahres beginnen und am 17'ten Februar
               (heute) enden.


File: gcal.info,  Node: Antwortdatei,  Next: Datummodifizierer,  Prev: Optionen,  Up: Kommandozeilenargumente

Antwortdatei
------------

Wenn ein `@DATEI' Argument in der Kommandozeile vorgefunden wird, so
wird eine "Antwortdatei" DATEI benutzt, d.h. Optionen und Kommandos
werden aus dieser Datei vorgeladen.  Eine Antwortdatei `@DATEI' darf
Optionen und Kommandos enthalten, aber *keine* Verweise auf weitere
Antwortdateien.  Werden solche Verweise auf weitere Antwortdateien
vorgefunden, so werden diese ignoriert.  *Note
`--response-file=DATEINAME': Globale Optionen, für Hinweise wie eine
Antwortdatei automatisch erzeugt werden kann.

Das Suchschema für eine Antwortdatei ist gleich dem Suchschema für
Ressourcendateien, mit der Ausnahme, daß *keine* Standard-Antwortdatei
berücksichtigt wird.  *Note Datei-Suchmechanismus: Ressourcendatei,
für weitere Details.  Es dürfen mehrere Antwortdateien beim Aufruf von
Gcal angegeben werden.  Diese werden in genau der Reihenfolge
abgearbeitet, in der sie in der Kommandozeile angegeben sind, also
streng sequentiell.

Jede Option und jedes Kommando muß auf einer einzelnen Zeile angegeben
sein, d.h. durch ein echtes `\n' (Newline) Zeichen getrennt werden.
Eine Zeile der Antwortdatei, die mit einem `;' (Semikolon) Zeichen
beginnt, ist ein Kommentar und wird von Gcal vollständig ignoriert
(*note Zeile kommentieren::.).

Optionen müssen vor Kommandos definiert werden.  Wenn eine Antwortdatei
Kommandos enthält, so werden alle weiteren Argumente, die nach
`@DATEI' in der Kommandozeile angegeben sind, ignoriert.

Zum Beispiel:

  1. Inhalt von Antwortdatei `Datei':

          Zeile    Text
          1        -j
          2        -Cw
          EOF
          
          $ gcal -i -b 3 @Datei -s 3 1994
          
          ==> gcal -i -b 3 -j -Cw -s 3 1994

  2. Inhalt von Antwortdatei `Datei':

          Zeile    Text
          1        -j
          2        -Cw
          3        mai 1992
          EOF
          
          $ gcal -i -b 3 @Datei -s 3 1994
          
          ==> gcal -i -b 3 -j -Cw mai

  3. Inhalt von Antwortdatei `Datei':

          Zeile    Text
          1        -j
          2        -Cw
          3        mai
          4        1992
          EOF
          
          $ gcal -i -b 3 @Datei -s 3 1994
          
          ==> gcal -i -b 3 -j -Cw mai 1992


File: gcal.info,  Node: Datummodifizierer,  Next: Kommandos,  Prev: Antwortdatei,  Up: Kommandozeilenargumente

Datummodifizierer
-----------------

Es ist möglich dasjenige Datum anstelle dem aktuellen (System) Datum zu
verwenden, welches in der `%DATUM' Option definiert ist.  Das bedeutet,
daß Terminwarnungen für *jedwedes* Jahr mit demselben Warnungsniveau
wie Terminwarnungen, die sich rein auf das aktuelle Jahr beziehen,
erzeugt werden können.

Das Datum muß in einem dieser Formate angegeben werden:

   * `JJJJ[MM[TT|WWW[N]]]'

   * `JJJJ*d|wN[WWW]'

   * `JJJJ@e|DVAR[[+|-]N[WWW]]'

   * `MONATSNAME[TT]'

   * `WOCHENTAGSNAME[N]'

   * TT

Hierzu einige Beispiele:

     *Bitte beachten:*
     In den folgenden Beispielen wird angenommen, daß das heutige
     Tagesdatum Mittwoch, der 17'te Februar 1993 (19930217) ist!

Das `JJJJ[MM[TT|WWW[N]]]' Format:
        * `gcal %1994' (== JJJJ)
          Das aktuelle Datum wird auf den 17'ten Februar 1994 gesetzt
          => 19940217.

        * `gcal %1994Mär'

        * `gcal %19943'

        * `gcal %199403' (== JJJJMM)
          Das aktuelle Datum wird auf das Datum 17'ter März 1994
          gesetzt => 19940317.

        * `gcal %1994Mär3'

        * `gcal %1994033'

        * `gcal %19940303' (== JJJJMMTT)
          Das aktuelle Datum wird auf das Datum 3'ter März 1994
          gesetzt => 19940303.

        * `gcal %1994MärDon'

        * `gcal %199403do' (== JJJJMMWWW)
          Das aktuelle Datum wird auf das Datum 4'ter März 1994
          gesetzt => 19940304.

        * `gcal %1994MärMit3'

        * `gcal %199403mi3' (== JJJJMMWWWN)
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch im März
          1994 gesetzt (N == `1...5|9') => 19940316.

        * `gcal %0'

        * `gcal %00'

        * `gcal %000'

        * `gcal %0000' (== JJJJ)
          Das aktuelle Datum bleibt unverändert => 19930217.

        * `gcal %0000Mär'

        * `gcal %00003'

        * `gcal %000003' (== JJJJMM)
          Das aktuelle Datum wird auf das Datum 17'ter März 1993
          gesetzt => 19930317.

        * `gcal %0000Mär3'

        * `gcal %0000033'

        * `gcal %00000303' (== JJJJMMTT)
          Das aktuelle Datum wird auf das Datum 3'ter März 1993
          gesetzt => 19930303.

        * `gcal %0000MärDon'

        * `gcal %000003do' (== JJJJMMWWW)
          Das aktuelle Datum wird auf das Datum 4'ter März 1993
          gesetzt => 19930304.

        * `gcal %0000MärMit3'

        * `gcal %000003mi3' (== JJJJMMWWWN)
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch im März
          1993 gesetzt (N == `1...5|9') => 19930317.

Das `JJJJ*d|wN[WWW]' Format:
        * `gcal %1994*d10' (== `JJJJ*dN')
          Das aktuelle Datum wird auf das Datum des 10'ten absoluten
          Tages 1994 gesetzt (N == `1...365|366|999') => 19940110.

        * `gcal %1994*d10son' (== `JJJJ*dNWWW')
          Das aktuelle Datum wird auf das Datum des 10'ten Sonntags 1994
          gesetzt (N == `1...51|52|53|99') => 19940306.

        * `gcal %0*d10' (== `JJJJ*dN')
          Das aktuelle Datum wird auf das Datum des 10'ten absoluten
          Tages 1993 gesetzt => 19930110.

        * `gcal %0*d10son' (== `JJJJ*dNWWW')
          Das aktuelle Datum wird auf das Datum des 10'ten Sonntags 1993
          gesetzt => 19930307.

        * `gcal %1994*w10' (== `JJJJ*wN')
          Das aktuelle Datum wird auf das Datum des Montags der 10'ten
          ISO-Kalenderwoche 1994 gesetzt (N == `0|1...52|53|99')
          => 19940307.

        * `gcal %1994*w10son' (== `JJJJ*wNWWW')
          Das aktuelle Datum wird auf das Datum des Sonntags der 10'ten
          ISO-Kalenderwoche 1994 gesetzt => 19940313.

        * `gcal %0*w10' (== `JJJJ*wN')
          Das aktuelle Datum wird auf das Datum des Montags der 10'ten
          ISO-Kalenderwoche 1993 gesetzt => 19930308.

        * `gcal %0*w10son' (== `JJJJ*wNWWW')
          Das aktuelle Datum wird auf das Datum des Sonntags der 10'ten
          ISO-Kalenderwoche 1993 gesetzt => 19930314.

Das `JJJJ@e|DVAR[[+|-]N[WWW]]' Format:
        * `gcal %1994@e' (== `JJJJ@e')
          Das aktuelle Datum wird auf das Datum des Ostersonntags 1994
          gesetzt => 19940403.

        * `gcal %1994@e10'

        * `gcal %1994@e+10' (== `JJJJ@e[+]N')
          Das aktuelle Datum wird auf das Datum 10 Tage nach
          Ostersonntag 1994 gesetzt => 19940413.

        * `gcal %1994@e-10' (== `JJJJ@e-N')
          Das aktuelle Datum wird auf das Datum 10 Tage vor
          Ostersonntag 1994 gesetzt => 19940324.

        * `gcal %0@e'

        * `gcal %00@e'

        * `gcal %000@e'

        * `gcal %0000@e' (== `JJJJ@e')
          Das aktuelle Datum wird auf das Datum des Ostersonntags 1993
          gesetzt => 19930411.

        * `gcal %0@e10'

        * `gcal %0@e+10' (== `JJJJ@e[+]N')
          Das aktuelle Datum wird auf das Datum 10 Tage nach
          Ostersonntag 1993 gesetzt => 19930421.

        * `gcal %0@e-10' (== `JJJJ@e-N')
          Das aktuelle Datum wird auf das Datum 10 Tage vor
          Ostersonntag 1993 gesetzt => 19930401.

        * `gcal %1994@e3Mi'

        * `gcal %1994@e+3Mi' (== `JJJJ@e[+]NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch nach
          Ostersonntag 1994 gesetzt => 19940420.

        * `gcal %1994@e-3mi' (== `JJJJ@e-NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch vor
          Ostersonntag 1994 gesetzt => 19940316.

        * `gcal %0@e3mi'

        * `gcal %0@e+3mi' (== `JJJJ@e[+]NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch nach
          Ostersonntag 1993 gesetzt => 19930428.

        * `gcal %0@e-3mi' (== `JJJJ@e-NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch vor
          Ostersonntag 1993 gesetzt => 19930324.

        * `gcal -v a=0303 %1994@a' (== `JJJJ@DVAR')
          Das aktuelle Datum wird auf das Datum 3'ter März 1994
          gesetzt => 19940303.

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

        * `gcal -v a=0303 %1994@a+10' (== `JJJJ@DVAR[+]N')
          Das aktuelle Datum wird auf das Datum 10 Tage nach dem 3'ten
          März 1994 gesetzt => 19940313.

        * `gcal -v a=0303 %1994@a-10' (== `JJJJ@DVAR-N')
          Das aktuelle Datum wird auf das Datum 10 Tage vor dem 3'ten
          März 1994 gesetzt => 19940221.

        * `gcal -v a=0303 %0@a' (== `JJJJ@DVAR')
          Das aktuelle Datum wird auf das Datum 3'ter März 1993
          gesetzt => 19930303.

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

        * `gcal -v a=0303 %0@a+10' (== `JJJJ@DVAR[+]N')
          Das aktuelle Datum wird auf das Datum 10 Tage nach dem 3'ten
          März 1993 gesetzt => 19930313.

        * `gcal -v a=0303 %0@a-10' (== `JJJJ@DVAR-N')
          Das aktuelle Datum wird auf das Datum 10 Tage vor dem 3'ten
          März 1993 gesetzt => 19930221.

        * `gcal -v a=0303 %1994@a3mi'

        * `gcal -v a=0303 %1994@a+3mi' (== `JJJJ@DVAR[+]NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch nach dem
          3'ten März 1994 gesetzt => 19940323.

        * `gcal -v a=0303 %1994@a-3mi' (== `JJJJ@DVAR-NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch vor dem
          3'ten März 1994 gesetzt => 19940216.

        * `gcal -v a=0303 %0@a3mi'

        * `gcal -v a=0303 %0@a+3mi' (== `JJJJ@DVAR[+]NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch nach dem
          3'ten März 1993 gesetzt => 19930324.

        * `gcal -v a=0303 %0@a-3mi' (== `JJJJ@DVAR-NWWW')
          Das aktuelle Datum wird auf das Datum 3'ter Mittwoch vor dem
          3'ten März 1993 gesetzt => 19930210.

Das `MONATSNAME[TT]' Format:
        * `gcal %April' (== MONATSNAME)
          Das aktuelle Datum wird auf das Datum 17'ter April 1993
          gesetzt => 19930417.

        * `gcal %april3'

        * `gcal %april03' (== MONATSNAME TT)
          Das aktuelle Datum wird auf das Datum 3'ter April 1993
          gesetzt => 19930403.

Das `WOCHENTAGSNAME[N]' Format:
        * `gcal %Freitag' (== WOCHENTAGSNAME)
          Das aktuelle Datum wird auf das Datum des Freitags der
          laufenden Woche im Februar 1993 gesetzt => 19930219.

        * `gcal %Freitag2'

        * `gcal %Freitag02' (== WOCHENTAGSNAME N)
          Das aktuelle Datum wird auf das Datum 2'ter Freitag im
          Februar 1993 gesetzt (N == `1...5|9') => 19930212.

Das TT Format:
        * `gcal %3'

        * `gcal %03' (== TT)
          Das aktuelle Datum wird auf das Datum 3'ter Februar 1993
          gesetzt => 19930203.

