         __________________________________________________________
        |                                                          |
        |  LL      LL              OO      OO                      |
        |  LLLL  LLLL    %%%%%%    OOOO    OO            ======    |
        |  LL  LL  LL  %%      %%  OO  OO  OO  888888  ==      ==  |
        |  LL      LL  %%      %%  OO    OOOO    88    ==          |
        |  LL      LL  %%%%%%%%%%  OO      OO    88    ==      ==  |
        |              %%      %%                88      ======    |
        |                                      888888              |
        |                                                          |
        |              ======              %%%%%%%%%%              |
        |                ==    LL      LL  %%                      |
        |  88      88    ==    LLLL    LL  %%%%%%%%%%  OOOOOOOO    |
        |  8888  8888    ==    LL  LL  LL  %%          OO      OO  |
        |  88  88  88  ======  LL    LLLL  %%%%%%%%%%  OOOOOOOO    |
        |  88      88          LL      LL              OO  OO      |
        |  88      88                                  OO    OOOO  |
        |__________________________________________________________|
                                                             v1.6.3


##>=-LEGAL BIT:-=<###########################################################

 This game is released as FREEWARE and we except no responsibility for any
 damage caused by using this programme.

 The original game is (C) 1983 BUG-BYTE Ltd and SOFTWARE PROJECTS Ltd.
		      (C) 1997 Alchemist Research.

 Please copy on to anybody you know providing you do not charge for the
 privilege and this file accompanies the game.

 If you intend to use this game on a magazine cover disk or compilation CD,
 all I [Andy Noble] ask is for you to send me a copy of the magazine or CD.

 Read midas.txt for the MIDAS Digital Audio System license.


##>=-INFO:-=<################################################################

 The original PC version was written over a 6 week period, on a night, after
 work. It was written in 100% C using Watcom 10.6. The graphics where drawn
 with Deluxe Paint.

 Right, let's get something straight. If you are looking for Manic Miner
 2000, you are looking in the wrong place. You will not get any rendered
 intros, rendered Willy's (Oo! Er!) or rendered anything. I [Andy] have made
 the game in it's original style. I like to think of it as a version of the
 game that would have appeared in 1984 if such things as "256 colour
 displays" where about. I am sick of downloading a game off the net, only to
 see some rendered intro and no game. Lets get back to basics. Lets play some
 good, old fashioned, playable games.

 "Why have you done a DOS version when the emulated version is perfect?"

 The answer is this. I [Andy] just wanted to. I like to mess around with
 programming. I am not very good at it, but I enjoy it. It's as simple as
 that.


##>=-THE GAME:-=<############################################################

 Miner Willy, while prospecting down Surbiton way, stumbles upon an ancient,
 long forgotten mine-shaft. On further exploration, he finds evidence of a
 lost civilisation far superior to our own, which used automatons to dig deep
 into the Earth's core to supply the essential raw materials for their
 advanced industry. After centuries of peace and prosperity, the civilisation
 was torn apart by war, and lapsed into a long dark age, abandoning their
 industry and machines. Nobody, however, thought to tell the mine robots to
 stop working, and through countless aeons they had steadily accumulated a
 huge stockpile of valuable metals and minerals, and Miner Willy realises
 that he now has the opportunity to make his fortune by finding the
 underground store. Can YOU take the challenge and guide Willy through the
 underground caverns to the surface and riches. In order to move to the next
 chamber, you must collect all the flashing keys in the room while avoiding
 nasties like POISONOUS PANSIES and SPIDERS and SLIME and worst of all, MANIC
 MINING ROBOTS. When you have all the keys, you can enter the portal which
 will now be flashing. The game ends when you have been "got" or fallen
 heavily three times.

 NOTE: This was taken from the original BUG-BYTE inlay. I have never seen any
 POISONOUS PANSIES, SPIDERS or SLIME anywhere in the game.


