home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Fred Fish Collection 1.5
/
ffcollection-1-5-1992-11.iso
/
ff_progs
/
icons
/
addicon.lha
/
AddIcon.dok
< prev
next >
Wrap
Text File
|
1992-10-12
|
21KB
|
590 lines
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