From c70af3a36b86a926add81128b47870bfd633a50d Mon Sep 17 00:00:00 2001
From: uz <uz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Sat, 26 Sep 2009 11:14:46 +0000
Subject: [PATCH 1/1] Documented the new mouse_setbox() and mouse_getbox
 functions.

git-svn-id: svn://svn.cc65.org/cc65/trunk@4231 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/funcref.sgml | 38 +++++++++++++++++++++++++++++++-------
 1 file changed, 31 insertions(+), 7 deletions(-)

diff --git a/doc/funcref.sgml b/doc/funcref.sgml
index c7f3e2f17..ccb15df9b 100644
--- a/doc/funcref.sgml
+++ b/doc/funcref.sgml
@@ -282,7 +282,8 @@ function.
 <item><ref id="mouse_uninstall" name="mouse_uninstall">
 <item><ref id="mouse_hide" name="mouse_hide">
 <item><ref id="mouse_show" name="mouse_show">
-<item><ref id="mouse_box" name="mouse_box">
+<item><ref id="mouse_setbox" name="mouse_setbox">
+<item><ref id="mouse_getbox" name="mouse_getbox">
 <item><ref id="mouse_move" name="mouse_move">
 <item><ref id="mouse_buttons" name="mouse_buttons">
 <item><ref id="mouse_pos" name="mouse_pos">
@@ -291,7 +292,7 @@ function.
 </itemize>
 
 (incomplete)
-
+                                          
 
 <sect1><tt/nes.h/<label id="nes.h"><p>
 
@@ -3253,14 +3254,13 @@ relocatable o65 modules for use with this function.
 </quote>
 
 
-<sect1>mouse_box<label id="mouse_box"><p>
+<sect1>mouse_setbox<label id="mouse_setbox"><p>
 
 <quote>
 <descrip>
 <tag/Function/Specify a bounding box for the mouse cursor.
 <tag/Header/<tt/<ref id="mouse.h" name="mouse.h">/
-<tag/Declaration/<tt/void __fastcall__ mouse_box (int minx, int miny,
-int maxx, int maxy);/
+<tag/Declaration/<tt/void __fastcall__ mouse_setbox (const struct mouse_box* box);/
 <tag/Description/The function allows to set a bounding box for mouse movement.
 <tag/Limits/<itemize>
 <item>The function does not check if the mouse cursor is currently within the
@@ -3275,12 +3275,35 @@ used in presence of a prototype.
 </itemize>
 <tag/Availability/cc65
 <tag/See also/
+<ref id="mouse_getbox" name="mouse_getbox">,
 <ref id="mouse_move" name="mouse_move">
 <tag/Example/None.
 </descrip>
 </quote>
 
 
+<sect1>mouse_getbox<label id="mouse_getbox"><p>
+
+<quote>
+<descrip>
+<tag/Function/Return the current bounding box for the mouse cursor.
+<tag/Header/<tt/<ref id="mouse.h" name="mouse.h">/
+<tag/Declaration/<tt/void __fastcall__ mouse_getbox (struct mouse_box* box);/
+<tag/Description/The function queries the current bounding box for mouse 
+movement.
+<tag/Limits/<itemize>
+<item>The function is only available as fastcall function, so it may only be
+used in presence of a prototype.
+</itemize>
+<tag/Availability/cc65
+<tag/See also/
+<ref id="mouse_move" name="mouse_move">,
+<ref id="mouse_setbox" name="mouse_setbox">
+<tag/Example/None.
+</descrip>
+</quote>
+
+
 <sect1>mouse_buttons<label id="mouse_buttons"><p>
 
 <quote>
@@ -3480,13 +3503,14 @@ used in presence of a prototype.
 is visible, it is shown at the new position.
 <tag/Limits/<itemize>
 <item>The function does not check if the new position is within the bounding
-box specified with <tt/<ref id="mouse_box" name="mouse_box">/.
+box specified with <tt/<ref id="mouse_setbox" name="mouse_setbox">/.
 <item>The function is only available as fastcall function, so it may only be
 used in presence of a prototype.
 </itemize>
 <tag/Availability/cc65
 <tag/See also/
-<ref id="mouse_box" name="mouse_box">
+<ref id="mouse_getbox" name="mouse_getbox">,
+<ref id="mouse_setbox" name="mouse_setbox">
 <tag/Example/None.
 </descrip>
 </quote>
-- 
2.39.2