Autokosten V1.4
---------------

Funktion: Das Programm verwaltet Eintrge, die rund um das Auto entstehen.
	Tankfllungen, Motorlwechsel, Steuer, Versicherung etc. knnen
	eingegeben und vom Programm ausgewertet werden.

Aufruf des Programms:
=====================
Aufruf von der Workbench oder durch den Shell-Aufruf "Autokosten".
Wird das Programm ohne Parameter aufgerufen (nur von der Shell mglich),
so wird die Datei "Daten/Auto.dat" vom Programm Autokosten geladen.
Um eine andere Datei zu laden, mu die entsprechende Datei als Parameter
bergeben werden. Dabei wird vom Autokosten-Programm vor den Dateinamen
das Verzeichnis "Daten/" eingefgt und an den Dateinamen die Kennung
".dat" angehngt.
Beispiel:
   Shell:    "Autokosten Golf"	ruft das Programm mit der Datei
				"Daten/Golf.dat" auf
   Workbench: Golf.info anklicken: bergibt den Parameter "Golf" an das
				Programm und ldt ebenfalls die Datei
				"Daten/Golf.dat"
Die *.info-Dateien sind Project-Icons und mssen als Default-Tool den
Namen des Autokosten-Programms enthalten, also "Autokosten".
An das Autokosten-Programm wird automatisch der Name des Icons (ohne die
.info-Endung) bergeben.
Wenn beispielsweise die Icons Golf.info, Auto.info mit dem
Default-Tool "Autokosten" angelegt werden, so werden beim Anklicken der Icons
das Programm Autokosten mit der dazugehrigen Datei (Daten/Golf.dat
oder Daten/Auto.dat) geladen.
Das Programm und die Daten sind also beispielsweise wie folgt angelegt:

     Autos:Autokosten		<- Autokosten-Programm, der Name mu in den
				   anderen Icons als Default-Tool stehen
     Autos:Golf.info		<- Icon fr "Autos:Daten/Golf.dat",
				   hat als Default-Tool: "Autokosten"
     Autos:MB300SL.info		<- Icon fr "Autos:Daten/MB300SL.dat",
				   hat als Default-Tool: "Autokosten"
     Autos:Daten/Golf.dat	<- diese Datei enthlt die Eintrge fr
				   das Auto (fr einen Golf?)
     Autos:Daten/MB300SL.dat	<- diese Datei enthlt hoffentlich die
				   Daten fr den MB 300 SL


Anlegen einer neuen Datei
=========================
Sicher werden Sie fr Ihr Auto eine eigene Datei anlegen. Kopieren
Sie hierfr das Icon "Kein Name" und geben Sie diesem einen neuen,
der Ihnen am besten gefllt. Starten Sie das Programm Autokosten
jetzt durch Anklicken des neuen Icons.


Bedienung und Beschreibung:
===========================
Um die Funktionen des Programms kennenzulernen, am besten einfach auf die
Schalter klicken und sehen, was passiert. Die Schalter sollten selbst-
erklrend sein. Fr quivalente Tastendrcke siehe die Zusammenfassung unten.
Das Speichern der Daten erfolgt immer automatisch. Wird ein neuer Eintrag
eingegeben, so wird er der Datei angehngt (mit "append", die Datei wird
also nicht komplett neu gespeichert). Wird ein anderer Eintrag gendert,
wird die ganze Datei beim Verlassen des Programms neu gespeichert, wobei
die alte Datei in eine Datei mit der Endung .bak geschrieben wird.


Ein Eintrag in der Autokosten-Datei besteht aus einem Datum, dem Kilometer-
stand, getankte Liter, Kosten, Flag fr Extrakosten und einer Bemerkung,
die bis zu 40 Zeichen lang sein darf.
Die Kosten werden normalerweise als Ausgaben behandelt, da dieses der
hufigere Fall sein wird. Sind Einnahmen einzugeben (beispielsweise beim
Verkauf des Autos oder bei einer Beitragsrckvergtung), so sind den
Kosten ein Minus voranzustellen.
Das Flag fr Extrakosten ist dafr gedacht, bei der bersicht zwischen den
laufenden Kosten und smtlichen Kosten zu entscheiden. Sie knnen bei den
Eingaben entscheiden, ob Sie den Eintrag zu den Extrakosten zhlen mchten
oder nicht (Feld bei der Eingabe: "Extrakosten? (J/N)"). Bei der Ausgabe
steht zwischen den Kosten und den Bemerkungen ein "x", falls der Eintrag
als Extrakosten markiert ist.
Beim berblick werden bei den Gesamtkosten alle Kosten addiert, whrend
bei den laufenden Kosten die Extrakosten nicht bercksichtigt werden.
In den beiden Zeilen darunter werden ebenfalls die Kosten pro Kilometer
einmal mit und einmal ohne Extrakosten berechnet.
Den Kauf eines Autos wrde ich zu den Extrakosten zhlen und Ausgaben fr
den Sprit nicht. Ob Ausgaben fr Versicherung, Steuer, Reparaturen usw.
zu den Extrakosten gezhlt werden oder doch lieber zu den laufenden Kosten,
bleibt Ihnen berlassen.

