More documentation stuff

git-svn-id: svn://cook.msm.cam.ac.uk:745/thrust3d/thrust3d@157 84d2e878-0bd5-11dd-ad15-13eda11d74c5

1 files changed, 26 insertions, 23 deletions

diff --git a/README b/README
index 921a1aa..8533f27 100644
--- a/README
+++ b/README
@@ -3,48 +3,57 @@ Thrust3D
 
 Post-apocalyptic Jet Set Willy, set in a 3D nuclear power station.
 
+Aim
+===
+
+Fly around the highly radioactive remains of the Mars nuclear power station and collect the coloured flashing radiactive
+debris.  Don't crash into any walls or other objects or your craft will explode.  Land only on the glowing energy
+platforms.
+
+Background
+==========
+
 In the mid 90s, I played a game from a magazine cover disk (Archimedes World I think, but I really can't remember) called
-"Lander".  No, not the demo version of Zarch.  This was a completely different game where you piloted a small 2D spaceship
+"Lander".  No, not the demo version of Zarch, this was a completely different game where you piloted a small 2D spaceship
 round a vast world collecting glowing radioactive debris from over a hundred separate rooms.  The spaceship part was just
 like the many Lunar Lander variants you have probably played, but the exploration of a vast world appealed to me for the
 same reasons that I enjoyed Jet Set Willy many years before.  In Lander, just like in Jet Set Willy. the game would
 theoretically end when all the debris had been collected.  In practice, this was virtually impossible due to the shear
 size and complexity of the game.  The attraction of the game was not in winning it, but in being able to explore a
-seemingly never-ending abstract world of pure imagination.
+seemingly never-ending world of pure imagination.
 
 In creating Thrust3D I wanted to recreate that feeling of exploration and imagination, but using the capabilities of
 modern graphics hardware to heighten the feeling.  I learnt a lot of OpenGL graphics programming and rendering techniques
-in the course of my doctoral studies for visualising my research results, but none of this allowed me to use any of the
-advanced capabilities available.  Thrust3D was an outlet for this, and here is the result.
+in the course of my doctoral studies for visualising my research results, but none of this gave me an excuse to use any
+of the advanced capabilities available.  Thrust3D was an outlet for this, and here is the result.
 
 Installation
 ============
 
 For installation details, see the 'INSTALL' file.  Basically it's just the usual ./configure / make / sudo make install.
 
-You will almost certainly need working 3D acceleration (direct rendering) to play Thrust3D at a reasonable speed.  To
-see if you have this, run 'glxinfo' in a terminal and see if it says 'direct rendering: yes' or not.  If not, you most
-likely need to install 3D drivers for your graphics card.  Linux drivers for NVIDIA and ATI cards come from the
-respective manufacturers' websites.  For Intel cards, look up the Linux DRI project.  Drivers might be included in
-your distribution.
+You will almost certainly need working 3D acceleration (direct rendering) and a vaguely modern graphics card to play
+Thrust3D smoothly.  To see if you have this, run 'glxinfo' in a terminal and see if it says 'direct rendering: yes' or
+not.  If not, you most likely need to install 3D drivers for your graphics card.  Linux drivers for NVIDIA and ATI cards
+come from the respective manufacturers' websites.  For Intel cards, look up the Linux DRI project.  Drivers might be
+included in your distribution.
 
 Thrust3D runs at full speed, but only just, on my ATI Mobility Radeon X600 card.  This is the primary development
 system.  It also works fine on my NVIDIA Quadro FX540.  Both of these are 'entry-level' cards with fairly comparable
-specifications.  If you have something beefier, great.  If not, you can still play - you might just need to disable
-a few features (if that doesn't happen automatically): see the output from 'thrust3d --help' for details of things you
-can disable.  You should also try turning the resolution down ('thrust3d --resolution 640' and so on).
+specifications.  If you have something beefier, great - it'll probably munch this for breakfast.  If not, you can still
+play - you might just need to disable a few features (if that doesn't happen automatically): see the output from
+'thrust3d --help' for details of things you can disable.  You should also try turning the resolution down (for example,
+'thrust3d --resolution 640').
 
 Music
 =====
 
 You can put some suitable background music as an Ogg/Vorbis file at $PREFIX/share/thrust3d/sounds/music.ogg ('$PREFIX' is
-probably '/usr/local' unless you've done something different).  'Radio-Activity' by Kraftwerk is particularly appropriate.
+probably '/usr/local' unless you've done something different).  'Radioactivity' by Kraftwerk is particularly appropriate.
 Obviously I can't distribute a copy of that material with the game, so you'll have to obtain your own copy.
 
-Playing
-=======
-
-Controls:
+Controls
+========
 
 	Space       - thrust (upwards)
 	Left arrow  - turn left
@@ -52,10 +61,4 @@ Controls:
 	Up arrow    - thrust forwards
 	Down arrow  - thrust backwards
 
-Aim:
-
-	Fly around the highly radioactive remains of the Mars nuclear power station and collect the coloured flashing
-	radiactive debris.  Don't crash into any walls or other objects or your craft will explode.  Land only on the
-	glowing recharge platforms.
-