                             Anleitung zu

                        PinPoint und Calendar

                              23.08.1998

                                 von

                              Dirk Haun
                           Johanniterstr. 3
                      D-74177 Bad Friedrichshall
                                   
                            Dirk Haun @ LB



Inhaltsverzeichnis
==================

 1  Einleitung

 2  PinPoint
    2.1  PinPoint: Installation
    2.2  PinPoint: Das Popup
    2.3  PinPoint: Die Datei pinpoint.inf
    2.4  Tips zu PinPoint

 3  Calendar
    3.1  Calendar: Installation
    3.2  Calendar: Das Popup
    3.3  Calendar: Die Datei calendar
    3.4  Calendar: Die Datei calendar.inf
    3.5  Tips zu Calendar

 4  Protokolle


Anhang
======

 A  History

 B  Rechtliches

 C  Kontaktadresse



1  Einleitung
*************

PinPoint ist ein einfaches Notizzettelprogramm, d.h. man kann damit
Notizen in einem Fenster auf dem Desktop ablegen.

Calendar ist eine Kreuzung aus PinPoint und dem Unix-Tool calendar,
d.h. man kann sich damit Termine eines Tages ebenfalls in einem
Fenster auf dem Desktop ablegen.

Falls Ihnen der Name PinPoint bekannt vorkommt: Ja, PinPoint ist eine
Weiterentwicklung des gleichnamigen Programms von Holger Weets.



2  PinPoint
***********

 2.1  PinPoint: Installation
 2.2  PinPoint: Das Popup
 2.3  PinPoint: Die Datei pinpoint.inf
 2.4  Tips zu PinPoint


2.1  PinPoint: Installation
===========================

Wenn Sie PinPoint erst einmal ausprobieren wollen, knnen Sie es
einfach vom Desktop aus starten. Am besten ist es aber im MagiC-
Autostart-Ordner (bzw. dessen quivalent unter anderen Betriebs-
systemen) aufgehoben.

Auer dem Programm PINPOINT.APP bentigen sie noch eine Datei namens
pinpoint.inf, in der Ihre Desktop-Notizen stehen sollen. Da PinPoint
diese Datei gleich beim Start laden will, sollten Sie mit einem
beliebigen Texteditor einfach eine solche Datei anlegen und sie
entweder in Ihrem HOME-Verzeichnis oder im Verzeichnis $HOME/defaults
ablegen.

Nach dem Start von PinPoint ffnet sich das Fenster von PinPoint in
der linken oberen Ecke des Bildschirms. Sie knnen es nun einfach mit
der Maus an einen Ihnen genehmen Platz verschieben


2.2  PinPoint: Das Popup
========================

Mit einem Doppelklick auf das PinPoint-Fenster ffnet sich das folgen-
de Popup:

 Notiz editieren     Hiermit knnen Sie die aktuelle Notiz (d.h. die
                     Datei pinpoint.inf) in einen Editor laden lassen.

                     Dazu ist aber etwas Vorbereitung ntig. Wenn eine
                     Environmentvariable $EDITOR existiert, wird
                     PinPoint den Desktop anweisen, das Programm,
                     dessen Name in dieser Variablen steht, zu starten
                     und ihm die pinpoint.inf zu bergeben. Existiert
                     die Variable nicht, wird PinPoint seine Inf-Datei
                     direkt an den Desktop bergeben. Wenn Sie dort
                     einen Editor dafr angemeldet haben, wird dieser
                     dann gestartet und wird die Datei laden.

 Notiz neuladen      Sucht (und liest) die Datei pinpoint.inf neu.
                     Diesen Menpunkt wird man nur selten bentigen,
                     da PinPoint ohnehin alle 30 Sekunden nachsieht,
                     ob sich die Datei gendert hat. Falls dem so ist,
                     wird sie automatisch neu eingelesen und
                     angezeigt.

 Font wechseln       Hiermit kann man den Font des PinPoint-Fensters
                     wechseln. PinPoint wird versuchen, einen Font-
                     selektor zu finden, der das Font-Protokoll
                     untersttzt oder einen xFSL-Fontselektor
                     aufzurufen.

                     Man kann auch aus einem Fontselektor, der das
                     Fontprotokoll untersttzt, einfach einen Font auf
                     das PinPoint-Fenster ziehen.

 Parameter sichern   Speichert die aktuelle Einstellungen (Fenster-
                     position, Font) in der Datei pinpoint.cfg an der
                     Stelle, an der auch pinpoint.inf liegt.

 Fenster toppen      Holt das PinPoint-Fenster nach vorne.

 beenden             Kommentar berflssig ...


