ChangeLogTag:Sun Jun 20 00:25:17 2004 J.T. Conklin <jtc@acorntoolworks.com>

3 files changed, 217 insertions, 211 deletions

diff --git a/TAO/docs/Options.html b/TAO/docs/Options.html
index 1ed3e4ff7ab..45077a56964 100644
--- a/TAO/docs/Options.html
+++ b/TAO/docs/Options.html
@@ -17,7 +17,7 @@
       <li><a href="#EV">Environment Variables</a> </li>
       <li><a href="#CLO">Command-line Options</a>
         <ol>
-          <li><a href="#CSCB">Controling Service Configurator Behavior </a>
+          <li><a href="#CSCB">Controlling Service Configurator Behavior </a>
           </li>
           <li><a href="#CDI">Controlling Debugging Information </a> </li>
           <li><a href="#ORP">Optimizing Request Processing </a> </li>
diff --git a/TAO/docs/index.html b/TAO/docs/index.html
index 0e2d1b40d5c..ad95e341380 100644
--- a/TAO/docs/index.html
+++ b/TAO/docs/index.html
@@ -33,17 +33,18 @@ HREF="http://www.omg.org/library/c2indx.html">CORBA</a> Documentation</h3>
       <dt> <img alt="o"
           src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="components.html">ORB Configuration & Tuning</a> </dt><P>
       <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> TAO <a HREF="compiler.html">IDL Compiler Options</a> </dt><P>
+      <dt> <img alt="o"
+          src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> TAO <a HREF="libraries.html">Library Subsets</a></dt><p>
       <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="orbsvcs.html">ORB Services Directories</a> </dt><P>
-      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="INS.html">Interoperable Naming Service</a> </dt><P>
-      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="implrepo/index.html">Implementation Repository</a> </dt><P>
+      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="Tags.html">Tags and Magic Numbers</a> </dt><P>
     </dl>
     </td>
 
     <td><font SIZE="+1"><dl>
       <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> TAO <a href="rtcorba/index.html">Real-Time CORBA</a> </dt><P>
-      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> ACE+TAO <a HREF="../../docs/ACE-subsets.html">Subsetting</a></dt><p>
+      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="INS.html">Interoperable Naming Service</a> </dt><P>
+      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="implrepo/index.html">Implementation Repository</a> </dt><P>
       <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> TAO <a href="exceptions.html">Exception Handling</a></dt><p>
-      <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="Tags.html">Tags and Magic Numbers</a> </dt><P>
       <dt> <img alt="o" src="http://www.cs.wustl.edu/~schmidt/gifs/misc/redball.gif"> <a HREF="pluggable_protocols/index.html">Writing Pluggable Protocols</a> </dt><P>
     </dl>
       </font>
diff --git a/TAO/docs/libraries.html b/TAO/docs/libraries.html
index d93a3727e4f..a07553476c8 100644
--- a/TAO/docs/libraries.html
+++ b/TAO/docs/libraries.html
@@ -10,217 +10,222 @@ link="#000fff"
 vlink="#ff0f0f"
 bgcolor="#ffffff">
 
-    <HR><P><H3 ALIGN=CENTER>Libraries in TAO</H3></P>
+<HR><P><H3 ALIGN=CENTER>Libraries in TAO</H3></P>
 
-    <H3>Overview</H3>
-    As part of the subsetting <a href="minimumTAO.html"> effort </a>
-    to reduce footprint of applications using TAO, we have created
-    different libraries which house various CORBA features such the
-    POA and DynamicAny. This helps to keep the footprint of the
-    application down, linking in features only when required. All of
-    the libraries thus created will have to be linked in by the
-    application code. It is possible to load most of these libraries
-    dynamically using the service configurator framework, but this
-    will not work for statically linked executables. Therefore linking
-    the libraries with the application is the safest way to get the
-    features into your application.
+<H3>Overview</H3>
 
-    <H3> List of Libraries </H3>
-    Here we outline the list of librariesin TAO core with the list of
-    <a href="../../MPC/README"> MPC </a> projects that can be used by
-    the application to get all the required libraries linked into the
-    application. 
+As part of the <a href="minimumTAO.html">subsetting effort</a> to
+reduce footprint of applications using TAO, we have created different
+libraries that house various CORBA features, such the POA and
+DynamicAny.  This design helps minimize application footprint, only
+linking in features that are required.  However, applications must
+link in the libraries they need.  It is possible to load most of these
+libraries dynamically using the ACE Service Configurator framework,
+though this will not work for statically linked executables.  Linking
+the necessary libraries with your application is therefore the most
+straightforward way to get the features you need.
 
