@database "Apper.guide"
@node "Main" "Main / Apper V1.17 (c)'95 by André (CPU) Seidelt"

		APPER V1.17 (20.09.95)
    
 @{" Einleitung              " link "Einlei"}  Apper - wat'n dat'n?
 @{" Inhalt                  " link "Inhalt"}  Was gehört dazu?
 @{" Installation            " link "Instal"}  Installation - wie, was, wo?
 @{" System Anforderungen    " link "Anford"}  Was will Apper?
 @{" ToolTypes               " link "ToolTypes"}  Wie stelle ich was ein?
 @{" MenuFile                " link "MenuFile"}  Wie erzeuge ich was?

 @{" Autor                   " link "Autor"}  Der Progger...
 @{" Registrierung           " link "Regist"}  Wieso'n das?
 @{" Rechtliches             " link "Rechtl"}  Nicht mit mir!

 @{" Geschichte des Programs " link "history"}  Es war einmal...
 @{" ToDo                    " link "ToDo"}  Mal sehen...
 @{" Blablabla...            " link "Thx"}  Was ich noch loswerden wollte...

@endnode

@node "Einlei" "Einleitung / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b} Einleitung:@{ub}
	Die WB sieht ab KS2.0 mit 8-Farb Icon's, etc. ja recht nett aus,
	nur fehlten mir einige Dinge, die es auf anderen Rechnerplatt-
	formen gibt.
	Unter anderen ein AppIcon, das beim drüberziehen von Files diese
	löscht. Nach kurzer Suche in dieversen BBS'ses wurde ich mit
	TrashIcon V1.6 von Mark McPherson fündig. Ich verpasste ihm ein
	schönes Icon aus einem MagicWB-Clone und war wieder für einige
	Zeit glücklich. Bis, ja bis ich bei einem Freund zusehen mußte,
	wie er nen Icon eines ILBM-Bildes einfach über das "Anzeigen"-
	Dock seines ToolManagers zog, und dieser ihm das Ding dann mit
	"VT" anzeigte. Toll, dachte ich mir, nur wenn man da jetzt nen
	Guidefile drüberzieht, dann gibbet Probs....
	Zudem fand ich, das der ToolManager ne ganze Menge Speicher
	schluckt (ich hab schließlich nur 6MB :))) und das eigene Fenster
	vom ToolManager fand ich auch nicht so berauschend.
	Da ich aber ein AppIcon zum abspielen, anzeigen und starten haben
	wollte und in meinem BBS-Umkreis nichts fand, habe ich mir halt
	soetwas selbst geschrieben und um die Anzahl der in der WBStartup-
	schublade gestarteten Programme nicht übermäßig zu erhöhen habe ich
	die Funktionen von TrashIcon und AddMenu gleich mit implementiert.

@{b}Eigenschaften:@{ub}
	-Verwendet zum identifizieren der Dateitypen die whatis.library,
	 dadurch sehr einfach um neue Dateitypen zu erweitern.
	-Ist recht klein und schnell, weil 100% Assembler. (Das Icon vom
	 Apper ist größer als das Programm selber ;))
	-Das Aussehen und die Position der AppIcons ist genauso frei kon-
	 figurierbar wie die Sicherheitsrequester und der meiste andere
	 Kram.
@endnode

