[src/trunk]: src/share/man/man4 Mention in ums(4) that a lot of usb mice deta...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ff2d30a0b075
branches:  trunk
changeset: 379562:ff2d30a0b075
user:      dholland <dholland%NetBSD.org@localhost>
date:      Mon Jun 07 03:04:50 2021 +0000

description:
Mention in ums(4) that a lot of usb mice detach/reattcah when not in use.

Prompted by PR 56209 but not related to the actual problem there.

diffstat:

 share/man/man4/ums.4 |  14 ++++++++++++--
 1 files changed, 12 insertions(+), 2 deletions(-)

diffs (35 lines):

diff -r ca755af8f7bb -r ff2d30a0b075 share/man/man4/ums.4
--- a/share/man/man4/ums.4      Sun Jun 06 18:37:20 2021 +0000
+++ b/share/man/man4/ums.4      Mon Jun 07 03:04:50 2021 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ums.4,v 1.11 2017/09/06 14:47:35 ryoon Exp $
+.\" $NetBSD: ums.4,v 1.12 2021/06/07 03:04:50 dholland Exp $
 .\"
 .\" Copyright (c) 1999, 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 6, 2017
+.Dd June 6, 2021
 .Dt UMS 4
 .Os
 .Sh NAME
@@ -43,6 +43,16 @@ driver provides support for USB mice and
 Access to the movement data is through the
 .Xr wsmouse 4
 driver.
+.Pp
+Be aware that many USB mice will, if the mouse device is not open,
+detach and reattach themselves repeatedly at regular intervals
+(usually around one minute) causing spam on the console and the system
+log.
+This is apparently intentional behavior on the part of the hardware
+manufacturers.
+The best workaround is to keep the mouse device open, either via 
+X11, or, if not using the window system, by running
+.Xr wsmoused 8 .
 .Sh SEE ALSO
 .Xr uhidev 4 ,
 .Xr usb 4 ,