@database BangerMenuDisk
@master Banger.guide
@$VER: 1.4 BangerMenuDisk.guide (20-Feb-96)
@author "Andre´ Trettin"
@(c) "Banger Software"
@index Index
@remark Anleitung zum Programm BangerMenuDisk

@node "Main" "Anleitung zu BangerMenuDisk"
@next "WasIst"
@prev "Main"
						   @{b}@{u}BangerMenuDisk@{ub}@{uu}

				   BangerMenuDisk 1.4 (20-Feb-96)


@{"Was ist BangerMenuDisk ?" link "WasIst" 0}     kurze Anleitung
@{"Rechtliches" link "Rechtliches" 0}                  Rechtliches und Vertrieb
@{"Systemvoraussetzungen" link "System" 0}        Kickstarts und Libraries vorhanden ?
@{"Installation" link "Install" 0}                 Manuelles Installieren
@{"Programm Bedienung" link "ProgBedienung" 0}           Ausführliche Bedienung des Programmes
@{"Konfigdatei Beschreibung" link "Konfig" 0}     Wie Konfiguriere ich BangerMenuDisk
@{"Mitgelieferte Konfig" link "Filekonfig" 0}         genaueres Betrachten der Beispiel-Konfig
@{"Fehlerbeschreibungen" link "Fehler" 0}         Fehler ? Warum ?
@{"Histroy" link "Histroy" 0}                      Versionsgeschichte
@{"Autor & Adresse" link "Autor" 0}              Kontakt Möglichkeiten
@endnode
@node "WasIst" "Was ist BangerMenuDisk ?"
@next "Rechtliches"
@prev "Main"
@{b}Was ist BangerMenuDisk ?@{ub}

BangerMenuDisk ist ein Programm das eine graphische selektive Auswahl beim Booten
ermöglicht mit eigener @{"Konfiguration" link "ProgBedienung" 0}. Beim Booten erscheint, wenn die
@{"CAPS-LOCK-Taste" link "ProgBedienung" 0} gedrückt wurde, ein Fenster, in dem je nach Konfiguration mehrere
Gadgets mit Programmen (oder Batchdateien) angezeigt werden. Durch Auswahl eines
dieser Gadgets wird dann das Programm oder das Skript ausgeführt. Entscheidet
man sich dann doch noch für den normalen Bootvorgang, muß nicht erst wieder
neu gebootet werden, sondern betätigt man statt dessen die @{"ESC" link "ProgBedienung" 0}- oder @{"Q-Taste" link "ProgBedienung" 0}
um das Programm abzubrechen.
@endnode
@node "Rechtliches" "Rechtliches"
@next "System"
@prev "WasIst"
@{b}Rechtliches@{ub}


Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig
ist. Ihr benutzt dieses Programm auf eigene Gefahr. Der Autor kann auf
keinen Fall für irgendwelche Schäden verantwortlich gemacht werden, die
durch die Anwendung dieses Programmes entstehen.