@node "Inhalt" "Inhalt / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Inhalt:@{ub}
    Apper package:
	apper.info
	apper/Apper
	apper/Apper.info
	apper/Install_Apper
	apper/Install_Apper.info
	apper/Apper_deu.guide
	apper/Apper_deu.guide.info
	apper/Apper_eng.guide
	apper/Apper_eng.guide.info
	apper/S
	apper/S/Apper.info
	apper/S/Apper4col.info
	apper/S/TrashIcon.info
	apper/S/TrashIcon4col.info
	apper/S/FileTypes
	apper/S/ToolsMenu
	apper/S.info

    Whatis.library package:
	apper/WhatIs
	apper/WhatIs/include
	apper/WhatIs/c
	apper/WhatIs/s
	apper/WhatIs/libs
	apper/WhatIs/InstallLib
	apper/WhatIs/InstallLib.info
	apper/WhatIs/Product-Info
	apper/WhatIs/s.info
	apper/WhatIs/WhatIsLibrary.doc
	apper/WhatIs/WhatIsLibrary.doc.info
	apper/WhatIs/AskReparse
	apper/WhatIs/env.lzx
	apper/WhatIs/include/proto
	apper/WhatIs/include/pragmas
	apper/WhatIs/include/libraries
	apper/WhatIs/include/clib
	apper/WhatIs/include/proto/whatis.h
	apper/WhatIs/include/pragmas/whatis_pragmas.h
	apper/WhatIs/include/libraries/WhatIsBase.h
	apper/WhatIs/include/clib/whatis_protos.h
	apper/WhatIs/c/WBInfo.c
	apper/WhatIs/c/WBRun
	apper/WhatIs/c/WBRun.doc
	apper/WhatIs/c/BaseName
	apper/WhatIs/c/BaseName.c
	apper/WhatIs/c/For
	apper/WhatIs/c/For.c
	apper/WhatIs/c/For.doc
	apper/WhatIs/c/TackOn
	apper/WhatIs/c/TackOn.c
	apper/WhatIs/c/tiny_For
	apper/WhatIs/c/tiny_For.c
	apper/WhatIs/c/VolName
	apper/WhatIs/c/VolName.c
	apper/WhatIs/c/WBInfo
	apper/WhatIs/c/AddIcon
	apper/WhatIs/c/AddIcon.c
	apper/WhatIs/s/FileTypes
	apper/WhatIs/s/FileTypes.info
	apper/WhatIs/libs/whatis.library
	apper/WhatIs.info
@endnode

@node "Instal" "Installation / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Installer-Script:@{ub}
	Einfach das Install-Icon doppelklicken und dann den Anweisungen
	im Script folgen folgen (Sorry, ich wollte den Installer nehmen,
	nur waren meine Installer-Unterlagen nicht mehr aufzufinden).
	Danach noch in den @{"ToolTypes" link "ToolTypes"} die Konfiguration vornehmen
	und das @{"MenuFile" link "MenuFile"} nach Wunsch verändern, fertig.

@{b}Per Hand:@{ub}
	- Die whatis.library aus dem Verzeichnis "Whatis37/Libs" ins LIBS:
	  Verzeichnis kopieren.
	- Die Dateien aus "S" nach S: kopieren.
	- Den Apper mit Icon nach SYS:WBStartup kopieren.
	- Die @{"Tooltypes" link "ToolTypes"} nach Bedarf verändern.
	- Den Rechner neu starten.

@{b}Die Befehle:@{ub}
	cd <Verzeichnis wo der Apper drinne ist> [RETURN]
	copy WhatIs37/Libs/whatis.library libs: [RETURN]
	copy s/#? s: [RETURN]
	copy Apper SYS:WBStartup/ [RETURN]
	copy Apper.info SYS:WBStartup/ [RETURN]
@endnode

@node "Anford" "Anforderungen / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Benötigt wird:@{ub}
	- Mindestens KS 2.x, wer das noch nicht hat, sollte sich begraben
	  lassen. ;)
	- whatis.library 2.x+
	- Die Wahnsinnsmenge von ca.60kb Speicher.
@endnode

