home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Club Amiga de Montreal - CAM
/
CAM_CD_1.iso
/
files
/
632.lha
/
KCommodity_v1.63
/
KCommodity.Dok.pp
/
KCommodity.Dok
Wrap
Text File
|
1992-05-13
|
42KB
|
931 lines
*****************************************************************************
K K CCCC OOO M M M M OOO DDDD I TTTTT Y Y
K K C O O MM MM MM MM O O D D I T Y Y
KK C O O M M M M M M M M O O D D I T Y
K K C O O M M M M M M O O D D I T Y
K K CCCC OOO M M M M OOO DDDD I T Y
*****************************************************************************
KCommodity V1.63
eine multifunktionale commodity für den Amiga unter OS 2.0.
*****************************************************************************
*****************************************************************************
KCommodity V1.63 ist ShareWare.
An all diejenigen, die mein Programm mögen und regelmäßig im Einsatz
haben, möchte ich um eine kleine Gabe um die 20.-DM oder $20 bitten.
(Die Adresse kann man ganz unten im Dokument finden.)
Ich denke, daß diese Sharegebür angebracht ist, da ich den kompletten
Quelltext mitliefere und es KEINE Demoversion ist. Der Vorteil des
eines Bezahlens der Sharegebühr liegt darin, daß registrierte Benutzer
sofort jede neue Version des Programms bekommen, sowie eine schönere
Anleitung.
Aber egal, wer auch immer etwas loswerden will kann es loswerden.
Etwas anderes : ICH ÜBERNEHME KEINERLEI VERANTWORTUNG FÜR JEGLICHE
SCHÄDEN, DIE WÄHREND DER BENUTZUNG VON KCOMMODITY
AUFTRETEN SOLLTEN. DIESES PROGRAMM WURDE GETESTET UND
ICH BENUTZE ES TÄGLICH. TROTZDEM IST KEIN PROGRAMMIERER
VOR FEHLERN GEFEIT, DIE ER PRODUZIEREN KÖNNTE. ALSO
STELLEN SIE NICHT MICH AN DEN PRANGER. (SONDERN MURPHY)
An alle Vertreiber von Public Domain, FreeWare, ShareWare, GiftWare
Software, die mehr als 10 DM für ihre Disketten verlangen sei nur dies
gerichtet : Laßt eure Finger von diesem Programm. Diese Art der
Distribution ist nicht sonderlich hilfreich diese Art der Software am
Leben zu erhalten.
Ich habe den kompletten Source zu KCommodity beigefügt. Er wurde in
Assembler erstellt und es liegen auch alle Includes vor, die sicherlich
keiner haben kann, da sie von mir sind.
Sie können dieses Programm an jeden weitergeben, der es haben will,
solange Sie keinen Profit daraus schlagen und die Files alle vorhanden
sind.
Das Programm wurde mit dem DevPac Version 3.01 geschrieben. Diese
Version von KCommodity kann NUR unter DevPac V3.01 assembliert werden,
da einige OpCodes vorliegen, die nur DevPac V3.01 "versteht".
****************************************************************************
Was eigentlich ist KCommodity V1.63 ?
-------------------------------------
Das Programm verbindet einige kleine Sachen, die sicherlich hilfreich
sein können bei Ihrer alltäglichen Arbeit am Amiga.
Als erstes ist da der Window-Activator von KeyActivate (von dem
KCommodity herstammt), der mer macht, als die gewöhnlichen Programme
dieser Art (wie AutoPoint). Diese Programm haben alle das gleiche
Problem : Sie deaktivieren ein aktiviertes StringGadget, falls die
Maus außerhalb des Windows bewegt wird. Dies war ein "Fehler", mit dem
ich nicht leben konnte, also schrieb ich KeyActivate, das diese Sache
weit, weit hinter sich ließ.
So glücklich über das, was ich erreicht hatte unter dem neuen
Betriebssystem habe ich weitergearbeitet, um eine flexiblere, kürzere
commodity. Da ich einige Tools auf meinem Computer laufen habe, dachte
ich, es sei eine gute Idee, wenn all diese Tools (oder einige davon)
in eine kleine, effiziente commodity gepackt würden, so daß ich nicht
mehr dutzende von Tools starten muß. Der andere Vorteil ist der, daß
ich all das haben kann, was ich will und das die Routinen so aussehen,
daß sie meinen Ansprüchen genügen können. Also wurde KCommodity
größer und größer und die Tools weniger und weniger.
Und hier ist es : KCommodity V1.63
Installation von KCommodity V1.63
---------------------------------
Kopieren Sie KCommodity einfach in ein Directory Ihrer Wahl und
das mitgelieferte KCXPREFFILE in ENVARC:. Dieses File stellt die
Standardkonfiguration dar.
Falls Sie die Online-Hilfe von KCommodity nutzen wollen, so kopieren Sie
das KCX Verzeichnis nach ENVARC:
Aktivierung von KCommodity V1.63
--------------------------------
- Falls Sie KCommodity während des Bootvorgangs starten (WBStartUp),
so dürfen Sie das DONOTWAIT ToolType nicht vergessen. Das
mitgelieferte icon hat alle ToolTypes, die KCommodity kennt, gesetzt
mit den Standardwerten.
- Vom CLI/SHELL müssen Sie KCommodity mit RUN/RUNBACK starten.
Egal, wie sie KCommodity starten, es wird immer erst das Preferences-
file eingelesen und dann die ToolTypes, d.h. die ToolTypes überschreiben
die eingelesenen Voreinstellungen.
Falls das NOICON ToolType nicht gesetzt ist, so wird das AppIcon
dargestellt. Wenn Sie nun auf dieses icon clicken, so wird das
Hauptwindow geöffnet. Die gleiche Reaktion erreichen Sie, wenn sie
den neuen Menüpunkt "KCX Main-Window" aktivieren.
Beenden von KCommodity
----------------------
Es gibt einige Wege KCommodity zu beenden.
- Zum einen das QUIT gadget oder die 'Q'-Taste im Hauptwindow.
- KCommodity ein weiters Mal starten.
- Unter Benutzung des Exchange-Programms.
Egal, wie Sie sich entscheiden es wird eine kurze Weile dauern, bis
sich KCommodity entgültig verabschiedet hat, da einige noch laufende
IORequests am Laufen sein könnten.
Aktionen, die KCommodity ausführen kann
---------------------------------------
- Windowaktivierung -
Es kann zwischen Tastatur- und Mausmodus gewählt werden.
- Zeitanzeige -
Hier gibt es verschiedene Optionen.
Anzeige der Zeit mit/ohne Sekunden.
Anzeige des Datums in englischer oder deutscher Notation
Anzeige des Wochentages entweder in voller Länge oder nur mit
drei Zeichen.
Alle Optionen können miteinander kombiniert werden, aber sobald
Sie die Zeitanzeige aktivieren wird immer die aktuelle Zeit
(Stunde:Minute) gezeigt werden.
Es gibt außerdem noch eine Onlinezeit, die angibt, wie lange Sie
mit Ihrem Modem online waren.
Durch Druck des Page-HotKeys (RALT HELP) kann zwischen
einzelnen Anzeigen geschaltet werden (Zeit<->Speicher)
- Speicherverbrauch -
Anzeige des freien Speichers entweder für Chip-/Fast-Memory getrennt,
als totaler, freier Speicher oder in graphischer Darstellung.
- Alarmfunktion -
Die Alarmzeit kann mit oder ohne Sekunden angegeben werden, aber Sie
müssen mindestens Stunde/Minute eintragen. Kann abgeschaltet werden.
- Environment Variablen -
Die aktuelle System-Zeit , d.h. Tag (volle Länge), Datum (entweder
in englischer oder deutscher Notation) und Zeit werden in drei
globale Environment Variablen geschrieben : DAY, DATE, TIME.
- Revision Control System -
Hilft Ihnen bei der Entwicklung von Programmen, indem das System
Ihnen die Möglichkeit bietet Kommentare über die Veränderungen an
einem Programm direkt in den Source zu speichern. Das System
aktualisiert die Revisionsnummer, bzw. setzt eine von Ihnen
vorgegebene ein. Diese Nummer und das Datum der Revision werden
in Defines gespeichert, so daß Sie sie in Ihren Programmen benutzen
können.
- Screen/Mouse Blanker -
Timeouts können in einer Spanne von 1-999 Sekunden definiert werden.
Falls eine Taste gedrückt wird, so wird der Mousepointer automatisch
ausgeschaltet.
- Window-Cycling -
Diese Funktion dient zum einfachen "Nach vorne/hinten bringen" von
Windows, ohne die Tiefen-Gadgets eines Windows zu betätigen.
Die linke Maustaste in Verbindung mit einer weiteren Taste bringt
das Window nach vorne, die rechte Maustaste bringt das Window nach
hinten.
- Tastatur-Click -
Wie auf professionellen Tastaturen üblich, so erklingt hier ein
kleiner Click, wenn eine Taste gedrückt wurde.
- Telefonabrechnung -
Berechnet Ihnen die Kosten, die Sie von schwere Modemaktivitäten
erwarten können.
- LeftyMouse Option -
Vertauscht linke und rechte Maustaste für Linkshänder.
- ESC Windowschließtaste -
Windows, die über eine CloseGadget verfügen können nun durch
Druck auf die ESC-Taste geschlossen werden, ohne das CloseGadget
zu berühren. Es kann auch ein Qualifier definiert werden, der
zusätzlich gedrückt werden muß, um die Aktion auszuführen.
Jegliche StringGadgets, die zu diesem Zeitpunkt aktiv sein
könnten werden erst deaktiviert.
- Shell-Start durch HotKey -
Starten einer Shell mit Ihren eigenen Parametern durch Druck
eines HotKeys. Dieser HotKey ist nach Voreinstellung :
ALT SHIFT S
- Umsetzung deutscher Umlaute -
Dies ist nützlich für die deutschen "modem freaks" von Ihnen.
Sie wissen, daß deutsche Umlaute in internationalen EchoMail
areas nicht erlaubt sind, sogar in einigen deutschen areas.
Daraus ergibt sich eine "Erschwerung" des Schreibens eines
Textes, der deutsche Umlaute enthält, da sie zwei an Stelle
eines Zeichens tippen müssen.
Diese Funktion setzt die deutschen Umlaute in "normale"
Zeichen um.
Wie wird mit KCommodity umgegangen ?
------------------------------------
Als erstes "versteht" KCommodity ToolTypes, die von dem CLI/SHELL genauso
benutzt werden, wie sie auch im icon Anwendung finde.
Diese sind :
ToolType Beschreibung Voreinstellung
------------------------------------------------------------------
CXPRIORITY=n Priorität des Brokers 5
CXPOPKEY=s PopUpKey für das Window LCOMMAND HELP
CXPOPUP=YES|NO PopUp beim Start NO
PORTNAME=s Name des ARexx-Ports KComm.1
TOOLPRI=n Priorität des Programms 21 (Muß > 21 sein)
NOICON AppIcon nicht anzeigen ---
Spezielle infos über den Umgang mit KCommodity`s StringGadgets
--------------------------------------------------------------
Jedes Fenster von KCommodity (ausser das kleine Statuswindow und das
Logwindow) besitzt ein Menü. Die meisten (oder sogar alle) MenuItems besitzen
ein Tastaturkürzel. Normalerweise mußten Sie sonst das StringGadget
deaktivieren, um eines dieser Kürzel zu benutzen. Nicht mit KCommodity.
Benutzen Sie einfach den Shortcut, den sie habe wollen und KCommodity führt
die Aktion aus, die Sie habe wollten :-) Falls nötig wird das programm dann
das StringGadget wieder reaktivierens. Dise zwei MAGISCHEN Kürzel RECHTE
AMIGA X/Q, die mit Editierfunktionen in StringGadgets belegt sind könnten
für Menu-Shortcuts gebraucht werden. Um diese beiden trotzdem aufzurufen (wie
die anderen) müssen Sie einfach den Shortcut in Kombination mit einer
SHIFT-Taste benutzen (z.B. RAMIGA-SHIFT-Q, um KCommodity zu beenden ...
wagen Sie sich). Es gibt aber noch mehr Funktionen von KCommodity für
das Editieren von StringGadgets.
- Das nächst-mögliche String/Integer-Gadget wird nach RETURN aktiviert.
- Das vorherige String/Integer-Gadget wird nach SHIFT-RETURN aktiviert.
- Druck von ESC bewirkt das gleiche, wie ein Druck auf die HELP-Taste ->
Das String/Integer-Gadget wird verlassen, ohne das nächste zu aktivieren.
- Wie gesagt -> Menü-Shortcuts direkt aus String/Integer-Gadgets.
- CURSOR HOCH/RUNTER, um in das letzte/nächste String/Integer-Gadget zu
gelangen.
- CONTROL CURSOR LINKS/RECHTS, um zum vorherigen/nächsten Wort zu gelangen.
Standard Editiermodi stehen auch zur Verfügung :
- TAB aktiviert das das nächst-möglich String/Integer-Gadget
- SHIFT-TAB macht das Gegenteil.
- HELP, um String/Integer-Gadgets zu verlassen.
- RECHTE-AMIGA-X löscht den Eingabepuffer.
- RECHTE-AMIGA-Q restauriert den vorherigen Eingabepuffer.
Online-Hilfe Funktion von KCommodity
------------------------------------
Wenn Sie HELP in einem der angeführten Windows drücken, so wird ein kleiner
Hilfetext angezeigt, der die Funktion des Windows beschreibt.
Hauptwindow, Bill window, Preferences window and HotKeys window
Da diese Windows ein Menü besitzen gibt es eine weitere Möglichkeit Hilfe
zu bekommen :
Positionieren sie Ihre Maus über dem Menü-Punkt, für den Sie Hilfe haben
möchten und drücken Sie die HELP-Taste. Das Hilfe window öffnet sich.
Im Help window können Sie durch den Hilfetext scrollen, entweder unter
Benutzung des Gadgets auf der rechten Seite, oder der Cursor Tasten.
Die Cursor Tasten sind wie folgt belegt :
CUROSR UP Eine Zeile hoch
CUROSR DOWN Eine Zeile runter
SHIFT-CURSOR UP Eine Seite hoch
SHIFT-CURSOR DOWN Eine Seite runter
Konfiguration KCommoditys während der Laufzeit.
-----------------------------------------------
Drücken Sie einfach den PopUp-HotKey (Voreinst. : LCOMMAND HELP),
clicken Sie das AppIcon an, selektieren Sie den
Menüpunkt "KCX Main-Window" im Tools-Menü der Workbench, oder
aber das SHOW Gadget des Exchange Programms. Ein Window mit einigen
wird Gadgets wird erscheinen.
- Window activate Ein-/Ausschalten der Windowaktivierung.
- MouseMode Ein-/Ausschalten der Windowaktivierung durch die Maus.
Ausgeschaltet bedeudet, daß eine Taste ein Window
aktiviert.
- Display clock/mem Einschalten der Zeit/Speicher Anzeige.
- Display in window Anzeige von Zeit/Speicher in einem Window.
- Show secondz Anzeige von Sekunden.
- Show date Anzeige des Datums.
- American date Datum in englischer Notation.
- Show day Anzeige des Tags.
- Short day string Nur drei Zeichen für die Tagbezeichnung.
- Alarm on Aktiviert Alarmfunktion.
- Key-Click Aktiviert Tastatur-Click.
- Write environment Tag, Datum und Zeit in Environment Variablen
DAY, DATE und TIME ablegen.
- Window cycling Aktiviert Window-Cycling.
- WB to front Im aktivierten Status gibt es an, daß die
Workbench nach vorne gebracht werden soll, wenn
das Kontroll-Window geöffnet wird.
- LeftyMouse Aktiviert LeftyMouse Option.
- ESC WindowClose Aktiviert ESC-Schließ Option.
- "Map Umlauts" Aktiviert/Deaktiviert die Umlautumsetzung
- Win Qualifier Definiert einen von vier Qualifiern, die in Verbindung
mit den Maustasten benutzt werden müssen, um ein
Window nach vorne/hinten zu bringen. Der Qualifier, der
zu sehen ist ist der aktuelle. Die linke Maustaste dient
zum Bewegen des Windows nach vorne, die rechte Taste zum
Bewegen nach hinten.
- ESC Qualifier Wie oben, nur daß hier der Qualifier für das Schließen
von Windows in Verbindung mit der ESC-Taste gemeint ist.
Sie können unter fünf Qualifiern wählen.
BEI CLI-WINDOWS : BENUTZEN SIE NIEMALS DIESE FUNKTION,
SOLANGE EIN PROGRAMM IHR CLI/SHELL
BLOCKIERT.
- Alarm time Hier können Sie die Alarmzeit eintragen. Sie müssen
mindestens die Stunden:Minuten eintragen. Fehler bei
der Eingabe führen zu einer Rücksetzung auf die zuletzt
eingegebene Zeit.
- User Shell Hier können Sie optionale Parameter eingeben, die in
Verbindung mit der NewShell-Funktion benutzt werden
sollen.
- Screen time Hier können Sie den Timeout für den ScreenBlanker
einstellen. Werte zwischen 1-999 Sekunden werden
akzeptiert. Eine Eingabe von 0 Sekunde bewirkt die
Deaktivierung des ScreenBlankers. Falsche Werte
führen zur Rücksetzung auf den letzten Wert.
- Mouse time Wie oben, nur für den MouseBlanker.
- Click vol Sie können hier die Lautstärke des Tastatur-Klicks
einstellen. Falsche Werte ( < 0, > 64 ) führen zu
einer Rücksetzung auf den alten Wert.
- Telefone bill... Das Window für die laufenden Kosten eines Telefonats
wird geöffnet. Änderungen ein Zeitzonen und Tarifen
können hier gemacht werden.
- Telefone prefe .. Es wird ein Window geöffnet, in dem Sie die
Voreinstellungen für die Zeitzonen und Tarife, sowie
für die Kosten einer Einheit festlegen. Sie können auch
ein neues Logfile wählen, in dem die Gebühren
gespeichert werden sollen, sowie eine Abrechnung abrufen.
- HotKeys... Das HotKeys Window wird geöffnet.
- Load Prefs... Sie können hier eine neue Konfiguration laden.
- Save Prefs... Die aktuelle Konfiguration kann gespeichert werden.
- Enable KCommodity`s Broker aktivieren.
- Disable KCommodity`s Broker deaktivieren (ACHTUNG : Alle HotKeys
sind nun auch deaktiviert. Sie müssen das Exchange
Programm, das AppIcon oder den Menüpunkt benutzen, um
an das Kontroll-Window zu kommen.)
- Hide Das Kontroll-Window schließen.
- Quit KCommodity beenden.
- CLOSEGADGET Wie Hide.
Alle Gadgets können auch durch einen Tastendruck selektiert werden.
Die Taste für ein Gadget ist durch einen Unterstrich im Gadgettext
gekennzeichnet. Alternativ können Sie auch die Gadgets über Menüs
erreichen, oder deren ShortCuts.
Solange ein KCommodity Window geöffnet ist merkt sich das Programm die
Position des Windows, so daß es beim nächsten Öffnen wieder an dieser
Stelle positioniert wird.
Die Menüs des KCommodity Hauptwindows
-------------------------------------
- Project
- Load Preferences... Neue Preferences für KCommodity laden.
- Save Preferences Augenblickliche Preferences in ein File
schreiben, das entweder durch
"Save preferences as..." angegeben wurde, oder
dem voreingestellten entspricht : ENV:KCXPREFFILE.
Falls Sie die Preferences permanent behalten
wollen, so müssen Sie "Save preferences as..."
benutzen.
- Save Preferences as... Angabe eines neuen Namens für das Preferences
File und Abspeichern unter diesem.
- Enable Gleiche Funktionen wie oben beschrieben.
- Disable
- Hide
- About... Zeigt ein kleines "about" und gibt Ihnen die
Möglichkeit ein Registrations-Formular auf
PRT: auszudrucken.
- Quit Raten Sie mal !!!
- Enable/Disable
Dies sind Menü-Alternativen zu den ShortCuts der Gadgets. Sie haben
die gleichen ShortCuts, wie die Gadgets selbst.
- Other settings
Sie können hier StringGadgets über die Menüs aktivieren.
- Windows
Öffnen der einzelnen KCommodity-Windows.
Das HotKeys Window
------------------
Es werden 6 StringGadgets gezeigt, die die Möglichkeit bieten die HotKeys
von KCommodity zu ändern. Geben Sie hier einfach die neuen HotKey-
Definitionen ein. Falls Ihr HotKey nicht benutzt werden kann, so nimmt
das Programm automatisch den letzten.
ACHTUNG : Beachten Sie andere Programme, die auch HotKeys benutzen, so daß
es hier zu keinen Fehlern kommen kann.
HotKey-Definitionen
-------------------
Hier ist eine Liste der Beschreibungstexte für die Definition von HotKeys.
Geben Sie diese einfach ein, wie sie wollen, da sie case-insensitive
gehandhabt werden. Es gibt folgende Formen :
[<qualifier> [<qualifier>...]] <code>
Qualifier
alt eine Alt-Taste
ralt rechte Alt-Taste
lalt linke Alt-Taste
shift eine Shift-Taste
rshift rechte Shift-Taste
lshift linke Shift-Taste
capslock Caps Lock Taste
rcommand rechte Amiga-Taste
lcommand linke Amiga-Taste
control Control-Taste
numericpad Benutzung der Zehnertastatur
rbutton Click der rechten Maus-Taste
midbutton Click der mittleren Maus-Taste
linkebutton Click der linken Mazs-Taste
newprefs Preferences wurden geändert
diskremoved Disk entfernt
diskinserted Disk eingelegt
Tasten
a .. z, 0 .. 9, etc. Normale-Tasten
f1 .. f10 F-Tasten
up, down, left, right Cursor-Tasten
help Help-Taste
del Delete-Taste
return Return-Taste
enter Enter-Taste (numericpad muß gesetzt sein)
backspace Backspace-Taste
esc Escape-Taste
space Space-Taste
comma Comma-Taste
upstroke Tilde-Taste
Das Revision Control System
---------------------------
Dies ist mein Liebstes :-)
Während man an einem Programm arbeitet möchte man doch hin und wieder
wissen, was dann und dann geändert wurde sei seiner letzten Veränderung.
Daher dürfte ein Revision Control System sehr hilfreich sein diese
Daten zu speichern. Und hier setzt KCommodity`s System an.
Stellen Sie sich vor, sie hätten eine neue, ganz tolle Funktion in Ihr
Programm aufgenommen und Sie wollen die Informationen, über das, was
Sie getan haben, in Ihrem Sourcecode verankert sehen, so daß Sie sehen
können, wie die Entwicklung Ihres Programms von Version zu Version
fortschritt. Diese Information (Log message) per Hand einzugeben ist
sicherlich nicht das gelbe vom Ei und wäre es nicht schön, wenn dies
ein Programm für Sie täte ? Genau das macht ab heute KCommodity für Sie.
Und noch mehr : Es erhöht die aktuelle Revisionsnummer jedes Mal, wenn
Sie KCommodity mit dem Sourcecode "füttern" und schreibt diese Nummer
in ein define/Macro, so daß sie die Zahl z.B. im Versionstring "$VER:..."
benutzen können und das Programm VERSION Auskunft geben kann.
Wie wird es benutzt ?
Diese Funktion kann nur über ARexx angesprochen werden.
Die Syntax ist :
REVISE FileName (ASM|C|PAS)
Also geben Sir nur einen Filenamen und eine Identifikation (ASM für
Assembler, C für `C' oder PAS for Pascal Quelltexte) und schon beginnt
KCommodity mit der Arbeit.
Als erstes prüft das Programm, ob bereits ein header angelegt wurde.
Dieser Header muß nicht zwingend am Anfang des Textes stehen, er kann
vielmehr innerhalb der ersten 15 Zeilen des Textes beginnen. Sie können
also einige wichtige Informationen am Anfang Ihres Sources ablegen.
Hatte KCommodity keinen Header finden können, so öffnet KCommodity ein
Fenster, in dem nach einer Purpose Message (Nachricht über den Zweck des
Programmes) verlangt. Diese Message kann bis zu 5 Zeile a 75 Zeichen
haben. Geben Sie hier einfach eine Message Ihrer Wahl ein.
Wenn Sie RETURN drücken, so wird das nächste StringGadget aktiviert.
Falls es das letzte war, so wird wieder das erste aktiviert. Sie können
Sie können die HELP-Taste verwenden, um aus einem String-/IntegerGadget
zu kommen, ohne das nächste zu aktivieren.
Durch Druck der TAB-Taste können sie durch die String-/IntegerGadgets
abwärts blättern. SHIFT-TAB macht das Gegenteil.
Die beiden IntegerGadgets am unteren Rand des Windows dienen dazu,
eine Revisionsnummer einzugeben, mit der begonnen/fortgefahren werden soll.
Geben Sie hier einfach die neue Nummer ein und KCommodity wird sie
richtig benutzen. Falls Sie die Vorgabe nicht verändern, oder 0.0
eingeben, so wird KCommodity 1.0 (für die erste Revision) benutzen,
oder mit der nächst höheren Revision fortfahren (1.0 -> 1.01).
Haben Sie nun die Eingaben beendet können Sie durch Anwahl des
CANCEL-Gadgets, der C-Taste, des CLOSE-Gadgets, oder der ESC-Taste das
System abbrechen. Andererseits können Sie durch Anwahl des OK-Gadgets,
der O-Taste fortfahren.
KCommodity beginnt nun damit den Header aufzubauen.
Er wird mit einer Standard Log Message (wird "initial release" sein),
der Purpose Message (ohne Leerzeilen, die Sie evtl. eingegeben haben)
und natürlich mit dem ersten define für Ihr "$VER:..." gefüttert.
Nach der Revisionsnummer folgt dann ein define/Macro für das
Revisionsdatum, das Sie dann in Ausgaben Ihres Programmes
benutzen können. Der restliche Teil Ihres Quelltextes wird nun
einfach an das "neue" File angehängt.
KCommodity sichert das Resultat seiner Kreation in einem
temporären File in T:, also halten Sie genügend Platz in auf Ihrer
(RAM)-Disk haben und das T: richtig assigned ist.
Nachdem KCommodity mit seiner Arbeit fertig ist, so wird das
temporäre File auf das originale File kopiert und danach gelöscht.
Revision eines bereits revidierten sources :
Und wieder sucht KCommodity den Header in der angegebenen Sprache
in den ersten 15 Zeilen.
Hatte das Programm Erfolg wird ein Log Message window geöffnet.
(Bei Nichterfolg wird der Purpose Message Teil abgearbeitet)
Die Kontrolle über dieses Window erfolgt in der selben Art und Weise,
wie beim Purpose Message Window. Nach Ihren Eingaben legt KCommodity
wieder los.
Die Revisionsnummer wird erhöht (bzw. es nimmt die von Ihnen angegebene),
fügt die LogMessage vor der letzten ein und aktualisiert die defines,
so daß nun die aktuelle Revisionsnummer und das aktuelle Datum
verfügbar sind.
ACHTUNG : Falls der erste define nicht vorgefunden werden kann, bzw.
nicht direkt nach dem Header folgt, so "denkt" KCommodity,
daß Sie die defines nicht mehr wollen und fährt fort,
ohne defines zu aktualisieren.
Zu guter Letzt wird der Rest des originalen Files angehängt,
das temporäre File auf das Original kopiert und dann das
temp-file gelöscht.
So würde ein Revision Header in Assembler aussehen :
(mit Revision 1.01, d.h. eine Veränderung wurde seit initial release
gemacht. Revision fand am 05-Jan-92 statt)
;
; Maximum von 14 Zeilen über dem Header erlaubt (nach Erstellung des Headers)
;
;* $Revision Header built by KCommodity by Kai Iske *** (do not edit) **********
;*
;* Copyright by <COMPANY>
;*
;* File : <this would be the name of the file>
;* Created on : Sunday, 05-01-92 02:27:25
;* Created by : <AUTHOR>
;* Current revision : V1.01
;*
;*
;* Purpose
;* -------
;* This is just a test for the purpose string
;* and a second line
;*
;* Revision V1.01
;* --------------
;* changed on Sunday, 05-01-92 02:27:45 by <AUTHOR>. LogMessage :
;* And a test for a LogMessage
;* second line
;* third line
;*
;* Revision V1.00
;* --------------
;* --- Initial release ---
;*
;*******************************************************************************
REVISION MACRO ; This is the macro for the revision number
dc.b "1.01"
ENDM
REVDATE MACRO ; This is the macro for the revision date
dc.b "05-Jan-92"
ENDM
;
; This is where your program might start
;
Benutzen Sie einfach die macros in Ihrem Source. Eine Implementation
könnte so aussehen :
dc.b "This is my program V"
REVISION
dc.b " created on ("
REVDATE
dc.b ")",0
Vergessen Sie nie ein 0-Byte am Ende des Strings.
ACHTUNG VORHERIGE BENUTZER :
Sie müßen das Layout Ihrer alten defines ändern, so daß
KCommodity diese erneuert. Also ändern Sie diese einfach so, daß
sie den neuen entsprechen.
Die defines für C und Pascal Sources haben die selben Namen und werden
auch in gleicher Weise gehandhabt.
ACHTUNG PASCAL SOURCE :
Um die defines verfügbar zu machen setzt KCommodity die CONTS-Direktive
direkt hinter den Revision Header. Demnach müßen Sie alle weiteren
Konstanten hinter die von KCommodity angelegten schreiben. Ansonsten
würde Ihr Source "verdreht" werden.
Um die <COMPANY> und <AUTHOR> Felder gefüllt zu bekommen müssen Sie
zwei Environment Variablen setzen, wie z.B. :
SetEnv COMPANY "My Company"
SetEnv AUTHOR "Hey that`s me"
Falls eine, oder beide Variablen nicht gefunden werden konnten, so
besetzt KCommodity die entsprechenden Felder mit "--- Unknown ---".
Falls Sie CANCEL in Purpose/LogMessage Window benutzt hatten, so
wird REVISE FALSE (0) in der ARexx-Variablen RESULT zurückliefern.
Falls Sie OK gedrückt hatten, so erhalten Sie TRUE (1).
Dadurch können Sie entscheiden, ob Sie mit dem ARexx-Script
fortfahren sollen, oder nicht.
Also haben Spass an dieser Einrichtung von KCommodity, die Ihnen
hilft die Revisionen im Auge zu behalten.
Telefonabrechnung
-----------------
Diese Funktion wurde auf zwei Windows verteilt, die Sie über die
"Telefone bill..." / "Bill preferences..." Gadgets erreichen können.
Nun zu den Preferences.
Dieses Window zeigt sechs IntegerGadgets dicht beieinander.
Zwei in einer Reihe repräsentieren normalen und billigen Tarif einer
der drei Zeitzonen, die KCommodity verwaltet. Geben Sie hier einfach
die Anzahl der Sekunden ein, die Sie haben wollen.
Zum Beispiel die Einstellungen der aktuellen Tarife in Deutschland.
Wir haben drei Zeitzonen (aus diesem Grund handhabt KCommodity auch
nur drei) und zwei Tarife.
Normale Zeit/Einheit 1 : 360 Bedeutet 6 Minuten für eine Einheit
Billge Zeit/Einheit 1 : 720 12
.
.
.
Die voreingestellten Zeite entsprechen denen in Deutschland.
Als nächstes kommt das Gadget, daß die Kosten für eine Einheit
aufnimmt. Hier werden die Kosten in cents, Pfennigen....
eingetragen. Geben Sie einfach Ihre lokalen Kosten ein.
Nun folgen zwei mutual exclude Gadgets, die die Vroeinstellung
für Zeitzone und Tarif bestimmen. Diese Einstellungen werden
in das Preferences File übernommen, so daß das BillWindow bei
jedem Neustart die am häufigsten benutzen Einstellungen reflektiert.
Benutzen Sie das "PopUp Bill window" gadget, um das BillWindow
bei jedem Carrier Detect erscheinen zu lassen. Mit einem deselektierten
"Log calls" gadget werden die Daten eines Anrufes NICHT in das
angegebene File geschrieben.
Um ein LogFile loszuwerden clicken Sie einfach auf das "Clear log" Gadget.
Bei Click auf "Save Log to..." wird ein FileRequester geöffnet, in dem
es Ihnen möglich ist ein neues LogFile zu wählen, in das die Daten
das nächste Mal geschrieben werden sollen. Falls Sie sich bereits
sicher sind, wohin das File geschrieben werden soll und wie es heisst,
dann können Sie den Namen samt Pfadangabe direkt in das StringGadget
neben dem "Save Log to..."-Gadget eingeben.
Das nächste Gadget ist ein einfaches. "Total sum..." öffnet ein Window,
in dem der Inhalt des LogFiles aufgelistet wird. Nachdem alle Einträge
eines Tages aufgelistet wurden zeigt KCommodity die Summe für diesen Tag.
Am Ende des LogFiles zeigt Ihnen KCommodity die Gesamtsumme aller Einträge.
Das Bill window.
Dieses Window zeigt Ihnen die aktuelle Zeit, Onlinezeit und Kosten, die
durchen den aktuellen/letzten Anruf entstehen.
In diesem Window befinden sich zwei Gadgets, die es Ihnen ermöglichen
die Zeitzone und den Tarif zu ändern. Clicken Sie einfach den
entsprechenden Knopf an. Falls Sie bereits Online sind, so rechnet
KCommodity automatisch die Kosten auf die neue Gegebenheit um, so daß
durch Ändern der Einstellungen trotzdem immer die richtigen Kosten
beibehalten werden. Unterhalb dieser Gadgets befindet sich ein
Anzeigefeld, daß die Kosten einer Stunde für die eingestellteq Zeit
Zeit/Tarif wiedergibt.
ARexx-Fähigkeit
---------------
Es gibt eine weitere Möglichkeit KCommodity zu konfigurieren, oder um
Daten der Einstellungen des Programms zu besorgen.
Als erstes folgen die ARexx-Kommandos, die KCommodity versteht.
ACTIVATE 1|0 Ein-/Ausschalten der Window-Aktivierung
MOUSEMODE 1|0 Ein-/Ausschalten der Mausaktivierung
SHOWCLOCK 1|0 Ein-/Ausschalten der Zeit/Speicher Anzeige
CLOCKWIN 1|0 Ein-/Ausschalten der Window Anzeige
CLOCKWINPOS 'X/Y' Setzen des Zeit/Speicher Windows auf Position
SHOWDATE 1|0 Datum anzeigen
SHOWDAY 1|0 Tag anzeigen
SHORTDAY 1|0 Nur drei Zeichen für Tag-String
SHOWSECS 1|0 Sekunden anzeigen
AMIDATE 1|0 Amerikanisches Datum
PAGEKEY 'string' HotKey zum ändern der Zeit/Speicher Anzeige
PAGENUM (0-4) Nummer der Seite, die angezeit werden soll
ALARM 1|0 Alarm einschalten
ALARMTIME 'hh:mm[:ss]' Alarmzeit setzen
SETENV 1|0 Tag, Datum, Zeit in Env Variablen
SCREENTIME 'secs' Neues Timeout für ScreenBlanker
MOUSETIME 'secs' Neues Timeout für MouseBlanker
CYCLEWIN 1|0 Ein-/Ausschalten des Window-Cyclings
CYCLEKEY (0-3) Setzen eines neuen Qualifiers für Window-Cycling
CLICK 1|0 Ein-/Ausschalten des Tasten-Klickers
CLICKVOL (0-64) Neue Lautstärke für den Klick
LOGCALLS 1|0 Jeden Anruf in das LogFile schreiben
BILLWINPOS 'X/Y' Neue Position des BillWindows
BILLPOPUP 1|0 Ein-/Ausschalten des PopUp des BillWindows
PREFSWINPOS 'X/Y' Neue Position des PreferencesWindows
WBFRONT 1|0 Ein-/Ausschalten des PopUps der Workbench
LEFTYMOUSE 1|0 Ein-/Ausschalten der LeftyMouse Option
ESCCLOSE 1|0 Ein-/Ausschalten der ESC-WindowClose Option
ESCKEY (0-4) Qualifier-Nummer für ESC-WindowClose
MAPUMLAUT 1|0 Ein-/Ausschalten der Umlautumsetzung
CLEARLOG Löschen des LogFiles
LOADPREFS 'string' Laden eines Preferences Files
SAVEPREFS 'string' Speicher der Preferences in ein File
CXPOPKEY 'string' Ändern des HotKeys für das Hauptwindow
BILLKEY 'string' Neuer HotKey für das BillWindow
PREFSKEY 'string' Neuer HotKey für das PreferencesWindow
HOTWINKEY 'string' Neuer HotKey für das HotKeyWindow
SHELLKEY 'string' Neuer HotKey für die Shell
UMLAUTKEY 'string' Neuer HotKey für "Umlaute"
SHELLCOMM 'string' Neue Parameter für Shell
ENABLE Einschalten des Brokers
DISABLE Ausschalten des Brokers
HIDE Hauptwindow verschwinden lassen
POPUP Hauptwindow erscheinen lassen
STATUS Statusabfrage (siehe unten)
REVISE 'File' [C|ASM] Start des Revision Control Systems
ACHTUNG : Alle mit ' gekennzeichneten Parameter müssen auch
in Anführungsstrichen erscheinen, so daß ARexx sich nicht
darüber beschwert.
Werte für PAGENUM
0 : Zeitanzeige
1 : Freies Chip/Fast Memory getrennt
2 : Gesamter freier Speicher
3 : Gesamter freier Speicher als Füllbalken
4 : Onlinezeit
Werte für CYCLEKEY
0 : Eine alt Taste
1 : Eine amiga Taste
2 : Eine shift Taste
3 : Control Taste
Werte für ESCKEY
0 : Eine alt Taste
1 : Eine amiga Taste
2 : Eine shift Taste
3 : Control Taste
4 : Keine Taste
Liste der STATUS Nummer, die KCommodity versteht
------------------------------------------------
1 Wert : Priorität des ganzen Programms
2 Wert : Priorität des Brokers
3 String : POPUPKEY (Voreinstellung : LCOMMAND HELP)
4 BOOL : Sollte KCommodity beim Start das Window öffenen
5 BOOL : Status der Aktivierung (AN/AUS)
6 BOOL : Maus-Modus (AN/AUS)
7 BOOL : Zeit/Speicher Anzeige (AN/AUS)
8 BOOL : Zeit/Speicher Window (AN/AUS)
9 String : Position des Zeit/Speicher Windows.
Nimmt die Form X/Y an.
10 BOOL : Datum (AN/AUS)
11 BOOL : Tag (AN/AUS)
12 BOOL : Sekunden (AN/AUS)
13 BOOL : Amerikanisches Datum (AN/AUS)
14 String : Gibt HotKey für Zeit/Speicher Anzeige zurück
15 LONG : Nummer der augenblicklich angezeigten Seite (0-4)
16 BOOL : Sollen wir Alarm geben ? (JA/NEIN)
17 String : Gibt die augenblickliche Alarmzeit zurück (hh:mm[:ss])
18 BOOL : Ist der Broker (HotKey, Aktivierung) deaktiviert (JA/NEIN)
19 BOOL : Ist das Hauptwindow offen ? (JA/NEIN)
20 BOOL : Environment Variablen aktiviert (JA/NEIN)
21 BOOL : Gesamter Tagstring (JA/NEIN)
22 LONG : Timeout Wert für ScreenBlanking (0 = deaktiviert)
23 LONG : Timeout Wert für MouseBlanking (0 = deaktiviert)
24 BOOL : Window-Cycling aktiv (JA/NEIN)
25 LONG : Nummer des Window-Cycling Qualifiers (0-3)
26 BOOL : Tasten-Klicker aktiviert (JA/NEIN)
27 LONG : Lautstärke des Klicks (0-64)
28 BOOL : Telefondaten speichern (AN/AUS)
29 String : Position des BillWindows
30 BOOL : BillWindow bei Carrier Detect öffnen (JA/NEIN)
31 String : Position des PreferencesWindows
32 BOOL : WB nach vorne, wenn das Hauptwindow geöffnet wird (JA/NEIN)
33 BOOL : LeftMouse aktiviert (JA/NEIN)
34 BOOL : ESC-Windowschließer aktiv (JA/NEIN)
35 LONG : Qualifier für ESC-WindowClose (0-4)
36 String : HotKey für BillWindow
37 String : HotKey für PreferencesWindow
38 String : HotKey für HotKeysWindow
39 String : HotKey für die Shell
40 String : HotKey für "Map Umlauts" modus
41 String : Parameter für NewShell
42 BOOL : Umlautumsetzung aktiviert (JA/NEIN)
ACHTUNG : (AN/AUS) und (JA/NEIN) sind keine Strings. Es sind vielmehr
Angaben, daß sie boolsche Ausdrücke TRUE/FALSE erwarten müssen,
die die Werte 1 oder 0 annehmen.
MERKE : Der voreingestellte Portname für ARexx-Kommandos ist KComm.1.
Wenn Sie den Namen also nicht geändert haben, so müssen Sie
ADDRESS 'KComm.1' angeben, um KCommodity ansprechen zu können.
Weitere Verbesserungen
----------------------
Ich warte auf Ihre Vorschläge
--------------------------------------------------------------------------
Um mich zu erreichen schreiben Sie einfach an :
Kai Iske
Brucknerstrasse 18
6450 Hanau 1
Deutschland
Tel.: +49-(0)6181-850181 (Wochentags erst ab 18:00 Uhr)
oder schicken Sie eine E-Mail an :
FIDO : 2:249/40.11, Kai Iske
SMBX : GURU:SNAKE
ZNET : SNAKE%HTH@AMNET.ZER
AMNET: SNAKE%HTH.AMN
oder in eine meiner lokalen Mailboxen :
Star League BBS: 069/5927709
Pyramania BBS: 069/543603
HitchHicker BBS: 069/5975113
Diese sind alle in Franktfurt/M Deutschland.
Es sind die Plätze, an denen ich die meiste Zeit zu erreichen bin.
Schreiben Sie einfach eine E-Mail an SNAKE.
Sie können dort außerdem die neusten Versionen von KCommodity
beziehen (nur die registrierten Benutzer bekommen sie noch schneller).
Oder aber auf einer der nächsten Fred Fish Disketten oder KickStart
Disketten.
Lassen Sie mich einfach von Ihren Fragen und Vorschlägen wissen........