
 Kurzanleitung zu Callbook         von Andreas Stempfhuber <andi@afulinux.de>
 ============================================================================

 Callbook ist ein Script fr TNN und andere Packet Radio Node oder
 Terminalprogramme unter Linux, um die CB-PR-Userdatenbank die von
 http://www.callbook.de.vu verffentlicht wird, abzufragen.

 Callbook kann im AS1NOD getestet werden.


 Features
 --------
 - Volltextsuche durch alle Daten.
 - Gro-/Kleinschreibung wird ignoriert.
 - Untersttzung von regulren Ausdrcken.
 - Erkennung des Userrufzeichens bei TNN. Fordert den User auf sich unter
   http://www.callbook.de.vu einzutragen, falls er noch nicht eingetragen ist.
 - Unabhngigkeit von der Anzahl und Bezeichnung der Datenbankfelder.


 Voraussetzungen
 ---------------
 - grep, cut, sed, awk, recode, printf und eine bash kompatible Shell.
 - GNU/Linux oder kompatibles Betriebssystem


 Installation bei TNN
 --------------------
 - callbook ins userexe Verzeichnis von TNN kopieren.

 - Die CB-PR-Userdatenbank im Textformat als callbook.txt ins Homeverzeichnis
   von TNN legen. Die jeweils aktuellste Version ist im CB Packet Radio
   Netz und im Internet unter http://packet-forum.de/viewforum.php?f=43
   verfgbar.

 - Optional: Falls showcall nicht installiert ist, im userexe Verzeichnis einen
   symbolischen Link von callbook nach showcall anlegen:
   ln -s callbook showcall


 Konfiguration
 -------------
 Beim Einsatz mit TNN mu nichts konfiguriert werden. Beim Einsatz mit anderen
 Programmen sollte die Variable "tnn" am Anfang von callbook auf 0 gesetzt
 werden.

 Ebenfalls kann dort der Dateiname der Userdatenbank und die Formatierung
 verndert werden.


 Bedienung unter TNN
 -------------------
 Callbook kann aus TNN heraus mittels "callbook" oder kurz "ca" aufgerufen
 werden. Wurde der symbolische Link nach showcall gesetzt, kann es ebenso
 mit "showcall" oder kurz "sho" aufgerufen werden.

 Als Parameter kann ein beliebiger Suchbegriff angegeben werden, z.B.
 Rufzeichen, Name, Email-Adresse oder auch nur Teile davon. Wird nichts
 angegeben, werden bei TNN die Daten des eigenen Rufzeichens ausgegeben oder
 man wird ggf. dazu aufgefordert, sich unter http://www.callbook.de.vu
 einzutragen. Zustzlich wird eine kurze Hilfe ausgegeben.


 Feedback
 --------
 Feedback zu Callbook ist wichtig und herzlich willkommen! Ich bin auf
 folgende Weise zu erreichen:

 Email:  andi@afulinux.de
 CB:     AS1GBF @ AS1BOX.#NDB.BAY.DEU.BCMNET

 73 de Andreas Stempfhuber