-    <table width="75%" border=1>
-        <caption><b>List of CORE libraries in TAO<BR></B></caption>
-     <thead>
-       <tr valign=top>
-       <th>Name of the Library
-       <th>Feature
-       <th> MPC project to use
-       </tr>
-     </thead>
-     <tbody>
-       <tr>
-       <th>libTAO.so</th>
-       <td> All the core features for a client and server side ORB. The
-        list includes support for IIOP, invocation framework,
-        wait strategies for transports, leader-follower framework,
-        thread pools and thread-per-connection framework,
-        portable interceptors, CORBA Any's, CORBA Policy framework,
-        CDR framework  etc. </td>
-       <td>taoclient.mpb for simple clients or tao_lib_with_idl.mpb to
-        create an application library.</td>
-       </tr>
-       <tr>
-       <th>libTAO_BiDirGIOP.so</th>
-       <td>Support for BiDirectional GIOP as outlined by the CORBA
-        spec. Please see $TAO_ROOT/tests/BiDirectional for a simple
-        test case of this feature. Applications need to <code>
-        #include "tao/BiDir_GIOP/BiDirGIOP.h" </code> within their
-        code to get this feature. </td>
-       <td>bidir_giop.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_Domain.so</th>
-       <td>Support for server side skeletons for the DomainManager
-        interface. </td>
-       <td>No base projects available</td>
-       </tr>
-       <tr>
-       <th>libTAO_DynamicAny.so</th>
-       <td>Support for DynamicAny. Please see
-        $TAO_ROOT/tests/DynAny_Test for an example of how to access
-        and use this library. Applications have to <code> #include
-        "tao/DynamicAny/DynamicAny.h" </code> to get the right
-        symbols.</td>
-       <td>dynamicany.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_DynamicInterface.so</th>
-       <td>Support for DII and DSI invocations. Applications have to
-        <code> #include "tao/DynamicInterface/Dynamic_Adapter_Impl.h"
-        </code> to get the right symbols.</td>
-       <td>dynamicinterface.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_DynamicInterface.so</th>
-       <td>Support for DII and DSI invocations. Applications have to
-        <code> #include "tao/DynamicInterface/Dynamic_Adapter_Impl.h"
-        </code> to get the right symbols.</td>
-       <td>dynamicinterface.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_IFR_Client.so</th>
-       <td>Support for client/stub side interfaces for
-        InterfaceRepository applications. Applications have to <code>
-        #include "tao/IFR_Client/IFR_Client_Adapter_Impl.h" </code> to
-        get the right symbols.</td> 
-       <td>ifr_client.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_IORInterceptor.so</th>
-       <td>Support for IORInterceptor. The portable server library
-        depends on the IORInterceptor library. Applications have to
-        <code> #include
-        "tao/IORInterceptor/IORInterceptor_Adapter_Factory_Impl.h"
-        </code> to get the right symbols.</td> 
-       <td>iorinterceptor.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_IORManipulation.so</th>
-       <td>Support for IOR manipulation. The interfaces offered
-        provide operations to create and multi-profile IOR's and
-        other related utilities. Applications have to <code> #include
-        "tao/IORManipulation/IORManip_Loader.h" </code> to get the
-        right symbols.</td>  
-       <td>iormanip.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_IORTable.so</th>
-       <td> Any TAO server can be configured as an corbaloc
-        agent. Such agents forward requests generated using a simple
-        ObjectKey in a corbaloc specification to the real location of
-        the object.  In TAO we implement this feature by dynamically
-        (or  statically) adding a new Object Adapter to the ORB, that
-        handles any sort of request. This feature is placed in this
-        library. Applications have to <code> #include
-        "tao/IORTable/IORTable.h" </code> to get the right
-        symbols.</td>   
-       <td>iortable.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_Messaging.so</th>
-       <td>Support for AMI and CORBA policies such as
-        RoundtripTimeout and ConnectionTimeout are placed in this
-        library. Applications have to <code> #include
-        "tao/Messaging/Messaging.h" </code> to get the
-        rightsymbols.</td>    
-       <td>messaging.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_ObjRefTemplate.so</th>
-       <td>Support for Object Reference Template
-        specification. The portable server library depends on this
-        library. </td>    
-       <td>objreftemplate.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_PortableServer.so</th>
-       <td>Support for POA. This library is automagically loaded by
-        the ORB when the application calls resolve_intial_references
-        ("RootPOA"); Just linking this library should be sufficient to
-        get all the features that are required to write powerful
-        servers. </td>   
-       <td>taoserver.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_RTCORBA.so</th>
-       <td>Support for RTCORBA client side features. Applications are
-        required to <code> #include "tao/RTCORBA/RTCORBA.h" </code> to
-        get the required symbols for linking. Support in this library
-        is complaint with RTCORBA 1.0 spec.</td>   
-       <td>rt_client.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_RTPortableServer.so</th>
-       <td>Support for RTCORBA server side features. Applications are
-        required to <code> #include
-        "tao/RTPortableServer/RTPortableServer.h" </code> to 
-        get the required symbols for linking. Support in this library
-        is complaint with RTCORBA 1.0 spec.</td>   
-       <td>rt_server.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_RTScheduling.so</th>
-       <td>Support for RTCORBA 2.0 features. Applications are
-        required to <code> #include
-        "tao/RTScheduling/RTScheulding.h" </code> to 
-        get the required symbols for linking. Support in this library
-        is complaint with RTCORBA 2.0 spec.</td>   
-       <td>rtscheduling.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_SmartProxies.so</th>
-       <td>Support for <a href
-        ="Smart_Proxies.html">Smartproxies</a>.</td>
-       <td>smart_proxies.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_Strategies.so</th>
-       <td>Support for advanced resource options for the ORB that have
-        been strategized into this library. Advanced resource
-        categories include new transport protocols, additional
-        reactors, connection purging strategies etc. Applications
-        should <code> #include "tao/Strategies/advanced_resources.h"
-        </code>.</td> 
-       <td>strategies.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_TypeCodeFactory.so</th>
-       <td>Support for TypeCodeFactory interface.</td> 
-       <td>typecodefactory.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_Utils.so</th>
-       <td>Helper methods for that are useful for writing portable,
-        exception safe application code.</td> 
-       <td>utils.mpb</td>
-       </tr>
-       <tr>
-       <th>libTAO_Valuetype.so</th>
-       <td>Support for OBV. Portable server and messaging depends on
-        this library </td> 
-       <td>valuetype.mpb</td>
-       </tr>
-  </tr>
-</table>
-        The library names in the above table are the ones created on
-UNIX based systems. Win32 based systems have a slightly different
-naming convention. For example the PortableServer library is named as
+<H3> List of Libraries </H3>
+
+Here we outline the list of libraries in TAO core with the list of <a
+href="../../MPC/README"> MPC </a> projects that can be used by the
+application to get all the required libraries linked into the
+application.  The library names in table below are the ones created on
+UNIX based systems.  Windows systems have a slightly different naming
+convention, e.g., the PortableServer library is named as
 PortableServerd.lib and PortableServerd.dll. But for the naming
 conventions used on different platforms, the contents of the libraries
