	NAME		RDoIt--renamed SocketServer
        AUTHOR          Bill Voss (voss@cs.uiuc.edu) updated by stp@ccrma.stanford.edu--5/92
        FUNCTION    UNIX command line DoIt, with X11 rootmenu Launcher example.
        ST-VERSIONS     ST80 R4 (R4.1 by stp)
	PREREQUISITES	utils/UnixSock.st (UNIX sockets from ParcPlace distribution)
	DISTRIBUTION  	world
	VERSION	ID	0.2
	VERSION DATE	5 June, 1992

SUMMARY RDoItServer

	This package consists of Smalltalk-80 Release 4, and C code.
The Smalltalk-80 code creates a Smalltalk process which provides
a Socket based server.  The C code talks to that server.  The result
is the ability to execute "rdoit" at a Unix command line, and have
the Smalltalk image "Do It."  (Very similar to the Berkley rsh command.).

	I use this package to put the "Launcher" options on my root
OpenWindows menu.  The speed is quite acceptable on a SparcStation 2
with 32 megs of RAM, and no other users. ;-)  I have not tested this
code in any other environment.

	I am releasing this code in the hope that others will find it
useful, and that others will improve it.  It is a very poor example of 
good coding style, or a very good example of poor coding style. ;-) 
However, it seems to work, and I need to get back to work.

					Bill Voss,  June 14th 1991.
					updated/extended by stp@ccrma.stanford.edu, 5/92
----------------------------------------------------------------------------
To install the RDoItServer:

1) Type "make" to compile the C program rdoit.c.
2) Start up a Smalltalk-80 R4.1 virtual image and file in "utils/UnixSock.st" 
	from the ParcPlace R4 distribution utils directory if necessary.
3) File in "OS-SocketServer.st" from this distribution.
4) Next read the "SocketServer" class comment for security warnings.

	-- If You Still Wish To Proceed. --
5) Evaluate "SocketServer start." to start the server.
6) In a shell window, execute the shell command,
	rdoit localhost 8004 "Transcript show: 'It works', (String with: Character cr)"
7) Click "YES" to authorize connections from localhost.
8) Make certain 'It works' has been printed on the System Transcript.
9) Copy the rdoit binary to some place on your path such as ~/bin.
10) (Assuming you are running olwm or olvwm.)
   Include the file "launcher-menu.4.1" in your ~/.openwin-menu file.
   (You may need to adjust the paths.)
11) The menu should update as soon as you save the menu file.
	Test the st80 menu items and re-edit the menu as appropriate.
12) Make a snapshot of the image with the socket server on and without a launcher.

...enjoy


Comments on the Socket Server and LauncherMenu goodies--stp, 5/92

I renamed the class SocketServer and the category OS-SocketServer; this
means renaming the file, and editing the st80 source as shown below.

I added a Transcript show if the Compiler returns anything.

There's an updated addition to ~/.openwin-menu for OW\ST-80 R4.1.
I also add my different images as the last submenu; see below.

