Added ACE_TRY macros to example and brought under ACE style guidelines.

1 files changed, 45 insertions, 5 deletions

diff --git a/TAO/tests/Explicit_Event_Loop/README b/TAO/tests/Explicit_Event_Loop/README
index f098bc9c3a1..66996c57b85 100644
--- a/TAO/tests/Explicit_Event_Loop/README
+++ b/TAO/tests/Explicit_Event_Loop/README
@@ -1,8 +1,48 @@
 $Id$
 
-Test code adapted from code in chaper 3 of "Advanced CORBA 
-Programming  with C++" by Michi Henning and Steve Vinoski.
+Explicit Event Loop test.
 
-Adaptations to to make the code run with TAO are found in
-the file CHANGES.  Further, in server.cpp the orb->run() line
-has been replaced with an explicit event loop.
+This is a test of the methods work_pending() and perform_work() methods of the orb.
+The simple time server, instead of calling orb->run(), has an loop in which 
+work_pending() and perform_work() are called explicitly.   Its usage is specified 
+below.
+______________________________________________________________________________
+This test has been adapted from code in chapter 3 of "Advanced CORBA 
+Programming with C++" by Michi Henning and Steve Vinoski. Copyright 1999. 
+Addison-Wesley, Reading, MA.  To make the examples work with TAO, some minor 
+modifications to the source code have been made, with permission, by Mike 
+Moran <mm4@cs.wustl.edu>.   All of these changes are documented in the file 
+CHANGES in this directory.
+______________________________________________________________________________
+
+
+Summary:
+    This is the simple time server given in chapter 3 of the book.
+    There is a server process which holds a servant object which can return 
+    the current Greenwich time, and a client process which can acess this 
+    object.
+
+Building:
+    This test uses the ACE_TRY macros, and does not need to use native 
+    C++ exceptions.    Make sure to use TAO_FLAG Ge=1 to ensure that 
+    CORBA::Environment variables are created in the IDL generated stubs 
+    and skeletons.
+
+    With GNU make, simply type 
+                            
+    % make
+
+    to create the executable server and client
+
+server:
+    The server takes no parameters nor command line options and returns an 
+    IOR to stdout.  The server then waits infinitely for clients requests.
+
+client:
+    The client takes an IOR from the command line, prints out the current 
+    time, and terminates.
+
+run_test.pl:
+    This is currently a UNIX only script!  It starts up the server, redirecting
+    stdout to a file, then passes the file's contents to the command line of
+    the client.  After the client terminates, the server is killed.