X10TOX11(1)

NAME
x10tox11 - X version 10 to version 11 protocol converter

SYNOPSIS
x10tox11 [-display host:display]

DESCRIPTION
x10tox11 masquerades as an X Window System Version 10 server. It enables an X Version 10 client to run unchanged under X Version 11 by converting Version 10 requests into appropriate Version 11 requests, and by converting all Version 11 events received from the server into Version 10 events. From the perspective of Version 10 clients, all Version 11 clients look like Version 10 clients; and from the perspective of Version 11 clients, all Version 10 clients just look like Version 11 clients. Hence, a Version 11 window manager can manipulate Version 10 clients.

This program does NOT use the X10 libnest ddX library. It does actual protocol translation, rather than simply using X11 graphics calls to implement X10 low level operations. As a result, it is both faster and more robust than the X10 Xnest server.

TYPICAL USAGE
The protocol converter must be run after the X11 server is running and should be run in the background:

x10tox11 &

The program will continue to run until you intentionally kill it or the X11 server is shut down.

OPTIONS

-display host:display
    Standard option for specifying the X11 display to which you wish to be connected. By default, it uses unix:0.0. Note that x10tox11 will always pretend to be an X10 server with the same display number as the X11 server to which it connects. For example, if the DISPLAY environment variable or the -display option specifies fizzle:1.0, then x10tox11 will connect to the X11 server on host fizzle for display 1 and then will pretend to the the X10 server for display 1. Consequently, your X10 clients will expect to have the environment variable DISPLAY set to fizzle:1 (but they should still work even if your X10 clients use fizzle:1.0).

MinimumTileSize=n
    Set minimum acceptable tile size to n. There is a difference in semantics between X10's XQueryShape and X11's XQueryBestSize such that X11 will allow any tile size but will return the optimum whereas X10 enforced a minimum tile size. Usually this minimum tile size was 16 and this is the default for x10tox11. If you find that this makes your X10 clients break, then you can override it with this option.

help
    This prints out a usage message and exits.

NoOverrideRedirect
    This instructs x10tox11 to make every effort not to use OverrideRedirect when creating and mapping windows. Normally, x10tox11 creates all windows with the OverrideRedirect attribute set to true. Placing this option on the command line will cause x10tox11 not to use OverrideRedirect except for windows that look like they might be menus. This will allow window managers that provide title bars to do so. Unfortunately, it is impossible to determine ahead of time what an X10 client intends to do with windows. In addition, X10 clients are known to spontaneously unmap their windows which upsets X11 window managers unless the OverrideRedirect attribute is true. Further, some X11 window managers may refuse to resize or move windows that are marked with OverrideRedirect. This may can be fixed to some extent when an Inter Client Communications Convention Manual (ICCCM) is adopted by the X11 community.

SEE ALSO
X(1), Xserver(1)

BUGS
There are limitations with respect to emulating Version 10 through a Version 11 server. See the file /usr/lib/X/x10tox11.help for more details.

Some window managers may refuse to move, resize or perform any operations on X10 client windows because, by default,

If the source is compiled with certain flags, there are significant debugging facilities available. Using the help option will tell you whether debugging facilities are available. x10tox11 marks them with OverrideRedirect. See OPTIONS above.

COPYRIGHT
Copyright 1988, Tektronix Inc.

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

AUTHOR
Todd Brunhoff, Visual Systems Laboratory, Tektronix.