* man/man1/tao_idl.1:

        Moved tao_idl man page to newly created man page directory.

        * man/man1/TAO.1:
        * man/man1/TAO_Concurrency_Service.1:
        * man/man1/TAO_CosEvent_Service.1:
        * man/man1/TAO_Event_Service.1:

        Started added man pages for TAO and TAO's ORB services.  There are
        still several more to complete.  Some of the ones listed above need
        to be revised.

5 files changed, 772 insertions, 0 deletions

diff --git a/TAO/man/man1/TAO.1 b/TAO/man/man1/TAO.1
new file mode 100644
index 00000000000..3f6055d44d8
--- /dev/null
+++ b/TAO/man/man1/TAO.1
@@ -0,0 +1,406 @@
+.\" Process this file with
+.\" groff -man -Tascii TAO.1
+.\"
+.\" $Id$
+.\"
+.TH TAO 1 "April 1999" "CORBA Tools"
+.SH NAME
+TAO \- The ACE ORB
+.SH SYNOPSIS
+.B TAO_Application
+.B [
+.I TAO OPTIONS
+.B ]
+.SH DESCRIPTION
+.B TAO
+is a high performance real-time
+.SM CORBA
+.SM ORB.
+All applications that use TAO can take advantage of the environment variables
+and command line options described in this manual page.
+.SH TAO ENVIRONMENT VARIABLES
+.TP
+.B NameServiceIOR
+Specifies which IOR the TAO Naming Service is listening on.
+.TP
+.B NameServicePort
+Specifies which port the TAO Naming Service is listening on.
+.TP
+.B TradingServiceIOR
+Specifies which IOR the TAO Trading Service is listening on.
+.TP
+.B TradingServicePort
+Specifies which port the Trading Service is listening on.
+.TP
+.B TAO_ORB_DEBUG
+Enables TAO debugging mode.
+.SH TAO OPTIONS
+The following components can be tuned via options:
+.IP
+.B CORBA::ORB
+.IP
+.B TAO_Resource_Factory
+.IP
+.B TAO_Default_Server_Strategy_Factory
+.IP
+.B TAO_Default_Client_Strategy_Factory
+.TP
+.B CORBA::ORB
+Typically, CORBA::ORB options are set via command line parameters, while the
+rest of the options are set via the service configurator
+.B (svc.conf)
+file.
+.IP
+.BI \-ORBsvcconf \ config_file_name
+\ \ Specifies the name of the file from which it will read dynamic service
+configuration directives ala ACE's Service Configurator.
+.IP
+.BI \-ORBsvcconfdirective \ directivestring
+\ \ Specifies a service configuration directive, which is passed to ACE's
+Service Configurator.
+.IP
+.B \-ORBdaemon
+\ \ Specifies that the ORB should daemonize itself.
+.IP
+.BI \-ORBdebug
+\ \ Turns on the output of debugging messages within ACE's Service
+Configurator componentry.
+.IP
+.BI \-ORBdebuglevel \ level
+\ \ Control the level of debugging in the ORB. Higher number produce more
+output (try 10).
+.IP
+.BI \-ORBhost \ hostname
+\ \  Tells the Object Adapter to listen for requests on the interface associated with the host named
+.I hostname.
+.IP
+.BI \-ORBport \ portspec
+\ \ Tells the Object Adapter to listen for requests on the port specified by
+.IR portspec ,
+which can be a name as found in
+.B /etc/services
+or a number. The default is 10013.
+.IP
+.BI \-ORBobjrefstyle \ IOR | URL
+\ \ Specifies the user-visible style of object references.
+.B IOR 
+is the traditional nonsensical object reference.
+.B URL
+makes the object reference look more like a URL.
+.IP
+.BI \-ORBtablesize \ object_table_size
+\ \ Specifies the size of the object table as a positive, non-zero integer. If
+not specified, the default is 64.
+.IP
+.BI \-ORBrcvsock \ receive_qabuffer_size
+\ \ Specify the size of the socket receive buffer as a positive, non-zero
+integer. If not specified, the system-dependent default is used.
+.IP
+.BI \-ORBsndsock \ send_buffer_size
+\ \ Specify the size of the socket send buffer as a positive, non-zero
+integer. If not specified, the system-dependent default is used.
+.IP
+.BI \-ORBnameserviceport \ portspec
+\ \ Specifies which port the Naming Service is listening on.
+.IP
+.BI \-ORBnameserviceior \ IOR
+\ \ Specifies the
+.I IOR
+for the Naming Service.
+.IP
+.BI \-ORBtradingserviceior \ IOR
+\ \ Specifies the
+.I IOR
+for the Trading Service.
+.IP
+.BI \-ORBtradingserviceport \ portspec
+\ \ Specifies which port the Trading Service is listening on.
+.IP
+.BI \-ORBcollocation \ yes | no
+\ \ Specifies the use of collocation object optimization. Default is
+.IR yes .
+.IP
+.BI \-ORBpreconnect \ host:port
+.BR [,
+.I host:port
+.RB ... ]
+\ \ Pre-establishes a blocking connection to each listed host:port combination.
+If a connection cannot be established, a warning is announced and it continues
+with the next listed. Listing the same combination multiple times will properly
+establish multiple connections to that endpoint.
+.IP
+.BI \-ORBcdrtradeoff \ maxsize
+\ \ Control the strategy to tradeoff between copy vs no copy marshalling of
+octet sequences. If an octet sequence is smaller than maxsize and the current
+message block contains enough space for it the octet sequence is copied instead
+of appended to the CDR stream.
+.IP
+.B \-ORBgioplite
+\ \ Enable a lightweight version of the GIOP protocol. This protocol removes
+some of the fields in the GIOP and the Request header. It only works on
+homogenous environments.
+.IP
+.BI \-ORBdotteddecimaladdresses \ boolean
+(0/1)   Use the dotted decimal notation for addresses.
+.IP
+.BI \-ORBInitRef\  ObjectId=IOR
+\ \ Allows specification of an arbitrary object reference for an initial
+service. The IOR could be in the one of the following formats:
+.BR OMG\ IOR , \ URL \ or \ iioploc
+form.
+.B iioploc
+is a multiple end-point IORs understood by
+.B string_to_object\ ()
+and used as a boot-strapping mechanism by
+.BR resolve_initial_references\ () .
+The mappings specified through this argument override the
+.B orb-install-time
+defaults.
+.IP
+.BI \-ORBDefaultInitRef \ IOR_prefix
+\ \ This argument allows resolution of initial references not explicitly
+specified with -ORBInitRef. It requires a URL prefix that, after appending a
+slash
+.B '/'
+and a simple object key, forms a new URL to identify an initial object
+reference. The URL prefix format currently supported is iioploc.
+.TP
+.B TAO_Resource_Factory
+.IP
+.BI \-ORBresources \ value
+\ \ Specify whether each thread uses a global (
+.I value
+=
+.B global
+) or a thread\-specific (
+.IR value
+=
+.B tss
+) instance for the resources it returns.
+.IP
+.BI \-ORBpoa \ value
+\ \ Specify whether each thread uses a global (which = global) or a
+thread\-specific (
+.I value
+=
+.B tss
+) instance for the Root POA.
+.IP
+.BI \-ORBreactorlock \ value
+\ \ Specify whether the ORB reactor is thread\-safe (
+.I value
+=
+.B token
+) or not (
+.I value
+=
+.B null
+). Default is
+.BR token .
+.IP
+.BI \-ORBcoltable \ value
+\ \ Specify whether each ORB uses a global (
+.I value
+=
+.B global
+) or a per\-ORB (
+.I value
+=
+.B orb
+) collocation table.
+.IP
+.BI \-ORBinputcdrallocator \ value
+\ \ Specify whether the ORB uses a global (
+.I value
+=
+.B global
+) or a per\-thread (
+.I value
+=
+.B tss
+) allocator for the incoming CDR buffers. Though
+.B tss
+should give the optimal performance; we made the default
+.BR global .
+TAO optimizations for octet sequences will not work when returning that data
+type if the allocator is
+.BR tss .
+Using a
+.B global
+allocator also allows the users to take advantage of the TAO octet sequence
+extensions to preserve the buffer after the upcall.
+.TP
+.B TAO_Default_Server_Strategy_Factory
+.IR Note :
+.B \-ORBdemuxstrategy
+flag has been changed to
+.B \-ORBsystemidpolicydemuxstrategy
+and
+.BR \-ORBuseridpolicydemuxstrategy .
+.IP
+.IR Note :
+.B \-ORBtablesize
+flag has been changed to
+.BR \-ORBactiveobjectmapsize .
+.IP
+.BI \-ORBconcurrency \ value
+\ \ Specify which concurrency strategy to use. Range of values is reactive for
+a purely Reactor\-driven concurrency strategy or thread\-per\-connection for
+creating a new thread to service each connection.
+.IP
+.BI \-ORBactiveobjectmapsize \ active_object_map_size
+\ \ Specify the size of the active object map. If not specified, the default
+value is 64.
+.IP
+.BI \-ORBuseridpolicydemuxstrategy \ dynamic | linear
+\ \ Specify the demultiplexing lookup strategy to be used with the user ID
+policy.  This option defaults to use the
+.I dynamic
+strategy.
+.IP
+.BI \-ORBsystemidpolicydemuxstrategy \ dynamic | linear | active
+\ \ Specify the demultiplexing lookup strategy to be used with the system ID
+policy.  This option defaults to use the
+.I active
+strategy. 
+.IP
+.BI \-ORBuniqueidpolicyreversedemuxstrategy \ dynamic | linear
+\ \ Specify the reverse demultiplexing lookup strategy to be used with the
+unique ID policy.  This option defaults to use the
+.I dynamic
+strategy. 
+.IP
+.BI \-ORBallowreactivationofsystemids \ 0 | 1
+\ \ Specify whether system ids can be reactivated, i.e., once an id that was
+generated by the system has be deactivated, will the user reactivate a new
+servant using the old ID. If the user is not going to use this feature, the
+IORs can be shortened, an extra comparison in the critical upcall path removed,
+and some memory on the server side can be saved.  This option defaults to
+.IR 1 .
+.IP
+.BI \-ORBactivehintinids \ 0 | 1
+\ \ Specify whether an active hint should be added to IDs. With active hints,
+IDs can be found quickly. However, they lead to larger IORs. Note that this
+option is disregarded if
+.B \-ORBallowreactivationofsystemids
+is set to
+.IR 0 .
+The
+.B \-ORBactivehintinids
+option can be
+.IR 0 \ or \ 1 .
+This option defaults to
+.IR 1 .
+.IP
+.BI \-ORBpoamapsize poa_map_size
+\ \ Specify the size of the POA map. If not specified, the default value is 24.
+.IP
+.BI \-ORBpersiententidpolicydemuxstrategy \ dynamic | linear
+\ \ Specify the demultiplexing lookup strategy to be used with the persistent
+ID policy.  This option defaults to use the
+.I dynamic
+strategy.
+.IP
+.BI \-ORBtransientidpolicydemuxstrategy \ dynamic | linear | active
+\ \ Specify the demultiplexing lookup strategy to be used with the transient ID
+policy.  This option defaults to use the
+.I active
+strategy. 
+.IP
+.BI \-ORBactivehintinpoanames \ 0 | 1
+\ \ Specify whether an active hint should be added to POA names. With active
+hints, POA names can be found quickly. However, they lead to larger IORs.  This
+option defaults to
+.IR 1 .
+.IP
+.BI \ -ORBthreadflags \ thread_flags
+\ \ Specify the flags used for thread creation. Flags can be any logical\-OR
+combination of
+.BR THR_DETACHED ,
+.BR THR_BOUND ,
+.B THR_NEW_LWP
+and
+.BR THR_SUSPENDED .
+.IP
+.BI \-ORBpoalock \ thread | null
+\ \ Specify the type of lock to be used for POA accesses.
+.I thread
+specifies that an inter\-thread mutex is used to guarantee exclusive
+access and
+.I null
+specifies that no locking be performed. The default is
+.IR thread .
+.IP
+.BI \-ORBcoltbllock \ thread | null
+\ \ Specify the type of lock to be used for the global collocation table.
+.I thread
+specifies that an inter\-thread mutex is used to guarantee exclusive access
+and
+.I null
+specifies that no locking be performed. The default is
+.IR thread .
+.IP
+.BI \-ORBconnectorlock \ thread | null
+\ \ Specify the type of lock to be used by the connector.
+.I thread
+specifies that an inter\-thread mutex is used to guarantee exclusive access
+and
+.I null
+specifies that no locking be performed. The default is
+.IR thread .
+.TP
+.B TAO_Default_Client_Strategy_Factory
+.BI \-ORBiiopprofilelock \ thread | null
+\ \ Specify, whether to use a lock for accessing the IIOP Profile or not.
+Default is
+.IR thread ,
+which means that a lock is used. The second option is
+.IR null ,
+which means a
+.B null
+lock is used. This makes sense in case of optiziations and is allowed when no
+forwarding is used or only a single\-threaded client.
+.IP
+.BI \-ORBclientconnectionhandler \ MT | ST | RW
+.IP
+.I MT
+means use the multi\-threaded client connection handler which uses the leader
+follower model. This model allows the use of multiple threads with a single
+Reactor.
+.IP
+.I ST
+means use the single\-threaded client connection handler, i.e., the leader
+follower model will not be used. However,
+.I ST
+does support nested upcalls and handling of new requests while waiting for the
+reply from a server. 
+.IP
+.I RW
+selects a strategy that simply blocks in
+.B recv()
+when waiting for a response from the server instead of waiting in the Reactor.
+The
+.I RW
+strategy only works when the application does not have to worry about new
+request showing up when waiting for a response. Therefore, this strategy is
+appropriate only for "pure" clients. Note that applications with nested upcalls
+are not "pure" clients.  Also note that this strategy will only effect two way
+calls, since there is no waiting for one way calls. This strategy can also be
+used in an application that is both a client and a server if the server side is
+handled by a separate thread and the client threads are "pure" clients.
+.IP
+Default for this option is
+.IR MT .
+.SH AUTHORS
+Center for Distributed Object Computing <http://www.cs.wustl.edu/~schmidt/TAO.html>
+.SH "SEE ALSO"
+.BR TAO_Concurrency_Service (1),
+.BR TAO_CosEvent_Service (1),
+.BR TAO_Event_Service (1),
+.BR TAO_ImplRepo_Service (1),
+.BR TAO_LifeCycle_Service (1),
+.BR TAO_Logging_Service (1),
+.BR TAO_Naming_Service (1),
+.BR TAO_Scheduling_Service (1),
+.BR TAO_Time_Service (1),
+.BR TAO_Trading_Service (1)
diff --git a/TAO/man/man1/TAO_Concurrency_Service.1 b/TAO/man/man1/TAO_Concurrency_Service.1
new file mode 100644
index 00000000000..f7a41b54a72
--- /dev/null
+++ b/TAO/man/man1/TAO_Concurrency_Service.1
@@ -0,0 +1,53 @@
+.\" Process this file with
+.\" groff -man -Tascii TAO_Concurrency_Service.1
+.\"
+.\" $Id$
+.\"
+.TH TAO_Concurrency_Service 1 "April 1999" "CORBA Tools"
+.SH NAME
+TAO_Concurrency_Service \- The TAO Concurrency Service
+.SH SYNOPSIS
+.B TAO_Concurrency_Service
+.B [
+\-d
+.B ]
+.B [
+\-s
+.B ]
+.B [
+\-o
+IOR_output_file
+.B ]
+.SH DESCRIPTION
+.B TAO_Concurrency_Service
+is an implentation of the CORBA Concurrency Service.  It provides a mechanism
+that allows clients to acquire and release various types of locks in a
+distributed system.
+.SH OPTIONS
+.TP
+.B \-d
+enable debugging
+.TP
+.B \-s
+prevent the concurrency server from using the naming server
+.TP
+.BI \-o IOR_output_file
+output the IOR of the lock set factory to a specified file
+.SH BUGS
+(blank for now)
+.SH AUTHORS
+.IP
+Torben Worm <tworm@cs.wustl.edu>
+.IP
+Ossama Othman <othman@cs.wustl.edu>
+.SH "SEE ALSO"
+.BR TAO (1),
+.BR TAO_CosEvent_Service (1),
+.BR TAO_Event_Service (1),
+.BR TAO_ImplRepo_Service (1),
+.BR TAO_LifeCycle_Service (1),
+.BR TAO_Logging_Service (1),
+.BR TAO_Naming_Service (1),
+.BR TAO_Scheduling_Service (1),
+.BR TAO_Time_Service (1),
+.BR TAO_Trading_Service (1)
diff --git a/TAO/man/man1/TAO_CosEvent_Service.1 b/TAO/man/man1/TAO_CosEvent_Service.1
new file mode 100644
index 00000000000..e6f35835e6d
--- /dev/null
+++ b/TAO/man/man1/TAO_CosEvent_Service.1
@@ -0,0 +1,88 @@
+.\" Process this file with
+.\" groff -man -Tascii TAO_CosEvent_Service.1
+.\"
+.\" $Id$
+.\"
+.TH TAO_CosEvent_Service 1 "April 1999" "CORBA Tools"
+.SH NAME
+TAO_CosEvent_Service \- The TAO COS compliant Event Service
+.SH SYNOPSIS
+.B TAO_CosEvent_Service
+.B [
+.I OPTIONS
+.B ]
+.SH DESCRIPTION
+.B TAO_CosEvent_Service
+is a COS compilant Event Service.  The service is registered with the naming
+service with the name "CosEventService." It exposes the EventChannel interface
+which can be used by suppliers and consumers to send and receive events.
+
+TAO_Naming_Service (1) and TAO_Event_Service (1) must be running in order to
+run the Event Channel.
+.SH OPTIONS
+.TP
+.BI \-n \ COS_Event_Service_Name
+specify the name with which to register the Event Service
+.TP
+.BI \-r \ Real_Time_Event_Service_Name
+specify the name with which to
+.I look
+for the RtEC
+.TP
+.BI \-s \ global | local
+specify if the scheduler is
+.I local
+or
+.I global
+
+If the scheduler option is
+.I global
+then the naming service is to locate the scheduling service with the name
+"ScheduleService."
+
+If the scheduler is
+.I local
+then a new scheduling service is created and started.
+.I local
+is the default.
+.TP
+.B \-l
+specify that a local Real Time Event Channel (RtEC).
+
+If you specify this option but no RtEC is already running, then the 
+TAO_CosEvent_Service starts its oewn RtEC.
+.SH FILTERING OPTIONS
+The following options are used to introduce a filtering mechanism for the Event
+Channel based on event types and source IDs.
+.TP
+.BI \-e \ "EventType_1\ EventType_2\ ..."
+specify the event types for the ConsumerQOS.  The ConsumerQOS is specified
+when the RtEC is being set up.
+
+The event types should be >= ACE_ES_EVENT_UNDEFINED = 16.  For example, \-e
+"17 20 40" specifies that event types with IDs 17, 20 and 40 should be passed
+to the consumers.
+.TP
+.BI \-o \ "EventSourceID_1\ EventSourceID_2\ ..."
+specify the source IDs for the ConsumerQOS.
+.TP
+.BI \-p \ "sourceID\ EventTypeID"
+specify a sourceID and event type pair for the Supplier QOS.
+.SH BUGS
+(blank for now)
+.SH AUTHORS
+.IP
+Pradeep Gore <pradeep@cs.wustl.edu>
+.IP
+Ossama Othman <othman@cs.wustl.edu>
+.SH "SEE ALSO"
+.BR TAO (1),
+.BR TAO_Concurrency_Service (1),
+.BR TAO_Event_Service (1),
+.BR TAO_ImplRepo_Service (1),
+.BR TAO_LifeCycle_Service (1),
+.BR TAO_Logging_Service (1),
+.BR TAO_Naming_Service (1),
+.BR TAO_Scheduling_Service (1),
+.BR TAO_Time_Service (1),
+.BR TAO_Trading_Service (1)
diff --git a/TAO/man/man1/TAO_Event_Service.1 b/TAO/man/man1/TAO_Event_Service.1
new file mode 100644
index 00000000000..e50e25a8bc9
--- /dev/null
+++ b/TAO/man/man1/TAO_Event_Service.1
@@ -0,0 +1,58 @@
+.\" Process this file with
+.\" groff -man -Tascii TAO_Event_Service.1
+.\"
+.\" $Id$
+.\"
+.TH TAO_Event_Service 1 "April 1999" "CORBA Tools"
+.SH NAME
+TAO_Event_Service \- The TAO Real-time Event Service
+.SH SYNOPSIS
+.B TAO_Event_Service
+.B [
+.I OPTIONS
+.B ]
+.SH DESCRIPTION
+.B TAO_Event_Service
+
+.SH OPTIONS
+.TP
+.BI \-n \ service_name
+specify the name with which to register the Event Service
+.TP
+.BI \-s \ global | local
+specify if the scheduler is
+.I local
+or
+.I global
+
+If the scheduler option is
+.I global
+then the naming service is to locate the scheduling service with the name
+"ScheduleService."
+
+If the scheduler is
+.I local
+then a new scheduling service is created and started.
+.I local
+is the default.
+.TP
+.B \-t \ null_filtering | reactive | old_reactive | old_mt
+(FIXME: NEED OPTION DESCRIPTIONS)
+.SH BUGS
+(blank for now)
+.SH AUTHORS
+.IP
+Carlos O'Ryan <coryan@cs.wustl.edu>
+.IP
+Ossama Othman <othman@cs.wustl.edu>
+.SH "SEE ALSO"
+.BR TAO (1),
+.BR TAO_Concurrency_Service (1),
+.BR TAO_CosEvent_Service (1),
+.BR TAO_ImplRepo_Service (1),
+.BR TAO_LifeCycle_Service (1),
+.BR TAO_Logging_Service (1),
+.BR TAO_Naming_Service (1),
+.BR TAO_Scheduling_Service (1),
+.BR TAO_Time_Service (1),
+.BR TAO_Trading_Service (1)
diff --git a/TAO/man/man1/tao_idl.1 b/TAO/man/man1/tao_idl.1
new file mode 100644
index 00000000000..57fa5b2c0e6
--- /dev/null
+++ b/TAO/man/man1/tao_idl.1
@@ -0,0 +1,167 @@
+.\" Process this file with
+.\" groff -man -Tascii tao_idl.1
+.\"
+.\" $Id$
+.\"
+.TH tao_idl 1 "DECEMBER 1998" "CORBA Tools" "User Manuals"
+.SH NAME
+tao_idl \- Compile IDL sources for use with the ACE ORB (TAO)
+.SH SYNOPSIS
+.B tao_idl
+.B [
+.I OPTION
+.B ... ] 
+filename
+.SH DESCRIPTION
+.B tao_idl
+is a program that is used to compile
+.I IDL
+source code.  The IDL compiler generates 6 files from each .idl file, the file
+names are obtained by taking the IDL basename and appending C.h, C.i, C.cpp,
+S.h, S.i and S.cpp; the client stubs are declared in the C.h file, the
+skeletons in the S.h file. Please see the Options list on how to get different
+suffixes for these files. 
+
+Both clients and servers should link against the object files for the stubs
+and skeletons, this is needed to transparently support collocated objects.
+
+The server skeleton can make use of different lookup strategies to match the
+incoming operation with the correct operation at the servant.  Dynamic Hashing
+and Perfect Hashing are the two different operation lookup strategies that are
+currently supported in tao_idl.  By default, tao_idl tries to use Perfect
+Hashing strategy.  If supported and available, gperf generates the lookup
+methods for this strategy. 
+.SH OPTIONS
+.TP
+.B \-V
+the compiler printouts its version and exits
+.TP
+.BI "\-Wb," "option_list" 
+pass options to the backend
+.IP
+.BI "export_macro=" "macro_name"
+The compiler will emit macro_name right after each class or extern keyword,
+this is needed for Windows/NT that requires special directives to export
+symbols from DLLs, usually the definition is just a space on unix platforms.
+.IP
+.BI "export_include=" "include_path"
+The compiler will generate code to include include_path at the top of the
+client header, this is usually a good place to define the export macro. 
+.TP
+.B \-E
+only invoke the preprocessor
+.TP
+.BI "-Wp," "option_list"
+pass options to the preprocessor
+.TP
+.BI "\-D" "macro_definition"
+passed to the preprocessor
+.TP
+.BI "\-U" "macro_name"
+passed to the preprocessor
+.TP
+.BI "\-I" "include_path"
+passed to the preprocessor
+.TP
+.BI "\-A" "assertion"
+passed to the preprocessor
+.TP
+.B \-Y
+passed to the preprocessor
+.TP
+.B "\-H perfect_hash"
+To specify the IDL compiler to generate skelton code that uses perfect hashed
+operation lookup strategy, which is the default strategy. Perfect hashing uses
+gperf program, to generate lookup methods.
+.TP
+.B "\-H dynamic_hash"
+To specify the IDL compiler to generate skelton code that uses dynamic hashed
+operation lookup strategy.
+.TP
+.B "\-H binary_search"
+To specify the IDL compiler to generate skelton code that uses binary search
+based operation lookup strategy.
+.TP
+.B "\-H linear_search"
+To specify the IDL compiler to generate skelton code that uses linear search
+based operation lookup strategy.
+.TP
+.B "\-in"
+To generate #include statements with <>'s for the standard include
+files (e.g. tao/corba.h) indicating them as non-changing files
+.TP
+.B "\-ic"
+To generate #include statements with ""s for changing standard include
+files (e.g. tao/corba.h). 
+.TP
+.B \-g
+To specify the path for the perfect hasing program (GPERF). Default is
+$ACE_ROOT/bin/gperf or whatever the ACE_GPERF macro was defined to be during
+compilation of TAO.
+based operation lookup strategy.
+.TP
+.B \-o
+To specify the output directory to IDL compiler as to where all the
+IDL\-compiler\-generated files are to be put. By default, all the files are
+put in the current directory from where
+.B tao_idl
+is called.
+.TP
+.B \-hc
+Client's header file name ending. Default is "C.h".
+.TP
+.B \-hs
+Server's header file name ending. Default is "S.h".
+.TP
+.B \-hT
+Server's template header file name ending. Default is "S_T.h".
+.TP
+.B \-cs
+Client stub's file name ending. Default is "C.cpp".
+.TP
+.B \-ci
+Client inline file name ending. Default is "C.i".
+.TP
+.B \-ss
+Server skeleton file name ending. Default is "S.cpp".
+.TP
+.B \-sT
+Server template skeleton file name ending. Default is "S_T.cpp".
+.TP
+.B \-si
+Server inline skeleton file name ending. Default is "S_i.cpp".
+.TP
+.B \-st
+Server's template inline file name ending. Default is "S_T.i".
+.TP
+.B \-Gc
+Generate stubs and skeletons using compiled marshaling.
+.TP
+.B \-Gi
+Generate stubs and skeletons using interpretive marshaling (default for now).
+.TP
+.B \-Ge
+Generate code that uses C++ exceptions (unimplemented as yet).
+.TP
+.B \-Gt
+Generate optimized TypeCodes (unimplemented as yet).
+.TP
+.B \-Sa
+Suppress generation of the
+.I Any
+operators
+.TP
+.B \-St
+Suppress generation of the
+.I TypeCodes
+.SH BUGS
+(blank for now)
+.SH AUTHORS
+.IP
+Carlos O'Ryan <coryan@cs.wustl.edu>
+.IP
+Ossama Othman <ossama@debian.org>
+performed man page conversion from original HTML source
+.SH "SEE ALSO"
+.BR gperf (1),
+.BR TAO (1)