X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=man%2Fcurs_mouse.3x;h=f48cb1e822a9f9a79ce2f8785cedff90c9ebfb69;hp=7e15f3ae1ad042bda266f8f67d639ea9c21944a1;hb=6b4f5830b7910188b532d661f79775306715f67e;hpb=06078d3fa68db669ed37178c01873546b4b28745 diff --git a/man/curs_mouse.3x b/man/curs_mouse.3x index 7e15f3ae..f48cb1e8 100644 --- a/man/curs_mouse.3x +++ b/man/curs_mouse.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright (c) 1998-2015,2017 Free Software Foundation, Inc. * +.\" Copyright (c) 1998-2017,2018 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * .\" copy of this software and associated documentation files (the * @@ -27,7 +27,7 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_mouse.3x,v 1.47 2017/11/18 23:52:45 tom Exp $ +.\" $Id: curs_mouse.3x,v 1.50 2018/12/29 23:40:47 tom Exp $ .ie \n(.g .ds `` \(lq .el .ds `` `` .ie \n(.g .ds '' \(rq @@ -43,7 +43,8 @@ .de NE .fi .ft R -.in -4 +.ie n .in -4 +.el .in -2 .. .de bP .ie n .IP \(bu 4 @@ -306,7 +307,8 @@ For instance the SVr4 curses library used the \fBget_mouse\fP capability to tell the terminal which mouse button events it should send, passing the mouse-button bit-mask to the terminal. -Also, it could ask the terminal where the mouse was using the \fBreq_mouse_pos\fP capability. +Also, it could ask the terminal +where the mouse was using the \fBreq_mouse_pos\fP capability. .IP Those features required a terminal which had been modified to work with curses. They were not part of the X Consortium's xterm. @@ -368,6 +370,12 @@ corresponds to private mode 1000 of xterm: \\E[?1000%?%p1%{1}%=%th%el%; .RE .PP +The mouse driver also recognizes a newer xterm private mode 1006, e.g., +.PP +.RS 3 +\\E[?1006;1000%?%p1%{1}%=%th%el%; +.RE +.PP The \fIz\fP member in the event structure is not presently used. It is intended for use with touch screens (which may be pressure-sensitive) or with @@ -394,9 +402,11 @@ i.e., it is the beginning of the response. .PP Because there are no standard terminal responses that would serve to identify terminals which support the xterm mouse protocol, \fBncurses\fR assumes that -if your $TERM environment variable contains "xterm", +if your $TERM environment variable contains \*(``xterm\*('', or \fBkmous\fR is defined in the terminal description, then the terminal may send mouse events. +The \fBkmous\fP capability is checked first, allowing the +use of newer xterm mouse protocols. .SH SEE ALSO \fBcurses\fR(3X), \fBcurs_kernel\fR(3X),