@node "ToolTypes" "ToolTypes / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}ToolTypes:@{ub}
	AppText=	: Der Text, der unter dem ApperIcon erscheinen soll,
			  wenn der Text leer gelassen wird, erscheint kein
			  Text unter dem Icon. (Default: Apper)
	TrashText=	: Der Text, der unter dem TrashIcon erscheinen soll,
			  wenn der Text leer gelassen wird, erscheint kein
			  Text unter dem Icon. (Default: Trash)
	AppXPos=	: X-Position des Apper-Icons (Default: keine Pos.)
	AppYPos=	: Y-Position des Apper-Icons (Default: keine Pos.)
	TrashXPos=	: X-Position des Trash-Icons (Default: keine Pos.)
	TrashYPos=	: Y-Position des Trash-Icons (Default: keine Pos.)
	AppIconPath=	: Pfad und Name des Icons, das Apper für sein
			  AppIcon benutzen soll. (ohne ".info")
			  Wenn hier nichts angegeben ist, verwendet Apper
			  sein ProgrammIcon
	TrashIconPath=	: Pfad und Name des Icons, das Apper für sein
			  TrashIcon benutzen soll. (ohne ".info")
			  Wenn hier nichts angegeben ist, verwendet Apper
			  sein ProgrammIcon
	MenuFile=	: Pfad und Name des @{"Menufiles" link "MenuFiles"}.
	ErrorRequest=	: (YES/NO) Erlaubt/Unterbindet Fehlermeldungen
			  (z.B. wenn der Dateityp unbekannt ist oder keine
			  Action für den Dateityp definiert wurde).
	ExitRequest=	: (YES/NO) Erlaubt/Unterbindet die Sicherheitsab-
			  frage zum beenden des Programmes, wenn eines der
			  Icons "doppelgeklickt" wird.
	DeleteRequest=	: (YES/NO) Erlaubt/Unterbindet die Sicherheitsab-
			  frage des TrashIcons beim löschen.
	TrashIcon=	: (YES/NO) Erlaubt/Unterbindet das erzeugen des
			  TrashIcons.
	(Default aller YES/NO-Switches: YES)

@{b}Actions:@{ub}
	Die Actions werden auch in den ToolTypes definiert und haben
	folgendes Aussehen:
		<IDString>=<Programm> [Optionen] %s%s [Optionen]

	IDString:	Wird von der WhatIs.library erzeugt
			(z.B. ILBM).
	Programm:	Das Programm, das gestartet werden soll
			(z.B. MultiView).
	%s%s:		Fügt Pfad (erstes %s) und Dateiname (zweites %s)
			des darübergezogenen Icons ein
			(z.B. Bilder:Fantasy/Dragon).
	Optionen:	Sind optional und für das Programm, das gestartet
			werden soll von Bedeutung (z.B. SCREEN).

	Aussehen würde das Ganze dann so:
		ILBM=MultiView %s%s SCREEN
	Der Apper würde jetzt beim drüberziehen der Datei "Dragon" aus dem
	Directory "Bilder:Fantasy/" die Befehlszeile
		MultiView Bilder:Fantasy/Dragon SCREEN
	ausführen (natürlich nur, wenn sie ein IFF-ILBM Bild ist).
@endnode

@node "MenuFile" "MenuFile / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}MenuFile@{ub}
	Ein "#" als erstes Zeichen einer Zeile erzeugt einen Menueintrag mit
	dem Text, der dem "#" folgt.
	Nach dem "#" folgt dann ein Kommando, das ausgeführt werden soll, es
	muß mit einem "_" beginnen.
	Optional kann noch ein Pfad angegeben werden, in den gewechselt
	werden soll, bevor das Programm gestartet wird. Er muß mit einem "."
	beginnen und gilt nur für das direkt auf ihn folgende Kommando.
	Das "=" kann z.b. auch zur Erzeugung eines Trennstriches verwendet
	werden, wenn man Einen Menueintrag nur aus "=" Erzeugt und das
	Kommando einfach wegläßt (es ist wohl selbstverfreilich, das dann
	beim Anwählen des Menupunktes nix passiert, oder ? ;)).
	Alle Zeilen, die mit einem anderen Zeichen als den drei oben be-
	schriebenen beginnen werden ignoriert (d.h. auch zwischen Eintragsname
	und Kommando kann eine Kommentarzeile stehen).
@endnode

@node "Autor" "Autor / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Autor:@{ub}
	Fastnet	: CPU@SETUP
		  CPU@Orkland

	E-Mail:
		cpu@karsen.be.schule.de

	SETUP:
		Port 1 - +49 (o)3o 683 48 81  TKR 19k2
		Port 2 - +49 (o)3o 683 48 91  NN  14k4
		Port 3 - +49 (o)3o 683 45 43  NN  14k4

	Orkland:
		Port 1 - +49 (o)3o 6o6 99 73
		Port 2 - +49 (o)3o 6o6 99 74
		Port 3 - +49 (o)3o 6o6 99 75
		Port 4 - +49 (o)3o 6o6 99 76
		Port 5 - +49 (o)3o 6o6 s0 0n
        (Mails, etc. an CPU schicken)

