diff --git a/docs/reference.xml b/docs/reference.xml
index 4d3a0327..bf59b6a2 100644
--- a/docs/reference.xml
+++ b/docs/reference.xml
@@ -1632,19 +1632,20 @@
Adds a new akimbo item.
- Adds a map model, i.e. an object rendered as md2/md3 which you collide against but has no behaviour or movement
+ Adds a map model to the map (i.e. a rendered md2/md3 model which you collide against but has no behaviour or movement)
- The mapmodel identifier is the desired map model which is defined by the 'mapmodel' command.
+ The mapmodel identifier is the desired map model which is defined by the 'mapmodel' command. The order in which
+ the mapmodel is placed in the map config file defines the mapmodel indentifier.
The map texture refers to a texture which is defined by the 'texture' command, if omitted the
models default skin will be used. The 'mapmodel' and 'texture' commands are placed in the map config normally.
- Mapmodels are more expensive than normal map geometry, do not use insane amounts of them to replace normal geometry.
+ Mapmodels are more expensive than normal map geometry, so do not use insane amounts of them to replace normal geometry.
-
-
-
+
+
+
@@ -1769,10 +1770,11 @@
Sets the map message, which will be displayed when the map loads.
- For example: mapmsg "Map By Author".
+ You will need to use quote marks around the message, otherwise it save the message correctly.
+ For example: /mapmsg "Map By Author"
-
+
@@ -1993,21 +1995,22 @@
Registers a mapmodel that can be placed in maps.
- A map model registered with this command can be placed in a map using the 'newent mapmodel' command.
- All of these values are used for collision as well as rendering. Specifying a snap can be useful
- for architectural mapmodels, as the md2 format doesn't provide exact vertex coordinates.
+ A mapmodel registered with this command can be placed in a map using the 'newent mapmodel' command.
+ The bounding box is an invisible force surrounding the model, allowing players to collide against it, instead
+ of walking through the mapmodel. For more information about this command, read mapediting5.xml.
- Example: mapmodel 4 2 4 2 this map model is 8x8x2 in size (x,y,z), by default hovers 4 units above ground,
- and has all coordinates snapped to the nearest even number. See data/models.cfg.
+ Example: mapmodel 4 2 4 0 "modelname"
+
+ This mapmodel has a bounding box of 8x8x2 in size (x/y/z) and by default hovers 4 units above ground.
-
-
-
-
-
+
+
+
+
+