2.3  PinPoint: Die Datei pinpoint.inf
=====================================

Wie schon erwhnt, kann die Datei pinpoint.inf einfach mit einem
beliebigen Texteditor angelegt werden. Folgende Besonderheiten gibt es
aber noch zu beachten:

    Es werden maximal 20 Zeilen aus der Datei gelesen. Alle folgenden
     Zeilen werden ignoriert.

    Zeilen, die mit mindestens drei aufeinanderfolgenden Minuszeichen
     beginnen, werden als durchgehender Strich angezeigt. Statt eines
     Minuszeichens kann es auch der Unter- oder Oberstrich (ASCII-
     Zeichen 95 bzw. 255) sein.

    Zeilen, die mit drei aufeinanderfolgenden Gleichheitszeichen
     beginnen, werden als durchgehende doppelte Linie ausgegeben.

    Zeilen, die mit drei aufeinanderfolgenden ASCII-Zeichen 240
     beginnen, werden als durchgehende dreifache Linie ausgegeben.

    Zeilen, die mit zwei Grerzeichen beginnen, werden in roter
     Textfarbe ausgegeben (die Grerzeichen werden dabei entfernt).


2.4  Tips zu PinPoint
=====================

Wenn Sie mehrere Notizzettel auf Ihrem Desktop brauchen, so geht das
ganz einfach: Fertigen Sie eine Kopie von PINPOINT.APP an und nennen
Sie sie beispielsweise NOTIZ.APP. Entsprechend nennen Sie dann die
Kopie der pinpoint.inf einfach notiz.inf. Dann einfach das kopierte
Programm starten. Dies knnen Sie beliebig oft wiederholen (solange
der Speicher oder der Platz auf dem Desktop reicht ...).



3  Calendar
***********

 3.1  Calendar: Installation
 3.2  Calendar: Das Popup
 3.3  Calendar: Die Datei calendar
 3.4  Calendar: Die Datei calendar.inf
 3.5  Tips zu Calendar


3.1  Calendar: Installation
===========================

Wenn Sie Calendar erst einmal ausprobieren wollen, knnen Sie es
einfach vom Desktop aus starten. Am besten ist es aber im MagiC-
Autostart-Ordner (bzw. dessen quivalent unter anderen Betriebss-
ystemen) aufgehoben.

Auer dem Programm CALENDAR.APP bentigen sie noch eine Datei namens
calendar (ohne Extension!), in der Ihre Termine stehen sollen. Da
Calendar diese Datei gleich beim Start laden will, sollten Sie mit
einem beliebigen Texteditor einfach eine solche Datei anlegen und sie
entweder in Ihrem HOME-Verzeichnis oder im Verzeichnis $HOME/defaults
ablegen. Optional kann dort auch noch eine Datei calendar.inf angelegt
werden, doch dazu spter.

Nach dem Start von Calendar ffnet sich das Fenster von Calendar in
der linken oberen Ecke des Bildschirms. Sie knnen es nun einfach mit
der Maus an einen Ihnen genehmen Platz verschieben


3.2  Calendar: Das Popup
========================

