home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / bazy / carcosts / autokosten.dok < prev    next >
Text File  |  1996-11-02  |  11KB  |  279 lines
  1.  
  2.                              AutoKosten Version 3
  3.                              ====================
  4.  
  5. Das Programm verwaltet in zwei Listen die kilometerabhängigen (Treibstoff)
  6. und die nicht kilometerabhängigen (Unterhalt) Kosten eines Autos.
  7.  
  8. Als Auswertung werden die Kosten gesamt und je Kilometer angezeigt, sowie
  9. die insgesamt gefahrenen Kilometer, der insgesamt verbrauchte Treibstoff
  10. und der Verbrauch je 100km.
  11.  
  12.  
  13. Rechneranforderungen
  14. --------------------
  15.  
  16. Das Programm macht häufig Gebrauch von Funktionen, die erst ab Kickstart
  17. 2.04 vorhanden sind. Daher wird ein Amiga mit Kickstart 2.04 (V37) und
  18. mindestens 512kB gebraucht. Im LIBS: Verzeichnis MUSS sich die
  19. asl.library und die MUIMaster.library befinden !
  20.  
  21.  
  22. Rechtliches
  23. -----------
  24.  
  25. Da ich keine Zeit mehr habe dieses Programm weiter zu pflegen habe ich mich
  26. entschlossen es incl. Quelltext als Freeware zu veröffentlichen.
  27. Wer will darf das Programm abändern/erweitern/verbessern etc. solange im
  28. Programm ein Hinweis vorhanden ist, von wem es ursprünglich mal war (also
  29. von mir:-)).
  30.  
  31. !!!!!
  32. Ich übernehme keine Haftung für Schäden, die aus der sach- oder unsach-
  33. gemäßen Benutzung des Programms entstehen !!!!
  34. !!!!!
  35.  
  36. AutoKosten ist eine MUI-Applikation. MUI ist (c) by Stefan Stuntz.
  37. Nähere Hinweise sind in der Datei Readme.MUI vorhanden.
  38.  
  39.  
  40. Installation des Programms
  41. --------------------------
  42.  
  43. Das Programm benutzt (falls vorhanden) die locale.library, die erst ab
  44. Workbench 2.1 vorhanden ist. Damit können verschiedene Sprachen für die
  45. Benutzeroberfläche verwendet werden. Fest eingebaut ist eine deutsche
  46. Benutzeroberfläche, daher dürfte für einen deutschsprachigen Benutzer 
  47. dieser Punkt nicht so interessant sein. Mitgeliefert wird ebenfalls ein
  48. englisches Catalog-File (CarCost.catalog). Um dies zu benutzen muß es 
  49. nach locale:catalogs/english/CarCost.catalog kopiert und im Locale-Prefs
  50. Englisch als Sprache eingestellt werden.
  51. Ein .cd und .ct-File zur Erstellung eigener Kataloge sollte in diesem
  52. Ordner vorhanden sein. Allerdings wird noch zusätzlich ein Programm zur
  53. Erstellung des .catalog-Files aus diesen Daten benötigt.
  54.  
  55. Weiterhin muß MUI installiert werden (falls das nicht schon geschehen ist).
  56. Die Datei MUIMaster.library muß nach LIBS: kopiert werden.
  57. Die im Ordner Classes/MUI/ enthaltenen Dateien müssen in ein entsprechendes
  58. Unterverzeichnis kopiert werden. Dies ist im Regelfall sys:classes/mui/.
  59. Außerdem muß dieses Unterverzeichnis mit einem assign LIBS: sys:classes/ add
  60. in die Liste der LIBS-Verzeichnisse aufgenommen werden.
  61.  
  62.  
  63. Starten des Programms
  64. ---------------------
  65.  
  66. Das Programm kann sowohl über einen Doppelclick auf das Programmicon
  67. gestartet werden als auch über eine Doppelclick auf ein Icon, das dieses
  68. Programm als Default-Tool enthält.
  69. Nach dem Starten erscheint ein Fenster auf der Workbench (oder einem
  70. anderen Bildschirm), von dem aus das Programm gesteuert wird.
  71.  
  72. Beim Start von der Shell kann ein Filename mit angegeben werden. Diese
  73. Datei wird dann sofort geladen. Bei dem Filenamen braucht die Extension
  74. .KFZ nicht angegeben zu werden.
  75.  
  76.  
  77. Wenn es nicht läuft...
  78. ----------------------
  79.  
  80. Falls eine zum Laufen des Programms nötige Library nicht geöffnet werden
  81. konnte, so meldet sich das Programm mit einem Requester. Ausnahme: Falls
  82. die Intuition.library Version 37 oder höher nicht geöffnet werden konnte,
  83. gibt es keine Meldung.
  84. Falls das Programm kein Fenster öffnen kann, sollte eine entsprechende 
  85. Meldung erscheinen. Mit einem Topaz/8-Zeichensatz läuft das Programm 
  86. allerdings auch auf NTSC-Hires, auf Lores-Bildschirmen wird man das 
  87. Programm nicht zum Laufen bringen...
  88. Sollte keine Meldung erscheinen, so kann man mit 'Exchange' testen, ob das
  89. Programm überhaupt gestartet wurde, bzw. das Programm kann beendet werden.
  90.  
  91.  
  92. Der Hauptfenster
  93. ----------------
  94.  
  95. Im Hauptfenster wird im unteren Bereich die Auswertung angezeigt (gefahrene
  96. Kilometer, getankte Liter, Verbrauch, Kosten (getrennt Treibstoff, Unter-
  97. halt, gesammt) gesammt und je Kilometer).
  98.  
  99. Im oberen Bereich wird angezeigt, für welches Fahrzeug die Daten gelten
  100. und für welchen Zeitraum Daten eingegeben wurden. Außerdem wird der
  101. Name der im Speicher befindlichen Datei angezeigt.
  102.  
  103. Darunter befinden sich zwei Schalter, mit denen man zu den einzelnen Listen
  104. verzweigt.
  105.  
  106. Fenster Treibstoffliste
  107. -----------------------
  108.  
  109. Unter einem großen Bereich, in dem die eingegebenen Daten angezeigt werden
  110. (Datum, Kilometerstand, Preis, Liter, Kilometer seit letzter Tankfüllung
  111. und Verbrauch) befinden sich einige Eingabebereich und Schalter. Die
  112. Eingabebereiche sind zunächst deaktiviert.
  113.  
  114. Mit "Neu" werden die Eingabebereiche aktiviert, ebenso der Schalter 
  115. "Abbruch", der eine Möglichkeit zum Abbrechen der Eingabe bietet. Der Cursor
  116. steht im ersten Eingabebereich (Datum). Wird nach Eingabe eines korrekten
  117. Datums (das Datumsformat ist wählbar, üblich ist tt.mm.yy oder tt-mmm-yy)
  118. und Drücken von RETURN ist der Cursor im zweiten Eingabebereich (km-Stand).
  119. Nach einem Druck auf RETURN im Preis-Eingabebereich wird der Eintrag in
  120. die Liste aufgenommen, WENN ein korrektes Datum eingegeben wurde, sonst
  121. steht der Cursor wieder im ersten Eingabebereich.
  122. Falls ein Datum eingegeben wurde, das bereits in der Liste vorhanden ist,
  123. so wird der Eintrag nicht angenommen (je Tag nur ein Eintrag !!). Sollte
  124. eine Unstimmigkeit in den Kilometerdaten vorhanden sein (erkennbar an
  125. negativen Kilometern seit der letzten Tankfüllung), so wird eine 
  126. entsprechende Meldung ausgegeben, der Eintrag aber angenommen.
  127.  
  128. Nach Anwahl eines Eintrags in der Liste und anschließende Wahl von
  129. "Ändern" löscht den Eintrag aus der Liste und zeigt die Angaben in den
  130. Eingabebereichen an, wo sie korrigiert werden können. Eine Anwahl von
  131. "Abbruch" fügt wieder den alten, unveränderten Eintrag in die Liste ein.
  132.  
  133. Nach Anwahl eines Eintrags in der Liste und anschließende Wahl von
  134. "Löschen" löscht den Eintrag aus der Liste.
  135.  
  136. Anwahl von "Fenster schließen" schließt das Fenster, das Hauptfenster wird
  137. wieder aktiviert.
  138.  
  139. Fenster Unterhaltsliste
  140. -----------------------
  141.  
  142. Dieses Fenster ist vom Aufbau her und der Funktion nahezu identisch mit
  143. dem Fenster für die Treibstoffliste, nur das hier kein Kilometerstand
  144. eingegeben wird, so daß auch kein Fehler in der Liste angezeigt wird.
  145.  
  146. Der Titel und die Bemerkung können bis zu 255 Zeichen lang sein, es werden
  147. aber nur etwa 25 in der Liste angezeigt und ausgedruckt.
  148.  
  149. Fenster Neue Datei
  150. ------------------
  151.  
  152. Nach Anwahl des Menupunktes "Neu" erscheint dieses Fenster erscheint dieses
  153. Fenster, in dem die Daten für den Startzeitpunkt einer Datei eingegeben
  154. werden. Abgefragt werden das Kennzeichen, das Datum, der Kilometerstand
  155. und das Datumsformat (hier wird festgelegt, wie in den Listen ein Datum
  156. eingegeben werden muß).
  157. Für das Datum und den Kilometerstand, der in diesem Fenster eingegeben
  158. wird, darf kein Eintrag in die Treibstoffliste vorgenommen werden !!
  159.  
  160.  
  161.  
  162. Die Menupunkte
  163. --------------
  164.  
  165. - Neu: Es erscheint das oben beschriebene Fenster
  166.  
  167. - Laden: Es wird eine neue Datei geladen.
  168.  
  169. - Speichern (als): Die aktuelle Datei wird abgespeichert.
  170.  
  171. - Drucken: Die aktuelle Datei wird ausgedruckt.
  172.  
  173. - About: Hier gibt es Informationen über das Programm.
  174.  
  175. - Ende: Hier kann das Programm verlassen werden.
  176.  
  177.  
  178.  
  179. Anlegen einer neuen Datei
  180. -------------------------
  181.  
  182. Um immer einen sinnvollen Verbrauch ausrechnen zu können, darf der 
  183. Kilometerstand, der beim Anlegen einer neuen Datei angegeben wurde NICHT
  184. mit den Kilometerstand des ersten Eintrags in der Treibstoffliste über-
  185. einstimmen.
  186. Um dies in der Praxis zu erreichen, geht man am Besten so vor:
  187. - Bei der nächsten Tankfüllung notieren Sie sich nur den Kilometerstand.
  188.   Damit die Verbrauchsdaten immer einigermaßen stimmen, wäre es günstig,
  189.   wenn Sie bei diesem Mal wirklich VOLL tanken würden.
  190.   Diese Tankfüllung wird NICHT in die Treibstoffliste eingetragen !
  191.   Es wird nur Kilometerstand und Datum zu Neuanlegen einer Datei benötigt.
  192. - Alle weiteren Tankfüllungen werden in die Treibstoffliste eingetragen.
  193. - Nach ca. 12 Monaten wäre es günstig, eine neue Datei für das neue Jahr
  194.   anzulegen (Jede Datei sollte dann auch nur z.B. die Versicherungskosten
  195.   für jeweils ein Jahr enthalten).
  196.   Um alle Kosten zu erfassen, tragen Sie die Daten einer Tankfüllung in die
  197.   Treibstoffliste Ihrer aktuellen Datei ein und benutzen den gleichen
  198.   Kilometerstand zum Anlegen einer neuen Datei (und NUR zum Anlegen, nicht
  199.   in die Treibstoffliste eintragen). Alle weiteren Kosten (Tanken, Wartung)
  200.   sollten danach nur noch in die neue Datei eingetragen werden !
  201.  
  202. Wenn Sie mal nicht volltanken, dann stimmt zwar der Verbrauch für diese eine
  203. Tankfüllung nicht, aber wenn Sie bei der letzten Tankfüllung für eine Datei
  204. (mit der Sie gleichzeitig eine neue Datei anlegen) volltanken, dann stimmt
  205. wenigstens der Durchschnittsverbrauch für den gesamten Zeitraum.
  206.  
  207.   
  208. Das Dateiformat
  209. ---------------
  210.  
  211. Ab der Version 3.0 benutzt AutoKosten einfache ASCII-Dateien.
  212. Ein Beispiel sieht so aus:
  213.  
  214. #
  215. 06-Dec-91     5087    22827  4
  216. AA-BB-123
  217. #
  218. 03-Jan-92     5115    23207      33.63      45.00
  219. #
  220. 06-Jan-92     5118      31.00 
  221. ADAC
  222.  
  223. #
  224.  
  225. Zunächst sind zwei Zeilen mit den Startdaten vorhanden, danach kommen
  226. die Zeilen mit den Treibstoffdaten und schließlich je drei Zeilen mit
  227. den Einträgen für die Unterhaltsdaten. Die in der Datei vorhandenen
  228. Datumsangaben im Klartext werden vom Programm nicht benutzt, dieses nutzt
  229. die darauf folgende Zahl (Tage). Die Form des Datums hängt auch noch von
  230. der Einstellung im Neu-Fenster ab.....
  231.  
  232.  
  233. Catalog-Dateien
  234. ---------------
  235.  
  236. Ein .cd und .ct-File sollten in diesem Ordner vorhanden sein. Falls Sie
  237. die Texte des Programms in eine andere Sprache übersetzen wollen, steht
  238. dem (fast) nichts mehr im Wege. Sie brauchen nur noch ein Programm wie
  239. MakeCat oder CatComp, um die ASCII-Datei in ein .catalog-File umwandeln
  240. zu können.
  241. Falls Sie die Texte des Programms in eine andere Sprache übersetzt haben,
  242. so schicken Sie mir doch bitte eine Kopie dieser Übersetzung (das .ct-File),
  243. und schreiben Sie auch gleich dabei, ob ich diese Übersetzung bei folgenden
  244. Übersetzungen mit veröffentlichen darf.
  245.  
  246.  
  247.  
  248. Danksagungen
  249. ------------
  250.  
  251. Ohne einige Personen wäre dieses Projekt so nicht möglich gewesen. Bei
  252. diesen Leuten möchte ich mich hier nochmals bedanken:
  253.  
  254. - Stefan Stuntz, denn ohne MUI wäre die Version 3.0 wohl nicht entstanden.
  255. - Dirk Nehring, der verschiedene Versionen des Programms testete, 
  256.   insbesondere war auf seinem A4000 auch ein Test unter 3.0 möglich.
  257.   Aus seiner Feder stammt auch das Icon (er fand meine Version nicht so
  258.   berauschend...)
  259.  
  260.  
  261. Der Autor
  262. ---------
  263.  
  264. Falls jemand mir noch einen Kommentar zukommen lassen will - hier meine
  265. Adresse, unter der ich gelegentlich zu erreichen bin:
  266.  
  267.                Rüdiger Dreier
  268.                Gustav-Winkler-Str. 40
  269.        D-33699 Bielefeld 
  270.                Deutschland
  271.  
  272. Bis auf Weiteres bin ich auch per EMail erreichbar:
  273.  
  274.  ruediger.dreier@t-online.de
  275.  
  276.  
  277. Die Adresse von Stefan Stuntz (Autor von MUI) ist in der Datei Readme.MUI
  278. vorhanden.
  279.