@database BangerMenu
@master Banger.guide
@$VER: BangerMenu_Eng.Guide 2.01 (09-Jan-96)
@author "Andreī Trettin"
@(c) "Banger Software"
@index Index
@remark A Guide to BangerMenu

@node "Main" "BangerMenu Documentation"
@next "WhatIs"
@prev "Main"
						 @{b}@{u}BangerMenu@{ub}@{uu}

				 BangerMenu 2.01 (09-Jan-96)


@{"What is the use of BangerMenu?" link "WhatIs" 0}    A short introduction
@{"Copyright" link "Copyright" 0}                         Copyright and other important things
@{"System requirements" link "System" 0}               Everything you need to start BangerMenu
@{"Installation" link "Install" 0}                      How to install manually
@{"How to use BangerMenu" link "Usage" 0}             A short instruction manual
@{"Keyboard control" link "Tastatur" 0}                  How to control BangerMenu ?
@{"How to setup a configuration" link "config" 0}      A short description how to setup a configuration file
@{"An example configuration" link "fileconfig" 0}          For a closer look at such a file
@{"Error description" link "error" 0}                 Error ? Why ?
@{"Histroy" link "Histroy" 0}                           Versions and Bug report
@{"Thanks" link "Danke" 0}                            Thanks and greetings
@{"Contact" link "Autor" 0}                           My adress
@endnode
@node "WhatIs" "What is the use of BangerMenu?"
@next "Copyright"
@prev "Main"
@{b}What is the use of BangerMenu?@{ub}

With BangerMenu you can make a selection to execute batch files and to launch
programs by using a graphical user interface. It is similar to MS-DOS Start
menu.

If you press the @{b}Caps Lock@{ub} key during the boot process a window will
appear.  This window contains buttons to execute batch files and to launch
programs according to the programs configuration. To execute batch files
or to launch programs select one of the gadgets. If you changed your mind
and you wanted to go on with your startup-sequence then press @{b}Escape@{ub} or the
@{b}Q@{ub} key to quit the program.
@endnode
@node "Copyright" "Copyright"
@next "System"
@prev "WhatIs"
@{b}Copyright@{ub}

