Add CLI arguments

media/manual.txt

@@ -2,7 +2,7 @@ WORK IN PROGRESS
 
 -._.-'"'-._.-'"'- LICAR MANUAL -'"'-._.-'"'-._.-
 
-by drummyfish, released under CC0 1.0, punlic domain
+by drummyfish, released under CC0 1.0, public domain
 
 ~~~ GENERAL ~~~
 
@@ -40,7 +40,7 @@ If you know what command line arguments are, you may also check them out by
 running the game with -h argument. This will allow you to for example start the
 game and immediately load a map, which is handy when creating new maps.
 
-~~~ OBJECTIVES ~~~
+~~~ GAMEPLAY ~~~
 
 In Licar, unlike in most other racing games, you only race against time, i.e.
 you are alone on the track. There is an option to race against a replay ghost,
@@ -55,6 +55,11 @@ to beat in the bottom left of the screen. If you beat the time, you have
 achieved the goal, your replay is automatically saved and your new time becomes
 the next target time.
 
+On the map there can be several different kinds of surfaces with different
+physics properties: concrete, grass, dirt and ice. Furthermore there are two
+special kind of sufaces: an accelerator (a bright yellow/orange one), which
+boosts the car's speed, and a fan, which propels the car upwards.
+
 Your run can be restarted at any time. Typically you will need hundreds of
 attempts to achieve a good time on a map.
 
@@ -124,7 +129,21 @@ where exactly time losses against the opponent occur.
 
 ~~~ MAKING CUSTOM MAPS ~~~
 
-Maps are stored in the data file.
+Maps are stored in the data file. For its simplicity the original game doesn't
+come with a user-friendly map editor, the maps are hand-written directly in the
+text format that's stored in the data file, however there is a helper file for
+Blender that facilitates this process.
+
+The map is a 64x64x64 grid, with each cell one unit in width, one unit in depth
+and half a unit in height. In the cell blocks can be placed. There are several
+types of blocks such as ramps, walls, corners etc. Each block can be rotated
+and/or flipped. Additionally each block also has a material (concrete, grass,
+...). The finish, checkpoints and car start position can also be seen as block.
+
+The format of the map data string is described in the map.h file, refer to it
+for further detail. In short: TODO
+
+
 
 Under the asset directory there is a helper file for Blender (a FOSS 3D editor)
 with which a map layout can be comfortably created. But Blender is not required
@@ -143,3 +162,13 @@ The "workflow" for making maps is roughly the following:
    1. or 2.
 
 ~~~ FAQ ~~~
+
+Q: Why is the physics so buggy?
+
+A: You are right in the observation that Licar physics is not perfect. This is
+firstly because of the game's aim for simplicity (e.g. avoiding use of floating
+point) combined with the fact that even without such constraints it's one of the
+most difficult tasks to create a flawless physics engine. We apologize for any
+frustration but unless you want to fix this yourself, you'll have to just accept
+it, the game is meant to be a simple entertainment. In other words this is a
+feature :)