nxat 1.0 README

Author: Mario Juric <mjuric@astro.princeton.edu>
License: GNU GPLv2. See the file LICENSE for the complete license.


DESCRIPTION
	nxat disables the standard Windows handling of ALT-TAB and SHIFT-ALT-TAB
when NX Client window is in the foreground. Those keystrokes are then passed
through NX to be handled by your X window manager (for example, to switch
between windows of a remote desktop).


USAGE
	To use the program, just start it. As long as it's running, the
special NX Client ALT-TAB handling will be activated. To stop the special
handling, close the program. The special handling is only active for the NX
Client window - when NX Client is not in the foreground, ALT-TAB handling will
continue to function as usual.


FULLSCREEN CONSIDERATIONS
	Further setup is needed when running NX Client in
fullscreen mode. Because of reasons unbeknownst to me, when in fullscreen
the NX Client goes into the background when ALT-TAB combination is forwarded
to it. In order to avoid that, nxat detects fullscreen mode and whenever you
pres ALT-TAB it sends an ALT-'/' combination through NX. Similarly,
SHIFT-ALT-TAB is remapped to ALT-'?' (which is just SHIFT+'/'). To restore
the expected behavior, have your window manager map ALT-'/' to the same
function as ALT-TAB and ALT-'?' to the same function as SHIFT-ALT-TAB.


COMPILING
	Under cygwin, do 'g++ -mwindows -o nxat nxat.cpp'.