+++++++++++++++++++++++++ + + + S K I C K v 2.0 & 3.0 + + + + (C) SinSoft 1992,93 + + + + User's manual + + + +++++++++++++++++++++++++ Introduction. ============= SKick is the replacement for Kickit, ZKick and LKick kickers, intended for use on A500 or A2000 machines with OS2.0 in ROM (for instance A500+). Its task is to soft-kick any other version of kickstart into RAM. 'Any other' means also the 1.3 kickstart, which was unavailable to kick with any other kicker. KickIt and ZKick both require 1.3 ROM for operation and function of LKick from 2.0 isn't very stable. SKick is fully assembly-written program, with many facilities added. The main advantages of SKick are: - ability to relocate any kickstart image, when the relocation table is supplied into any kind of RAM (CHIP, FAST, EXP etc.) - standard operation (like Kickit etc.), when table is not available - patch function (patches kickstart image prior its start, which may correct known bugs etc.), using supplied patch file - powerful command line and Workbench interface - Graphic User Interface (GUI) - all operations during kicking are made so 'purely' as possible, all structures are exactly in the same state as if kicked from ROM - small code size (even if most powerful, SKick is the shortest from all the kickers) - relocation tables for new kickstart versions will be automatically available for registered users - loaded kickstart survives any 'soft crash' (without corrupting execbase or kickstart itself) and user reset - allows use of CoolCapture, romtags and memtags with user programs without any limitation 1. Copyright. ============= SKick and its documentation files are Copyright (C) SinSoft 1992, Prague, CSFR. =============================================================================== This archive may be freely redistributed, but only in totally unchanged state, i.e. no files can be added, deleted, modified etc. All copyright notices in the program and its documentation must remain on their places. Also '.displayme' and other files, usually with 'wonderful' ANSI graphics, so obvious at various BBS's, cannot be added. 2. Contents of the archive. =========================== This .LHA archive MUST contain following files: SKick - executable code of the program SKick.info - program icon SKick.doc - this file History.doc - development history - PLEASE READ FOR LATEST CHANGES directory Kickstarts: kick39110.A500.BETA.RTB *) kick39110.A500.BETA.PAT kick39106.A1200.RTB **) kick39106.A500.BETA.RTB *) kick39106.A500.BETA.PAT kick39046.A500.BETA.RTB *) kick39046.A500.BETA.PAT kick37175.A500.RTB **) kick36143.A3000.RTB ***) kick36143.A3000.PAT kick34005.A500.RTB kick34005.A500.PAT *) These kickstart versions are available only to official developers. **) Patch table not required to use these kickstarts. ***) This kickstart was available on SuperKickstart disk for A3000. Patch file makes usage of this kickstart on A500 possible. However, this 'historical' version of OS is obsolete and it is not recommended to use it. NOTE TO COMMODORE: Sorry CBM for a small law-break (I hope small) from my side: I'm not the official developer, but I have Your BETA releases on my drive: they came into Czechoslovakia from some pirate BBS in Germany and they are available from general Amiga population. I've never misused or abused them and I also keep in mind Your copyrights: I never redistribute them. But when I've got them, I wanted to help another people and do some useful work: All known kickers (they are PD, aren't they?) seemed to be imperfect in some aspects for me and then I realized to write my own kicker to meet all my needs and give it to all people which need it too. 3. System requirements. ======================= SKick may be operated, if the following requirements are met: - Computer: Amiga 500, 600, 1000, 1200 and 2000 with 68000, '010 and '020 processors - Minimum 1 meg of RAM (possibly only Chip RAM, expansion RAM isn't needed when relocation is to be used) - Kickstart 2.0 or 3.0 in ROM (not tested with V36, because there are not machines with V36 ROM in Czechoslovakia, developed and tested under 37.175 and 39.106) That's all. When Your system meets all these requirements, You are able to use SKick. Of course, large amount of RAM (especially expansion RAM) will help You use non-relocatable kickstarts (they are located from $200000 obviously), but it is not necessary. Skick is designed to work on machines without a MMU. For machines with the MMU, there exist suitable software to do such work. Especially, program SoftBoot is available to official developers and allows to remap any RAM to the $F8 space, thus emulating the ROM. NOTE: Because of a nature of 2.0 system, it is impossible to kick anything from address $c00000 exactly. The first usable address is $c40000. 1.3 system did allow this, 2.0 doesn't. It is because the system restart is more drastic than on 1.3 system. 4. Installation. ================ Installation of SKick and related files is very simple. Please follow instructions below: On Amiga 3000, there is the convention, that during cold start process, file 'DEVS:kickstart' is read into memory and run. To make the possibility to choose from several kickstarts, SKick searches kickstart images and related files on the directory DEVS:kickstarts. Your first step is to issue the command >Makedir DEVS:kickstarts from the Shell, so the appropriate subdirectory will be created on Your boot partition (usually hard disk). Your second step is to copy the auxiliary files (.RTB and .PAT) from this archive, if You wish to use them, and to add appropriate kickstart images. SKick can handle both 'exact ROM images' and files intended for Kickit and other kickers. When copying kickstart images, rename them with names of .RTB/PAT files, but without any extension; or, vice versa, rename auxiliary files according to the main file. All the files of one particular kickstart must have identical names (except extensions). IMPORTANT NOTE: There are no kickstart images in this archive! Supplied files only allow to use standard 1.3 ROM image, which may be obtained from Commodore (one method : buy A3000 SuperKickstart disk, it also contains this, and use some disk tool or monitor to grab it from the disk into the file. Another method: Somebody will upgrade his A500 1.3 with a new 2.04 ROM. Because he bought old 1.3 ROM with his machine, it continues to be his ownership and may be used. There is no need to buy hardware add-on (ROM-Switches etc), and the contents of the old ROM may be copied into the file before replacement and then used. ('Backup copy')). There are also files for another kickstart versions. Some of them are available to the official developers only. I hope that SKick will help them to keep their work. It's only a dream for me to be an official developer... The third step is to copy SKick itself (with its icon) into any place where You wish to have it. Please read the following chapter for more explanation. 5. SKick usage ============== SKick may be called either from the Shell or from the Workbench. 5.1 Invocation from the Shell ============================= When invocating SKick from the Shell, following template should be used: NAME,ADR/K,FORCE/S,EXT/S,CHIP/S,FAST/S,NOEXT/S,NOREL/S,NOPATCH/S,QUIET/S, GUI/S,RELSTACK/S,FASTRES/S There are two optional parameters and many switches. NAME ==== This parameter specifies the file name with full path of the kickstart to be loaded. If omitted, SKick will do nothing, until GUI is called either by its switch (GUI) or by pressing left mouse button during program run. ADR === ADR parameter allows You to specify the address for the relocatable kickstart to be loaded. The address must be entered in hex, and only the upper byte of the address is entered. It is also assumed always to be in 24-bit space. For example, when You wish to load Your kickstart image from $C80000, please specify Your wish with 'ADR C8' or 'ADR $C8', or possibly 'ADR $00C8'. NOTE: This option is only useful for special cases, like debugging etc. Normally, the fully automatic search for the appropriate place is performed and the best place for the kickstart is found. NOTE for users with 'kickstart RAM': A1000's or any other machines, having RAM from $F00000, allow loading into this location. In such case, the command SKick ADR F0 FORCE has to be used, as the kickstart RAM isn't normally accessed, and obviously it is not added to the free memory list. FORCE ===== This switch allows You to force load to the place, which iie Adressenliste: Neue Mitglieder markieren (z.B. mit nem blauen Textmarker auf der Nase :-). <> >>> Markus Pöllmann Disks erhalten? Und zufrieden ? Schön :-) Neue Hoffnung: Ein entfernter Bekannter bastelt für seinen 1000er an einer 2MB ChipMem Erweiterung!!! >>> Bweb Hast Du noch mehr Sprüche von FFN auf Lager ??? Ich hab mir nen Ast gelacht:-) >>> Ingo Wolfmüller OS2.1 gibts ja jetzt endlich doch offiziell. Und die Produktion des 600er darf nicht eingestellt werden, denn sonst kommt Commodore auf dumme Ideen und für die alten Rechner gibt es keine OS Updates mehr. Zumal OS3.0 eh nur noch mit Turbo Amigas läuft. <> Sensible Soccer und Battle Isle waren schon längst verkauft. Und vergessen zu antworten hab ich auch noch... (immer diese Beamten :-) Genaueres steht ja im Brief, den Du mittlerweile haben solltest?! >>> Bernd Rische Du darfst mir mal die ParNet Software schicken. >>> André Voget Hi :^) PD-Soft angekommen ?! PS: Danke Jörg für die tolle PD-Software !!!!!! ;-)) <> 700ÇPshafen ****** ****** Winkler, Nils ***************** W-6700 Ludwigshafen ** ****** Brand, Rudi Schubertstr. 3 W-6718 Grünstadt 06359/ 81771 Rische, Bernd Große Gailergaße 1 W-6720 Speyer 06232/ 28661 Meister, Jürgen ***************** ****** *************** 07272/ 73569 Groß, Matthias Werderstr. 11 W-6750 Kaiserslautern Park, Peter ***************** W-6900 Heidelberg Hirsch, Helmut ***************** W-69** bei Heidelberg ****** ****** Metz, Oliver ***************** ****** *************** 06201/ 33588 Kohler, Klaus ***************** W-7074 Mögglingen Mayer, Nicol ***************** W-7121 Erligheim Köhnke, Jürgen ***************** W-7410 Reutlingen Steinhilber, Jan ***************** W-7454 Bodelshausen Baur, Ekkehard Heubergstr. 74 W-7470 Albstadt 2 ****** ****** Hilpert, Martin Leopoldstr. 33 W-7500 Karlsruhe 1 0721/ 29271 Chwalczyk, Robert Kaiserstr. 45 W-7500 Karlsruhe 1 0721/ 370803 Schneller, Andreas An der Fasanen- W-7500 Karslruhe 1 0721/ gartenmauer 2 22066 ****** Zacherle, Michael Abergavennystr. 2 W-7524 Östringen 07253/ 22787 Hasemann, Jens ***************** W-7614 Gengenbach ****** ****** Klug, Peter Bergstr. 59 W-7630 Lahr 07821/ 21602 Gabel, Thomas Römerstr. 5 W-7844 Neuenburg/Rhein 07631/ 72758 Bek, Christian ***************** W-7900 Ulm Büchse, Joachim Jutastr. 11 W-8000 München 19 089/ 131858 Widera, Alexander Hofmarkstr. 5 W-8037 Olching 2 08142/ 15862 Plötz, Michael B.-Rößner-Str. 18 W-8038 Gröbenzell Pöllmann, Markus Lärchenstr. 44 W-8080 Fürstenfeldbruck 08141/ 16720 Buchwald, Peter ***************** W-8300 Landshut ****** ****** Bauer, Joachim ***************** W-8371 Kollnburg Huber, Willibald jun ***************** W-8385 Pilsting-Trieching Dörries, Bernhard Rabenstein 6 W-8391 Thurmansbang 08504/ 8987 Windl, Jürgen ***************** W-8415 Nittenau ****** ****** Fueßl, Harald ***************** W-8450 Amberg 09621/ 75619 Eisenhut, Michael ***************** W-8500 Nürnberg ** ****** ****** Abel, Michael Ossiacherstr. 26 W-8500 Nürnberg 50 0911/ 899536 Edelmann, Heinz ***************** W-8501 Roßtal ****** ****** Sokoliuk, Matthias ***************** W-8520 Erlangen Hannig, Günter ***************** W-8580 Bayreuth Wagner, Heiko ***************** W-8580 Bayreuth ****** ****** Frank, Gerd Wampen 11 W-8591 Thiersheim 09233/ 1702 Schönmüller, Tristan ***************** W-8729 Eltmann ****** ****** Kaufmann, Oliver Eserwallstr. 8 W-8900 Augsburg 0821/ 518495 Otto, Bernd Ortlerstr. 96 W-8900 Augsburg 0821/ 663788 McCarroll, Sean Augustusstr. 2E W-8901 Königsbrunn 08231/ 7381 Endreß, Jens ***************** W-8976 Blaichach ****** ****** Hillinger, Kurt Fischerweg 9 A-4664 Oberweis A-07613/ 5479 Schupfer, Stefan ***************** A-4822 Goisern ****** ****** Aichberger, Markus ***************** A-5730 Mittersill Asinger, Peter ***************** A-9020 Klagenfurt Hegg, Richard ***************** CH-5037 Muhen Bieler, Markus Rebbergstr. 3 CH-8967 Widen AG ****** ****** Wenn ein Name/eine Adresse oder Telefonnummer falsch wiedergegeben wurden, bitte ich darum, mich zu benachrichtigen, damit das geändert werden kann. Außerdem bitte ich diejenigen, von denen ich noch keine Telefonnummer habe, mir Diese mitzuteilen. Ich betreibe !keinen! Handel mit Adressen. Bitte seid auch Ihr so fair und gebt diese Adressenliste an keinen weiter, den sie nichts angeht. Nachtrag: Wer seine Adresse aus Datenschutzgründen nicht hier veröffent- licht sehen will, der kann mir Bescheid sagen, ich werde dann seine Daten (mit Ausnahme von Name, Zuname und Wohnort) aus der Liste löschen. "****" bedeutet entweder, daß die entsprechende Adresse auf Wunsch des Mitgliedes getilgt wurde, sämtliche Kontakte laufen damit über mich, oder daß das entsprechende Mitglied noch keine Genehmigung zur Veröffentlichung der Adresse/Telefonnummer gegeben hat. Bei wem das der Fall ist, der möchte sich bitte bei mir melden ! Der Wohnort bleibt aus Gründen der räumlichen Orientierung bestehen. besit«X wird die Anzahl der Farben auf vier reduziert. Die Positionierung beachtet den Mehrspaltenmodus nur im Inhaltsverzeichnis. ›[0;3mg) Zeichensatz öffnen›[0m Format: @OZnyyFontname Beispiel: @OZ108ruby.font Erklärung: In Look kann man beliebig viele Fonts in einem Text ver- wenden. Jeder Font besitzt eine Nummer, die von 1-9 reichen darf. Die Größe wird in "yy" angegeben, und muß immer zweistellig sein. Wird ein Font mit einer Nummer geladen, die schon existierte, dann wird der alte Font aus dem Speicher gelöscht, so daß man beliebig viele Fonts in einem Text benutzen kann. Um den Font auch be­ nutzen zu können, muß er mit dem Befehl "@ZS" zum aktu­ ellen Font erklärt werden. ›[0;3mh) Zeichensatz setzen (für aktuell erklären)›[0m Format: @ZSn Beispiel: @ZS1 Erklärung: Mit diesem Befehl kann man einen Font, der mit dem Befehl "@OZ" geöffnet wurde, auch benutzen! :-) Dabei ist "0" immer der Systemzeichensatz (Topaz-8). "n" darf zwischen "0" und "9" liegen, dabei ist "0" immer der Systemzeich- ensatz Topaz in der Größe 8. ›[0;3mi) Neue Spaltenanzahl›[0m Format: @SPn Beispiel: @SP2 Erklärung: Look kann eine bis drei Spalten pro Seite verwalten. Die Anzahl der Spalten gibt man in "n" an. Voreinge­ stellt ist die Anzahl "1", es wird also die volle Seite ausgenutzt. Bei einem Text, der z.B. den Zweispaltenmo­ dus benutzt, darf die Zeilenlänge 38 Buchstaben bei ein­ em Font mit der Größe 8 nicht überschreiten. Im Drei­ spaltenmodus sollten 25 Zeichen nicht überschritten wer­ den, im Einspaltenmodus (voreingestellt) können selbst­ verständlich die vollen 80 Zeichen benutzt werden. Es ist zu beachten, daß die Spaltenmodi auf einer Seite nicht gemischt werden sollten. Look überprüft dies nicht. Zur Sicherheit sollte man zuvor den "@NS"-Be­ fehl benutzen (siehe unter c). ›[0;3mj) Überschrift ändern›[0m Format: @UBtitel Beispiel: @UBFishvorstellung: AmigaLibDisk 756 Erklärung: Man kann den Screentitel mit diesem Befehl ändern. Der Text darf höchstens 78 Zeichen enthalten und muß mit einem abgeschlossen sein. Dieser Befehl dient dazu, einen Text übersichtlicher zu machen, denn z.B. bei PD-Serien-Vorstellungen könnte auf jeder neuen Seite eine Diskette vorgestellt werden mit der entsprechenden Überschrift (siehe Beispiel). Nach dem ein neuer Text geladen wurde, wird die Überschrift automatisch geändert und der Pfadname wird eingetragen. ›[0;3mk) Textbefehle ausschalten›[0m Format: @LBn Beispiel: @LB0 (schaltet Look-Befehle aus) Erklärung: Dieser Befehl wurde nötig, um auch die Anleitung zu Look mit Look anzeigen zu lassen :-) Wird für "n" der Wert 0 gewählt, dann werden die Befehle abgeschaltet. Mit dem Wert "1" werden sie wieder eingeschaltet. Dies passiert automatisch, wenn ein neuer Text geladen wird. ›[0;3ml) Tabulator-Größe setzen›[0m Format: @TBnn Beispiel: @TB08 Erklärung: Da es leider keinen Tabulator-Größe-Standard (:^) gibt, kann man mit diesem Befehl die TAB-Größe setzen. Wird ein Text geladen, dann wird die TAB-Größe automatisch auf acht Leerzeichen gesetzt. Um einen Artikel auf den eigenen Editor anzupassen, muß man nur wissen, wieviele Leerzeichen der Editor ausgibt, wenn man die -Taste drückt. Der Parameter "nn" muß immer zwei Stellen be­ sitzen, und darf Werte zwischen 2 bis 79 annehmen. ›[0;3mm) Zeilenvorschub setzen›[0m Format: @ZZnn Beispiel: @ZZ10 Erklärung: Wenn man ein Brush darstellt, bemerkt man besonders bei mehrspaltigen Texten, daß die Zeilen in den verschiedenen Spalten nicht mehr genau gegenüber stehen. Mit diesem Be- fehl kann man nun den Zeilenvorschub neu setzen. Er ist normalerweise auf Fontgröße plus zwei Pixel festgesetzt, z.B. Topaz-8-Font besitzt einen Zeilenvorschub von zehn Pixel. Für "nn" kann man den neuen Vorschub angeben; der Wert "-01" rechnet ihn nach der obigen Formel für den aktuellen Font aus. Übrigens kann man mit diesem Befehl auch neue Effekte kreieren, wenn man den Zeilenvorschub kleiner als die Fontgröße stellt, z.B. "02". »»» V. MAGAZIN-ERSTELLUNG ««« ›[0;4mWas ist ein Scriptfile?›[0m Look benötigt eine Datei, in der Informationen über die Texte und das Aussehen des Inhaltsverzeichnisses angegeben sind. Diese Datei mußt Du mit einem Editor selbst schreiben und unter einem geeigneten Namen abspeiche