Quoting Jamie Zawinski <[EMAIL PROTECTED]>: > Hi,
Hi, > Someone just brought to my attention this recent (?) addition to the > XF86Config man page: > > Option "AllowClosedownGrabs" "boolean" > [snip] > Well, since I'm the author of xscreensaver, I guess I'm the one who is > expected to be "updating that screen saver/locker"... But after quite > a > bit of searching, I can't find *any* documentation about this > purported > API that was added! > > I did see this message, which gave me the name > XF86MiscSetGrabKeysState: > http://www.spinics.net/lists/xf-xpert/msg03301.html > but I can't find *any* documentation on that function. Google has > only > three hits on it, and those are the (uncommented) source. Unfortunately, the only documentation is the sources. The only "API" function is: int XF86MiscSetGrabKeysState( Display* /* dpy */, Bool /* enabled */ ); and the possible return values are: /* return values for XF86MiscSetGrabKeysState */ #define MiscExtGrabStateSuccess 0 /* No errors */ #define MiscExtGrabStateLocked 1 /* A client already requested that * grabs cannot be removed/killed */ #define MiscExtGrabStateAlready 2 /* Request for enabling/disabling * grab removeal/kill already done */ > What exactly does it do? What are the consequences of calling or not > calling it? If the options AllowDeactivateGrabs and AllowClosedownGrabs are not specified in XF86Config, the function will always return a success status. Else, it will only fail if another program already requested a temporary disable of the key sequences, or if the program is calling it twice. It also uses the XF86Config option AllowNonLocalModInDev, that defaults to off, to allow, or not, remote clients from disabling the keyboard sequence; this is actually one of the main reasons for that functionality, remote applications running over a slow link can make X unusable for a large amount of time during keyboard/mouse grabs, as well as broken apps. This interface was made available for XFree86 4.2.0, the code will need to make sure it is running under the XFree86 server, as well as make sure the required version of the XF86Misc extension is available. I am really sorry about the missing documentation. I was going to update the XF86Misc manpage, but the Imakefile change says it is not being installed since: -- revision 3.5 date: 2000/03/04 01:07:33; author: dawes; state: Exp; lines: +19 -3 don't install out of date man pages -- It is just expecting someone to volunteer in fixing/updating it (I am really not the best person to write english documentation)... > Thanks, > > -- > Jamie Zawinski > [EMAIL PROTECTED] http://www.jwz.org/ > [EMAIL PROTECTED] http://www.dnalounge.com/ Paulo _______________________________________________ XFree86 mailing list [EMAIL PROTECTED] http://XFree86.Org/mailman/listinfo/xfree86