Weiterhin darf das Programm und der Quelltext zu `BangerMenuDisk' nicht zu
kommerziellen Zwecken jeder Art verwendet werden.
Programmpaket und die Dokumentation sollten ohne Veränderung weitergegeben
werden. Ferner sollten *KEINE* Dateien hinzugenommen werden oder selbige
verändert werden!

Der Quelltext ist völlig Public Domain und Giftware, aber es wäre nett, wenn
mich der jeweilige Programmierer in einer kleinen Danksagung erwähnen würde.
Auch wenn andere dieses Programm als Grundlage nehmen, um ein neues Programm zu
programmieren, sollten diese sich mit mir in Verbindung setzen, damit wir unsere
Aktivitäten koordinieren können.

Der Installer ist © bei Amiga Technologies (Division of ESCOM).
MagicWB is Copyright ©1992-1994 Martin Huttenloher.
@endnode
@node "System" "Systemvoraussetzungen"
@next "Install"
@prev "Rechtliches"
@{b}Systemvoraussetzungen@{ub}

Es wird für das Programm BangerMenuDisk @{b}Kickstart 2.04@{ub} oder höher benötigt.
Die gadtools.library sollte im LIBS: Verzeichnis vorhanden sein.
Die gadtools.library ist ab Kickstart 2.x standart.
@endnode
@node "Install" "Installation"
@next "ProgBedienung"
@prev "System"
@{b}Installation@{ub}

Bei der Disketten-Installation sollte das Programm BangerMenuDisk ins C-Ver-
zeichnis und die @{"Konfigdatei" link "Konfig" 0} ins S-Verzeichnis kopiert werden.
Bei Festplatten sollten alle Daten zum Programmpaket in ein bestimmtes
Verzeichnis auf der Platte kopiert werden. @{b}(z.B. Work:Tools/BangerMenuDisk)@{ub}
Hier ist der oberste Teil der Orginal-@{b}Startup-Sequence@{ub}.


@{b}; $VER: startup-sequence 39.9 (9.8.92)@{ub}

@{b}C:SetPatch QUIET
C:Version >NIL:
C:AddBuffers >NIL: DF0: 15
FailAt 21

C:MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys
C:Copy >NIL: ENVARC: RAM:ENV ALL NOREQ

Resident >NIL: C:Assign PURE
Resident >NIL: C:Execute PURE

Assign >NIL: ENV: RAM:ENV
Assign >NIL: T: RAM:T
Assign >NIL: CLIPS: RAM:Clipboards
Assign >NIL: REXX: S:@{ub}


@{i}  Und hier ist die geänderte Startup-Sequence@{ui}

; $VER: startup-sequence @{fg highlight}40.007 (4.8.95)
@{fg highlight}FailAt 21@{fg text}                                          ;BangerMenuDisk gibt einen Returncode
												   ;10 zurück wenn etwas ausgewählt wurde.
@{fg highlight}C:MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys@{fg text} ;Hier legen wir das T-Verzeichnis
@{fg highlight}Assign >NIL: ENV: RAM:ENV@{fg text}                          ;im Ram an. Das ist wichtig wenn
@{fg highlight}Assign >NIL: T: RAM:T@{fg text}                              ;BangerMenuDisk Skriptdateien ausführen soll
@{fg highlight}Assign >NIL: CLIPS: RAM:Clipboards@{fg text}                 ;soll.

@{b}<Pfad>
BangerMenuDisk@{ub} @{fg highlight}<Parameter>@{fg text}
IF ERROR THEN
 ENDCLI
@{b}ENDIF@{ub}

C:SetPatch QUIET
C:Version >NIL:
C:AddBuffers >NIL: DF0: 15

Resident >NIL: C:Assign PURE
Resident >NIL: C:Execute PURE

Assign >NIL: REXX: S:@{ub}
@endnode
@node "ProgBedienung" "Programm Bedienung"
@next "Konfig"
@prev "Install"
@{b}Programm Bedienung@{ub}

BangerMenuDisk kann nur aus der shell gestartet werden (Es ist gedacht, daß
das BangerMenuDisk aus der Startup-Sequence ausgeführt wird). Wenn Sie das
Menu bei jedem Starten sehen wollen, können Sie als Parameter Angabe
@{b}NOKEY@{ub} angeben. Dies ist vorteilhaft bei Disketten mit mehreren Programmen
(oder Spielen). Wird BangerMenuDisk ohne Parameter aufgerufen, muß die @{b}CAPS-@{ub}
@{b}LOCK-Taste@{ub} gedrückt sein, damit das Menu erscheint. Das hat den Grund, das
die normale Startup-Sequence immer beim Booten ausgeführt wird, wenn die
Taste nicht gedrückt wurde. Nur bei speziellen Anlässen erscheint das
Menu und man kann dann das Programm oder das Startup-Skript mit der Maus
wählen.
Für mausfaule User existiert die Möglichkeit, mit den Cursortasten
@{b}hoch@{ub} oder @{b}runter@{ub} die Gadgets zu markieren. Das Gadget wird mit der
Return-Taste ausgewählt. Werden die Cursortasten @{b}links@{ub} oder @{b}rechts@{ub} benutzt
wird entweder ganz am Anfang bzw. eine Spalte nach links (falls vorhanden)
oder Ende bzw. eine Spalte nach rechts gesprungen.
Das Programm wird mit dem Drücken des @{b}CLOSE-Gadgets@{ub} des Fenster
oder mit den Tasten @{b}ESC@{ub} und @{b}Q@{ub} abgebrochen. Dann wird die normale Startup-
Sequence weiter fortgeführt.
@endnode
@node "Konfig" "Konfigdatei Beschreibung"
@next "Filekonfig"
@prev "ProgBedienung"
@{b}Konfigdatei Beschreibung@{ub}

Die Konfigdatei muß immer BangerMenuDisk.Prefs heißen und wird dort, wo sich
das Programm BangerMenuDisk befindet oder im S: Verzeichnis gesucht.

Beispiel:   @{b}Programmname1
			Programmpfad1
			Programmname2
			Programmpfad2
			Programmname3
			Programmpfad3
			·
			·
			·@{ub}


siehe dazu auch die @{"mitgelieferte Konfigdatei" link "Filekonfig" 0} an.
@{b}Die Konfigdatei braucht kein ENDE mehr seit Version 1.220!@{ub}
Der Programmname erscheint nachher im Gadget. Wobei der Pfad ein voran
gestelltes Kommando wie RUN für Programme die sich nicht abkuppeln von der
CLI und ein NEWSHELL für Skripts stehen muß (und sollte), damit alles richtig
funktioniert.
Je länger der Programmname ist desto länger werden die Gadgets. Es passen
in eine Spalte 17 Gadgets und somit 17 Programmnamen. Es können je nach
länge des Programmnamen bis zu 70 Gadgets dargestellt werden (und mehr).
@endnode
@node "Filekonfig" "Mitgeliefertes Konfigfile"
@next "Fehler"
@prev "Konfig"
@{b}Mitgelieferte Konfig@{ub}

@{i}CD32@{ui}                                                @{b}1. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/CD32@{fg text}          der CD32 - Emulator zum Booten von CD32-CD´s
@{i}ShapeShifter@{ui}                                        @{b}2. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/ShapeShifter@{fg text}  hier wird für den MAC-Emulator eine Batch-Datei abgearbeitet
@{i}Directory Opus@{ui}                                      @{b}3. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/DOpus@{fg text}         für DOpus wird auch eine Batch-Datei ausgeführt
@{i}ADPro@{ui}                                               @{b}4. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/ADPro@{fg text}         ADPro braucht meist viel Speicher
@{i}VT 2.76@{ui}                                             @{b}5. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/VT2.76@{fg text}        gleich den Virenkiller starten damit kein Linkvirus im Speicher ist
@{i}Shell@{ui}                                               @{b}6. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/Shell@{fg text}         eine Shell für Programmierer von vorteil vielleicht
@{i}Seelenturm@{ui}                                          @{b}7. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenuDisk/Bat/Seelenturm@{fg text}    für Spiele die viel Speicher benötigen
@endnode
@node "Fehler" "Fehlerbeschreibungen"
@next "Histroy"
@prev "Filekonfig"
@{b}Fehlerbeschreibungen@{ub}

Returncodes:

10   =  kein Fehler. Das Programm ist vollständig abgelaufen und hat ihr
		Programm ihrer Wahl gestartet. Dieser Returncode ist dazu da, damit
		die Startup-Sequence abgebrochen werden kann und ihre Batchdatei
		ausgeführt wird.
21   =  kein Speicher
22   =  konnte Library (oder Libraries) nicht öffnen (dos,intuition,@{"gadtools" link "System" 0})
23   =  GetVisualInfo Fehler (Fenstergrafik Fehler)
24   =  konnte File @{"BangerMenuDisk.Prefs" link "Konfig" 0} nicht öffnen
25   =  bei der Gadgeterschaffung trat ein Fehler auf
26   =  konnte Fenster nicht öffnen oder Task nicht finden
27   =  @{"Einstellungen" link "Konfig" 0} sind Leer
28   =  kein Speicher für die Einstellungen
29   =  kein MsgPort
30   =  konnte kein IORequest belegen
31   =  konnte input.device nicht öffnen
32   =  Parameter Angabe falsch
@endnode
@node "Histroy" "Histroy"
@next "Danke"
@prev "Fehler"
@{b}Versions verlauf@{ub}

		1.210   erste Version im Aminet

		1.220   kein ENDE mehr zum Kennzeichen der Konfigdatei
				da in Defender als ENDE erkannt wurde.
				kleiner Bug im Screentitle

				Ein Anrufer aus Kanada sagte: BangerMenuDisk läuft nicht
				mit CROAK2 (Aminet/games/jump).
				Ich testete Croak2 von Workbench : Ergebnis kein Frosch da.
				Danach ohne Startup-Sequence : Ergebnis immer noch kein
				Frosch da (Spritefehler).
				So danach testete ich BangerMenuDisk. Wählte Shell aus und
				startete Croak2. Ergebnis nun war der Frosch da!
				Keine Ahnung warum!?!

		1.235   Kleine Veränderung am Layout (bei mehreren Spalten)

		1.4     unbenannt aus BangerMenu in BangerMenuDisk
				NOKEY Option Funktioniert nun. Spalten gelöst

	Testcomputer: A4000/30 25Mhz FPU 82 14MB Kick3.1 SCSI+AT CyberVision 4MB
				  A1200    28Mhz         6MB Kick3.0 AT
@endnode
@node "Danke" "Dankessagungen"
@next "Autor"
@prev "Histroy"
@{b}Dankessagungen in Alphabetischer Reihenfolge@{ub}

	Andreas             Für die tollen Vorschläge mit denen Version 3.0 entstand
						Ich wünsche Dir Glück für die letzte Prüfung

	A-Team-Box          für den Banger-Programm Einsatz, für das billige Daughter-
						board

	Michael Belter      für seinen Auftrag zum programmieren von BangerMenu
						Na, läuft der A2000er noch ? Melde dich mal !

	BEAViS              für die Fehler Meldungen, seine Ideen und EMail kontakt
						Schöne Grüße von Hamburg nach Kanada

	Eric                Dein DSA-Util ist riesig Groß. Weiter so !

	Fireball            fürs Beta-Testen all meiner erfolgreichen und nicht so
						erfolgreichen Programmen, Tips, Ideen, usw.
						Übung macht den Meister: Schreib mal das ARexx-Prog. für
						Fiasco

	Enriko Groen        für die erste Postkarte aus den Niederlanden

	Martin Huttenloher  für den MagicWB Standard

	MCP-Macher          für ihr geniales Programm !!!!!!!

	Rollenspieler       an alle Rollenspieler meiner Gruppen: Rollenspiel für immer

	Christian Schacht   für den VGA Vorschlag, und seine EMail

	Skobar              für die DSA-plaudereien auf IRC, wir müssen mal wieder ...
@endnode
@node "Autor" "Autor & Adresse"
@next "Main"
@prev "Danke"
@{b}Autor & Addresse@{ub}

			@{fg highlight}Andre' Trettin
			Duwockskamp 33
			21029 Hamburg
			Germany

			040/7246861

			EMail: tretti-a@rzbt.fh-hamburg.de !
			  WWW: http://www.fh-hamburg.de/~tretti-a/index.html@{fg text}


@{b}Programm Werbung@{ub}:   @{fg highlight}BangerVersion 1.357@{fg text}     @{b}Aminet/util/misc@{ub}
					schreibt die Versionnr. als Filekommentar

					@{fg highlight}BangerIsharIns@{fg text}          @{b}Aminet/game/patch@{ub}
					Installiert Ishar 1 auf Festplatte

					@{fg highlight}BangerFileChc@{fg text}          @{b}demnächst im Aminet@{ub}
					In der Testphase ein FileCheckerprog. für die
					Mailbox mit Erkennung auf doppelt und fakes
					und etlichen Filetypen. --> BangerFileChecker
					Wer interesse hat und den FileChecker testen
					möchte kann mir ja eine EMail schicken.
					Die Englische Anleitung fehlt nur noch.

					@{fg highlight}BangerDSA-KS@{fg text}            @{b}Aminet/game/role@{ub}
					Ist ein Kräutersuchprogramm für das Deutsche
					Rollenspiel DSA mit Kräuter Beschreibung.

					@{fg highlight}BangerKommKurz@{fg text}          @{b}Aminet/dev/asm@{ub}
					kürzt Kommentare aus Assembler Sourcecode und
					den Includes für Assembler. Dadurch ist ein
					schnelleres Übersetzen möglich
@endnode
@node "Index" "Index von BangerMenuDisk"

	 @{"Addresse" link "Autor" 0}
	 @{"Autor" link "Autor" 0}
	 @{"BangerMenuDisk.Prefs" link "Konfig" 0}
	 @{"CAPS-Lock-Taste" link "WasIst" 0}
	 @{"Close-Gadget" link "ProgBedienung" 0}
	 @{"Cusorsteuerung" link "ProgBedienung" 0}
	 @{"ESC-Taste" link "ProgBedienung" 0}
	 @{"Fehler" link "Fehler" 0}
	 @{"Histroy" link "Histroy" 0}
	 @{"Installation" link "Install" 0}
	 @{"Installationskript" link "Install" 0}
	 @{"Konfigdatei" link "Konfig" 0}
	 @{"Q-Taste" link "ProgBedienung" 0}
	 @{"Startup-Sequence" link "Install" 0}
@endnode
