There exists client that send repeated "down" events on automatic key
repeats, and those that send pairs of "up" and "down". Usually this
behaviour depends on the platform on which the client runs.

Since only the repeated "down" case allows the server to tell the
difference between automatic and manual key repeats, clarify that the
"down" repeat method is the preferred.

Also clarify that the client should handle auto repeat because of
latency problems.

Signed-off-by: Pierre Ossman <[email protected]>
---

Index: rfbproto.rst
===================================================================
--- rfbproto.rst        (revision 3796)
+++ rfbproto.rst        (working copy)
@@ -642,6 +642,16 @@
 4               ``U32``                         *key*
 =============== ==================== ========== =======================
 
+Auto repeating of keys when a key is held down should be handled on the
+client. The rationale being that high latency on the network can make
+it seem like a key is being held for a very long time, yet the problem
+is that the KeyEvent message releasing the button has been delayed.
+
+The client should send only repeated "down" KeyEvent messages, no "up"
+messages, when a key is automatically repeated. This allows the server
+to tell the difference between automatic repeat and actual repeated
+entry by the user.
+
 For most ordinary keys, the "keysym" is the same as the corresponding
 ASCII value. For full details, see The Xlib Reference Manual, published
 by O'Reilly & Associates, or see the header file ``<X11/keysymdef.h>``

-- 
Pierre Ossman            OpenSource-based Thin Client Technology
System Developer         Telephone: +46-13-21 46 00
Cendio AB                Web: http://www.cendio.com

Attachment: signature.asc
Description: PGP signature

------------------------------------------------------------------------------
Register Now & Save for Velocity, the Web Performance & Operations 
Conference from O'Reilly Media. Velocity features a full day of 
expert-led, hands-on workshops and two days of sessions from industry 
leaders in dedicated Performance & Operations tracks. Use code vel09scf 
and Save an extra 15% before 5/3. http://p.sf.net/sfu/velocityconf
_______________________________________________
tigervnc-rfbproto mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/tigervnc-rfbproto

Reply via email to