-and the dependencies outlined above are true. 
+and the dependencies outlined below are the same. <P>
+
+<table width="75%" border=1>
+    <caption><b>List of CORE Libraries in TAO<P></B></caption>
+ <thead>
+   <tr valign=top >
+   <th>Name of the Library
+   <th>Feature
+   <th> MPC project to use
+   </tr>
+ </thead>
+ <tbody>
+   <tr align=left>
+   <th>libTAO.so</th>
+   <td> All the core features for a client and server side ORB. The
+    list includes support for IIOP, invocation framework,
+    wait strategies for transports, leader-follower framework,
+    thread pools and thread-per-connection framework,
+    portable interceptors, CORBA Any's, CORBA Policy framework,
+    CDR framework  etc. </td>
+   <td>taoclient.mpb for simple clients or tao_lib_with_idl.mpb to
+    create an application library.</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_BiDirGIOP.so</th>
+   <td>Support for BiDirectional GIOP as outlined by the CORBA
+    spec. Please see $TAO_ROOT/tests/BiDirectional for a simple
+    test case of this feature. Applications need to <code>
+    #include "tao/BiDir_GIOP/BiDirGIOP.h" </code> within their
+    code to get this feature. </td>
+   <td>bidir_giop.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_Domain.so</th>
+   <td>Support for server side skeletons for the DomainManager
+    interface. </td>
+   <td>No base projects available</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_DynamicAny.so</th>
+   <td>Support for DynamicAny. Please see
+    $TAO_ROOT/tests/DynAny_Test for an example of how to access
+    and use this library. Applications have to <code> #include
+    "tao/DynamicAny/DynamicAny.h" </code> to get the right
+    symbols.</td>
+   <td>dynamicany.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_DynamicInterface.so</th>
+   <td>Support for DII and DSI invocations. Applications have to
+    <code> #include "tao/DynamicInterface/Dynamic_Adapter_Impl.h"
+    </code> to get the right symbols.</td>
+   <td>dynamicinterface.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_DynamicInterface.so</th>
+   <td>Support for DII and DSI invocations. Applications have to
+    <code> #include "tao/DynamicInterface/Dynamic_Adapter_Impl.h"
+    </code> to get the right symbols.</td>
+   <td>dynamicinterface.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_IFR_Client.so</th>
+   <td>Support for client/stub side interfaces for
+    InterfaceRepository applications. Applications have to <code>
+    #include "tao/IFR_Client/IFR_Client_Adapter_Impl.h" </code> to
+    get the right symbols.</td> 
+   <td>ifr_client.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_IORInterceptor.so</th>
+   <td>Support for IORInterceptor. The portable server library
+    depends on the IORInterceptor library. Applications have to
+    <code> #include
+    "tao/IORInterceptor/IORInterceptor_Adapter_Factory_Impl.h"
+    </code> to get the right symbols.</td> 
+   <td>iorinterceptor.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_IORManipulation.so</th>
+   <td>Support for IOR manipulation. The interfaces offered
+    provide operations to create and multi-profile IOR's and
+    other related utilities. Applications have to <code> #include
+    "tao/IORManipulation/IORManip_Loader.h" </code> to get the
+    right symbols.</td>  
+   <td>iormanip.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_IORTable.so</th>
+   <td> Any TAO server can be configured as an corbaloc
+    agent. Such agents forward requests generated using a simple
+    ObjectKey in a corbaloc specification to the real location of
+    the object.  In TAO we implement this feature by dynamically
+    (or  statically) adding a new Object Adapter to the ORB, that
+    handles any sort of request. This feature is placed in this
+    library. Applications have to <code> #include
+    "tao/IORTable/IORTable.h" </code> to get the right
+    symbols.</td>   
+   <td>iortable.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_Messaging.so</th>
+   <td>Support for AMI and CORBA policies such as
+    RoundtripTimeout and ConnectionTimeout are placed in this
+    library. Applications have to <code> #include
+    "tao/Messaging/Messaging.h" </code> to get the
+    rightsymbols.</td>    
+   <td>messaging.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_ObjRefTemplate.so</th>
+   <td>Support for Object Reference Template
+    specification. The portable server library depends on this
+    library. </td>    
+   <td>objreftemplate.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_PortableServer.so</th>
+   <td>Support for POA. This library is automagically loaded by
+    the ORB when the application calls resolve_intial_references
+    ("RootPOA"); Just linking this library should be sufficient to
+    get all the features that are required to write powerful
+    servers. </td>   
+   <td>taoserver.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_RTCORBA.so</th>
+   <td>Support for RTCORBA client side features. Applications are
+    required to <code> #include "tao/RTCORBA/RTCORBA.h" </code> to
+    get the required symbols for linking. Support in this library
+    is complaint with RTCORBA 1.0 spec.</td>   
+   <td>rt_client.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_RTPortableServer.so</th>
+   <td>Support for RTCORBA server side features. Applications are
+    required to <code> #include
+    "tao/RTPortableServer/RTPortableServer.h" </code> to 
+    get the required symbols for linking. Support in this library
+    is complaint with RTCORBA 1.0 spec.</td>   
+   <td>rt_server.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_RTScheduling.so</th>
+   <td>Support for RTCORBA 2.0 features. Applications are
+    required to <code> #include
+    "tao/RTScheduling/RTScheulding.h" </code> to 
+    get the required symbols for linking. Support in this library
+    is complaint with RTCORBA 2.0 spec.</td>   
+   <td>rtscheduling.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_SmartProxies.so</th>
+   <td>Support for <a href
+    ="Smart_Proxies.html">Smartproxies</a>.</td>
+   <td>smart_proxies.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_Strategies.so</th>
+   <td>Support for advanced resource options for the ORB that have
+    been strategized into this library. Advanced resource
+    categories include new transport protocols, additional
+    reactors, connection purging strategies etc. Applications
+    should <code> #include "tao/Strategies/advanced_resources.h"
+    </code>.</td> 
+   <td>strategies.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_TypeCodeFactory.so</th>
+   <td>Support for TypeCodeFactory interface.</td> 
+   <td>typecodefactory.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_Utils.so</th>
+   <td>Helper methods for that are useful for writing portable,
+    exception safe application code.</td> 
+   <td>utils.mpb</td>
+   </tr>
+   <tr align=left>
+   <th>libTAO_Valuetype.so</th>
+   <td>Support for object by value (OBV). Portable server and messaging depends on
+    this library </td> 
+   <td>valuetype.mpb</td>
+   </tr>
+</tr>
+</table>
+
+<hr>
+<p>Back to the TAO <a href="index.html">TAO documentation page</a>.<!--#include virtual="/~schmidt/cgi-sig.html" -->
+</body>
+
 </HTML>