new command "closemenu, ARG_1STR"

git-svn-id: svn://svn.code.sf.net/p/actiongame/code/trunk/ac@3348 e016b1c5-ed68-44aa-a2f7-31cac88cffde

docs/reference.xml

@@ -2004,7 +2004,7 @@ Output:
           <arguments>
             <argument token="N" description="The menuitem description."/>
             <argument token="A" description="The command to execute on selection of the menuitem." optional="true"/>
-	<argument token="H" description="The command to execute upon rolling over the menuitem." optional="true"/>			
+			<argument token="H" description="The command to execute upon rolling over the menuitem." optional="true"/>			
           </arguments>
         </command>
         <command name="showmenu">
@@ -2019,6 +2019,23 @@ Output:
           <arguments>
             <argument token="N" description="the name of a previously defined menu"/>
           </arguments>
+		  <references>
+			<identifierReference identifier="closemenu"/>
+		  </references>
+        </command>
+		<command name="closemenu">
+          <description>Closes the specified menu if it is open.</description>
+          <remarks>
+            <remark>
+			If it is open multiple times in the stack only the topmost instance will be closed!
+            </remark>
+          </remarks>
+          <arguments>
+            <argument token="N" description="the name of a previously defined menu"/>
+          </arguments>
+		  <references>
+			<identifierReference identifier="showmenu"/>
+		  </references>
         </command>
         <command name="menumdl">
           <description>Specifies a model to render while displaying the last added menu.</description>

source/src/menus.cpp

@@ -634,6 +634,7 @@ COMMAND(menumdl, ARG_5STR);
 COMMAND(menudirlist, ARG_4STR);
 COMMAND(chmenumdl, ARG_6STR);
 COMMANDN(showmenu, showmenu_, ARG_1STR);
+COMMAND(closemenu, ARG_1STR);
 COMMAND(menuinit, ARG_1STR);
 COMMAND(menuitem, ARG_3STR);
 COMMAND(menuitemimage, ARG_4STR);