From 080384ca792236c1034a20dce90071cda7966ed1 Mon Sep 17 00:00:00 2001
From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Fri, 29 Jul 2005 21:16:39 +0000
Subject: [PATCH] Added mouse_ioctl to complete mouse.h

git-svn-id: svn://svn.cc65.org/cc65/trunk@3561 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/funcref.sgml | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/doc/funcref.sgml b/doc/funcref.sgml
index 02da396dd..4c87a757f 100644
--- a/doc/funcref.sgml
+++ b/doc/funcref.sgml
@@ -277,7 +277,7 @@ function.
 <item><ref id="mouse_buttons" name="mouse_buttons">
 <item><ref id="mouse_pos" name="mouse_pos">
 <item><ref id="mouse_info" name="mouse_info">
-<!-- <item><ref id="mouse_ioctl" name="mouse_ioctl"> -->
+<item><ref id="mouse_ioctl" name="mouse_ioctl">
 </itemize>
 
 (incomplete)
@@ -3400,6 +3400,31 @@ used in presence of a prototype.
 </quote>
 
 
+<sect1>mouse_ioctl<label id="mouse_ioctl"><p>
+
+<quote>
+<descrip>
+<tag/Function/Call the driver specific ioctl function.
+<tag/Header/<tt/<ref id="mouse.h" name="mouse.h">/
+<tag/Declaration/<tt/unsigned char __fastcall__ mouse_ioctl (unsigned char code, void* data);/
+<tag/Description/The function calls the IOCTL entry in the mouse driver,
+which is driver specific. The <tt/code/ parameter will choose between
+different IOCTL functions, and the <tt/data/ depends on code. The
+function returns an error code. The purpose of this function is to allow
+for driver specific extensions. See the documentation for a specific mouse
+driver for supported ioctl calls.
+<tag/Limits/<itemize>
+<item>Calling this function is non portable, because each driver may
+implement different ioctl calls (or none at all).
+<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/Example/None.
+</descrip>
+</quote>
+
+
 <sect1>mouse_load_driver<label id="mouse_load_driver"><p>
 
 <quote>
-- 
2.39.5