Sat Sep 8 15:03:05 UTC 2007 Phil Mesnier <mesnier_p@ociweb.com>

3 files changed, 64 insertions, 16 deletions

diff --git a/TAO/ChangeLog b/TAO/ChangeLog
index 86bc690f2d8..cf5b8f76631 100644
--- a/TAO/ChangeLog
+++ b/TAO/ChangeLog
@@ -1,17 +1,25 @@
+Sat Sep  8 15:03:05 UTC 2007  Phil Mesnier  <mesnier_p@ociweb.com>
+
+        * tests/POA/EndpointPolicy/README:
+          Revised the wording.
+
+        * tests/POA/POAManagerFactory/README:
+          Added a README for this test.
+
 Fri Sep  7 19:28:33 UTC 2007  Jeff Parsons <j.parsons@vanderbilt.edu>
 
         * TAO_IDL/be/be_enum.cpp:
-        
+
           One  more bit of old code that needed to be restored,
 
 Fri Sep  7 18:42:26 UTC 2007  Jeff Parsons <j.parsons@vanderbilt.edu>
 
         * TAO_IDL/be/be_enum.cpp:
         * TAO_IDL/be/be_visitor_enum/cdr_op_ch.cpp:
-        
+
           Removed some experimental code that was inadvertently checked
           in with
-          
+
           Thu Sep  6 13:10:49 UTC 2007  Jeff Parsons <j.parsons@vanderbilt.edu>
 
 Fri Sep  7 18:15:12 UTC 2007  Johnny Willemsen  <jwillemsen@remedy.nl>
diff --git a/TAO/tests/POA/EndpointPolicy/README b/TAO/tests/POA/EndpointPolicy/README
index 611858f1666..3c5f215fdbd 100644
--- a/TAO/tests/POA/EndpointPolicy/README
+++ b/TAO/tests/POA/EndpointPolicy/README
@@ -2,25 +2,36 @@
 
 @page EndpointPolicy Test README File
 
-	This test bases on the simplest TAO test - Hello test and adds the 
-	endpoint policy test in the server application. The server application 
-	explicitly creates the POAManager with a valid endpoint policy, uses 
-	the POAManager to create a poa and uses the poa to activate a servant. 
-	This is to test the endpoint policy in the POAManager influences the 
-	selection of endpoints to be used when collecting Profiles for use 
-	in Object References. 
-	
-	In addition, the server application also tests some error conditions
-	such as an inappropriate policy is supplied to a new POAManager.
+  This test validates the TAO-specific Endpoint Policy. The Endpoint Policy
+  is applied to a POAManager via the POAManagerFactory, it is not applied to
+  individual POAs. Any POA associated with an endpoint constrained POAManager
+  is subject to the same constraint.
 
+  The server in this test takes one or more localhost-based -ORBEndpoint
+  arguments. A second argument supplies the "correct" port number to be used
+  to create an Endpoint Policy value. Internally, the server creates an
+  invalid endpoint using the hostname_in_ior option for -ORBEndpoint.
 
-	To run the test use the run_test.pl script:
+  Two Endpoint Policy instances are created, one using localhost and the
+  supplied port number, and another creating an invalid endpoint. These are
+  then supplied to the separate POAManagers which are then used to create
+  new POAs. Object references are created on each of the root, good, and bad
+  POAs.
+
+  The client is then passed an IOR and a flag indicating this is expected to
+  succeed or fail. The test succeeds if the client can use the good IOR and
+  gets an exception using the bad IOR.
+
+  To run the test use the run_test.pl script:
 
 $ ./run_test.pl
 
   or start the client and the server manually:
 
-$ server -o $iorfile -p $port -ORBEndpoint iiop://localhost:$port &
-$ client -k file://$iorfile
+$ server -p $port -ORBEndpoint iiop://localhost:$port
+$ client -k file://$iorfile [-b]
+
+  $iorfile is either "good.ior" or "bad.ior" and -b makes the client expect
+  to fail using the supplied IOR.
 
 */
diff --git a/TAO/tests/POA/POAManagerFactory/README b/TAO/tests/POA/POAManagerFactory/README
new file mode 100644
index 00000000000..6088a17d076
--- /dev/null
+++ b/TAO/tests/POA/POAManagerFactory/README
@@ -0,0 +1,29 @@
+/**
+  $Id$
+
+  @page POAManagerFactory Test README
+
+  This test validates the POAManagerFactory implementation. The PMF is
+  described in section 11.3 of the CORBA 3.0.2 specification. The PMF is used
+  to create POAManagers that are not associated with any particular POA. This
+  is useful when creating POAs on demand and need to disassociate the creation
+  of the POAManager. The POAManagerFactory also enables the assignment of
+  policies to the POAManager.
+
+  This test validates
+   - that a reference to the PMF may be obtained,
+   - that the PMF can be used to create POAManager instances,
+   - that the PMF correctly creates only one POAManager for a given name,
+   - that created POAManagers can be supplied to POAs,
+   - that a list of current POAManagers may be obtained from the PMF,
+   - that a specific POAManager may be located.
+
+  This test does not evaluate any policies that may be applied to a POAManager
+  via the PMF. Currently TAO supports only one POAManager policy, the
+  Endpoint Policy. See TAO/tests/POA/EndpointPolicy for information regarding
+  that policy.
+
+  Run this test with the supplied run_test.pl, or directly by running
+  ./POAManagerFactory
+
+*/