@{b}Briefpost:@{ub}
	André (CPU) Seidelt
	Holzmindener Str.1
	12347 Berlin
	Germany
@endnode

@node "Regist" "Registrierung / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Registrierung@{ub}
	Der Apper ist Cardware/Mailware, das heißt, wenn du das Programm
	installierst und es regelmäßig benutzt, dann möchte ich von dir
	eine Postkarte oder eine E-Mail geschickt bekommen. (Adresse siehe
	@{"Autor" link "autor"})
	Du solltest deinen Absender bitte mit angeben, damit ich weiß, woher
	die Postkarte gekommen ist.

	Wenn jemand Interesse an dem Source verspüren sollte (oh je), dann
	kann er's ja auf seiner Postkarte/in seiner Mail vermerken, evtl.
	lasse ich mich ja weichklopfen. ;)))
@endnode

@node "Rechtl" "Rechtliches / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b} Rechtliches:@{ub}
	DIE BENUTZUNG DES APPER'S IST FREI (SOLANGE WIE DER UNTER
	@{"REGISTRIERUNG" link "regist"} ANGEGEBENEN PUNKT ERFÜLLT WURDE), UND ER DARF, BZW.
	SOLL IN MAILBOXEN "UPGELOADET" ODER IN PD-SERIEN AUFGENOMMEN WERDEN.
	ALLERDINGS SOLLTE DER ARCHIVEINHALT NICHT VERÄNDERT WERDEN, DAS HINZU-
	FÜGEN VON MAILBOXWERBUNG IST ALLERDINGS GESTATTET.
	DER VERKAUF DES APPERS IST UNZULÄSSIG, ALLERDINGS DARF EINE KOPIER-
	GEBÜHR FÜR DIE DISKETTE, DIE DEN APPER ENTHÄLT, VERLANGT WERDEN, SO-
	LANGE DIESE 5,- DM (BZW. 5$ ODER DER ENTSPRECHENDE GEGENWERT IN
	EINER ANDEREN WÄHRUNG) NICHT ÜBERSTEIGT !!!

	ICH ÜBERNEHME KEINERLEI GARANTIE FÜR DIESES PROGRAMM. WER ES IN-
	STALLIERT UND BENUTZT TUT DIES AUF EIGENE GEFAHR. ICH KANN KEINES-
	FALS FÜR IRGENDWELCHE HARD- ODER SOFTWAREVERLUSTE VERANTWORTLICH
	GEMACHT WERDEN.
	DIE WHATIS.LIBRARY IST (C) 1994 BY SYLVAIN ROUGIER UND PIERRE
	CARRETTE, FÜR SIE GELTEN DIE IM "WHATISLIBRARY.DOC" NIEDERGELEGTEN
	COPYRIGHT UND HAFTUNGSBESTIMMUNGEN.
@endnode

@node "History" "History / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Idee@{ub}
	Die kam mir am 12.08.95.

@{b}History@{ub}
       <V1.00	- Vergisses man....;)

	V1.03	- Erste Betaversion, noch ohne TrashIcon (14.08.95).

	V1.10	- Zweite Betaversion, Trashicon kann noch keine Dir's.
		  löschen.

	V1.11	- Das Löschen der Dir's geht solange gut, bis eine
		  Datei löschgeschützt ist, dies hatte einen Absturz
		  zur Folge.

	V1.13	- Erster Release (17.08.95).

	V1.14	- Harmlosen Fehler in der Komandozeilenzusammensetzundstart-
		  routine entfernt.

	V1.15	- Die Möglichkeit Einträge im Tools-Menu der WB hinzuzufügen
		  eingebaut.
		- Zweiter Release (19.08.95).

	V1.16	- Ein Tools-Menu-Eintrag kann jetzt mehrere Kommandos aus-
		  führen.
		- Der Apper wechselt jetzt vor dem starten der Menu-Programme
		  in ein das Dir, das man im angibt.
		- Dritter Release (20.08.95).

	V1.17	- Wenn man den Apper vom CLI aus gestartet hat, dann hat er
		  nach Ausgabe der Fehlermeldung das Aktuelle-Dir verbogen.
		- Vierter Release (22.08.95)