Mit den Schaltern  |<  <<  <  >  >>  >|  bzw. mit Pfeiltasten (s.u.) kann
man zum Anfang bzw. zum Ende der Eintrge scrollen - sofern mehr Eintrge
vorhanden sind als in das Ausgabefeld passen.

Mit den Schaltern "Ausgabe", "Verbrauch", "Eingabe", "berblick" kann
zwischen den verschiedenen Betriebsmodi gewechselt werden:

"Ausgabe": dieser Schalter ist beim Start des Programms nicht anwhlbar,
   da das Programm mit diesem Modus startet. Ansonsten wird zu der
   normalen Ausgabe der Eintrge gesprungen, so da man sich alle Eintrge
   anschauen kann. Am Anfang einer Zeile steht zur Orientierung die
   Nummer des Eintrags, danach folgen die Felder, die man bei der Eingabe
   selbst belegt hat.
   Klickt man im Ausgabefeld auf einen Eintrag, so wird in den Eingabemodus
   gesprungen und der angeklickte Eintrag kann gendert oder gelscht werden
   oder es kann vor diesem Eintrag ein neuer Eintrag eingefgt werden.

"Verbrauch": Unter Nr erscheint die Nummber des Eintrags.
   Fr den ersten Eintrag, der einen Tankeintrag enthlt wird kein
   Verbrauchswert ermittelt, da kein genauer Bezugspunkt vorhanden ist.
   Die Felder Datum, km (Kilometerstand), Liter und Kosten enthalten die
   eingegebenen Zahlen, whrend die folgenden Felder berechnet werden:
   Pf/l: bezahlte Pfennig pro Liter. Ntzlich zur Kontrolle, ob die
	Zapfsulen richtig zhlen und zur Erinnerung an billigere Zeiten.
   km: gibt die gefahrenen Kilometer zwischen der neuen Tankfllung und dem
	letzten Tanken an
   Verbr: gibt den letzten Durchschnittsverbrauch an, d.h. der Verbrauch
	zwischen der neuen Tankfllung und dem letzten Tanken.
	Die Berechnung ist getankte Liter geteilt durch gefahrenen Kilometer.
	Der berechnete Wert ist natrlich nur realistisch, wenn man
	jedesmal volltankt.
   -Ver: hier steht der Durchschnittsverbrauch aller bis zu diesem
	Zeitpunkt gemachten Tankfllungen.
   -Pf/l: hier stehen die Durchschnittskosten fr einen Liter Sprit vom
	ersten bis zu diesem Eintrag, also was man bislang im Schnitt fr
	einen Liter Sprit bezahlt hat.

	Hat man beispielsweise einmal nicht vollgetankt, so ist der
	berechnete Verbrauchswert zu niedrig und bei der nchsten Voll-
	tankung zu hoch. Um trotzdem einen berblick ber die letzten beiden
	Verbruche zu erhalten, schaut man auf den unteren Teil des Bild-
	schirms mit dem Feld "Die letzten 1,2,...,20 Verbruche". Hier
	werden die Durchschnittsverbrauchswerte der letzten Tankfllungen
	berechnet. Hier werden also die Verbrauchswerte vom letzten Eintrag
	an in Richtung der ersten Eintrge ermittelt, whrend im oberen Feld
	in der Spalte "-Ver" die Verbrauchwerte vom ersten bis zum letzten
	Eintrag berechnet werden.

	Bei Verbruchen ber 99 Liter - kann passieren, wenn man irgendwann
	einmal nicht vollgetankt hat - steht bei der Ausgabe an erster
	Stelle ein Ausrufezeichen. Smtliche Verbrauchswerte werden jedoch
	korrekt berechnet.