Mit einem Doppelklick auf das Calendar-Fenster ffnet sich das folgen-
de Popup:

 Kalender editieren   Hiermit knnen Sie Ihren Kalender (d.h. die
                      Datei calendar) in einen Editor laden lassen.

                      Dazu ist aber etwas Vorbereitung ntig. Wenn
                      eine Environmentvariable $EDITOR existiert, wird
                      Calendar den Desktop anweisen, das Programm,
                      dessen Name in dieser Variablen steht, zu
                      starten und ihm die Datei calendar zu bergeben.
                      Existiert die Variable nicht, wird Calendar
                      seine Datei direkt an den Desktop bergeben.
                      Wenn Sie dort einen Editor dafr angemeldet
                      haben, wird dieser dann gestartet und wird die
                      Datei laden.

 Kalender neuladen    Im Gegensatz zu PinPoint berprft Calendar
                      seine Datei nicht zyklisch auf nderungen. Sie
                      mssen daher nach einer nderung Calendar mit
                      diesem Menpunkt ber die nderungen an seiner
                      calendar-Datei informieren.

 Font wechseln        Hiermit kann man den Font des Calendar-Fensters
                      wechseln. Calendar wird versuchen, einen Font-
                      selektor zu finden, der das Font-Protokoll
                      untersttzt oder einen xFSL-Fontselektor
                      aufzurufen.

                      Man kann auch aus einem Fontselektor, der das
                      Fontprotokoll untersttzt, einfach einen Font
                      auf das Calendar-Fenster ziehen.

 Parameter sichern    Speichert die aktuelle Einstellungen (Fenster-
                      position, Font) in der Datei calendar.cfg an der
                      Stelle, an der auch die Datei calendar liegt.

 Fenster toppen       Holt das Calendar-Fenster nach vorne.

 beenden              Kommentar berflssig ...


3.3  Calendar: Die Datei calendar
=================================

Wie schon erwhnt, kann die Datei calendar einfach mit einem belie-
bigen Texteditor angelegt werden. Die Datei ist dabei so aufgebaut,
da pro Zeile ein Termin stehen kann. Einen Termin erkennt Calendar
daran, da irgendwo in der Zeile eine Datumsangabe steht. Das Datum
"erster Dezember" kann dabei in einem der folgenden Formate angegeben
werden:

    "01.12." oder "1.12." (deutsches Format)

    "12/01" oder "12/1" (amerikanisches Format)

    "1 Dezember" oder "1. Dezember" oder "Dezember 1" (deutsch)

    wie oben, aber mit "Dez" statt "Dezember"

    "1 December" oder "1. December" oder "December 1" (englisch)

    wie oben, aber mit "Dec" statt "December"

... analog fr die anderen Monate des Jahres. Zeilen, die keine
(gltige) Datumsangabe enthalten werden einfach ignoriert und knnen
als Kommentarzeilen verwendet werden.

Auerdem werden auch Zeilen, die mit dem Zeichen `#' beginnen, als
Kommentare behandelt. Dies bentigt man dann, wenn man Termine
auskommentieren will oder wenn man einen Kommentar schreibt, der von
Calendar als Termin interpretiert wird.

Wie schon in der pinpoint.inf kann man Zeilen auch mit zwei Grer-
zeichen beginnen, wodurch sie dann in roter Textfarbe ausgegeben
werden (die Grerzeichen werden entfernt).


3.4  Calendar: Die Datei calendar.inf
=====================================

ber die Datei calendar.inf kann beeinflut werden, wie und welche
Termine Calendar anzeigt. Das Dateiformat ist leider etwas kryptisch
geraten, aber es sollte eben nicht zuviel Speicherplatz fr einen
aufwendigen Interpreter verschwendet werden.

Auch die calendar.inf kann wieder mit einem beliebigen Texteditor
angelegt werden. Eine Zeile enthlt entweder einen Kommentar (dann mu
das erste Zeichen ein `#' sein) oder eine Formatanweisung.

