@database "CallMan.guide"
$VER: AmigaGuide zu CallMan 1.1 (12.07.97)
@Node Main "CallMan 1.1"

        @{b}CallMan 1.1@{ub}
        ===========
        (12.07.1997)


        @{" Zweck             " link "Purpose"       0}   Was macht dieses Programm eigentlich?
        @{" Shareware         " link "Shareware"     0}   Bitte eine kleine Spende ;-)
        @{" Rechtliches       " link "LegalStuff"    0}   Das Übliche...

        @{" Installation      " link "Installation"  0}   Get ready to rock...
        @{" Voraussetzungen   " link "Requirements"  0}   Was brauch' ich alles?

        @{" Bedienung         " link "Usage"         0}   Wie pack' ich's an...
        @{" Update 1.0 -> 1.1 " link "Update"        0}   Was ist zu beachten?
        @{" Modempriorität    " link "Modempriority" 0}   Wer ist der Boss?

        @{" FAQ               " link "FAQ"           0}   Häufig gestellte Fragen...
        @{" Bugs              " link "Bugs"          0}   BITTE UNBEDINGT LESEN!
        @{" Autor             " link "Author"        0}   Wer hat's verbrochen?
        @{" History           " link "History"       0}   A long time ago, in a galaxy far, far, away...
        @{" Zukunft           " link "Future"        0}   Es liegt an euch...
        @{" Support           " link "Support"       0}   Wo gibt's neue Versionen?
        @{" Gebührendateien   " link "Ratesfiles"    0}   Neue Gebührendateien sind immer gern gesehen!

        @{" MUI               " link "MUI"           0}   Das beste GUI
        @{" Danksagung        " link "Thanks"        0}   Die üblichen Dankeshymnen...


Copyright (c) 1997 by @{" Alexander 'Sascha' Fichtner " link "Author"}
@EndNode


@Node "Purpose" "Ziel & Zweck von CallMan"

Ziel & Zweck von CallMan
========================

CallMan erspart einem die ewige Suche nach dem Telefonbüchlein. In einer
(zugegeben momentan noch recht primitiven) Datenbank lassen sich die
wichtigsten Daten von Freunden/Verwandten/etc. inkl. Telefonnummern
speichern. Per Tastendruck kann nun über ein, an den Amiga angeschlossenes,
Modem ein Gespräch zu einer der Personen aus der Datenbank aufgebaut werden.
Sobald der Wählvorgang beendet ist, wird das Gespräch an den (hoffentlich
ebenfalls angeschlossenen) Telefonapparat übergeben. Jeder Wahlvorgang wird
mit den wichtigsten Daten (Datum, Uhrzeit, Dauer des Gesprächs, Gesprächs-
partner) in einer Logdatei vermerkt.

Diese Logdatei kann später gezielt ausgewertet werden. Es lassen sich eine
Liste der geführten Gespräche, die Gesamtdauer aller Gespräche, sowie deren
Kosten anzeigen. Dabei kann die Auswertung sowohl zeitlich als auch auf
bestimmte Gesprächsteilnehmer beschränkt werden.

Desweiteren läßt sich CallMan auch im sog. "TelephoneBill" Modus betreiben.
Hier werden automatisch in regelmäßigen (frei definierbaren) Abständen die
Gesamtkosten der Telefonate berechnet. Zusätzlich können die Logdateien des
TCP/IP Stacks "Miami", der Terminalprogramme "Term" und "NComm", des Fax-
programmes "MultiFax", sowie der BTX-Software "MultiTerm/KIT" analysiert
und die Kosten zu den Gesamtkosten addiert werden.

@EndNode


@Node "Shareware" "Dieses Programm ist Shareware"

CallMan ist SHAREWARE. Wer dieses Programm längere Zeit (ganz nach eigenem
Ermessen) benutzt, ist verpflichtet, dem @{" Autor " link "Author"} (mir :-) eine Shareware-
Gebühr in Höhe von DM 20,- zukommen zu lassen.

Aber keine Angst... ;-)

CallMan ist vollkommen "uncrippled". Es gibt keine Nervrequester und das
Programm ist in keinster Weise in seinem Funktionsumfang beschnitten. Durch
das Bezahlen der Shareware-Gebühr erwirbt man somit einzig das Recht, das
Programm CallMan auf unbeschränkte Zeit benutzen zu dürfen.

Nur zur Sicherheit:
Man erwirbt KEINEN Anspruch auf weitere Versionen des Programms bzw. Behebung
von Bugs. Was jedoch nicht heissen soll, daß ich das Programm nicht weiter-
entwickeln werde. Auch bin ich jederzeit offen und dankbar für Bugreports und
Verbesserungsvorschläge!

Im Falle des Nichtzahlens der Shareware-Gebühr und gleichzeitigem Dauer-
betriebs des Programms geht dieses automatisch in die Gattung "NIGHTMAREWARE"
über, d.h. ich verfolge die entsprechende Person zeit ihres Lebens in ihren
Alpträumen mit einer Kettensäge... ;-)

Ich freue mich immer über eMail, egal ob Kritik oder Lob. Auch für den Fall,
daß euch dieses Programm hier nicht gefällt: laßt es mich wissen, sonst kann
ich nichts dran verbessern! ;)

@EndNode

@node LegalStuff " Legal Stuff "
@{b}DISCLAIMER@{ub}

THERE IS NO WARRANTY FOR THIS PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE
LAW.  EXCEPT WHERE OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE
ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO
OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

@{b}COPYRIGHT@{ub}