"Eingabe": hier werden neue Eintrge angelegt.
   Die Schalter auf der rechten Seite dienen als Hilfe. Mit den Schaltern
   "Motorl gewechselt", "Versicherung" und "Steuer" wird das Feld
   Bemerkung vorbelegt. Bei der bersicht ber alle Eintrge werden zur
   Berechnung der Kosten fr Versicherung und Steuer die Texte im Feld
   fr Bemerkungen herangezogen. Dabei wird nur das erste Wort verglichen,
   so da man die Bemerkungen ergnzen kann, z.B. zu "Versicherung 1993"
   oder zu "Versicherung Beitragsrckvergtung 92".
   Steht als Bemerkung "Motorl gewechselt", so wird der nchste fllige
   Motorlwechsel berechnet, der bei der Ausgabe in der untersten Zeile
   erscheint.

   Reservekanister
   ===============
   Die Schalter "... Reservekanister ..." vereinfachen die Verwaltung
   von Reservekanistern. Im Moment sind 3 Reservekanister vorgesehen, deren
   Inhalte (in Litern) im File "Auto.h" vorbelegt sind.
   Ist ein Reservekanister leer, erscheint als Schalter
   "1. Reservekanister gefllt". Wird der Schalter gedrckt, erscheint im
   Feld Bemerkung "Reservekanister1 gefllt" und im Feld Liter die
   vorbelegte Literzahl. Die Literzahl kann aber nach Belieben gendert
   werden. Im Feld Kosten sollte man den bezahlten Betrag eingeben.
   Das Feld Bemerkung kann noch ergnzt werden, z.B. zu
   "Reservekanister1 gefllt mit Super Plus"
   Besttigt man den "Ok"-Schalter, so gilt der 1. Reservekanister als
   gefllt. Bei zuknftigen Eingaben wird dann der Schalter
   "1. Reservekanister geleert" erscheinen, da man diesen Kanister
   wahrscheinlich erst einmal wieder leeren mu. Nach Anklicken dieses
   Schalters erscheint im Feld Liter die getankte Literzahl. Im Feld
   Kosten sollte nun nichts mehr eingegeben werden, denn einmal bezahlen
   reicht.
   Wieviel Sprit man noch in den Reservekanistern hat, kann man in der
   letzten Zeile bei der Ausgabe erkennen.
   Bei den Verbrauchsberechnungen werden die Reservekanister wie folgt
   bercksichtigt:
   Ist ein Reservekanister gefllt, so wird er bei den Verbruchen nicht
   bercksichtigt. Erst wenn er geleert wurde, wird er bei den Berechnungen
   herangezogen. Die Kosten holt sich das Programm aus dem Eintrag, bei
   dem der Kanister gefllt wurde.

berblick: eine bersicht ber alle Eintrge
   Beim Durchschnittsverbrauch werden hier alle getankten Liter
   einschlielich der Reservekanister addiert und durch die Gesamtfahr-
   leistung dividiert. Auch die anderen Angaben ber den Sprit umfassen
   alle Eintrge einschlielich der Eintrge ber Reservekanister.

Drucken: Ausdrucken der Eintrge bzw. der bersicht, je nachdem, ob man sich
   im normalen Ausgabemodus oder in der bersicht befindet.
   Durch Drcken der rechten Maustaste ber dem Schalter kann eingestellt,
   wohin gedruckt werden soll. Standardmig ist "PRT:" zum Drucken ber die
   Workbench-Preferences eingestellt, es kann aber auch eine Ausgabedatei wie
   z.B. "DF0:Ausgabe" eingegeben werden.
   Beim Ausdrucken der Eintrge werden bis zu 88 Zeichen pro Zeile gedruckt.
   Deswegen sollte am Drucker eine Schrift eingestellt werden, die
   entsprechend viele Zeichen pro Zeile darstellen kann (beispielsweise
   96-Zeichen-Schrift bzw. 12 CPI).

Quit: Verlassen des Programms