##>=-INSTALLATION:-=<########################################################

 DOS, Linux:

  If you are building from source, you will edit the "Makefile" to select the
  operating system, and graphics and sound libraries that you will be using.
  (You can safely delete the directory !Manic and its contents.)

  If you're using DOS and you don't understand this, don't worry -- you
  should be using the binary version instead.

  To install the binary version, just copy the zip or tar.gz file to a
  directory (e.g. c:\games or "c:\program files" in DOS/Windows, or
  /usr/local/games in Linux) and extract the archive. If you use pkunzip,
  make sure that you use the -d option.

 RISC OS:

  If you are building from source, just do so :-)

  Requirements are Acorn C v5 and OSLib; gcc should be useable with
  appropriate modifications to the makefile. Unzipping: unzip to some
  convenient directory, then move the contents of manicminer (or
  manicminer-<version>) into !Manic. Note that the filenames are arranged for
  DOS and Linux; unzip 5.41 and later can deal with this with the -/ switch
  (you'll need -/c:h:s).

  To install the binary version, just extract !Manic from the archive. Or
  even run it from the archive, if you have SparkFS.


##>=-RUNNING FROM THE COMMAND LINE:-=<#######################################

 Usage: manic [ OPTIONS ]
 Options:
   -fs                       reconfigure sound, if applicable
   -rh                       reset hiscore
   -h                        display this help and exit
   -v                        output version information and exit
   -2                        double size display (Allegro only)
   FILE                      load level data file FILE

 The RISC OS version cannot (normally) be run from the command line; it is
 designed as a desktop application with a single-tasking mode.


##>=-INSTRUCTIONS:-=<########################################################

 For those of you who have never played Manic Miner before, all you have to
 do is collect all of the flashing items from each screen to open the exit
 before your air runs out. Sounds easy? Just give it a try.

 From the loading screen press any key to get to the main title.

 On the title screen:

   F1           ABOUT and game SPEED / MUSIC / LEVELS setup.
   ENTER/RETURN Start Game.

   (If you leave the keyboard alone the game will go into demo mode. Just
   press a key to return to the title screen.)

 In Game:

   Q E T U O [           = Left
   W R Y I P ]           = Right
   SHIFT to SHIFT, SPACE = Jump
   A to G                = Pause
   H to L                = Music toggle

   CTRL+F1-F5= Change Game Speed. F1=Fast/F5=Slow

 ESCAPE      at any time will take you back to the title screen.
 F10         (DOS, Linux) will quit the program.
 F12         (RISC OS) will suspend the game, returning you to the desktop.


##>=-ANDY'S FINAL WORDS:-=<##################################################

 I hope you enjoy the game and I hope it brings back some happy and
 frustrating memories. If it is popular, even if it's not, I am planning on
 doing Jet Set Willy. Well, you can't have one without the other I say.

 I would like some feedback even if it's bad. So please send mail to
 andy@andyn.demon.co.uk.

 Oh, by the way, there is a CHEAT you know.


##>=-TALES FROM A PARALLEL UNIVERSE:-=<######################################

 In addition to the normal Manic Miner levels, this game includes Blood's
 "Tales From a Parallel Universe" (the filename is set1.lev).

 (excerpts from Blood's 'Tales From a Parallel Universe' docs)

 Designed by the infamous BLOOD! (ltonks@iclretail.icl.com)
 (c)1996 Cheese Freak Software

 Manic Miner programmed by Matthew Smith
 (c)1983 Bug Byte Software

 Manic Miner Editor by Rich Swann (for the Sinclair Spectrum)
 Printed by YS, supplied by Henning and typed by BLOOD!

 INSTRUCTIONS

 It is rumoured that there are an infinite number of parallel universes where
 every possibility is played out. Things in these other dimensions may be
 very similar to our own reality, but subtly different because of certain
 decisions which were taken differently.

 Miner Willy is no exception to this rule. Previously, thousands of Speccy
 owners had thrilled to his adventures in his battle to escape the Manic
 Mining machines, but now Cheese Freak Software brings you the escapades of
 ANOTHER Miner Willy from a parallel universe! Just like his counterpart in
 this reality, Willy has fallen into a mine packed with dangers and must
 escape from 20 lethal caverns in order to locate the untold treasures of an
 ancient civilisation. However, in this universe things are subtly
 different..... Can Miner Willy emulate the antics of his trans-dimensional
 counterpart, or are the Speccy owners of the other universe doomed to a life
 with no Jet Set Willy?

 FOR THE EASILY FOOLED

 In case you hadn't noticed, this is a version of Manic Miner which I have
 edited with the Manic Miner Editor to produce a very different game! All 20
 screens have been replaced (and the scrolly message!) and should prove a new
 challenge for MM addicts. I can't pretend that my screens are as good as
 Matt Smith's originals, but I GUARANTEE that they're much better than the
 very crap 'Manic Miner 2' snapshot which has been doing the rounds on the
 Internet.

 I haven't changed many graphics, for two reasons :
 1) The graphics were very good anyway
 2) I'm crap at drawing
 You won't recognise any of the rooms anyway - it's completely different.
 They're not all rock hard either - some are easy and some are like The
 Warehouse.....Eeek!

 I'm not asking for anything for this - it's free, just play it and enjoy it.
 And when you've done, why not grab a copy of the editor and have a go at
 redesigning it yourself? The editor's free too. I'm just too nice. I'd like
 to see any of your creations.....


 Regards,
 Blood.

 p.s. The screens are as follows. If you want to take a peek at 'em, use the
 level skip cheat or watch the demonstration......

  1. Slightly to One Side Cavern
  2. Brass Penguins?
  3. Bernard Matthews' Personal Hell
  4. Sealed with a Glasgow Kiss
  5. Future Echoes
  6. Pac Up Your Troubles
  7. Altar of 7th Day Advent Hoppists
  8. Alan Sugar's Take-Over Bid
  9. Perils of a Bad-Hair Day
 10. Dr. Jones WOOD Believe This!
 11. Revenge of Brian's Phone Bill! (dedicated to Brian 'No Binaries!' Gaff)
 12. Alan Sugar must DIE!
 13. The 'Difficult to Edit' Cavern
 14. Crashing More Often Than a ZX81!
 15. Matthew Smith's Unpaid Royalties
 16. Zucchini! Or Something.... (dedicated to the hard working YS team)
 17. Farmer Barleymow's DDT Store
 18. Eye o' Oktup (dedicated to 'dat ole looney...bwah!)
 19. Warp Core Breach
 20. Join the Jet Set (with apologies to Richard Hallas!)


