home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / VORWA112.LHA / Vorwahl.dok < prev    next >
Encoding:
Text File  |  1996-07-20  |  11.0 KB  |  283 lines
  1.  
  2.  
  3.  
  4.                Vorwahl V1.12
  5.                =============
  6.  
  7.                © 1996 by W. Wesemann
  8.  
  9.  
  10.                 Was ist 'Vorwahl' ?   
  11.               System-Voraussetzungen  
  12.                    Installation       
  13.                     Bedienung         
  14.                      Haftung          
  15.                     Copyright         
  16.                    Anschriften        
  17.                     Versionen         
  18.  
  19.  
  20.  
  21.  
  22.  
  23. Was ist 'Vorwahl' ?
  24. ===================
  25.  
  26. Es handelt sich dabei um ein kleines Hilfsprogramm (Filegröße: 16552 Bytes),
  27. das Sie bei der Suche nach einer Vorwahl bzw. den zu einer Vorwahl gehörigen
  28. Orten unterstützt. Das verwendete Daten-File basiert auf 'AmiAVON V1.0' von
  29. Reinhard Hennig und enthält das komplette Vorwahl-Verzeichnis für Deutsch-
  30. land. Das File wurde speziell für 'Vorwahl' formatiert und kann deshalb
  31. nicht (wie AmiAVON) mit einem normalen Textanzeige-Programm verwendet
  32. werden. Das ist aber auch nicht nötig, da 'Vorwahl' alle Funktionen ent-
  33. hält, um Daten anzeigen, ändern, löschen oder neu eingeben zu können.
  34.  
  35.  
  36.  
  37.  
  38. Welche Systemvoraussetzungen sind erforderlich ?
  39. ================================================
  40.  
  41. 'Vorwahl' benötigt mindestens OS 2.0 (??? siehe Versionen) und eine
  42. Festplatte.
  43.  
  44. Der Betrieb von Diskette ist zwar möglich, allerdings nicht anzuraten, da
  45. ein Suchvorgang dann sehr lange dauert (ca. 27 Sek. auf einem A1200, 2MB -
  46. mit Festplatte: ca. 1-2 Sekunden !).
  47.  
  48. 'Vorwahl' belegt nur sehr wenig Speicher (ca. 45 KB Chip-Ram und ca.
  49. 20 KB sonstiges Ram).
  50. Für die Menu-Funktion 'Sortieren' werden jedoch (bei der derzeitigen Größe
  51. des Daten-Files von ca. 450 KB) rund 500 KB Ram zusätzlich benötigt, um das
  52. komplette Daten-File und andere Informationen im Speicher halten zu können.
  53. Die Größe des benötigten Speichers ist abhängig von der aktuellen Größe des
  54. Daten-Files und wird erst bei Aufruf des Menü-Punkts ermittelt. Kann nicht
  55. genügend Speicherplatz reserviert werden, so wird die Funktion nicht ausge-
  56. führt. Da diese Funktion aber ohnehin nur selten gebraucht wird, dürfte das
  57. kein großes Problem darstellen.
  58.  
  59.  
  60.  
  61.  
  62. Installation
  63. ============
  64.  
  65. Um 'Vorwahl' zu installieren ziehen Sie einfach das Disketten-Icon in das
  66. gewünschte Verzeichnis auf Ihrer Festplatte. Dort wird dann automatisch ein
  67. Verzeichnis namens 'Vorwahl' erstellt, das die folgenen Files enthält:
  68.  
  69.     - Vorwahl
  70.     - Vorwahl.dat
  71.     - Vorwahl.doc
  72.     - Vorwahl.guide
  73.  
  74.  
  75. Das Programm kann dann durch Anklicken des Icons von der Workbench gestartet
  76. werden oder durch Eingabe des Programmnamens im CLI/Shell.
  77.  
  78. Wenn Sie das 'Vorwahl'-Icon anwählen und im Workbench-Menü den Menü-Punkt
  79. 'Icons/Information' aufrufen, können Sie die ToolTypes des Programms
  80. einstellen. Die folgenden ToolTypes stehen zur Verfügung:
  81.  
  82.     LEFTEDGE - Damit können Sie die linke obere Ecke des Fensters
  83.     TOPEDGE    positionieren, damit das Fenster immer an der von
  84.            Ihnen gewünschten Position geöffnet wird. Die Breite des
  85.            Fensters bleibt immer gleich, die Höhe ist abhängig vom
  86.            eingestellten Zeichensatz.
  87.  
  88.     FILENAME - Hier können Sie den Namen des Daten-Files eintragen,
  89.            für den Fall, daß Sie das File umbenennen oder in einem
  90.            anderen Verzeichnis als das Programm unterbringen
  91.            möchten. Sie müssen dann hier zusätzlich den Pfad-Namen
  92.            auf das Verzeichnis eintragen.
  93.  
  94. Wenn ein ToolType fehlt, wird dafür eine Default-Einstellung verwendet.
  95.  
  96.  
  97.  
  98.  
  99. Wie wird 'Vorwahl' bedient ?
  100. ============================
  101.  
  102. Die Bedienung dürfte eigendlich weitgehend selbsterklärend sein, trotzdem
  103. noch ein paar Worte dazu:
  104.  
  105. Bei einer Eingabe in das Vorwahl-Gadget werden alle Orte angezeigt, die mit
  106. dieser Vorwahl erreicht werden können. Die Vorwahl muß komplett eingegeben
  107. werden und darf nur Zahlen enthalten. Da eine Vorwahl in der Regel immer
  108. mit einer 0 beginnt, müssen mindestens 2 Ziffern eingegeben werden. Es
  109. werden jedoch nur Orte angezeigt, deren Vorwahl exakt mit der eingegebenen
  110. Vorwahl übereinstimmen (also z.B. bei Eingabe von 01 würden nur Orte mit der
  111. Vorwahl 01 angezeigt, nicht jedoch Orte mit Vorwahl 011, 019, 0131 o.ä.).
  112.  
  113. Bei einer Eingabe in das Ort-Gadget werden alle Orte angezeigt, deren
  114. Anfangsbuchstaben mit der Eingabe übereinstimmen. Um also die Vorwahl für
  115. einen Ort zu suchen, genügt es, die Anfangsbuchstaben des Ortes einzugeben
  116. (z.B. bei Eingabe von 'öl' wird 'Öllingen' und 'Ölsen' angezeigt).
  117. Auch hier müssen mindestens 2 Zeichen eingegeben werden, es sind allerdings
  118. alle Zeichen (z.B. auch Zahlen) erlaubt. Groß- oder Kleinschreibung ist
  119. egal. Da die maximale Länge der Liste begrenzt ist, kann es sein, daß nicht
  120. alle Orte angezeigt werden. In dem Fall wird aber vom Programm eine ent-
  121. sprechende Meldung ausgegeben. Sie müssen dann den Suchbereich eingrenzen,
  122. indem Sie in der Eingabe noch einen oder mehrere Buchstaben zusätzlich
  123. eingeben.
  124.  
  125. Werden bei der Suche mehrere Orte gefunden, so werden sie in die Liste ein-
  126. getragen. Sie können sich den gesuchten Ort dann per Mausklick anzeigen
  127. lassen. Wird nur ein Ort gefunden, dann wird dieser automatisch angezeigt.
  128.  
  129. Einen Eintrag, den Sie angeklickt haben oder der automatisch angezeigt wird,
  130. können Sie ändern oder löschen, indem Sie das entsprechende Gadget wählen.
  131. Durch anklicken des Gadgets 'Neu' können Sie einen neuen Eintrag erstellen.
  132. Dieser wird auf evtuelle Übereinstimmungen mit den bereits vorhandenen
  133. Daten überprüft und dann in das Daten-File geschrieben. Wurden vorher Daten
  134. gelöscht, so werden die neuen Daten an diese Position geschrieben, ansonsten
  135. werden sie an das Daten-File angehängt.
  136.  
  137. Wenn Sie viele Daten neu eingetragen und/oder gelöscht haben kann es
  138. nützlich sein das Daten-File neu zu sortieren. Dadurch werden die Daten
  139. alphabetisch sortiert und gelöschte Positionen werden entfernt. Da man diese
  140. Funktion sicher nicht sehr oft benötigt ist sie nur über das Menü zu
  141. erreichen. Bei Verwendung des Programms mit einem Diskettenlaufwerk kann
  142. diese Funktion nicht benutzt werden, da die sortierten Daten sicherheits-
  143. halber zunächst in ein neues File geschrieben werden. Da das Daten-File
  144. ca. 450 KB groß ist, wäre dann nicht mehr genug Platz für das neue File
  145. (außer vielleicht bei HD-Laufwerken).
  146.  
  147. Beenden können Sie das Programm durch Klick auf das Close-Gadget, über den
  148. Menü-Punkt 'Quit' oder durch Drücken der ESC-Taste.
  149.  
  150.  
  151.  
  152.  
  153. Haftung
  154. =======
  155.  
  156. Die Benutzung dieses Programms erfolgt auf eigene Gefahr !
  157.  
  158. Das Programm wurde ausgiebig auf Fehler getestet. Trotzdem ist nicht
  159. auszuschließen, daß bei bestimmten System-Konfigurationen oder unter
  160. bestimmten Umständen das Programm nicht so arbeitet, wie es von ihm
  161. erwartet wird. Der Author übernimmt daher keinerlei Garantie für die
  162. Funktionsfähigkeit des Programms und keine Haftung für Schäden, die direkt,
  163. indirekt oder auf irgendeine andere Weise durch Anwendung dieses Programms
  164. entstehen.
  165.  
  166.  
  167.  
  168.  
  169. Copyright
  170. =========
  171.  
  172. Sämmtliche Rechte an 'Vorwahl' liegen beim Author. Das Programm darf frei
  173. kopiert werden. Die Aufnahme in eine (PD)-Softwaresammlung ist erwünscht und
  174. erlaubt, solange nur ein geringer Unkostenbeitrag verlangt wird (maximal
  175. DM 5,- pro Diskette bzw. DM 25,- pro CD).
  176. Ansonsten ist dieses Programm KOSTENLOS, d.h. Sie brauchen keine Shareware-
  177. Gebühr o.ä. zu bezahlen (gegen eine kleine Spende ist allerdings nichts
  178. einzuwenden).
  179.  
  180. Wenn Sie vorhaben dieses Programm weiterzuverbreiten, so darf dies nur
  181. komplett erfolgen. Das Programm, das Daten-File und die Text-Files müssen
  182. zusammen weitergegeben werden und dürfen nicht verändert werden. Dies gilt
  183. vor allem auch für das Daten-File, selbst wenn darin Fehler enthalten sein
  184. sollten. Es ist sicher nicht sinnvoll, wenn jeder seine eigene Version des
  185. Daten-Files in Umlauf bringt. Falls Sie Fehler finden, so wenden Sie sich
  186. bitte an eine der untenstehenden Adressen. Es wird dann zu gegebener Zeit
  187. ein Update geben, das ALLE Änderungen enthält.
  188.  
  189. Sollte ein Magazin oder eine Zeitschrift Interesse daran haben 'Vorwahl' in
  190. eine Softwaresammlung auf Diskette oder CD aufzunehmen, wäre es wünschens-
  191. wert wenn Sie jeweils eine Ausgabe an die untenstehenden Adressen schicken
  192. würden.
  193.  
  194. Falls Sie Fehler im Programm finden, machen Sie bitte möglichst genaue An-
  195. gaben wie und wann der Fehler aufgetreten ist, welche Konfiguration Sie
  196. benutzen etc., um ein Aufspüren des Fehlers zu erleichtern.
  197.  
  198.  
  199.  
  200.  
  201. Anschriften
  202. ===========
  203.  
  204. Für Verbesserungsvorschläge, Bug-Reports und Spenden an den Programmierer
  205. schreiben Sie bitte an:
  206.  
  207.             Wolfgang Wesemann
  208.             Friedensallee 176
  209.             63263 Neu-Isenburg
  210.  
  211.  
  212. Falls Sie Fehler im Daten-File finden oder dem Ersteller des Files etwas
  213. spenden möchten, wenden Sie sich an:
  214.  
  215.             Reinhard Hennig
  216.             Hochschulstr. 28/02-01
  217.             01069 Dresden
  218.             Tel.: 0351/4763103
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  Version
  225.  =========================================================================
  226.  
  227.  V1.0   27-Juni-96   Erste Version von 'Vorwahl'. Läuft problemlos auf
  228.              meinem A1200, OS 3.0, 68030, 50MHz, 4MB Fast-Ram, mit
  229.              und ohne Turbo-Karte, von Festplatte und von Diskette.
  230.              Läßt sich allerdings unter OS 2.0/2.1 nicht starten
  231.              (getestet von Reinhard Hennig auf A500+, OS 2.1,
  232.              M-Tec-Turbokarte 68020i mit 4MB, CP 500 plus Vario 3
  233.              mit 2MB Fast- und 1.8MB Chip-Ram).
  234.              Die minimal verlangte Version für alle Libs ist V37.
  235.  
  236.  
  237.  V1.1   03-Juli-96   Die minimal verlangte Version für die Intuition-
  238.              Library und die GadTools-Library ist jetzt V36. Bei
  239.              allen anderen verwendeten Libraries (Dos-, Graphics-,
  240.              und Icon-Library) ist die minimale Version V33.
  241.  
  242.              Es wurde eine Routine eingebaut, die eine Meldung
  243.              ausgibt, falls eine Library nicht gefunden wurde o.ä.
  244.              und das Programm deshalb nicht gestartet werden kann.
  245.  
  246.              Läßt sich unter OS 2.0/2.1 immer noch nicht starten,
  247.              da das Fenster nicht geöffnet werden kann. Da ich
  248.              selbst keinen Zugang zu einem Amiga mit OS 2.0 oder
  249.              2.1 habe, kann ich den Grund dafür nicht ermitteln.
  250.              Im Source-Code ist kein offensichtlicher Fehler zu
  251.              finden.
  252.  
  253.  
  254.  V1.11  12-Juli-96   Das Programm müßte jetzt auch auf einem Public-Screen
  255.              laufen. Hatte noch keine Gelegenheit das zu testen.
  256.              Außerdem wird jetzt die Dos-Library in Version V36
  257.              benötigt, um dem Programm den exklusiven Zugriff auf
  258.              das Daten-File zu ermöglichen.
  259.  
  260.              Da das Programm offensichtlich nicht unter OS 2.0/2.1
  261.              läuft, wurden die Fehler-Meldungen etwas verfeinert,
  262.              um das Problem enger eingrenzen zu können. Falls das
  263.              Programm also bei Ihnen nicht läuft, bitte teilen Sie
  264.              mir die Fehler-Meldung und den evtl. zusätzlich
  265.              angezeigten Fehler-Code mit. Falls das Programm bei
  266.              Ihnen auch unter OS 2.0/2.1 läuft, teilen Sie mir das
  267.              bitte auch mit. Bitte immer mit Angabe Ihrer genauen
  268.              System-Konfiguration.
  269.  
  270.              Das Problem liegt vermutlich beim Erstellen der Gadgets
  271.              mit der Funktion 'CreateGadgetA' der GadTools-Library.
  272.              Falls jemand Hinweise oder Tips hat, wie man Gadgets
  273.              mit Hilfe der GadTools-Library programmiert, welche
  274.              Probleme dabei entstehen können (insbesodere auch
  275.              welche Unterschiede evtl. zwischen OS 2.0/2.1 und
  276.              OS 3.0 bestehen) und wie man sie löst, dann soll er/sie
  277.              mir bitte ebenfalls schreiben. Vielen Dank.
  278.  
  279.  
  280.  V1.12  20-Juli-96   Es wurden noch ein paar kleine Optimierungen gemacht.
  281.              Erster offizieller Release.
  282.  
  283.