Die erste Formatanweisung gibt an, wieviele Tage im Voraus Calendar
nach Terminen suchen soll. Das erste Zeichen in der Zeile mu ein
Pluszeichen sein, gefolgt von einem Leerzeichen und einer Zahl
zwischen 0 (bedeutet "nur heutige Termine") und 6 (bedeutet "heute und
die sechs folgenden Tage". Zustzlich kann noch ein `w' angegeben
werden, das bedeutet "nur die nchsten Werktage beachten".

Fr jeden dieser Tage kann nun auch noch eine berschrift angegeben
werden, z.B. "Termine heute", "Termine morgen", usw. Dazu schreibt man
als erstes Zeichen in die Zeile die entsprechende Ziffer (`0' fr
heute, `1' fr morgen, usw.), gefolgt von einem Leerzeichen und dem
Text. Dies kann ein beliebiger Text oder einer der weiter unten
erklrten Platzhalter sein.

Auer einer berschrift fr die einzelnen Tage kann auch noch eine
Gesamtberschrift fr das ganze Calendar-Fenster angegeben werden.
Dazu mu das erste Zeichen in der Zeile ein Sternchen sein, wieder
gefolgt von einem Leerzeichen und dem Text (wie oben, also auch mit
Platzhaltern).

Und schlielich kann auch noch eine Zeile angegeben werden, die
erscheinen soll, wenn keine Termine anliegen. Die Zeile dafr beginnt
mit einem Minuszeichen, gefolgt von einem Leerzeichen und dem Text.


Platzhalter

Ein Platzhalter besteht immer aus einem Prozentzeichen, gefolgt von
einer Ziffer oder einem Buchstaben (Achtung: Gro-/Kleinschreibung
wird beachtet!).

      %d   Tag, ohne fhrende Nullen
      %D   Tag, mit fhrenden Nullen
      %m   Monat, ohne fhrende Nullen
      %M   Monat, mit fhrenden Nullen
      %y   Jahr, ohne Jahrhundert (zweistellig)
      %Y   Jahr, mit Jahrhundert (vierstellig)
      %g   Name des Tags, deutsch, als Krzel
      %G   Name des Tags, deutsch, ausgeschrieben
      %e   Name des Tags, englisch, als Krzel
      %E   Name des Tags, englisch, ausgeschrieben
      %1   eine einfache Trennlinie
      %2   eine doppelte Trennlinie
      %3   eine dreifache Trennlinie
      %0   nichts

Es gibt eine Einschrnkung: Es kann nur entweder ein Platzhalter fr
eine Trennlinie (auch %0) oder ein Text mit Textplatzhaltern verwendet
werden. Mischen ist leider nicht mglich.


Beispiele:

Zur Verdeutlichung noch zwei Beispiele: Wird keine calendar.inf
gefunden, so verwendet Calendar folgende Defaulteinstellungen:

      + w1
      * Heute ist %G, der %D.%M.%Y
      0 %0
      1 %1
      2 %2
      3 %3
      - (keine Termine)

Es werden also nur Termine fr heute und den nchsten Werktag ange-
zeigt. Die berschrift fr das Fenster lautet z.B. "Heute ist Montag,
der 01.12.1997". Zwischen der berschrift und den heutigen Terminen
steht keine Trennlinie, zwischen denen von heute und morgen steht eine
einfache Trennlinie, zwischen morgen und bermorgen eine doppelte,
usw. Liegen keine Termine an, wird der Text "(keine Termine)" ange-
zeigt.

Zweites Beispiel: Meine Einstellungen.

      + 2
      0 %1
      1 %2
      2 %2
      * Heute ist %G, der %D.%M.%Y
      - (keine Termine)

Ich lasse mir also die Termine fr heute, morgen und bermorgen
anzeigen (und zwar fr alle Tage, nicht nur fr Werktage), mit einer
einfachen Trennlinie zwischen der Fensterberschrift und den heutigen
Terminen und je einer doppelten zwischen den Terminen fr morgen und
bermorgen. Der Rest entspricht den Defaulteinstellungen.


3.5  Tips zu Calendar
=====================

Wenn Sie mehrere Kalender auf Ihrem Desktop brauchen, so geht das, wie
schon bei PinPoint, ganz einfach: Fertigen Sie eine Kopie von
CALENDAR.APP an und nennen Sie sie beispielsweise BUSINESS.APP.
Entsprechend nennen Sie dann die Kopie der Datei calendar einfach
business. Dann einfach das kopierte Programm starten. Dies knnen Sie
beliebig oft wiederholen (solange der Speicher oder der Platz auf dem
Desktop reicht ...).

Der Name der Datei calendar wurde absichtlich so gewhlt, da dies auch
der Name der Datei unter Unix ist. Sie knnen die gleiche Datei daher
auch mit Calendar oder dem Programm calendar.ttp von Julian Reschke
verwenden. Allerdings mu man sich bei den Datumsformaten etwas
einschrnken, da das Unix-Original sowie Julians calendar.ttp z.T.
andere Formate erwarten. Mit dem amerikanischen Format ("12/1") sowie
der Kurzschreibweise mit nachgestelltem zweistelligen Datum ("Dec 01")
sollte man jedoch alle drei Programme zufriedenstellen knnen.



4  Protokolle
*************

PinPoint und Calendar nehmen beide am XAcc-Protokoll teil. Sie geben
darber nicht nur ihren Namen bekannt, sondern auch Ihre Funktion
("Notizblock" bzw. "Kalender") sowie Ihre Teilnahme am Fontprotokoll.
Beide verwenden die Kennung "GT" (fr "General Text application") als
maschinenlesbaren Applikationstyp.

PinPoint nimmt darber hinaus auch noch an der Stufe 1 des XAcc-
Protokolls teil, d.h. es versteht auch die Nachricht ACC_TEXT und
zeigt so bergebene Texte (bzw. nur die ersten zwanzig Zeilen davon)
in seinem Fenster an.

PinPoint und Calendar untersttzen beide auch Teile des VA-Protokolls.
Liegt das Fenster des Programms im Vordergrund, so leitet es alle
eingehenden Tastendrcke an den AV-Server (meist den Desktop) weiter.
Beide nehmen auch am applikationsbergreifenden Fensterwechsel teil.
Den Editor starten sie mit der Nachricht VA_START an den Desktop nach.
Zudem verstehen PinPoint und Calendar ihrerseits die Nachrichten
VA_START und VA_DRAGACCWIND. PinPoint zeigt eine damit bergebene
Datei in seinem Fenster an, Calendar dagegen ignoriert den bergebenen
Dateinamen und liest stattdessen seine calendar-Datei neu ein.

Und schlielich, auch das mu sein, bringen PinPoint und Calendar ihre
eigenen Icons mit und stellen diese einem hoffentlich installierten
StIc-Server zur Verfgung.




A  History
**********

Version vom 30.11.1997

    Bugfix in Calendar: Termine fr die folgenden Tage (morgen,
     bermorgen, ...) wurden u.U. nicht angezeigt.

    Neu in Calendar: Kommentarzeilen, die mit einem `#' beginnen,
     damit man auch Termine auskommentieren kann.

    Keine nderungen an PinPoint.


Version vom 30.11.1997

    erste verffentlichte Version



B  Rechtliches
**************

PinPoint und Calendar sind in den Versionen vom 30.11.1997 und vom
23.08.1998 samt der Sourcen Public Domain. Ein jeder darf mit den
Programmen bzw. Teilen davon tun und lassen was er/sie/es will. Have
fun.



C  Kontaktadresse
*****************

Der Autor dieser Programme ist auf den folgenden Wegen zu erreichen:

     Dirk Haun
     Johanniterstr. 3
     D-74177 Bad Friedrichshall

     E-Mail: Dirk Haun @ LB (MausNet)




