home *** CD-ROM | disk | FTP | other *** search
-
-
-
-
-
-
-
- ANLEITUNG DOKUMENTATION ZU
-
-
- AddIcon VERSION 1.7 FREEWARE VERSION
-
-
- geschrieben 1992 von H.P.G.
-
- INDEX:
-
-
-
- INDEX
- Allgemeine Beschreibung
- Geschichte
- SYSTEM Vorrausetzungen
- Rechtliches
- FEATURES
- Installation
- Starten von AddIcon
- AddIcon START PARAMETER
- Tips
- BUGS
- Benutzen von AddIcon
- Liste aller bekannten IconTypen
- Technisches
- Zum Schluß
- Adresse
- Liste aller Dateien
-
-
-
-
- Allgemeine Beschreibung:
-
-
- AddIcon [AI] ist ein Programm, daß Dateien und Verzeichnisse mit
- Icons versieht.
-
- AI verfügt über eine Vielzahl von Übergabeparametern.
-
- AI unterstützt PatternMatching ( also Angabe von Suchmustern,
- z.B.: #? ~#? [a-u]) in Datei- und Verzeichnisnamen nach
- AmigaDOS Standart.
-
- AddIcon läuft nur unter OS 2.xx. Wobei auch die Version 36 Pro-
- bleme haben könnte, da dabei einige Funktionen noch nicht rich-
- tig implementiert waren. Da das Programm regen Gebrauch der
- neuen OS 2.0 Features macht, ist es leider unter OS 1.2 und 1.3
- nicht lauffähig.
-
- Die Icons, die AI kopiert, müssen sich im logischen Device
- oder Assign 'Icons:' befinden. Man kann also einfach die auf
- dieser Diskette vorhandenen Icons im Icons-Verzeichnis kopieren
- und in der Startup-Sequence folgende Zeile einfügen:
-
- Assign Icons: 'Verzeichnis der Icons'
-
- und schon hat man damit keine Probleme mehr.
-
- AddIcon erkennt viele verschiedene Datei-Typen. Dabei geht es
- zuerst davon aus, daß die Dateien mit einem zu ihrem Typ ent-
- sprechenden Suffix '.xx' versehen sind. Also z.B. eine Datei
- mit Suffix '.c' wird immer als CSource Datei erkannt. Dateien
- mit Suffix '.ilbm' dagegen werden als Bilder (PICTURES) erkannt.
-
- Findet AI eine Datei ohne Suffix, wird diese Datei automatisch
- nach sogenannten Iff-Chunks untersucht.
-
- Findet AI keinen IFF-Chunk, liest es die Datei und untersucht,
- ob es sich um eine binäre oder eine ASCII-Datei handelt könnte.
-
- Bestehen über 90% der Daten der Datei aus ASCII-Buchstaben, so
- nimmt AI an, daß es sich um eine TextDatei vom TYP ASCII handelt.
-
- Achtung: Bei größeren Dateien kann dies eine geraume Zeit dauern.
-
- Findet AI den Typ einer Datei heraus, so kopiert es das entspre-
- chende Icon zu dieser Datei.
-
- Selbstverständlich kann man eigene Icons verwenden und alle Ein-
- stellungen der Icons nach seinem Belieben abändern.
- Bei Projekt Icons kann man z.B. das DefaultTool dieser, entspre-
- chend seinen eigenen Wünschen, abändern.
-
- Benutzt man z.B. TurboText als TextEditor, so ändert man das
- DefaultTool des ASCII-Icons einfach in z.B. c:TTX um. Wird nun
- dieses Icon zu einer Datei kopiert, so wird nun automatisch beim
- Doppelklick auf dieses Icon TTX mit dem Namen der Datei gestartet.
-
- Dies funktioniert natürlich genauso bei allen anderen Projekt-
- Icons. Vorraussetzung ist allerdings, daß das Programm, daß
- man aufrufen will, Aufrufe mittels Mehrfachslektion von Icons
- unterstützt.
-
- Geschichte:
-
- Version 0.1 - 0.9:
-
- Beta Versionen ohne richtige Funktion. Nur geschrieben, um den
- Umgang mit dem Amiga zu erlernen.
-
- Version 1.0 - 1.3
-
- Funktionesfähige Version für Kickstart 1.3. Mit Intuition-
- Oberfläche, aber ohne Typen Erkennung von Icons, benötigte
- Arp.Library V 39.1
-
- Version 1.4
-
- Verbesserung der Bedienungsoberfläche. Ersatz der Arp.Library
- durch Benutzung der Req.Library.
-
- Version 1.5
-
- Verbesserungen im Bedienungskompfort. Neue Funktionen eingebaut.
-
- Version 1.6
-
- Erste OS 2.0 Version. Beta-Testing. Benutze noch alte Funktionen
- für Commandline Parsing. Jetzt nur noch Cli-startfähig. Wenige
- Parameter.
-
- Version 1.61 - 1.68
-
- Verbesserungen und mehr Funktionen eingebaut. Konsequente
- Nutzung der neuen OS 2.xx Fähigkeiten. Ausgabe des Programmes
- verbessert. Geschwindigkeitssteigerungen beim Analysieren. Ein-
- bau der QUICK- und ASK- und UPDATE-Option. Support von Pattern-
- Matching.
-
- Version 1.7
-
- Ab jetzt ist keine Intuition Oberfläche mehr vorhanden.
- Einbau von ^C-Break-Handling. Jetzt kann das Programm jeder-
- zeit durch ^C ( Control+C Taste ) abgebrochen werden, ohne daß
- Speicher verloren geht oder Locks etc. freigegeben werden. Ein-
- bau eines Easy-Requesters im Break-Fall, der nach Abbruch fragt.
- Verbesserung der Geschwindigkeit beim Analysieren der Datei-
- typen. Einbau von IFF-Chunks-Suchroutine. Abfrage der ASCII-
- Zeichen in einer Datei. Benutzt jetzt logisches Device 'ICONS:'.
- Dadurch mehr Flexibilität beim Ersatz der benuzten Icons.
- AI kann jetzt auch ganze Verzeichnisse mit Icons versehen
- (mit Pattern Matching).
- Erste allgemeine Veröffentlichung.
-
-
- SYSTEM Vorrausetzungen:
-
-
- Für AI benötigt man mindestens Kickstart 2.xx Version 37.xx.
-
- Man muß ein logisches Device namens 'Icons:' installiert haben.
- Dort sollten sich alle Icons, die auch im Icons-Verzeichnis auf
- dieser Diskette sind, befinden.
-
- Man sollte AI nicht bei größeren Dateien benutzen, da dies eine
- geraume Zeit dauern kann.
- AI allokiert zu lesen einen Speicherblock, der der Größe der zu
- untersuchenden Datei enstpricht, so kann es bei größeren Da-
- teien zu Speicherengpässen kommen. In diesem Fall lieber mit
- der QUICK-Option und/oder der ASK-Option arbeiten.
-
-
- Rechtliches:
-
-
- Ich habe mich entschlossen dieses Programm und alle beigefügten
- Dateien und Scripts, sowie aller Anleitungen, als FREEWARE zu
- deklarieren.
-
- D.h.:
-
- Jeder kann AddIcon benutzen.
- Jeder darf AddIcon weitergeben, wenn:
-
- 1. Alle unten aufgeführten Programme mit weitergegeben
- werden,
-
- 2. Keinerlei Veränderungen der unten aufgeführten Pro-
- grammen (am Ende der Anleitung) vorgenommen wurden,
-
- 3. Bei Nachkompilierungen der QuellCodes muß ein Hin-
- weis auf den Orginalprogrammierer beigefügt sein,
- bei Herausgabe dieser, muß eine Kopie an mich
- gesandt werden.
-
- 4. AddIcon darf nicht verkauft werden.
-
- Außnahme: Es darf eine geringe Kopiergebühr er-
- hoben werden, die aber 5 DM bzw. den
- entsprechenden Gegenwert in anderen
- Währungen nicht übersteigt.
-
- 5. AddIcon darf nur als Teil eines kommerziellen Pr-
- oduktes herrausgegeben werden, mit ausdrücklicher
- schriftlicher Genehmigung des Autors (Adresse siehe
- unten).
-
- Zuwiderhandlungen der oben Aufgeführten Konditionen
- werden Zivilrechtlich verfolgt.
-
-
- Ferner wird für die Funktion des Programmes ,sowie möglicher
- Folgen der Benutzung des Programmes sowie der u. a. Dateien,
- keinerlei Gewährleistung übernommen.
-
- !!! Alle Risiken trägt der Benutzer allein !!!
-
-
-
- FEATURES:
-
- - Volle Unterstützung von PatternMatching nach AmigaDOS
- Standart
-
- - Konsequente Nutzung von OS 2.xx Features und daher relativ
- klein.
-
- - AddIcon erkennt eine Vielzahl von verschiedenen Datei-Typen
-
- - Es besitzt eine Update-Funktion, die nur Icons zu Dateien
- kopiert, die bis dahin noch kein Icon besitzen
-
- - Ask Funktion, die dem Benutzer Gelegenheit gibt, vor jedem
- Kopiervorgang AddIcon abzubrechen oder zur nächsten Datei zu
- gehen.
-
- - Quick Funktion, die eine große Zeitersparnis bei größeren
- Dateien mit sich bringt.
-
- - Automatische Erkennung von IFF_Chunks
-
- - Untersuchung nach Binärdaten in Dateien
-
- - Verwendung von selbsthergestellten Icons möglich
-
- - Volle Information beim Auftreten System-bedingte Fehler oder
- Bedienungsfehler.
-
- - Volle Informierung des Benutzers während aller Kopiervorgänge
-
-
-
- Installation:
-
-
- Einfach AddIcon ins C:, oder jedes beliebig andere Verzeichnis
- im aktuellen AmigaDOS-Suchpfad kopieren.
-
- das Icons-Verzeichnis auf dieser Diskette irgendwohin am besten
- auf die WorkBench-Diskette kopieren.
-
- Folgende Zeile in Startup-Sequence einfügen
-
- .
- .
- .
-
- Assign Icons: <Pfad der Icons>
-
- .
- .
- .
-
-
- Starten von AddIcon:
-
-
- AddIcon muß vom CLI aus gestartet werden. Alternativ dazu kann
- man auch den WBenchmenüpunkt 'ExecuteCommand' ausführen und
- dann AddIcon <Parameter> in das StringGadget eingeben.
-
-
-
- AddIcon START PARAMETER:
-
-
- AI hat folgende
-
- Syntax: AddIcon <INFO/S|TO>[UPDATE/S][ASK/S][QUICK/S][QUIET/S]
- [NOCOL/S]
-
- INFO ------------ gibt man INFO an so gibt AddIcon
- eine Liste aller ihm bekannten
- Chunks und die zugehörigen Icon
- Typen aus. Die Icons im 'ICONS:'
- - Verzeichnis müssen den glei-
- chen Namen, wie die Typen haben.
-
- TO Zeichenkette Anstelle von TO muß man ein Ver-
- zeichnis oder eine Datei angeben.
- Die .info Endung kann man weg-
- lassen.
- Handelt es sich bei TO um ein
- Verzeichnis, so gibt es zwei
- Möglichkeiten:
-
- 1. man will das Verzeichnis mit einem Icon mit
- dem Typ DRAWER (Verzeichnis) versehen:
-
- TO muß dann einfach dem Namen des Verzeich-
- nisses entsprechen, zu dem man das Icon ko-
- pieren möchte
-
- Bsp.: AddIcon sys:c
-
- In diesem Fall würde AddIcon ein Icon
- mit dem Typ DRAWER zu SYS: mit dem Namen
- c.info kopieren
-
- 2. man will alle Dateien des angegebenen Ver-
- zeichnisses mit Icons versehen:
-
- TO muß dann mit einem ':' oder einem '/'
- enden.
-
- Bsp.: AddIcon sys:text/
-
- In diesem Fall würde AddIcon alle Dateien
- und Unterverzeichnisse des Verzeichnisses
- 'sys:text' mit Icon versehen.
-
- UPDATE ------------ gibt man UPDATE an, so kopiert
- AddIcon nur Icons zu Dateien bzw.
- Verzeichnissen, die noch kein
- Icon besitzen.
-
- ASK ------------ gibt man ASK an, so fragt AI
- jedesmal bevor es ein Icon ko-
- piert, ob man es auch wirklich
- will. Dabei gibt AI folgenden
- Text aus:
-
- Do you want to create <ICON-Name> with the Type
- <IconType> (y)es|(n)o|(c)ancel
-
- (sinngemäß: Willst du IconName mit dem Typ
- IconType kopieren ja nein abbruch)
-
- - gibt man y für yes ein, so wird das Icon ko-
- piert
- - gibt man c an, so wird der gesamte Vorgang
- abgebrochen
- - gibt man n oder irgendetwas Anderes ein, so
- sucht AddIcon nach der nächsten Datei, falls
- Jokerzeichen oder ein Verzeichnis angegeben
- wurden.
-
- Will man ein Verzeichnis mit Icons versehen,
- ohne dessen Inhalt zu kennen, sollte man die
- ASK-Option benutzen. AddIcon erkennt zwar viele
- Dateitypen, aber nicht alle.
- Um nicht einen falschen Icon-Typ kopiert oder
- über ein bereits vorhandenes Icon überschrieben
- zu bekommen, sollte man außerdem noch die
- UPDATE-Option benutzen.
-
- QUICK ------------ gibt man Quick an, so untersucht
- AddIcon Dateien ohne Suffix zeit-
- sparend. D.h bei größeren Files
- ( größer als 5 k ) nimmt AddIcon
- an, daß es sich um TOOLS also
- lauffähige Programme handelt und
- kopiert also das TOOL-Icon zu die-
- sen Dateien.
-
- QUIET ------------ AI informiert den Benutzer ständig
- über das, was das Programm gerade
- macht. Mit Angabe dieser Option,
- werden keine Informationen zum Cli
- Fenster ausgegeben. Es sei denn,
- es passiert ein Fehler.
-
- NOCOL ------------ Normalerweise schreibt AI seine
- Nachrichten in zwei Farben in das
- Cli-Fenster. Wenn einem dies nicht
- gefällt, kann man NOCOL angeben.
- Wird dies getan, so erscheinen
- Nachrichten in schwarz. Auch bei
- Angabe von Info wird die Ausgabe
- nun einfarbig ausgeführt.
-
-
- Alle Optionen und PARAMETER können beliebig gemischt und in
- jeder Reihenfolge angegeben werden.
-
- Treten Fehler auf, wird der Benutzer darauf aufmerksam gemacht.
-
-
- *** Startet man AI ohne PARAMETER wird ein kleiner Hilfstext ausgegeben.
- *** Dieser Hilfstext erscheint ebenfalls bei falschen Parameterübergaben.
-
-
- Tips:
-
- Man kann ohne viel Aufwand auch verschiedene Verzeichnisse mit
- Icons mit AI benutzen. Dabei muß man nur das 'ICONS:'- Assign ent-
- sprechend umändern.
- Dazu eignet sich am Besten eine Batch-Datei, die etwa folgende
- Zeilen enthalten könnte:
-
-
- .OPT RELEASE
-
- if <RELEASE> EQ FISH
- assign ICONS: sys:FishDisks
- endif
- if (RELEASE> EQ NORMAL
- assign ICONS: sys:NormalIcons
- endif
- ...
-
-
- Ist diese Datei im aktuellen Suchpfad und hat man zusätzlich noch
- das Script-Bit mittels 'Protect <Name> +s' gesetzt, kann man mit
-
- 1> <Name> FISH ; Name = Name dieser BatchDatei
-
- die Icons im 'sys:FiskDisk' - Verzeichnis mit AddIcon verwenden.
-
-
-
- BUGS:
-
- (Eigentlich ist kein Bug)
-
- AddIcon benutzt die offiziellen PatternMatching - Routinen der
- Dos.Library. Dadurch ist AddIcon aus technischen Gründen nicht fä-
- hig Pattern wie
-
- z.B.:
-
- sys:utilities/a~(#?info)
-
- zu verarbeiten.
-
- Daß heißt man sollte möglichst auf ausschließende Pattern wie
- ~(...) verzichten, da AI intern schon intern ein ~(#?.info) an
- die System-Funktionen übergibt. Alle anderen Pattern sind erlaubt.
-
- Dabei muß beachtet werden, daß beim PatternMatching kein '/' von
- der DOS.Library angehängt wird, d.h. man kann mit PatternMatching
- keine ganzen Verzeichnisse mit Icons versehen; nur Datein und/oder
- Verzeichnisse.
-
- Bsp: Mit 1> AddIcon sys:uti#?
-
- (ich nehme jetzt die orginale WBDiskette an)
-
- würde AddIcon sys:utilities mit einem Verzeichnis-Icon versehen.
- Will man aber das gesamte Verzeichnis 'sys:utilities' mit Icons
- versehen, dann kann man z.B.:
-
- 1> AddIcon sys:util#?/#?
-
- eigeben.
-
- Alle Dateien im Verzeichnis sys:utilities werden nun mit einem Icon
- versehen.
-
-
- Benutzen von AddIcon:
-
- Noch ein paar weitere Beispiele:
-
- 1> AddIcon Ram:#? UPDATE ASK
-
- AI sucht alle Dateien und Verzeichnisse in der RamDisk, die
- noch kein Icon haben. Findet AI ein solches, wird der Benut-
- zer gefragt, ob er das entsprechende Icon kopieren will. Ha-
- ben bereits alle Dateien und Verzeichnisse in der RamDisk
- Icons, passiert nichts.
-
- 1> AddIcon c:a#? QUICK
-
- AI schaltet den 'Schnellsuchlauf' an. Es werden nun alle Da-
- teien im Verzeichnis C:, die mit einem 'A' anfangen, mit
- einem Icon mit Typ TOOL versehen.
-
- Liste aller bekannten IconTypen:
-
- Icon TYP Suffix des DateiTypen Erklärung
- ________________________________________________________________________
- ASCII .asc Texte
- PICTURE .iff .ilbm .pic .br Bilder
- MUSIC .mod .med Musik
- BATCHFILE .bat AmigaDOS-Scripts
- CSHSCRIPT .sh Csh-Scripts
- PAGESTREAM .tem PageStream-Dokumente
- PREFS .prefs .config .cfg .def Preferences
- ASM .asm .s ASM-Source
- SOURCE .c C-Source
- HEADER .h C-Header
- OBJECT .o Object-Dateien
- LIBRARY .library Bibliotheken
- CLIB .lib .oss .osl .ols .oll C-Bibliotheken
- DOC .readme .doc .dok .man Anleitungen
- REXX .rexx .dme Rexx-Scripts
- ANIM .anim Animationen
- ASMINC .i ASM-Includes
-
- Dateien ohne Suffix werden nach folgenden Chunks untersucht
-
- Icon Typ Iff Chunk
-
- ILBM PICTURE
- SMUS MUSIC
- FTXT TEXT
- 8SVX MUSIC
- ANIM ANIM
-
- Dateien ohne Suffix und ohne Chunks werden zusätzlich noch nach der
- Anzahl binären und ASCII-Zeichen untersucht. Besteht eine Datei aus
- mehr als 90% ASCII-Daten , so nimmt AddICon an, daß es sich um eine
- TextDatei (TYP ASCII) handelt.
-
- ( nur wenn Option QUICK nicht angegeben ist )
-
-
- Technisches:
-
-
- AI wurde in C geschrieben und mit dem Manx Aztec C V 5.2a -
- Compiler kompiliert.
-
-
- AI benutzt die neuen DOS ReadArgs Funktionen für CommandLine-
- Parsing. Ebenfalls werden die Funktionen MatchFirst, MatchNext
- und MatchEnd für PatternMatching genutzt.
-
-
- Zum Schluß:
-
- Ich hoffe AddIcon wird von vielen Leuten benutzt. Sollten sich
- Fehler des Programms herausstellen, so schreibt mir. Auch kon-
- struktive Kritik und/oder Ideen sind willkommen.
-
-
- Adresse:
-
- Schickt alle Anschriften bitte an:
-
-
- Hans - Peter Günther
-
- Grüner Weg 5
-
- 3501 Fuldatal 2
-
- ( B.R.D )
-
- Liste der Dateien:
-
- (Fehlen ein oder mehrere dieser Dateien, ist diese Veröffentlichung inkomplett.
- Laßt mich das bitte wissen. )
-
- AddIcon.dok : Deutsche Dokumentation
- AddIcon.dok.info
- AddIcon.doc : Englische Dokumentation
- AddIcon.doc.info
- AddIcon : Das Programm
- AddIcon.info
- ReadMeFirst.doc : Englische Kurzübersicht
- ReadMeFirst.doc.info
- ReadMeFirst.dok : Deutsche Kurzübersicht
- ReadMeFirst.dok.info
- LegalStuff.doc : Englisch Rechliches
- LegalStuff.doc.info
- Rechtliches.dok : Deutsch Rechtliches
- LegalStuff.doc.info
-
- Icons (dir) : Verzeichnis mit verscheidenen Icon verscheiner
- Autoren. Unterligt natürlich nicht dem Copyright
-
- ---
- END
-
-
- Viel Spaß noch mit AI ...
-
- H.P.G
-