--- 	HELPER - The "User Interface" to sharable Applications     ---

The helper is the additional X application you need to access the "shared X 
functionality"; it simply consists of a menu bar with three entries:
	
	__________
	| Helper |
	-------------------------
	|  Add   Chalk   Remove |
	________________________ 
	

1) Add:
------

"Add" allows you to establish new connections to other X Displays dynamically 
and multiplex the output of a sharable application to these additional 
displays.

HOW TO ADD NEW DISPLAYS TO YOUR APPLICATION:

Click on the Add field with the LEFT mouse button. A new dialog box appears:

	_______________
	| Add Host(s) |
	-------------------
	|>                |
	-------------------
	|         	  |
	|          Cancel |
	-------------------

It prompts for the names of the displays you want to "add" to your application.
The "names" must adhere the X convention concerning display names, i.e.:
	<hostname>:[:]<display number>[.<screen number>]

Example: foo:0.0 means display 0, screen 0 on host foo using TCP/IP transport
	 foo::0.0 means display 0, screen 0 on host foo using DECnet transport
	 (just in case you want to share your application with a VMS guy)

If you want to supply more than one "host", separate the single names with
commas, e.g: foo:0,bar::1

Use the Cancel button to cancel the operation.

After you have pressed the <Return> key, the cursor will change to a "cross-
hair". Now comes the final step: "Identify" the application by moving the 
cursor into one of its windows and pressing ANY mouse button!

The shared X library will notify you that the replication starts by
"ringing" the bell. When the bell rings a second time, replication has
finished and all the displays you supplied have been added.  

NOTE : Don't do anything with the application you want to share during this 
       interval ( AND don't move or resize the application after replication; 
       window management isn't implemented yet !!!).

       If the bell doesn't ring your application is waiting for a useful event
       (it will not get informed about this "add-new-displays"-event); do some-
       thing "useful with it (like moving/clicking the mouse) 

2) Chalk: 
---------

The Chalk command allows you to pass the "chalk" (the input control) to another
display (or get the input control back).

HOW TO PASS THE CHALK TO ANOTHER DISPLAY:

When you activate the Chalk command (like Add, click on the Chalk button with 
the LEFT mouse button), a new and EMPTY dialog appears and the cursor will 
change to the "cross-hair" again.

We break the consistency here, to make chalk-passing easier:

First identify your application (see above). After that the dialog box will be
"filled" with a list containing all displays your application is connected 
with:
	
	--------------
	| Pass Chalk |
	---------------
	|  foo:0      |
	|  bar::1     |
	|             |
	|_____________|
	|             |
	| Ok   Cancel |
	|_____________|


Click on the item (the display) you want to pass the chalk to with the LEFT 
button and then click on the Ok button or simple double-click on the list item.
(Do you think a consistent way would be easier by typing in the display name ?)

Use the Cancel button to cancel the operation.

3) Remove:
----------

The Remove command is used to remove display connections that have previoulsly
been added.

HOW TO REMOVE DISPLAYS FROM YOUR CONNECTION:

Removing works the same way as "passing the chalk" does.