AIAB r10c (for WinUAE) Assembled by Jaybee					      19/12/02
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~					      ~~~~~~~~

Hi there UAE fans! Its Jaybee, an ex-miggy owner bringing you 'Amiga In A Box' !

Whats It All About?
~~~~~~~~~~~~~~~~~~
AmigaInABox, is the essential download for all UAE freaks. To be brief, its a 'snapshot' of
a nice-looking Workbench, setup for UAE.  This isnt just any old 'snapshot' however; every-
think here has been painstakingly setup for immediate use.  The main archive extracts into
the WinUAE path, meaning a Kickstart ROM and a Workbench ADF are all thats needed!

For most UAE users the Amiga OS can be pretty daunting (and ugly). There is help on how to
get everything working, provided you can be bothered to follow the twenty-odd links looking
for it. You could try asking on an Amiga emulation discussion board, but your questions will
either get ignored, or someone will reply with "Get it off Aminet..." - which isnt much help,
since you're unlikley to know what Aminet is, let alone the site url for it!   Well, with
AmigaInABox (AIAB) you can kiss to all those headaches goodbye, as practically everything you
could ever need is here - already pre-configured;  MUI, Picasso96, Glow/Newicons, MagicMenu,
even applications to get you on the net!

Prepare to delete all those wierdly named LZX, LHA archives, and make room for just one easy
zip; this is *real* Amiga emulation, as good as it gets - this is an Amiga In A Box.

-------------------------------------------------------------------------------------------

Installation   (Note: A more detailed guide with screenshots, can be found on the AIAB site)
~~~~~~~~~~~~   (at the following url:   http://aiab.emuunlim.com/installing/index.html	   )
               (info on using AIAB with MacUAE can also be found at the same page.         )

Linux:
~~~~~

.tar.gz archive:	Extract the archive somewhere on your Linux box, this will create
			a folder called 'uae'.  Now just copy over your UAE binary, and the
			Kickstart 3.0/3.1 ROM file to '/Roms/Kick.rom'

			Then just cd to the 'uae' folder, and run the executable!
			If you use UAE JIT, you may wish to play around with the .uaerc
			file, since although it works for me, will almost certainly not
			be optimised for your system.

NB:	If you have AmigaForever, please read the Docs\AmigaForever-readme.txt file now!
~~								    ~~~
-------------------------------------------------------------------------------------------

1.	Load WinUAE from wherever you installed it (Ie: C:\WinUAE\WinUAE.exe)

2.	Click "OK" on the WinUAE gui - thats right, DONT FIDDLE ABOUT!
	You can edit/load the other configs to your hearts content later!

3.	After a short wait, youll see some text, and a prompt to press return.
	Press return and a requester stating 'No disk present in drive 0'.  At
	this point you'll need to insert your Workbench 3.1/3.0 ADF:    [The hardest bit]

	3.1	Press F12 to bring up the WinUAE GUI.
	3.2	Click the 'Floppies' page tab.
	3.3	Click the file-requestor button (...)
	3.4	Find and select your Workbench 3.1/3.0 ADF (ie: WB31.adf)
	3.5	Click "OK" - the WinUAE GUI will disappear, and wait.

	This disk will be checked to ensure it is valid for use with AIAB.  If it fails
	any tests, you will be prompted to try another disk.

	NB:  If you're using AmigaForever and dont have a Workbench 3.x ADF, please
	~~   take a look at the readme in the Docs\ folder for a solution (of sorts).

4.	Now you must select the displaymode you wish to use, (Its arguably best to use a
	screenmode equivalent to that of your Windows desktop).	From the Screenmode GUI:

	4.1	Select a UAEgfx mode, eg: 800x600 15/16bit.  You may have to scroll the
		list of displaymodes in order to find a suitable selection.
	4.2	Click the "No. of colours" bar, and scroll it to the maximum number.
	4.3	Click "Save"

5.	You will be asked whether or not you wish to add WheelMouse functionality to the AIAB
	setup.  AIAB will work fine if you click 'Yes', but dont have a WheelMouse, so dont
	worry too much.

6.	Next, you will be asked which iconset you wish to use for AIAB - either 'GlowIcons'
	(the new look), or 'ProLite' (the old look).

	The Amiga will pause, and then reboot.  The next screen you will see should be a
	blue patterned desktop containing several icons.

7.	Read the 'Welcome' guide, by double clicking the icon in the top right of the screen.


Note:	If this *still* doesnt work, make sure you let WinUAE detect your graphics card.
~~~~	If you are unsure about this, simply click the "Detect 16bit GFX modes" button in
	the WinUAE display config.

-------------------------------------------------------------------------------------------

Thats It!
~~~~~~~~
Now you have a real Amiga, capable of running practically every Amiga application ever made,
from Personal Paint to Lightwave! This system is also an ideal starting point for running
the hundreds of HD installers available from Aminet - such installers allow non-dos, games
to be installed onto the HD for faster-than-ADF loading and usually better compatibility!

-------------------------------------------------------------------------------------------

FAQ
~~~
Q.	What happened to AIAB r9?
A.	Dunno.

Q.	The AHI stuff doesnt work for me.
A.	Try enabling sound in WinUAE, and using 44khz, 16bit, stereo.

Q.	Is that it?
A.	Yep.

Q.	Hmmm... I dont think much of this FAQ!
A.	No, neither do I - why dont you write a better one for me?  ;)

