home *** CD-ROM | disk | FTP | other *** search
-
- *****************************************************************************
- 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........
-