1 files changed, 11 insertions, 12 deletions
diff --git a/docs/map_scripts.md b/docs/map_scripts.md
index 2302257e7..fa864ac37 100644
--- a/docs/map_scripts.md
+++ b/docs/map_scripts.md
@@ -11,14 +11,14 @@
 ## <code>MapName_MapScripts:</code>
 
 
-### <code>.SceneScripts: db <i>N</i></code>
+### <code>db <i>N</i> ; scene scripts</code>
 
 <pre>
 	scene_script <i>script</i>
 </pre>
 
 
-### <code>.MapCallbacks: db <i>N</i></code>
+### <code>db <i>N</i> ; callbacks</code>
 
 <pre>
 	callback <i>type</i>, <i>script</i>
@@ -70,26 +70,25 @@ Callback types:
 ## <code>MapName_MapEvents:</code>
 
 ```asm
-	; filler
-	db 0, 0
+	db 0, 0 ; filler
 ```
 
 
-### <code>.Warps: db <i>N</i></code>
+### <code>db <i>N</i> ; warp events</code>
 
 <pre>
-	warp_def <i>x</i>, <i>y</i>, <i>warp_id</i>, <i>map</i>
+	warp_event <i>x</i>, <i>y</i>, <i>warp_id</i>, <i>map</i>
 </pre>
 
 
-### <code>.CoordEvents: db <i>N</i></code>
+### <code>db <i>N</i> ; coord events</code>
 
 <pre>
 	coord_event <i>x</i>, <i>y</i>, <i>scene_id</i>, <i>script</i>
 </pre>
 
 
-### <code>.BGEvents: db <i>N</i></code>
+### <code>db <i>N</i> ; bg events</code>
 
 <pre>
 	bg_event <i>x</i>, <i>y</i>, <i>type</i>, <i>script</i>
@@ -110,12 +109,12 @@ BG event types:
 - `BGEVENT_ITEM`
 
 <pre>
-	hiddenitem <i>event_flag</i>, <i>item_id</i>
+	hiddenitem <i>item_id</i>, <i>event_flag</i>
 </pre>
 
 - `BGEVENT_COPY`
 
-### <code>.ObjectEvents: db <i>N</i></code>
+### <code>db <i>N</i> ; object events</code>
 
 <pre>
 	object_event <i>x</i>, <i>y</i>, <i>sprite</i>, <i>movement</i>, <i>rx</i>, <i>ry</i>, <i>h1</i>, <i>h2</i>, <i>palette</i>, <i>type</i>, <i>range</i>, <i>script</i>, <i>event_flag</i>
@@ -162,11 +161,11 @@ Object types:
 - `OBJECTTYPE_ITEMBALL`
 
 <pre>
-	itemball <i>item_id</i>
+	itemball <i>item_id</i>[, <i>quantity</i>=1]
 </pre>
 
 - `OBJECTTYPE_TRAINER`
 
 <pre>
-	trainer <i>event_flag</i>, <i>group_id</i>, <i>trainer_id</i>, <i>seen_text</i>, <i>beaten_text</i>, <i>loss_text</i>, <i>script</i>
+	trainer <i>group_id</i>, <i>trainer_id</i>, <i>event_flag</i>, <i>seen_text</i>, <i>beaten_text</i>, <i>loss_text</i>, <i>script</i>
 </pre>