-------------------------------------------------------------------------------------------

Whats New
~~~~~~~~~
Please take a look at the separate 'Notes.txt' file for a list of changes/improvements,
since this list is usually pretty big ;)  Also, if you're using an 'update' release (with
a letter on the end), have a look at the 'Update.txt' file for a summary of whats changed.

-------------------------------------------------------------------------------------------

Credits
~~~~~~~
Massive thanks to the following, without whom AIAB would be...well, of 'less quality':

	* Bernd Schmidt for starting the whole 'UAE thing'
	* Mathias Ortmann for initially porting it to Win32
	* Brian "Bri" King for continuing to improve the best UAE port around ;)
	* Alexander Kneer and Tobias Abt (The Picasso96 Team)

	* Amiga INC. for their marvellous - if flawed and 'getting on a bit' - OS
	* Falke Swanke for his brilliant (if large) 'RomFind' tool
	* Lasse 'Gazoo' Laursen for introducing me to 'InstallMaker' (sorry I forgot you!)
	* Tiernan Hubble & Garry Brooke for help with MacUAE and 'doing' MacAIAB
	* Hippy2000 for help with parts of the 'copy-files' script
	* GPsoft for allowing me to use Dopus4.12 [www.gpsoft.com.au]
	* Jacek Rzeuski for improving the Dopus4.12 code
	* The SatanicDreams guys for allowing me to use Scalos [www.satanicdreams.com]
	* Pzyco and Sanny for the gorgeous GlowIcons [http://mitglied.tripod.de/IconDesigner]
	* Henrik Isaksson for his wonderful popupmenu.library [http://boing.nu/pm]
	* Hynek Schlawack for his corking great proggy, DirScanner
	* Jeff Fabre for his continuing work on JST [http://jffabre.free.fr/amiga/patches.html]
	* Bert Jahn for his fine WHDload tool [http://www.whdload.org]
	* Stephan Rupprecht for the nicer gadget classes (ported from Georg Steger's code)
	* Stephan Rupprecht (again) for the corking 'EnvHandler' (and fixing it for UAE!)
	* Stephan Rupprecht (!) for his excellent 'sounddt41.datatype'
	* Dieter Groppe for allowing me to include MCP 1.34+ [http://mcp.dgroppe.de]
	* George Steger for the newer, re-worked AROS compatible libraries etc.
	* Frank Bunton for advice, and his wonderful 'AmigaDos Beginners Guide' [Aminet]
	* Peter 'Mr Tickle' Gordon, for his rather funky 'TitleShadow' patch
	* Bruce Steers for writing that wonderful 'AIABext' (aka 'Extract to RAM:') script.
	* Martin Blom for allowing me to use 'AHI' - http://www.lysator.liu.se/~lcs/ahi.html
	* Anyone who let me use their fine Amiga programmes
	* The WinUAE_beta@yahoogroups.com chaps for answering my questions
	* Anyone else who has sent me thanks/ideas/CDs/tips/info/help etc.

-------------------------------------------------------------------------------------------

If you have any queries or problems with 'AmigaInABox' please look on the website.  There is
a mailing list for announcements/info etc. at  http://www.yahoogroups.com/group/aiab/
and now, even an AIAB discussion board:   http://aiab.emuunlim.com/bin/wwwboard

Cya!
	James Maurice Battle - j.m.battle@bradford.ac.uk - http://aiab.emuunlim.com