Bei "Augabe" und "berblick" befinden sich unter den Schaltern und in der
untersten Zeile weitere Informationen:
- Anzahl der Eintrge
- letzten Kilometerstand
- Pfennig pro Kilometer aus Gesamtkosten durch gefahrene Kilometer
- Durchschnittsverbrauch: ermittelt aus getankten Litern durch gefahrene
    Kilometer, wobei geleerte Kanister mitbercksichtigt werden.
    Dieser Durchschnittsverbrauch kann sich vom Durchschnittsverbrauch
    beim berblick unterscheiden, da dort die noch gefllten Kanister
    bercksichtigt werden, whrend hier die Kanister erst in die
    Berechnung einflieen, wenn sie auch geleert wurden.
    Da hier auch der erste Eintrag bercksichtigt wird, unterscheidet sich
    dieser Durchschnittsverbrauch vom letzten Durchschnittsverbrauch, der
    in der Verbrauchsliste nach Anklicken des Schalters "Verbrauch"
    erscheint.
- Gesamtkosten aller Eintrge
letzte Zeile:
- wann der nchste lwechsel fllig ist oder war. Die lwechselintervalle
  stehen in der zweiten Zeile in der Datei, in der sich die ganzen Daten
  befinden (z.B. in "Daten/Golf.dat"). Diese Zeile kann direkt editiert
  werden.
- wieviel in den Reservekanistern ist.


Direkt ber den Schaltern befindet sich eine Titelzeile, die durch
Anklicken aktiviert und gendert werden kann.


Anlegen einer neuen Datei:
==========================
Zum Anlegen einer neuen Datei ruft man das Programm entweder so auf:
Autokosten NeueDatei	nach Anklicken des Eingabe-Schalters wird vom
			Programm zunchst ein Titel bzw. eine berschrift
			gefordert, anschlieend erfolgt die normale Eingabe
			der Eintrge. Bei Verlassen des Programms wird die
			Datei "Daten/NeueDatei.dat" gespeichert.
Man kann auch die Info-Icons kopieren:
copy Golf.info NeueDatei.info

Alle Daten werden im Text-Format in den Dateien (z.B. "Auto.dat") gespeichert,
d.h. die Dateien knnen auch direkt editiert werden.


Zusammenfassung der Bedienung:
==============================
Fast alle Funktionen sind ber Gadgets und Tastatur aufrufbar:

Schalter	Tastatur		Funktionsbeschreibung

|<		Shift + Pfeil oben	zeigt Eintrge ab dem ersten
<<			Pfeil oben	scrollt mehrere Eintrge zurck
<			Pfeil links	scrollt einen Eintrag zurck
>			Pfeil rechts	scrollt einen Eintrag vor
>>			Pfeil unten	scrollt mehrere Eintrge vor
>|		Shift + Pfeil unten	zeigt die letzten Eintrge bei
					normaler Ausgabe und scrollt bis zum
					letzten Eintrag bei der Verbrauchs-
					ausgabe

Ausgabe			a		Eintrge normal ausgeben
Verbrauch		v		Verbruche berechnen
Eingabe			e		neuen Eintrag eingeben
berblick				bersicht ber alle Kosten
Drucken			d		Eintrge bzw. bersicht drucken
Drucken (RMB) 		D		Druckdatei ndern (default "PRT:")
Quit			q		Programm beenden, wobei die Daten
					automatisch gespeichert werden
Close-Gadget		ESC		wie Quit

Klick mit linker Maus-			ermglicht ndern oder Lschen des
taste auf einen Eintrag			angeklickten Eintrags oder das
im Ausgabefeld (nur bei			Einfgen eines neuen Eintrags vor
normaler Ausgabe)			dem angeklickten Eintrag


Bedienung bei der Eingabe von Eintrgen:
========================================
linke Maustaste:	springt in die entsprechende Zeile oder
			beendet Eingabe bei Anwahl des "OK"-Feldes
Pfeil links / rechts	Cursor zurck / vor
Pfeil hoch / runter	Zeile hoch / runter
RETURN			springt eine Zeile weiter oder
			beendet im "OK"-Feld die Eingabe
"Eintrag lschen"	neuer Eintrag wird nicht eigefgt

"Reservekanister ..."	verndert mehrere Felder des Eintrags entsprechend
			des angeklickten Textes
"Motorl gewechselt"	schreibt entsprechenden Text als Bemerkung
"Versicherung"				"
"Steuer"				"

Bedienung bei der nderung von Eintrgen:
=========================================
wie bei Eingabe von Eintrgen, jedoch:
"Eintrag lschen"	der angezeigte Eintrag wird gelscht
"Eintrag einfgen"	vor dem angezeigten Eintrag wird ein Eintrag
			eingefgt