@endnode

@node "ToDo" "ToDo / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}ToDo:@{ub}
	- Evtl. mehrere Actions für einen Dateityp ermöglichen, die dann
	  mit einem Requester abgefragt werden.
	- Das Teil zum Commoditie modifizieren (ich weiß nich, macht den
	  Code doch nur unnötig größer...) ?
	- Für jede eintreffende AppMsg einen eigenen Prozeß starten, das
	  würde bewirken, daß der Apper vollständig asynchron arbeiten
	  könnte.
	- Was weiß ich... (macht verdammtnochmal Vorschläge, wenn euch was
	  nicht paßt ;))
@endnode

@node "Thx" "Danke / Apper V1.17 (c)'95 by André (CPU) Seidelt"
@{b}Kommentare:@{ub}
	- Nehmt mir mein Deutsch in dieser Anleitung nicht übel, sobald
	  ich an einer Tastatur sitze verfalle ich meinen "Chatjargon"
	  und mein mieses Deutsch trägt auch nicht unbeding zur Leser-
	  lichkeit dieses Guides bei.
	- Nebenbei bemerkt: wie ihr aus den englischen Texten im MenuFile
	  und im Filetypes entnehmen könnt, ist mein Englisch auch nicht
	  viel besser (wer hat sowas unlogisches wie Sprachen erfunden ?).
	- Die Herkunft der beiden Icons ist ungeklärt. Das ApperIcon
	  habe ich aus einem WB-Snappshot ausgeschnitten, wo es als
	  ToolManager-Dock diente, und den Mülleimer vom Trashicon habe
	  ich in dem selben Snappshot aus einem Icon für TrasIcon aus-
	  geschnitten. Wenn sich einer der Autoren der Icons ungerecht
	  behandelt fühlt kann er's mir ja sagen.
	- GRINS, gerade fällt mir da was auf: Man kann mit dem Apper keine
	  Icons anzeigen lassen !!! ;)))))))))))))

@{b}Grüße:@{ub}
	  Benny, Bluethunder, Bunny, Crush, Curley Sue, Dr.Damage, Dude,
	  El Kamehl, Ernie, HCL, Kadetti, Kathy, Klecks, Magnetic, Maverick,
	  Mr.Sam, Nobody, Orog Ork, Panter, Phantom, Power, RAM, Reiner,
	  Relax, RoadRunner, Schlaefer, Shadow, Silja, Soulman, Tachy,
	  Thorsten, Thrawn, Thunderhawk, WingThor

@{b}Danksagungen:@{ub}
	- Ich danke meinen Eltern, daß sie ab und an für Nahrungszufuhr
	  gesorgt haben.

	- Ich danke Mozart, Beethoven, Vivaldi, Brahms, Tschaikovsky,
	  Mendelssohn, Grieg, Verdi, TiamaT, Paradise Lost, Iron Maiden,
	  Metallica, Slayer, Rage against the machine, D.A.D., Skid row,
	  AC/DC, Marillion und den Toten Hosen dafür, daß sie mich
	  musikalisch aufgeheitert haben !!!

	- Ich danke RoadRunner für den DevPac V2.0, Markus Junginger für
	  seinen MegaEd V1.0, Michael Sinz für den Enforcer V37, Peter
	  Stuer für DosTrace V2.13 und Andreas Gelhausen für Scout V37.116.

	- Den Autoren der whatis.library dafür, daß die Entwicklerdokumente
	  der whatis.library für Assemblerprogrammierer so gut wie garnicht
	  zu gebrauchen sind. ;(((
	  (die Lib ist trotzdem genial)

	- UND ICH DANKE DEM AMIGA DAFÜR, DAß ES IHN GIBT !!!

	- UND ESC*M DAFÜR, DASS SIE DIE AMIGALINIE WEITERFÜHREN: MACHTS
	  BESSER ALS DIE C= LEUTE !!!
@endnode