This programm is @{b}GIFTWARE@{ub}. If you like this programm and if you
use it often you can send me an exciting postcard from you hometown
or other things. @{"contact" link "Autor" 0} .
If you have some good idees to make this programm better or if you found some
bugs (I hope not) I would be pleased about a postcard from you.
If you are writing programms too I allow you to use my code (it`s in assembler)
to copy programmparts for your own programm.

@{b}Use it at your own risk!@{ub}

The Installer is copyright by Amiga Technologies (Divison by ESCOM)
MagicWB is copyright 1992-1994 Đ by Martin Huttenloher.
@endnode
@node "System" "System requirements"
@next "Install"
@prev "Copyright"
@{b}System requirements@{ub}

To run BangerMenu you need Kickstart 2.04 or a later version. The gadtools.library
has to be in your "Libs:" directory. Since library is included in your
"Libs:" directory since Kickstart 2.04.
@endnode
@node "Install" "Installation"
@next "usage"
@prev "System"
@{b}Installation@{ub}

To install BangerMenu onto a separate disc you should copy the program BangerMenu in your
@{b}:c/@{ub} directory and the configuration file in your @{b}:s/@{ub} directory.

To install BangerMenu onto your hard disc you should copy the every file of the
program package into a directory, for example @{fg highlight}"Work:Tools/BangerMenu"@{fg text}.

This is the top of the original startup-sequence.


@{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}  And this are the necessary changes, if you use BangerMenu without
  a particular monitor@{ui}

; $VER: startup-sequence @{fg highlight}40.??? (30-Aug-95)
@{fg highlight}FailAt 21
C:
MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys@{fg text}   ;to create the T-dirctory to ram
@{fg highlight}Assign >NIL: ENV: RAM:ENV@{fg text}                          ;this is needed to run
@{fg highlight}Assign >NIL: T: RAM:T@{fg text}                              ;skripts by BangerMenu
@{fg highlight}Assign >NIL: CLIPS: RAM:Clipboards@{fg text}

@{b}<Pfad>@{ub}
@{b}BangerMenu@{ub}                                         ;this will be copied to
@{b}IF ERROR THEN@{ub}                                      ;startup-sequence
 @{b}ENDCLI
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}


@{i}  And this are the necessary changes, if you use BangerMenu with a
   monitor like VGA or Euro72 (etc.)@{ui}

; $VER: startup-sequence @{fg highlight}40.??? (30-Aug-95)
@{fg highlight}FailAt 21
C:
MakeDir RAM:T RAM:Clipboards RAM:ENV RAM:ENV/Sys@{fg text}   ;to create the T-dirctory to ram
@{fg highlight}Assign >NIL: ENV: RAM:ENV@{fg text}                          ;this is needed to run
@{fg highlight}Assign >NIL: T: RAM:T@{fg text}                              ;skripts by BangerMenu
@{fg highlight}Assign >NIL: CLIPS: RAM:Clipboards@{fg text}
@{fg highlight}C:SetPatch QUIET@{fg text}                                   ;this is necessary for the monitordriver

@{fg highlight}DEVS:Monitors/VGAOnly@{fg text}                              ;if VGAOnly in the Monitors-Dir, then you
												   ;must add this line to startup-sequence

@{b}<Pfad>@{ub}
@{b}BangerMenu@{ub} <@{fg highlight}@{i}Treiber@{ui}@{fg text}> @{b}monitorid@{ub}=<@{fg highlight}@{i}IDNumber@{ui}@{fg text}>          ;look at @{"usage" link "usage" 0}
@{b}IF ERROR THEN@{ub}
 @{b}ENDCLI
ENDIF@{ub}

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 "usage" "How to use BangerMenu"
@next "Tastatur"
@prev "Install"
@{b}How to use BangerMenu@{ub}

BangerMenu can only be started by using the shell.

If you would like to see the menu every time you boot then you have to add
the parameter @{b}nokey@{ub} in your @{"startup-sequence" link "Install" 0}. This is favourable for
floppy discs with more than one application or game.

If you call BangerMenu without any parameters you have to press the @{b}Caps Lock@{ub} key
to start the menu. If you did not press the @{b}Caps Lock@{ub} key the ordinary
@{b}startup-sequence@{ub} will be executed.

BangerMenu can be cancelled by pressing the @{b}close@{ub} gadget, escape or the @{b}q@{ub} key. In
this case your ordinary startup-sequence will be continued.

New at version 2.0 you can load a monitordriver. 1. Setpatch must run before
BangerMenu. 2. If VGAOnly in the DEVS:Monitors-Dir then must the program run
before BangerMenu, too. 3. You must give the monitordriver name and the
idnumber.

Look at example:

@{b}BangerMenu@{ub} @{fg highlight}DEVS:Monitors/VGA@{fg text} @{b}monitorid@{ub}=@{fg highlight}233508@{fg text}

Here is a list of IDs and there solutions

@{b}   MONITORID    MONITORDRIVER          SOLUTIONS@{ub}
	102400      DEVS:Monitors/NTSC      640*200    ;standard (USA)
	167936      DEVS:Monitors/PAL       640*256    ;standard (Europe)
	233508      DEVS:Monitors/Multiscan 640*480
	430116      DEVS:Monitors/Euro72    640*400
	561192      DEVS:Monitors/Super72   800*600
	626688      DEVS:Monitors/DblNTSC   640*400
	692224      DEVS:Monitors/DblPAL    640*512

This list is not complete. For more IDnumber you can look at the includes
@{b}graphics/modeid.@{ub}(@{b}i@{ub}/@{b}h@{ub}) or sent me @{"Mail" link "Autor" 0}
this the solution.
It is possible to represent the solution of a graphicboard like CyberVision on
BangerMenu. You must only know the monitorID-number. To get the number look
at the developersoftware.
New at version 2.01 you can use @{b}BangerMonitorID@{ub} to get the ID-number of any solution
you want.
@endnode
@node "Tastatur" "Keyboard control"
@next "config"
@prev "usage"
@{b}Keyboard control@{ub}

@{fg highlight}Cursor@{fg text}    @{b}Up@{ub}: active the gadget before
			  if this gadget the last one, then active the gadget in the
			  next columm
	+  @{fg highlight}Shift@{fg text}: the first gadget in this columm
		@{b}Down@{ub}: active the next gadget, if this gadget the last one,
			  then active the first gadget in the next columm
	+  @{fg highlight}Shift@{fg text}: the last gadget in this columm
		@{b}Left@{ub}: the next columm will active is this the last columm
			  on this page the next page will represent
	+  @{fg highlight}Shift@{fg text}: the first columm of the page will active
	+   @{fg highlight}Ctrl@{fg text}: the page before will active
	   @{b}Right@{ub}: the gadget in the next columm will active, is this the
			  last columm on this page the next page will active
	+  @{fg highlight}Shift@{fg text}: the last columm of the page will active
	+   @{fg highlight}Ctrl@{fg text}: the next page will active, if this the last
			  page, the first one will represent

 @{b}>@{ub}          : a page to right
 @{b}<@{ub}          : a page to left

 @{b}Return@{ub}     : active gadget executing (equal mouseklick on gadget)

 @{b}q,Q,ESC@{ub}    : quit @{b}BangerMenu@{ub} withou doing nothing, the normal
			  Startup-sequence will executed (equal to click on CLOSE-
			  Gadget of the window)
@endnode
@node "config" "How to setup a configuration"
@next "Fileconfig"
@prev "Tastatur"
@{b}How to setup a configuration@{ub}

The configuration file has to be called @{b}BangeMenu.Prefs@{ub} and needs to be
stored either in the directory of the program or in your @{b}S:@{ub} drawer.

example:    @{b}programname1
			programpath1
			programname2
			programpath2
			programname3
			programpath3
			·
			·
			·@{ub}


Donīt use at the end of the config the word @{b}ENDE@{ub} (the german word
for end). I have remove it since version 1.220. Thanks goto canadian.
For further information please have a look at the configuration file of
the program package.
Maybe you have to add to some programpaths a @{b}Run >NIL:@{ub}.
For batchfiles use NEWSHELL from <batchfile>.
Now you can use till 2560 gadget on till 10 pages.
@endnode
@node "fileconfig" "Example of an config file"
@next "error"
@prev "config"
@{b}Example of an config file@{ub}

@{i}CD32@{ui}                                                @{b}1. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/CD32@{fg text}          the CD32 - emulator to boot cd32īs from cd-rom
@{i}ShapeShifter@{ui}                                        @{b}2. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/ShapeShifter@{fg text}  here starts the mac
@{i}Directory Opus@{ui}                                      @{b}3. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/DOpus@{fg text}         DOpus will starts
@{i}VT 2.76@{ui}                                             @{b}4. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/VT2.76@{fg text}        viruskiller at beginning
@{i}Shell@{ui}                                               @{b}5. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/Shell@{fg text}         a Shell
@{i}ReOrg@{ui}                                               @{b}6. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/ReOrg@{fg text}         reorganize needs a lot of memory
@{i}Croak2@{ui}                                              @{b}7. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/Croak2@{fg text}        a game to relax
@{i}DrMario@{ui}                                             @{b}8. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/DrMario@{fg text}       some games needs a lot of memory, too
@{i}Ishar I@{ui}                                             @{b}9. Gadgetname@{ub}
@{fg highlight}Newshell from HD1:Misc/BangerMenu/Bat/Ishar1@{fg text}        or old games donīt like AGA
@endnode
@node "error" "Error description"
@next "Histroy"
@prev "fileconfig"
@{b}Error description@{ub}

Returncodes description

10   =  No errors. The program has been run without any mistakes and your
		selection has be executed. This returncode is for aborting your
		startup-sequence and executing a batch file.
21   =  No memory
22   =  Was not able to open library or libraries (dos, intuition,@{"gadtools" link "System" 0} )
23   =  GetVisualInfo error (Windowgraphic error)
24   =  @{"BangerMenu.Prefs" link "config" 0} could not be opened.
25   =  During the creation of the gadget a mistake has happened.
26   =  Could not open the window or could not find the task
27   =  @{"Preference" link "config" 0} are empty
28   =  Preference are empty
29   =  No MsgPort
30   =  Could not use any IORequest
31   =  Could not open input.device
32   =  Error during the parsing of the parameters
33   =  to much gadgets (>2560)
34   =  error to load monitordriver
35   =  id number not found (false)
36   =  couldnīt open screen
@endnode
@node "Histroy" "histroy"
@next "Danke"
@prey "error"
@{b}Version and Bug report@{ub}

		1.210   first aminet release

		1.220   remove ENDE checkrountine from configfile;
				(for example: defender...)
				little bug in the screentitle

				test CROAK2 (aminet/game/jump):
				workbench: the frogsprite have a error
				without startup-sequence: the same
				with BangerMenu: the frogsprite will be appear !
				i donīt know why !?!
				thanks Steven Becker from canada

		1.235   bug in layout (by more columm)
				thanks Steven Becker

		1.237   error by assemblieren, fix columm now
				thanks again Steven Becker

		2.0     new till 2560 gadgets
				new till 10 pages
				new can open the workbench in different solutions
				can run on gfxborad like CyberVision
				a new logcial keyboard control

	test computer A4000/30 FPU 82 25Mhz 14MB  Kick3.1  SCSI+AT CyberVision 4MB
				  A1200           28Mhz  6MB  Kick3.0  AT
@endnode
@node "Danke" "Thanks and greetings"
@next "Autor"
@prev "Histroy"
@{b}Thanks and greetings in alphabetical list@{ub}

	A-Team-Box          for the cheap daughterboard and the Banger-support

	Michael Belter      for his idea on BangerMenu.

	BEAViS              for all his ideas, bugreport and Emails
						nice greetings from hamburg to canada

	Fireball            for beta-testing, ideas, cheats, etc

	Enriko Groen        for his first postcard from the netherlands

	Christian Schacht   for his VGA suggestion and EMail

	Martin Huttenloher  for the MagicWB-Standard
@endnode
@node "Autor" "Author & Adress"
@next "Main"
@prev "Histroy"
@{b}Author & Address@{ub}

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

			040/7246861

			EMail: tretti-a@rzbt.fh-hamburg.de@{fg text}


@{b}Program advertising@{ub}: @{fg highlight}BangerVersion 1.357@{fg text}    @{b}aminet/util/misc@{ub}
					 writes the versionstring as filecomment

					 @{fg highlight}BangerIsharIns@{fg text}          @{b}Aminet/game/patch@{ub}
					 install Ishar 1 on HD

					 @{fg highlight}BangerFileChc@{fg text}          @{b}the next time in Aminet@{ub}
					 A FileChecker for the mailbox is in a test
					 phase. The checker can check on double,
					 fakes and many filetypes. --> BangerFileChecker
					 If you want to test the filechecker for the
					 mailbox then send me a email
					 I must write only the english guide still
@endnode
@node "Index" "Index of BangerMenu"

	 @{"Address" link "Autor" 0}
	 @{"Author" link "Autor" 0}
	 @{"BangerMenu.Prefs" link "config" 0}
	 @{"CAPS-Lock-Key" link "WhatIs" 0}
	 @{"Close-Gadget" link "Usage" 0}
	 @{"Cusorsteuerung" link "Usage" 0}
	 @{"Thanks ang Greetings" link "Danke" 0}
	 @{"ESC-Key" link "Usage" 0}
	 @{"Error" link "error" 0}
	 @{"Histroy" link "Histroy" 0}
	 @{"Installation" link "Install" 0}
	 @{"Installationscript" link "Install" 0}
	 @{"Config" link "config" 0}
	 @{"Q-Key" link "Usage" 0}
	 @{"Startup-sequence" link "Install" 0}
	 @{"Keyboard control" link "Tastatur"0}
@endnode
