From 0c0f976b34c2cf91ed5f18c8d49ecc96a8cc4ddf Mon Sep 17 00:00:00 2001
From: RandumKiwi <RandumKiwi@users.noreply.github.com>
Date: Sat, 16 Aug 2008 10:49:41 +0000
Subject: [PATCH] more docs.

git-svn-id: svn://svn.code.sf.net/p/actiongame/code/trunk/ac@2330 e016b1c5-ed68-44aa-a2f7-31cac88cffde
---
 docs/basics.xml      |  6 ++++++
 docs/mapediting2.xml | 49 +++++++++++++++++++++++++++++++++++++++-----
 docs/mapediting4.xml |  2 +-
 3 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/docs/basics.xml b/docs/basics.xml
index b3d5e119..ee774e2f 100644
--- a/docs/basics.xml
+++ b/docs/basics.xml
@@ -263,6 +263,12 @@
     <p>
       Gibs are created by: Headshots from sniper rifles, deaths from knifing &amp; deaths from grenade blasts.
     </p>
+    <h2>
+      Suicide
+    </h2>
+    <p>
+      If you ever find yourself stuck in a tough spot and need to commit suicide, simply type: <b>/suicide</b>.
+    </p>
     <h2 id="voting">
       Voting
     </h2>
diff --git a/docs/mapediting2.xml b/docs/mapediting2.xml
index a6220b2b..221c251f 100644
--- a/docs/mapediting2.xml
+++ b/docs/mapediting2.xml
@@ -52,6 +52,20 @@
         </li>
         <li>
           <a href="#commands">Useful commands</a>
+          <ol>
+            <li>
+              <a href="#copypaste">Copy/paste</a>
+            </li>
+            <li>
+              <a href="#water">Water</a>
+            </li>
+            <li>
+              <a href="#mapmsg">Map messages</a>
+            </li>
+            <li>
+              <a href="#undo">Undo</a>
+            </li>
+          </ol>
         </li>
       </ul>
             
@@ -252,16 +266,41 @@
       There is 1 key allocated to move forwards through the textures for each of these and one key to move backwards. When selecting textures, 
       the AssaultCube engine automatically puts the last chosen texture at the start of the list, so commonly used textures become easier to find.
       <br />Note: The "upper-wall" are the sides of the wall that protrudes from the ceiling.
-    </p>  
-    
+    </p>
 
     <h2 id="commands">Useful commands</h2>
+    
+    <h3 id="copypaste">Copy/paste</h3>
     <p>
-      <b>Undo</b> - Pressing <b>U</b> will undo the last texture/geometry action that was done. It will not undo entities.
+      Selecting some cubes and pressing <b>C</b> will copy them. Then, select a cube and press <b>V</b> to paste it. 
+      The cubes will be pasted from the red dot on the <a href="mapediting1.xml#selector">cube selector</a>.
+    </p>
+    
+    <h3 id="water">Water</h3>
+    <p>
+      In AssaultCube, water is placed by selecting a level at which the water will be present. It will then settle throughout the whole map
+      at that level. You can't have water in just one place, it can only be put through the whole map.
     </p>
     <p>
-      <b>Copy/paste</b> - Selecting some cubes and pressing <b>C</b> will copy them. Then, select a cube and press <b>V</b> to paste it. 
-      The cubes will be pasted from the red dot on the <a href="mapediting1.xml#selector">cube selector</a>.
+     To add water to your map, type: <b>/waterlevel X</b><br />
+     Replace <b>X</b> with the level that you would like the water to settle at. To remove water, use the same command to make the water settle 
+     lower than the geometry (for example: <i>/waterlevel -128</i> ).
+    </p>
+    
+    <h3 id="mapmsg">Map messages</h3>
+    <p>
+      When your map is loaded up, there is always a message stated. This message is used to advise players of the map name and author.
+      This "map message" can be added to any map by using the "<i>mapmsg</i>" command.
+      When using this command, be sure to use quote marks at the beginning and end of the phrase you use, otherwise it will not put the full message
+      onto the map. Be sure to save your map afterwards. Below is an example of how to use the "<i>mapmsg</i>" command.
+    </p>
+    <p>
+      Example: <b>/mapmsg "Foobar by Raboof"</b>
+    </p>
+
+    <h3 id="undo">Undo</h3>
+    <p>
+      Pressing <b>U</b> will undo the last texture/geometry action that was done. It will not undo entities.
     </p>
     
     <h4>
diff --git a/docs/mapediting4.xml b/docs/mapediting4.xml
index 6e5e415f..ebbcc3d9 100644
--- a/docs/mapediting4.xml
+++ b/docs/mapediting4.xml
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="transformations/cubedoc2xhtml.xslt"?>
 
 <html xmlns="http://www.w3.org/1999/xhtml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" lang="en" xml:lang="en">
-  <head><title>Map editing: Tips</title></head>
+  <head><title>Map editing: Tips, tricks and advice</title></head>
   <body>
     <h1>Map editing: Tips, tricks and advice</h1>
     <h2>Size does matter!</h2>