CallMan 1.1 is Copyright 1997 by Alexander 'Sascha' Fichtner.
All Rights Reserved. It is released under the concept of `Shareware'.

The archive of CallMan may only be distributed in unmodified
form.  No files may be added, changed or removed. You may not charge for
this archive, other than the cost of the media and duplication fees.
Distribution is allowed in all forms, such as BB systems, floppy or
compact disks, and ftp sites.
@endnode


@Node "Installation" "Installation"

Es gibt zwei Möglichkeiten, CallMan zu installieren:

1. Einfach das Installerskript durch einen Doppelklick starten.

2. Die manuelle Installation ist einfach:

   Das komplette Verzeichnis an einen beliebigen Ort kopieren.

   Die Voreinstellungsdatei 'CallMan.prefs' wird vom Programm ebenfalls
   in diesem Verzeichnis abgelegt. Der Zielort der Datenbank sowie der
   Logdatei läßt sich im Programm selbst einstellen.

   Der Inhalt des Verzeichnisses 'Catalogs' kann nach LOCALE: kopiert
   werden. Das Programm sucht nach den Katalogdateien zuerst unter
   "PROGDIR:Catalogs" und erst anschließend unter "LOCALE:Catalogs".

   Nicht benötigte Sprachversionen der Anleitung unter 'Docs' sowie
   Sprachkataloge können gelöscht werden.

   Gleiches gilt für überflüssige Gebührendateien unter 'Rates'.


Gestartet wird CallMan entweder über einen Doppelklick auf das Programm-
Icon oder über das CLI/die Shell mittels 'CallMan'. Der Shellaufruf sollte
ausschließlich aus dem CalMan-Verzeichnis heraus erfolgen, da sonst die
Voreinstellungsdatei nicht gefunden werden kann.

Tooltypes bzw. Parameter gibt es (noch) keine.


@EndNode


@Node "Requirements" "Voraussetzungen"

Für den Betrieb von CallMan benötigt man...

- einen Amiga :-)
- AmigaOS 3.1 oder höher
- MUI 3.3 oder höher
- ein Hayes-kompatibles Modem und ein Telefon an derselben Leitung


Erfolgreich getestet wurde CallMan auf folgenden Konfigurationen:

 - A2000/Blizzard2060
   32/1 MByte RAM
   OS 3.1
   GVP Spectrum (CyberGraphX 2.25)
   14.400er Modem
   2.400er Modem

 - A500/MTEC-68020
   4/1 MByte RAM
   OS 3.1
   Multiface-III
   14.400er Modem

@EndNode


@Node "Usage" "Bedienung des Programms"

  Die Bedienung von CallMan erfolgt wahlweise über die Maus oder Tastatur.
  Die wichtigsten Menüpunkte sind per Shortcut erreichbar. Alle Gadgets
  befinden sich in der TAB-Cyclechain.


    Die Menüs:

      @{" CallMan Menü       "  link "Usage_CMMenu"}
      @{" TelephoneBill Menü "  link "Usage_TBMenu"}


    Die Fenster:

      @{" Hauptfenster               " link "Usage_Main"      }
      @{" TelephoneBill              " link "Usage_TB"        }
      @{" Editierfenster             " link "Usage_Edit"      }
      @{" Schnellwahl                " link "Usage_QuickDial" }
      @{" Gesprächsfenster           " link "Usage_Call"      }
      @{" Analyse                    " link "Usage_Analyze"   }
      @{" Voreinstellungen           " link "Usage_Prefs"     }
      @{" Gebührendateien bearbeiten " link "Usage_PrefsRates"}

@EndNode


@Node "Usage_CMMenu" "Funktionen des CallMan Menüs"

  Projekt            Verschiedenes
  ================   ==============================
  @{" Über...       " link "Usage_CMMenu" 10}   @{" Voreinstellungen...           " link "Usage_CMMenu" 28}
  @{" Über MUI...   " link "Usage_CMMenu" 14}   @{" Gebührendateien bearbeiten... " link "Usage_CMMenu" 32}
  @{" Ikonifizieren " link "Usage_CMMenu" 17}   @{" MUI...                        " link "Usage_CMMenu" 37}
  @{" Beenden       " link "Usage_CMMenu" 21}   @{" Logfile säubern...            " link "Usage_CMMenu" 41}
                     @{" TelephoneBill Fenster         " link "Usage_CMMenu" 48}

 @{b}Über...@{ub}
     Öffnet einen kleinen Informationsrequester.
     Shortcut: RAMIGA-?

 @{b}Über MUI...@{ub}
     Einige Informationen über MUI.

 @{b}Ikonifizieren@{ub}
     Schließt alle Fenster und versetzt das Programm in Wartestellung.
     Shortcut: RAMIGA-i

 @{b}Beenden@{ub}
     Beendet das Programm.
     Shortcut: RAMIGA-q



 @{b}Voreinstellungen@{ub}
     Öffnet das Fenster mit den @{" Voreinstellungen " link "Usage_Prefs"}.
     Shortcut: RAMIGA-p

 @{b}Gebührendateien bearbeiten...@{ub}
     Öffnet ein Fenster, über das die @{" Gebührendateien editiert " link "Usage_PrefsRates"} werden
     können.
     Shortcut: RAMIGA-r

 @{b}MUI...@{ub}
     Startet das MUI-Voreinstellungsprogramm.
     Shortcut: RAMIGA-m

 @{b}Logfile säubern@{ub}
     Mit dieser Funktion ist es möglich, alle "abgebrochenen" Telefonate
     (also alle Gespräche mit unbekannter Länge) aus der Logdatei zu ent-
     fernen. Nach einer Sicherheitsabfrage wird der Löschvorgang gestartet
     und anschliessend die Zahl der entfernten Gespräche ausgegeben.
     Shortcut: RAMIGA-l

 @{b}TelephoneBill Fenster@{ub}
     Wechsel in die Betriebsart @{" TelephoneBill " link "Usage_TB"}, in der in einem kleineren
     Fenster in regelmäßigen (benutzerdefinierbaren) Abständen die aktuellen
     Telefon- und TCP/IP-Kosten (funktioniert nur mit dem TCP/IP-Stack MIAMI)
     berechnet werden.
     Shortcut: RAMIGA-t

@EndNode


@Node "Usage_TBMenu" "Funktionen des TelephoneBill Menüs"

  Projekt            Verschiedenes
  ================   ========================
  @{" Über...       " link "Usage_TBMenu" 10}   @{" Voreinstellungen...           " link "Usage_TBMenu" 27}
  @{" Über MUI...   " link "Usage_TBMenu" 14}   @{" Gebührendateien bearbeiten... " link "Usage_TBMenu" 31}
  @{" Ikonifizieren " link "Usage_TBMenu" 17}   @{" MUI...                        " link "Usage_TBMenu" 36}
  @{" Beenden       " link "Usage_TBMenu" 21}   @{" CallMan Hauptfenster          " link "Usage_TBMenu" 40}


 @{b}Über...@{ub}
     Öffnet einen kleinen Informationsrequester.
     Shortcut: RAMIGA-?

 @{b}Über MUI...@{ub}
     Einige Informationen über MUI.

 @{b}Ikonifizieren@{ub}
     Schließt alle Fenster und versetzt das Programm in Wartestellung.
     Shortcut: RAMIGA-i

 @{b}Beenden@{ub}
     Beendet das Programm.
     Shortcut: RAMIGA-q



 @{b}Voreinstellungen...@{ub}
     Öffnet das Fenster mit den @{" Voreinstellungen " link "Usage_Prefs"}.
     Shortcut: RAMIGA-p

 @{b}Gebührendateien bearbeiten...@{ub}
     Öffnet ein Fenster, über das die @{" Gebührendateien editiert " link "Usage_PrefsRates"} werden
     können.
     Shortcut: RAMIGA-r

 @{b}MUI...@{ub}
     Startet das MUI-Voreinstellungsprogramm.
     Shortcut: RAMIGA-m

 @{b}CallMan Hauptfenster@{ub}
     Wechselt zurück in die Betriebsart @{" 'CallMan' " link "Usage_Main"}.
     Shortcut: RAMIGA-c

@EndNode


@Node "Usage_Main" "Das Hauptfenster"

  Das Hauptfenster von CallMan gliedert sich in zwei
  logische Gruppen.


  Die obere Gruppe besteht aus einer Liste, welche die
  Namen der in der Datenbank gespeicherten Personen
  enthält, sowie vier Gadgets zur Manipulation der
  Einträge direkt darunter. Die Liste selbst wird je
  nach Einstellung in den @{" Voreinstellungen " link "Prefs_CM"} alpha-
  betisch nach Vorname/Nachname oder Nachname/Vorname
  sortiert.

  @{"    Neu     " link "Main_New"}@{" Bearbeiten " link "Main_Edit"}@{"  Löschen   " link "Main_Delete"}@{" Speichern  " link "Main_Save"}



  Die untere Gruppe enthält zwei Textgadgets, in
  denen Name und Telefonnummer des aktiven Daten-
  bankeintrags angezeigt werden. Darunter finden
  sich vier weitere Gadgets zur Steuerung der all-
  gemeinen Programmfunktionen:

  @{"        Wählen       " link "Main_Dial"   }  @{"     Schnellwahl     " link "Main_QuickDial"}

  @{" Logfile analysieren " link "Main_Analyze"}  @{"        Ende         " link "Main_Quit"     }

@EndNode

@Node "Main_New" "Hauptfenster: Neu"

  Fügt einen neuen Eintrag an das Ende der Personendatenbank. Es öffnet sich
  nun das @{" Editierfenster " link "Usage_Edit"}, über das der neue Datensatz eingegeben werden
  kann.

@EndNode

@Node "Main_Edit" "Hauptfenster: Bearbeiten"

  Es öffnet sich das @{" Editierfenster " link "Usage_Edit"}, über welches der
  aktive Eintrag der Datenbank bearbeitet werden kann.

@EndNode

@Node "Main_Delete" "Hauptfenster: Löschen"

  Entfernt den aktiven Eintrag aus der Datenbank.

  ACHTUNG: Es gibt hierbei KEINE Sicherheitsabfrage!

@EndNode

@Node "Main_Save" "Hauptfenster: Speichern"

  Speichert die Datenbank in dem Verzeichnis, welches im
  @{" Voreinstellungsfenster " link "Usage_Prefs"} definiert wurde.

@EndNode

@Node "Main_Dial" "Hauptfenster: Wählen"

  Startet den Wahlvorgang der aktiven Telefonnummer. Es öffnet sich hierzu
  das @{" Gesprächsfenster " link "Usage_Call"}.

@EndNode

@Node "Main_QuickDial" "Hauptfenster: Schnellwahl"

  Mit dieser Funktion ist es möglich, unabhängig von den Einträgen in der
  Datenbank eine Telefonnummer wählen zu lassen. Hierzu öffnet sich das
  @{" Schnellwahlfenster " link "Usage_QuickDial"}.

@EndNode

@Node "Main_Analyze" "Hauptfenster: Logfile analysieren"

  Zur Analyse der Logdatei öffnet sich das @{" Analysefenster " link "Usage_Analyze"}.

@EndNode

@Node "Main_Quit" "Hauptfenster: Ende"

  Beendet das Programm.

  ACHTUNG: Es gibt hierbei keine Sicherheitsabfrage und die Datenbank wird
  NICHT automatisch gespeichert!

@EndNode


@Node "Usage_TB" "TelephoneBill Fenster"

  Sobald das Programm in den 'TelephoneBill' Modus wechselt, wird das große
  Hauptfenster durch das kleinere 'TelephoneBill' Fenster ersetzt. Dieses
  besteht ausschließlich aus drei Textgadgets:

  - das oberste Textgadget zeigt die aufsummierten Telefonkosten.

  - das mittlere Gadget zeigt die aufsummierten Modemkosten.

  - das untere Textgadget zeigt die Gesamtsumme aus Telefonkosten und Modem-
    kosten. Hierbei kann optional in den @{" Voreinstellungen " link "Usage_Prefs"} angegeben werden,
    ob eine Grundgebühr (und falls ja, in welcher Höhe) zu diesen Gesamt-
    kosten addiert werden soll.

  Der Zeitraum, über den die Kostenberechnung durchgeführt werden soll, läßt
  sich, genauso wie das Intervall in dem die Berechnungen erfolgen, in den
  @{" Voreinstellungen " link "Usage_Prefs"} individuell festlegen.

  Befindet sich der Rechner während der Berechung der Modemkosten online, d.h.
  es besteht eine aktive Modemverbindung, so erscheint hinter der Modemkosten-
  summe der Hinweis "(online)". Dies funktioniert nur mit der Miami Logdatei!

  Stößt das Programm während der Berechung der Kosten auf eine Telefonnummer,
  die es in der eigenen Datenbank nicht finden kann, so nimmt CallMan als
  Entfernungszone die in den @{" Voreinstellungen " link "Usage_Prefs"} definierte alternative
  Entfernungszone an. Da in diesem Fall die errechnete Summe u.U. nicht dem
  tatsächlichen Wert entspricht, wird das entsprechende Textgadget (Telefon-,
  Modem-, oder Gesamtkosten) mit einem Asterisk '*' markiert.

  Konnte eine der Logdateien nicht gefunden werden, wird dies entsprechend mit
  'keine Logdatei' im jeweiligen Textgadget vermerkt.

  Kam es zu einem Fehler bei der Berechnung der Kosten (Telefonnummer konnte
  nicht in der Datenbank gefunden werden oder hat keine Entfernungszone
  zugewiesen bekommen) und der entsprechende Punkt in den @{" Voreinstellungen " link "Usage_Prefs"}
  ist aktiviert, so öffnet sich ein @{" Fehlerfenster " link "Usage_TBError"}.

@EndNode

@Node "Usage_TBError" "TelephoneBill Fehlerfenster"

  Dieses kleine Fehlerfenster enthält zwei Listen sowie einen "Weiter" Button,
  über den das Fenster wieder geschlossen werden kann.

  Die obere Liste führt alle die Telefonnummern auf, die nicht in der Datenbank
  gefunden werden konnten. Zur Berechnung der Kosten wird für die hier
  aufgeführten Nummern die bei den @{" Voreinstellungen " link "Usage_Prefs"} definierte
  alternative Entfernungszone verwendet. Die tatsächlichen Kosten können daher
  u.U. von dem errechneten Wert differieren.

  Die untere Liste enthält die Telefonnummern, die zwar in der Datenbank
  gefunden werden konnten, denen jedoch keine Entfernungszone zugewiesen wurde.
  Alle diese Nummern werden bei der Berechnung der Kosten NICHT berücksichtigt.
  Finden sich hier also Telefonnummern, so entsprechen die berechneten Kosten
  GARANTIERT nicht den tatsächlichen Kosten.

@EndNode


@Node "Usage_Edit" "Editierfenster"

  Das Editierfenster besteht aus 4 Textgadgets, einem Cyclegadget, und zwei
  Buttons. Von oben nach unten erfüllen sie folgende Aufgaben:

  - Stringgadget "Nachnahme":
    Der Nachname der Person/Firma/etc. Die maximale Länge beträgt
    30 Zeichen. Alle Zeichen sind erlaubt, mit Ausnahme der beiden eckigen
    Klammern '[' und ']'. Der Nachname wird in der Logdatei vermerkt.

  - Stringgadget "Vornahme":
    Der Vorname der Person/Firma/etc. Die maximale Länge beträgt
    30 Zeichen. Alle Zeichen sind erlaubt, mit Ausnahme der beiden eckigen
    Klammern '[' und ']'. Der Vorname wird in der Logdatei vermerkt.

  - Stringgadget "Kurzer Kommentar":
    Nur ein kurzer Kommentar (z.B. "(privat)", "(Büro)", o.ä.). Die maximale
    Länge beträgt 30 Zeichen. Alle Zeichen sind erlaubt. Der Kommentar wird
    in der Logdatei vermerkt.

  - Stringgadget "Straße":
    Die Straße der Person/Firma/etc. Die maximale Länge beträgt 30 Zeichen.
    Alle Zeichen sind erlaubt.

  - Stringgadget "Postleitzahl":
    Die Postleitzahl des Ortes. Die maximale Länge beträgt 20 Zeichen. Alle
    Zeichen sind erlaubt.

  - Stringgadget "Stadt":
    Die Stadt, in der sich die Person/Firma/etc. befindet. Die maximale Länge
    beträgt 30 Zeichen. Es sind alle Zeichen erlaubt.

  - Stringgadget "Land":
    Die maximale Länge beträgt 30 Zeichen. Es sind alle Zeichen erlaubt.

  - Stringgadget "Telefonnummer":
    Die Telefonnummer der Person/Firma/etc. Unbedingt notwendig, sonst kann
    nicht gewählt werden :-). Die maximale Länge der Nummer beträgt
    60 Zeichen.
    Akzeptiert werden folgende Zeichen: 0123456789/()+-|

    Es lassen sich mehrere Nummern angeben, wobei diese jeweils durch "|"
    getrennt sein müssen. Zu beachten ist, daß nur die erste Nummer gewählt
    wird. CallMan nutzt alle folgenden Nummern ausschließlich in den internen
    Analyseroutinen. Die Angabe zusätzlicher Nummern ist dann sinnvoll, wenn
    sich z.B. die Nummer eines Freundes geändert hat, dessen alte Nummer aber
    noch in der Logdatei vermerkt ist.

    ACHTUNG: Die Analyse-Routinen ignorieren bei den Telefonnummern aus den
    einzelnen Logdateien eventuelle DAVOR- oder DAHINTERliegende Leerzeichen.
    Es sollten deshalb in der Datenbank keine zusätzlichen Leerzeichen um
    die Nummer herum eingetragen werden. So müßte beispielsweise der folgende
    Eintrag bei beiden Nummern Schwierigkeiten machen:

    " 0815/47 11 13 |007/666 "

    Richtig sollte es heißen:

    "0815/47 11 13|007/666"

    Ansonsten muß die Nummer in der Datenbank EXAKT der Nummer entsprechen,
    die in der Logdatei vermerkt wurde. Das schließt Leerzeichen INNERHALB
    der Nummer ein, da diese NICHT ignoriert werden!

  - Cyclegadget "Entfernungszone":
    Dieses Cyclegadget stellt alle die Entfernungszonen zur Wahl, die in den
    @{" Voreinstellungen " link "Usage_Prefs"} definiert wurden. Mindestens enthält es jedoch den
    Eintrag 'Unbekannt'. Es sollte unbedingt die korrekte Zone eingestellt
    werden, da mit der Zone 'Unbekannt' sonst die errechneten Telefonkosten
    nicht den tatsächlichen Werten entsprechen könnten.
    Wird keine Zone festgelegt (Gadget steht auf 'Unbekannt'), so bleibt das
    Gespräch bei der Berechung der Telefonkosten unbeachtet.

  - die beiden Buttons "Ok" und "Abbruch" dienen der Übernahme und dem
    Verwerfen der kompletten Eingabe.

@EndNode


@Node "Usage_QuickDial" "Schnellwahl"

  Das Fenster für die Schnellwahl enthält sechs verschiedene Gadgets: zwei
  Textgadgets, ein Cyclegadget, ein Checkmark-Gadget, und zwei Buttons. Ihre
  Bedeutung von oben nach unten:

  - Stringgadget "Telefonnummer":
    Die Telefonnummer der Person/Firma/etc. Unbedingt notwendig, sonst kann
    nicht gewählt werden :-). Die maximale Länge der Nummer beträgt
    60 Zeichen.
    Akzeptiert werden folgende Zeichen: 0123456789/()+-

  - Stringgadget "Kurze Beschreibung (optional)":
    Eine optionale kurze Beschreibung zur angegebenen Telefonnummer. Dieser Text
    wird in der Logdatei an der Stelle von Vorname/Nachname/Kommentar vermerkt.

  - Cyclegadget "Entfernungszone":
    Dieses Cyclegadget stellt alle die Entfernungszonen zur Wahl, die in den
    @{" Voreinstellungen " link "Usage_Prefs"} definiert wurden. Mindestens enthält es jedoch den
    Eintrag 'Unbekannt'. Es sollte unbedingt die korrekte Zone eingestellt
    werden, da mit der Zone 'Unbekannt' sonst die errechneten Telefonkosten
    nicht den tatsächlichen Werten entsprechen könnten.
    Wird keine Zone festgelegt (Gadget steht auf 'Unbekannt'), so bleibt das
    Gespräch bei der Berechung der Telefonkosten unbeachtet.

  - Checkmark "Name & Telefonnummer in Datenbank übernehmen?":
    Ist dieses Gadget abgehackt, so wird die Telefonnummer inkl. kurzer
    Beschreibung und Entfernungszone in die Datenbank übernommen. Die Datenbank
    wird hierbei gleich auf Platte gespeichert.

  - Button "Wählen":
    Beginnt den Wählvorgang der angegebenen Telefonnummer. Wurde keine
    Telefonnummer angegeben, so springt die Eingabe zurück in das Textgadget
    "Telefonnummer". Im Falle eines Modemfehlers öffnet sich ein entsprechender
    Requester. Konnte erfolgreich gewählt werden, wird das Schnellwahlfenster
    durch das @{" Gesprächsfenster " link "Usage_Call"} ersetzt.

  - Button "Abbruch":
    Das Programm bricht die Schnellwahl ab und kehrt zum @{" Hauptfenster " link "Usage_Main"} zurück.

@EndNode


@Node "Usage_Call" "Gesprächsfenster"

  Dieses Fenster ermöglicht dem Benutzer die Kontrolle über Gesprächsbeginn und
  Gesprächsende und informiert zudem über den aktuellen Gesprächspartner.

  Im Textfenster in der linken oberen Ecke gibt CallMan einige Informationen
  zum angewählten Gesprächspartner aus.

  CallMan beginnt die Zeitmessung mit Beenden des Anwahlvorgangs. Zur exakten
  Steuerung dienen drei Buttons:

  - "Gesprächsbeginn":
    Setzt die komplette Zeitmessung auf Null zurück. Dieser Button läßt sich nur
    einmal pro Gespräch betätigen. Danach wird er zusammen mit dem Button
    "Abbruch" inaktiv gesetzt.

  - "Gesprächsende":
    Markiert das Ende des Gesprächs. Die zeitliche Differenz zwischen Gesprächs-
    beginn und Gesprächsende wird in der Logdatei vermerkt. Anschließend schließt
    sich das Fenster.

  - "Abbruch":
    Bricht die Zeitmessung ab und vermerkt das Gespräch in der Logdatei als
    erfolglos. Das Fenster schließt sich und das Programm kehrt zum
    @{" Hauptfenster " link "Usage_Main"} zurück.


  In der unteren Hälfte des Fensters finden sich vier Textgadgets mit weiteren
  Informationen zu Gesprächsdauer und -kosten:

  - "Dauer des Gesprächs":
    Die bereits vergangene Gesprächszeit.

  - "Restzeit bis zur nächsten Einheit":
    Die verbleibende Zeit, bis die nächste Gebühreneinheit fällig wird.

  - "Fällige Einheiten":
    Die bereits vertelefonierte Anzahl an Gebühreneinheiten.

  - "Kosten des Gesprächs":
    Die bereits angefallenen Kosten des aktuellen Telefonats.

  Wurde der gewählten Telefonnummer keine Entfernungszone zugeteilt, so
  bleiben die letzten drei Gadgets leer.

@EndNode


@Node "Usage_Analyze" "Analyse"

  CallMan ermöglicht eine detaillierte Auswertung der eigenen Logdatei.

  Der obere Fensterbereich gehört 3 Registerseiten:

  @{" Gesamtzeit " link "Analyze_Time"} @{" Gesprächsliste " link "Analyze_List"} @{" Gesamtkosten " link "Analyze_Costs"}

  -------------------------------------------------------------------------------

  Im unteren Bereich finden sich Gadgets zur Beschränkung der Auswertung auf
  einen festen Zeitraum und/oder einen bestimmten Gesprächspartner.

  - Zeitraumbeschränkung:
    Ist das Gadget "Zeitraum" aktiv, so kann über die beiden rechts davon
    liegenden Stringgadgets jeweils ein Datum für Beginn und Ende der Auswertung
    bestimmt werden. Die Eingabe des Datums erfolgt nach dem Schema "TT.MM.JJJJ",
    wobei Tag und Monat zweistellig, Jahr hingegen vierstellig angegeben werden
    müssen.

  - Personenbeschränkung:
    Über dieses Stringgadget läßt sich die Auswertung der Logdatei auf einzelne
    Gesprächspartner beschränken. CallMan sucht nach allen Gesprächen, bei denen
    dieser Teiltext vermerkt ist. Befinden sich beispielsweise mehrere Personen
    mit demselben Nachnamen in der Datenbank, so können diese durch Angabe des
    entsprechenden Nachnamens, unabhängig von den Vornamen, gemeinsam ausgewählt
    werden. Zu beachten ist hierbei, dass die Informationen in der Logdatei in
    der Reihenfolge "Vorname Nachname Kommentar" vermerkt sind. Dies muß beachtet
    werden, sobald nach einer bestimmten Person mittels Vor- und Nachname gesucht
    wird.
    Auswahl zu erleichtern, läßt sich über das rechts befindliche Popup-Gadget
    und über die daraufhin erscheinende Popup-Liste ein Name aus der Datenbank
    auswählen.

  - Button "Analyse":
    Startet die Auswertung der Logdatei.

  - Button "Abbruch":
    Rückkehr zum @{" Hauptfenster " link "Usage_Main"}.

@EndNode


@Node "Analyze_Time" "Analyse - Gesamtzeit"

  Vier Gadgets zeigen die Gesamtzeit in Tagen, Stunden, Minuten und Sekunden.

  Über das Cycle-Gadget am rechten Rand läßt sich einstellen, ob die Gesamtzeit

  - "in Sekunden"
  - "in Minuten"
  - "in Stunden"
  - "in Tagen"

  dargestellt werden soll.

  Restzeit wird entsprechend in der nächstkleineren Einheit angezeigt.

  -------------------------------------------------------------------------------

  Im unteren Bereich finden sich Gadgets zur Beschränkung der Auswertung auf
  einen festen Zeitraum und/oder einen bestimmten Gesprächspartner.

  - Zeitraumbeschränkung:
    Ist das Gadget "Zeitraum" aktiv, so kann über die beiden rechts davon
    liegenden Stringgadgets jeweils ein Datum für Beginn und Ende der Auswertung
    bestimmt werden. Die Eingabe des Datums erfolgt nach dem Schema "TT.MM.JJJJ",
    wobei Tag und Monat zweistellig, Jahr hingegen vierstellig angegeben werden
    müssen.

  - Personenbeschränkung:
    Über dieses Stringgadget läßt sich die Auswertung der Logdatei auf einzelne
    Gesprächspartner beschränken. CallMan sucht nach allen Gesprächen, bei denen
    dieser Teiltext vermerkt ist. Befinden sich beispielsweise mehrere Personen
    mit demselben Nachnamen in der Datenbank, so können diese durch Angabe des
    entsprechenden Nachnamens, unabhängig von den Vornamen, gemeinsam ausgewählt
    werden. Zu beachten ist hierbei, dass die Informationen in der Logdatei in
    der Reihenfolge "Vorname Nachname Kommentar" vermerkt sind. Dies muß beachtet
    werden, sobald nach einer bestimmten Person mittels Vor- und Nachname gesucht
    wird.
    Auswahl zu erleichtern, läßt sich über das rechts befindliche Popup-Gadget
    und über die daraufhin erscheinende Popup-Liste ein Name aus der Datenbank
    auswählen.

  - Button "Analyse":
    Startet die Auswertung der Logdatei.

  - Button "Abbruch":
    Rückkehr zum @{" Hauptfenster " link "Usage_Main"}.

@EndNode


@Node "Analyze_List" "Analyse - Gesprächsliste"

  Diese Registerseite listet alle Gespräche auf, die den Suchkriterien ent-
  sprechen. Die Telefonate werden chronologisch sortiert und es werden
  folgende Informationen zu den Telefonaten ausgegeben: Datum und Uhrzeit des
  Gesprächs, Gesprächspartner, Dauer des Gesprächs, Anzahl der vertelefonierten
  Einheiten, die Entfernungszone, sowie die jeweiligen Kosten des Gesprächs.

  -------------------------------------------------------------------------------

  Im unteren Bereich finden sich Gadgets zur Beschränkung der Auswertung auf
  einen festen Zeitraum und/oder einen bestimmten Gesprächspartner.

  - Zeitraumbeschränkung:
    Ist das Gadget "Zeitraum" aktiv, so kann über die beiden rechts davon
    liegenden Stringgadgets jeweils ein Datum für Beginn und Ende der Auswertung
    bestimmt werden. Die Eingabe des Datums erfolgt nach dem Schema "TT.MM.JJJJ",
    wobei Tag und Monat zweistellig, Jahr hingegen vierstellig angegeben werden
    müssen.

  - Personenbeschränkung:
    Über dieses Stringgadget läßt sich die Auswertung der Logdatei auf einzelne
    Gesprächspartner beschränken. CallMan sucht nach allen Gesprächen, bei denen
    dieser Teiltext vermerkt ist. Befinden sich beispielsweise mehrere Personen
    mit demselben Nachnamen in der Datenbank, so können diese durch Angabe des
    entsprechenden Nachnamens, unabhängig von den Vornamen, gemeinsam ausgewählt
    werden. Zu beachten ist hierbei, dass die Informationen in der Logdatei in
    der Reihenfolge "Vorname Nachname Kommentar" vermerkt sind. Dies muß beachtet
    werden, sobald nach einer bestimmten Person mittels Vor- und Nachname gesucht
    wird.
    Auswahl zu erleichtern, läßt sich über das rechts befindliche Popup-Gadget
    und über die daraufhin erscheinende Popup-Liste ein Name aus der Datenbank
    auswählen.

  - Button "Analyse":
    Startet die Auswertung der Logdatei.

  - Button "Abbruch":
    Rückkehr zum @{" Hauptfenster " link "Usage_Main"}.

@EndNode


@Node "Analyze_Costs" "Analyse - Gesamtkosten"

  Das oberste Textgadget enthält die Gesamtkosten aller Gespräche, die den
  Suchkriterien entsprechen.

  Die darunterliegende Liste führt alle die Telefonnummern auf, die nicht in
  der Datenbank gefunden werden konnten. Zur Berechnung der Kosten wird für
  die hier aufgeführten Nummern die bei den @{" Voreinstellungen " link "Usage_Prefs"}
  definierte alternative Entfernungszone verwendet. Die tatsächlichen Kosten
  können daher u.U. von dem errechneten Wert differieren.

  Die unterste Liste enthält die Telefonnummern, die zwar in der Datenbank
  gefunden werden konnten, denen jedoch keine Entfernungszone zugewiesen wurde.
  Alle diese Nummern werden bei der Berechnung der Kosten NICHT berücksichtigt.
  Finden sich hier also Telefonnummern, so entsprechen die Kosten GARANTIERT
  nicht den tatsächlichen Kosten.

  -------------------------------------------------------------------------------

  Im unteren Bereich finden sich Gadgets zur Beschränkung der Auswertung auf
  einen festen Zeitraum und/oder einen bestimmten Gesprächspartner.

  - Zeitraumbeschränkung:
    Ist das Gadget "Zeitraum" aktiv, so kann über die beiden rechts davon
    liegenden Stringgadgets jeweils ein Datum für Beginn und Ende der Auswertung
    bestimmt werden. Die Eingabe des Datums erfolgt nach dem Schema "TT.MM.JJJJ",
    wobei Tag und Monat zweistellig, Jahr hingegen vierstellig angegeben werden
    müssen.

  - Personenbeschränkung:
    Über dieses Stringgadget läßt sich die Auswertung der Logdatei auf einzelne
    Gesprächspartner beschränken. CallMan sucht nach allen Gesprächen, bei denen
    dieser Teiltext vermerkt ist. Befinden sich beispielsweise mehrere Personen
    mit demselben Nachnamen in der Datenbank, so können diese durch Angabe des
    entsprechenden Nachnamens, unabhängig von den Vornamen, gemeinsam ausgewählt
    werden. Zu beachten ist hierbei, dass die Informationen in der Logdatei in
    der Reihenfolge "Vorname Nachname Kommentar" vermerkt sind. Dies muß beachtet
    werden, sobald nach einer bestimmten Person mittels Vor- und Nachname gesucht
    wird.
    Auswahl zu erleichtern, läßt sich über das rechts befindliche Popup-Gadget
    und über die daraufhin erscheinende Popup-Liste ein Name aus der Datenbank
    auswählen.

  - Button "Analyse":
    Startet die Auswertung der Logdatei.

  - Button "Abbruch":
    Rückkehr zum @{" Hauptfenster " link "Usage_Main"}.

@EndNode


@Node "Usage_Prefs" "Voreinstellungen"

  Die Voreinstellungen gliedern sich in drei Teile:

  @{" Modem " link "Prefs_Modem"} @{" CallMan " link "Prefs_CM"} @{" TelephoneBill " link "Prefs_TB"}

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.

@EndNode


@Node "Prefs_Modem" "Voreinstellungen - Modem"

  Auf dieser Seite lassen sich Modem sowie serielle Schnittstelle konfigurieren.

  Achtung:
  Bei den Modembefehlssequenzen ist ein abschließendes '\\r' NICHT erforderlich.

  - "Device":
    Der Name des seriellen Devices, über das das Modem angesprochen werden soll.
    Bitte unbedingt auf die richtige Schreibweise (auch Groß-/Klein-Schreibweise)
    achten!

    Beispiele:   serial.device (Standarddevice des AmigaOS)
                 duart.device  (Device der MultiFace Schnittstellenkarte)

  - "Unit":
    Die Unit des angegebenen Devices, über die das Modem angesprochen wird.

  - "Geschwindigkeit":
    Die Geschwindigkeit der seriellen Schnittstelle. Für den internen seriellen
    Port des Amigas sollte dieser Wert nicht höher als 57600 gesetzt werden.

  - "OwnDevUnit.library verwenden?":
    Ist diese Option aktiv, werden alle Zugriffe auf die serielle Schnittstelle
    über die "OwnDevUnit.library" durchgeführt. Die "OwnDevUnit.library" findet
    man im Aminet.

  - "Modeminitstring":
    Die Befehlssequenz, mit der das Modem vor jedem Wählvorgang initialisiert
    werden soll. Die Sequenz sollte mit einem 'AT' beginnen!

  - "Wählpräfix":
    Die Sequenz, mit der der Wählvorgang eingeleitet werden soll. Es empfiehlt
    sich, diese Sequenz mit 'DP' (bei Pulswahl) bzw. 'DT' (bei Tonwahl) enden
    zu lassen, da die zu wählende Telefonnummer direkt an das Ende dieses Strings
    angehängt werden. Die Sequenz sollte mit einem 'AT' beginnen!

  - "Wählsuffix", "Wählsuffix 2", "Wählsuffix 2 Verzögerung":
    Hier muß nun unterschieden werden, ob das Modem vor das Telefon geschalten
    ist oder umgekehrt:

    -> Modem vor Telefon:
       Hier genügt es, unter "Wählsuffix" die Befehlssequenz einzutragen, die das
       Modem zurück in den Befehlsmodus schaltet und anschliessend die Leitung
       auflegt. "Wählsuffix 2 Verzögerung" und "Wählsuffix 2" sind hierbei ohne
       Bedeutung.
       Während des Wählvorgangs kann nun der Telefonhörer bereits in die Hand
       genommen werden. Sobald gewählt wurde, legt das Modem auf und übergibt
       damit die stehende Leitung dem Telefon.

    -> Telefon vor Modem:
       Unter "Wählsuffix" sollte hier die Befehlssequenz eingetragen werden,
       über die das Modem zurück in den Befehlsmodus geschalten werden kann.
       "Wählsuffix 2" sollte die Befehlssequenz zum Auflegen der Leitung ent-
       halten. Mittels "Wählsuffix 2 Verzögerung" bestimmt man die Zeitspanne,
       die zwischen Anwahl und Auflegen vergehen soll (d.h. dies ist also die
       Zeit, die einem bleibt, um den Telefonhörer an sich zu reißen ;-)

    Wie man nun genau feststellt, wie Modem und Telefon geschalten sind,
    erfähert man @{" hier " link "Modempriority"}.

  - "Modem-Timeout (in Sekunden)":
    Die maximale Zeitspanne, die das Programm nach dem Wählvorgang auf die
    Rückmeldung des Modems wartet. Danach kommt es im Regelfall zu einer
    Fehlermeldung und dem Rücksprung zum @{" Hauptfenster " link "Usage_Main"}.

  - "Hilfsfenster anstelle der Suffix 2 Verzögerung anzeigen?":
    Ist diese Option aktiv, ignoriert CallMan nach dem Wählen die Einstellung
    unter "Wählsuffix 2 Verzögerung". Stattdessen öffnet sich ein Requester
    mit der Aufforderung, nun den Telefonhörer abzuheben. Sobald dies mit
    einem Klick auf den "Ok" Knopf bestätigt wurde, schließt sich der Requester
    und das Modem übergibt das Gespräch an das Telefon.

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.

@EndNode


@Node "Prefs_CM" "Voreinstellungen - CallMan"

  Einige allgemeine CallMan-Parameter:

  - "Sortiere Datenbank nach...":
    Die Datenbank wird automatisch alphabetisch sortiert. Hierbei kann man
    wählen, ob man die Sortierung nach Vorname/Nachname oder Nachname/Vorname
    vornehmen will.

  - "Pfad der CallMan Datenbank & Logdatei":
    Hier läßt sich einstellen, an welchem Ort CallMan seine Datenbank und seine
    Logdatei speichern soll. Hier genügt eine Pfadangabe (ohne Dateinamen!). Auch
    hier erleichtert ein Popup-Gadget (inkl. Dateirequester) die Suche.

  - Gebührendatei-Informationstext sowie "Laden":
    Nach Betätigen des Buttons "Laden" kann über einen Dateirequester die
    gewünschte Gebührendatei geladen werden. Handelt es sich bei der gewählten
    Datei nicht um eine CallMan-Gebührendatei bzw. enthält sie Tage, denen noch
    keine Tagesart zugewiesen wurde, so kommt es zu einer Fehlermeldung.
    Konnte die Gebührendatei erfolgreich geladen werden, erfährt man im
    Informationskasten Näheres zum Inhalt der Datei.

  - Liste "Alternative Entfernungszone":
    Mit dieser Liste läßt sich eine der Entfernungszonen als "Alternativzone"
    definieren. Kann CallMan während der Kostenberechnung eine Telefonnummer
    nicht in seiner Datenbank finden, so verwendet das Programm diese Alternativ-
    zone als Entfernungszone. Damit ist gewährleistet, daß das entsprechende
    Gespräch zumindest teilweise bei der Kostenberechnung berücksichtig wird
    (wenn jedoch auch nicht immer adäquat).

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.

@EndNode


@Node "Prefs_TB" "Voreinstellungen - TelephoneBill"

  Die Einstellungsseite für den TelephoneBill Modus gliedert sich in zwei
  Unterseiten:

  @{" Verschiedenes " link "Prefs_TB_Misc"} @{" Modem Logdateien " link "Prefs_TB_MLF"}

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.


@EndNode


@Node "Prefs_TB_Misc" "Voreinstellungen - TelephoneBill - Verschiedenes"

  Auf dieser Seite lassen sich spezielle Parameter für das TelephoneBill Fenster
  konfigurieren.

  - "Nach Programmstart sofort TelephoneBill-Fenster öffnen?":
    Ist diese Option aktiv, so öffnet sich CallMan nach dem Start nicht mit dem
    Hauptfenster, sondern sofort mit dem @{" TelephoneBill-Fenster " link "Usage_TB"}.

  - "Grundgebühr zu den Gesamtkosten addieren?":
    Ist diese Option aktiv, so addiert CallMan bei der Berechnung der Gesamt-
    kosten im @{" TelephoneBill-Fenster " link "Usage_TB"} eine Grundgebühr.
    Diese läßt sich im Stringgadget rechts daneben angeben.

  - "Berechnung über..."

    -> "...aktuellen Monat":
       Die Berechnung beginnt man dem 1. des aktuellen Monats und endet mit dem
       letzten Tag des Monats.

    -> "...Zeitraum":
       Die Berechnung beginnt mit dem unter "vom" angegebenen Datum und endet
       mit dem unter "bis" festgelegten Tag.

  - "Neue Berechnung alle":
    Das zeitliche Intervall, in dem die Gesamtkosten berechnet werden sollen.

  - "Fehlerfenster anzeigen?":
    Ist diese Option aktiv, so öffnet sich bei einem Fehler während der Kosten-
    berechnung ein @{" Fehlerfenster " link "Usage_TBError"}.

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.

@EndNode


@Node "Prefs_TB_MLF" "Voreinstellungen - TelephoneBill - Modemlogdateien"

  "Modem Logdateien":
  In dieser Liste lassen sich (nahezu) beliebig viele Logdateien angeben,
  die im Rahmen der Kostenberechung analysiert und deren Kosten zu den
  gesamten Modemkosten dazuaddiert werden sollen.

  Jeder Eintrag in der dreispaltigen Liste steht hierbei für eine einzelne
  Logdatei. Sobald einer der Einträge aktiviert wurde, korrespondiert der
  Inhalt der jeweiligen Spalten mit den unterhalb der Liste liegenden Gadgets.
  Mittels der Knöpfe "Neu" und "Löschen" können neue Einträge in die Liste
  eingefügt bzw. alte Einträge wieder gelöscht werden.

  -> "Aktiv:
     Nur aktive Logdateien werden wirklich in die Berechnung miteinbezogen.
     In der Liste markiert ein "x" jeden aktiven Eintrag. Mit einem Doppelklick
     auf einen Eintrag in der Liste kann schnell zwischen "aktiv" und "inaktiv"
     gewechselt werden.

  -> "Logdatei":
     Der Pfad und der Name der entsprechenden Logdatei. Ein über das Popup-
     gadget verfügbarer Dateirequester erleichtert die Anwahl.

  -> "Scanner Modul":
     Um eine Logdatei korrekt analysieren zu können, muß CallMan wissen, um
     was für eine Logdatei es sich handelt. Da viele Logdateien keine spezielle
     Kennung besitzen, muß dies manuell festgelegt werden.
     CallMan ist momentan in der Lage, die Logdateien der folgenden Programme
     (oder entsprechend kompatible Logdateien) zu analysieren:

     - Miami           (TCP/IP Stack)
     - NComm           (Terminalprogramm)
     - Term            (Terminalprogramm)
     - MultiFax        (Faxprogramm)
     - MultiTerm/KIT   (BTX Software)

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich drei Buttons:

  - "Speichern":
    Schließt das Fenster und speichert die Voreinstellungen auf Platte.

  - "Benutzen":
    Schließt das Fenster, jedoch ohne die Voreinstellungen dauerhaft auf Platte
    zu sichern. Intern bleiben die Änderungen aktiv.

  - "Abbruch":
    Schließt das Fenster und verwirft evtl. Änderungen an den Voreinstellungen.

@EndNode


@Node "Usage_PrefsRates" "Gebührendateien bearbeiten"

  Hier lassen sich neue Gebührendateien erstellen und alte Gebührendateien
  bearbeiten. Nach dem Öffnen ist das Fenster noch leer. Über den "Laden" Button
  am unteren Fensterrand läßt sich nun eine alte Gebührendatei laden. Es kann
  jedoch auch eine völlig neue Datei erstellt werden.

  Das Fenster gliedert sich hierzu in folgende Teilbereiche:

  - Stringgadget "Beschreibung":
    Hier sollte man einen möglichst aussagekräftigen, kurzen Informationstext
    angeben. Dieser Text erscheint im @{" Voreinstellungsfenster " link "Usage_Prefs"}, wenn dort
    eine Gebührendatei eingestellt wird. Es bietet sich an, hier einen Standard-
    versionsstring [z.B. $VER: Name 1.0 (31.05.97) ] zu integrieren.

  - Fließkommagadget "Kosten pro Einheit":
    Hier definiert man die Kosten einer einzelnen Gebühreneinheit.

  - Gruppe "Entfernungszone":
    Diese Liste enthält die verschiedenen regionalen Entfernungszonen. Die
    Bezeichnungen der Zonen können frei gewählt werden.

    Um neue Einträge hinzuzufügen, wählt man den Button "Neu". Daraufhin
    aktiviert sich das darüberliegende Stringgadget. Hier kann nun die
    Bezeichnung der neuen Entfernungszone eingegeben werden. Übernommen wird
    der Eintrag erst nach dem Betätigen der Return-Taste.

    Vorhandene Einträge können mit dem Button "Löschen" entfernt werden.

  - Gruppe "Wochentage"

  - Gruppe "Datum":
    Diese Liste enthält mögliche Feiertage oder sonstige Tage, an denen sich
    die Gebührenzählung von gewöhnlichen Wochentagen unterscheidet.

    Um einen neuen Feiertag hinzuzufügen, wählt man den Button "Neu". Daraufhin
    aktiviert sich das darüberliegende Stringgadget. Hier kann nun der neue
    Feiertag in der Form 'TT.MM' angegeben werden. Übernommen wird der Eintrag
    erst nach dem Betätigen der Return-Taste.

    Vorhandene Feiertage können mit dem Button "Löschen" entfernt werden.

  - Gruppe "Zeiteinteilung":
    Diese Gruppe ermöglicht die differenzierte Angabe verschiedener Tagesarten
    (und ihrer zeitlichen Einteilung) und ihre Zuweisung zu den einzelnen Wochen-
    und Feiertagen sowie den verschiedenen Entfernungszonen.

    -> Die linke Liste enthält die Bezeichnungen der verschiedenen Tagesarten.
       Der Name einer Tagesart kann hierbei frei gewählt werden.

       Um neue Einträge hinzuzufügen, wählt man den Button "Neu". Daraufhin
       aktiviert sich das darüberliegende Stringgadget. Hier kann nun die
       Bezeichnung der neuen Tagesart eingegeben werden. Übernommen wird der
       Eintrag erst nach dem Betätigen der Return-Taste.

       Vorhanden Einträge können mit dem Button "Löschen" entfernt werden.

       Über den Button "Zuweisen" kann man die aktive Tagesart dem aktiven
       Wochen- oder Feiertag in Verbindung mit der aktiven Entfernungszone
       zuweisen. Für eine korrekte Zuweisung MÜSSEN sowohl eine Entfernungszone
       als auch ein Wochen- oder ein Feiertag aktiv sein!

    -> Die rechte Liste zeigt die zeitliche Aufteilung der aktiven Tagesart.

       Ein Beispiel für eine Zeitzoneneinteilung:

           00:00
             |
           10:00  <-- Zeitzonengrenze
             |    <-- Platzhalter für Sekunden/Einheit und Verbindungskosten
           18:00  <-- Zeitzonengrenze
             |
           24:00

       Um eine Zeitzonengrenze zu verschieben, aktiviert man sie und kann nun
       mit Hilfe der beiden Slidergadgets unterhalb der Liste Stunden- und
       Minutenwert ändern. Zu beachten ist, daß eine Zeitzonengrenze immer
       zwischen der darüber- und der darunterliegenden Zeitzonengrenze liegen
       muß. Daher gilt:

          Grenze darüber < aktive Zeitzonengrenze < Grenze darunter

       Um eine Zeitzonengrenze zu entfernen, muß diese aktiv sein und der Button
       "Löschen" betätigt werden. Die beiden äußersten Grenzen (00:00 und
       24:00) können nicht gelöscht werden!

       Um eine neue Zeitzonengrenze einzufügen, aktiviert man den Platzhalter
       des entsprechenden zu teilenden Zeitabschnitts und betätigt den Button
       "Neu". Der neu entstandene Abschnitt übernimmt die Werte des ursprüng-
       lichen Abschnitts.

       Aktiviert man hingegen einen der Platzhalter, so kann man in den unter
       den Slidergadgets liegenden beiden Stringgadgets für jeden Zeitabschnitt
       individuell die verfügbare Zeit pro Einheit ("Sek/Einheit") sowie die
       evtl. vorhandenen einmaligen Verbindungsgebühren ("Verb.kosten")
       festlegen.

       Desweiteren lassen sich für jeden Zeitabschnitt sogenannte "Zusätzliche
       Kosten" angeben. Dies ermöglicht beispielsweise die genaue Abrechnung
       eines PPP-Zugangs über einen Provider, der zu den Telefongebühren noch
       weitere zeitabhängige Gebühren verlangt. Die Angabe dieser zusätzlichen
       Kosten erfolgt hierbei in der Form "DM/s", wobei beide Werte beliebig
       eingegeben werden.
       Für beispielsweise eine zusätzl. Gebühr von 0,08 Pf pro Minute wäre
       der korrekte Eintrag: "0,08/60".

       Desweiteren ist zu beachten, daß nach dem Löschen einer Zeitzonengrenze
       der damit neu entstehende Zeitabschnitt die Werte (Sek/Einheit, Verbind-
       ungskosten, Zusätzl. Kosten) von dem ehemals über der alten Grenze
       liegenden Abschnitt übernimmt.

  -------------------------------------------------------------------------------

  Am unteren Rand des Fensters befinden sich vier Buttons:

  - "Laden":
    Lädt eine neue Gebührendatei. Die Auswahl erfolgt über einen Dateirequester.

  - "Speichern":
    Speichert die Gebührendatei unter ihrem alten Namen.

  - "Speichern als":
    Speichert die Gebührendatei unter einem neuen Namen. Hierzu öffnet sich ein
    Dateirequester.

  - "Abbruch":
    Schließt das Fenster, verwirft evtl. Änderungen an der Gebührendatei und
    kehrt zurück zum @{" Hauptfenster " link "Usage_Main"}.

@EndNode






@Node "Update" "Update 1.0 -> 1.1"

 @{b}Voreinstellungen:@{ub}
    Leider ist es aufgrund eines Fehlers in der Struktur der alten
    Voreinstellungsdatei notwendig, die Voreinstellungen neu vorzunehmen.

 @{b}Gebührendateien:@{ub}
    Können weiterverwendet werden.

 @{b}Datenbank:@{ub}
    Kann prinzipiell weiterverwendet werden. Allerdings ist es aufgrund der
    Erweiterung der Datenstruktur ratsam, den Namen und die Adresse der
    entsprechenden Personen auf die (nun vorhandenen) einzelnen Felder
    aufzuteilen.


@EndNode


@Node "Modempriority" "Modempriorität"

Hier folgt nun eine kurze Anleitung um herauszufinden, wie Telefon und Modem
zueinander geschalten sind.


1. Man startet irgendein Terminalprogramm (z.B. TERM) und hebt den
   Telefonhörer ab. Man sollte das Freizeichen hören können. Tippt man nun
   im Terminalprogramm "ATDP" (inkl. RETURN) ein und das Modem übernimmt die
   Leitung (im Telefonhörer ist das Freizeichen nicht mehr bzw. nur noch sehr
   leise zu hören), dann hat das Modem Priorität vor dem Telefon.

   In diesem Fall kann man es mit folgenden Einstellungen probieren:

   Modem-Initstring:          leer
   Wählpräfix:                ATDP
   Wählsuffix:                ;H
   Wählsuffix 2 Verzögerung:  0
   Wählsuffix 2:              leer
   Modem-Timeout:             20
 
   Anwahlvorgang:
   Man hebt den Hörer ab und startet den Anwahlvorgang einer Telefonnummer.
   Das Freizeichen verschwindet vom Telefonhörer und das Modem wählt. Sobald
   das Modem fertig gewählt hat, übergibt es die Leitung zurück an das Telefon
   und man sollte im Hörer das Klingeln hören. Und wenn jetzt noch jemand am
   anderen Ende der Leitung abhebt, hat man eine Verbindung ;)


2. Sollte allerdings das Freizeichen weiterhin beim Telefon bleiben und das
   Modem einen Fehler zurückliefern, dann hat das Telefon Priorität vor dem
   Modem.

   In diesem Fall kann man es einmal mit diesen Einstellungen versuchen:

   Modem-Initstring:          leer
   Wählpräfix:                ATDP
   Wählsuffix:                ;
   Wählsuffix 2 Verzögerung:  4
   Wählsuffix 2:              H
   Modem-Timeout:             20

   Anwahlvorgang:
   Man läßt den Hörer auf der Gabel und startet die Anwahl einer Telefonnummer.
   Sobald das Modem mit dem Wählen begonnen hat, nimmt man den Hörer in die Hand.
   Wenn das Wählen beendet ist und es bei der Gegenstelle zu klingeln beginnt,
   zählt CallMan die Sekunden herunter, die man unter "Wählsuffix 2 Verzögerung"
   eingestellt hast. Danach übergibt das Modem die Leitung an das Telefon. Jetzt
   sollte man das Klingeln im Hörer hören können.


@EndNode





@Node "FAQ" "FAQ"

Häufig gestellte Fragen:
========================

 @{b}F:@{ub} Manchmal kommt es trotz erfolgreichen Wählens und deutlich hörbarem Klingeln
    im Telefonhörer zu der Fehlermeldung "Modem problem". Warum?

 @{b}A:@{ub} In einem solchen Fall ist meistens der Modem-Timeout nicht groß genug
    gewählt. Ein Wert von 15 Sekunden sollte genügen, um diesen Fehler zu beheben.
    Falls nicht, einfach einen noch höheren Wert verwenden.


@EndNode


@Node "Bugs" "Fehler"

Das Programm CallMan wurde über einen längeren Zeitraum im täglichen
Einsatz getestet. Es sind keine gravierenden Fehler mehr bekannt. Jedoch
kann nicht ausgeschlossen werden, daß immer noch Bugs unentdeckt geblieben
sind.

Bugreports sind daher ausdrücklich erwünscht!

Am Besten per eMail an:

fichtner@informatik.tu-muenchen.de

Das Programm wurde mit 'Fortify' (einer extrem nützlichen Memory Allocation
Shell für C - liegt im Aminet) kompiliert und gibt im Falle eines Speicher-
fehlers eine entsprechende Meldung im CLI aus. Wenn möglich, bitte diese
Ausgabe an mich schicken.

Auch Enforcer-Reports sind gern gesehen... :-)

Ich freue mich aber auch über normale eMail und eure Meinung zu meinem
Programm!

@EndNode


@Node "Author" "Wer hats verbrochen?"

Der Verantwortliche für diese Ansammlung sinnlosen Codes:

Alexander 'Sascha' Fichtner
Vulpiusstraße 99
D-81739 München
Germany

eMail: fichtner@informatik.tu-muenchen.de
WWW:   http://www.informatik.tu-muenchen.de/~fichtner/


Bankverbindung (innerhalb Deutschlands):

Alexander Fichtner
Konto-Nr. 150 516 284
BLZ 702 501 50
Kreissparkasse München

Ansonsten bitte einen Euro-Cheque oder das Geld bar schicken.

Wer mir nicht unbedingt Geld schicken/überweisen will, der kann
die Shareware-Gebühr auch in Form von unbeschädigten
"Star Wars: CCG" Karten (englische Ausgabe) der Stufe R/R1/R2
bezahlen. In diesem Fall aber bitte zuerst Rückfrage bei
mir... ;-)


Entstanden ist CallMan auf einem Amiga 2000 unter OS3.1 und unter
Verwendung einer Blizzard2060. Programmiert wurde in C anfangs mit
dem Compiler 'vbcc' von Volker Barthelmann, später mit GNU's 'gcc'.

@EndNode


@Node "History" "History"

@{b}CallMan 1.0 (01.06.1997):@{ub}
 - first public release


@{b}CallMan 1.1 (12.07.1997):@{ub}
 - device name & unit now configurable
 - completely reworked serial code (should work now with a
   lot more modem; if not, please let me know!)
 - added region to info field in call window
 - whenever a phone number's region (i.e. the region's
   position in the list) was higher than the total
   number of regions specified on the active rates file,
   garbage was calculated when dialling and calculation
   in TelephoneBill mode could endless-loop; fixed
 - serial speed configuration now configurable
 - added "number of used units" and "region" to conversation
   list (analyze window)
 - added support for "OwnDevUnit.library"
 - switching the cycle gadget on "Total time" page (analyze
   window) now automatically starts analyzing
 - reworked "logfile analyzing" code (should be faster now)
 - added individual phone call costs to conversation list
 - analyzing immediately started on opening the analyze
   window
 - added TERM/NCOMM logfile scanner/analyzer
 - converted code to gcc
 - database now sorted alphabetically
 - when analyze was limited to one person, sometimes the person's
   name would disappear from the conversation list when switching
   register pages; fixed
 - added one more security check to "analyze" (this should keep
   CallMan from busy-looping in certain situations)
 - added work-around to a bug in one of gcc's link-libraries
 - added dial help requester: when dialling with "suffix 2 delay",
   delay can now be replaced by an requester, waiting for user
   confirmation to return the call from the modem to the phone
 - person limitation now performed as a substring search
 - improved version handling of prefs and database file (prefs
   have to be reentered, though)
 - added configurable list of different modem logfiles: when in
   TelephoneBill mode they will be scanned and their costs added
   to the total modem costs.
 - added NCOMM/TERM scanner/analyzer
 - immediately after opening the analyze window the unknown
   phonenumbers and numbers without a region weren't displayed;
   fixed
 - some conversation lengths were miscalculated due to a bug in
   one of gcc's link libraries (same as above); provided work-
   around
 - immediately after setting a new rates file the new regions
   wouldn't be displayed in the "alternative region" list; fixed
 - enforcer hits when loading/saving rates files; fixed
 - "costs/unit" always were saved as 0; fixed
 - after changing "default region" (prefs window) the
   quickdial region was always set to "unknown"; fixed
 - all rates file requester now default to the "Rates"
   directory
 - phonenumber now supports "-" and SPACE
 - calculating costs for one single day (i.e. both date
   boundaries set to the same day) didn't work; fixed
 - added 'additional costs' field to timezones
 - Added MULTIFAX scanner/analyzer
 - phonenumber now supports "+"
 - when loading a new ratesfile in the prefs, the
   alternative region was trashed; fixed
 - extended phonenumber to 60 digits
 - phonenumber field now accepts more than one number,
   separated by a '|'; although you can now specify
   multiple numbers note that only the first one will
   be dialled; all other numbers are just used by the
   logfile analyze routines (useful if e.g. a friend's
   number has recently changed and there's still the
   old one in your logfile or if you want to analyze
   MULTIFAX's logfile which seems to contain different
   numbers dependent on whether the sending of the fax
   has been successful or not :-P )
 - fixed bug that under certain circumstances invoking
   the prefs window would cause a MUI fallback to a
   thinner font as specified
 - added dupe check to MULTIFAX scanner
 - added MULTITERM/KIT scanner/analyzer
 - analyzer now checks for identical phonenumber length
 - scanner modules now ignore spaces around logfile
   phonenumbers
 - extended quickdial phonenumber to 60 digits, too
 - cancelling pref window's "load rates" requester
   trashed the "alternative region" list; fixed
 - fixed just another possible MUI font fallback when
   opening the rates window


@EndNode


@Node "Future" "Future"

Ein Programm läßt sich IMMER noch weiter verbessern. Die Zukunft von
CallMan hängt also ganz an euch! Was wollt ihr implementiert haben?
Welche Fehler sollten behoben werden? Schreibts @{"mir" link "Author"}!

@EndNode


@Node "Support" "Support"

Die neueste Version von CallMan kann über meine Homepage bezogen
werden:

  http://www.informatik.tu-muenchen.de/~fichtner/
  [Framesversion]

  http://www.informatik.tu-muenchen.de/~fichtner/CallMan.html
  [für Browser ohne Frames]

@EndNode


@Node "Ratesfiles" "Gebührendateien"

Momentan ist die Auswahl an Gebührendateien noch SEHR dürftig. :-)
Ich bin daher dankbar für jede neue Gebührendatei, egal für welche
Telefongesellschaft, egal für welches Land. Jede Gebührendatei
wird (jedoch ohne Kontrolle auf Richtigkeit) in das CallMan-Archiv
mit aufgenommen, sofern nicht bereits eine entsprechende andere
Version vorhanden ist.

Korrekturen an bereits vorhandenen Dateien sind ebenfalls
willkommen!

Bitte bei der Auswahl der Dateinamen eine möglichst vielsagende
Bezeichnung wählen und auch das interne Beschreibungsfeld der
Gebührendatei sinnvoll ausfüllen.

@EndNode


@Node "MUI" "MUI"

                          This application uses


                        MUI - MagicUserInterface

                (c) Copyright 1992-97 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY



             Support and online registration is available at

                          http://www.sasg.com/

@EndNode


@Node "Thanks" "Danksagungen"

Mein ganz besonderer Dank gilt Ralf Leonhardt: meinem User #1,
der mich unermüdlich mit Bugreports und jeder Menge Verbesserungs-
vorschlägen versorgt und mich tatkräftig beim Debuggen unterstützt
hat!


Mein weitere Dank gilt folgenden Personen (welche nicht unbedingt
alle etwas mit der Entwicklung von CallMan zu tun haben ;-) :

- Andi Schmidt

- Dietmar Eilert:     für GoldED

- Volker Barthelmann: für den C Compiler 'vbcc'

- Stefan Stuntz:      für MUI

- Holger Kruse:       für MIAMI, den komfortablen TCP/IP Stack

- Oliver Wagner:      für Voyager-NG

- Simon P. Bullen:    für 'Fortify', die Memory Allocation Shell



Besonders bedanken möchte ich mich auch noch bei folgenden Personen,
die mich bisher mit Bugreports und Verbesserungsvorschlägen versorgt
haben (Liste chronologisch sortiert):

- Ralf Leonhardt

- Achim Klopsch

- Jens Pesek

@EndNode