##>=-CREDITS:-=<#############################################################

Original Programming, Graphics, Sound, Music:
	Matthew Smith
Programming, Graphics, Sound:
	Andy Noble
Music Arrangements:
	Matt Simmonds
Programming:
	Stuart Brady, Darren Salt, Matan Ziv-Av
Testing, Help, Ideas:
	Ewan Christie, Tyrone L. Cartwright, Alex Cornhill, Andrew Cadley,
	Andy Noble, Matan Ziv-Av, John Dow, Richard Hallas, Andr Timmermans
Additional Levels:
	Blood!


##>=-CHANGELOG:-=<###########################################################

 v1.6.3 [DS]
   Reformatted the source (C comments; indented using GNU indent -br).
   Integrated the RISC OS port:
     Replaced the Miner Willy control and collision code.
     Replaced the end-of-level effect with a "fade to blue" routine.
     Added piano-playing code (works with libmikmod or RISC OS).
     Re-fixed the piano image for this :-)
   Moved a lot of variables into structures.
   Restructured the "game completed" text.
   Replaced a lot of repeated code with function calls.
   Added an option for *2 display (if you're using Allegro).
   Level file format tweaked a little:
     +0: "MANIC\r\n\x1A"
     +8: Short (16-chr) description, NUL-terminated
     +24: level data, as before

 v1.6.2 [SB]
   Moved level data into two files
   Added command line option to specify a level data file

 v1.6.1 [SB]
   Non-busy sleep code for SVGAlib [Matan Ziv-Av]
   Graphics now loaded from files
   Improved the Makefile
   MIDAS uses mm_snd_update in Linux
   LibMikMod target now works properly
   Fixed the piano graphics

 v1.6.0 [SB]
   SVGAlib, Allegro, LibGGI targets added, MODEX code removed
   MIDAS code restructured, LibMikMod code added


 All changes made by Andy:

 v1.51
   Default screen mode is now 320x200 (not 360x240).

 v1.50
   Command Line Options added.
   Pixel Perfect Collision against Bad Guys added.
   Solar Power Generator made slightly easier.
   Errors in Jump Sound fixed.
   Errors in Just onto Conveyor fixed.

 v1.0
   Hopefully most of the bugs fixed.

 v0.97
   New music system.
   Digital effects.
   Small end of game sequence.

 v0.9
   Music some bug fixes.

 v0.5
   First release.
   No music and loads of bugs.


##>=-EMAIL:-=<###############################################################

 Andy Noble ................... andy@andyn.demon.co.uk
 Stuart Brady ............ stuart@wholehog.fsnet.co.uk
 Darren Salt .......... ds@youmustbejoking.demon.co.uk


##>=-WEB SITES AND NEWSGROUPS:-=<############################################

 Andy's Homepage:
    http://www.andyn.demon.co.uk/
       Manic Miner and Jet Set Willy PC

 Darren Salt's Homepage:
    http://www.youmustbejoking.demon.co.uk/
       RISC OS version

 Stuart Brady's Homepage:
    http://www.wholehog.fsnet.co.uk/
       Cross-platform version

 Andrew Broad's Homepage:
    http://www.cs.man.ac.uk/~abroad/
       Additional levels and level editor, for the Spectrum version

 Blood's Crap Speccy Page:
    http://www.geocities.com/SiliconValley/Lakes/6142/
       Tales from a Parallel Universe

 Stephen Smith's Spectrum Pages:
    http://www.jonlan.demon.co.uk/spectrum/
       Spectrum Games FAQ, and the "Where is Matthew Smith?" page

 Retrospec:
    http://www.retrospec.co.uk/
       But you knew that already

 JSW Ultimate Fan Page:
    http://fly.cc.fer.hr/~arsen/jsw/
       JSW tech info

 Newsgroups:
    comp.sys.sinclair, alt.binaries.comp.sinclair

 comp.sys.sinclair FAQ:
    http://www.srcf.ucam.org/~pak21/cssfaq/
