16 files changed, 229 insertions, 236 deletions
diff --git a/TAO/orbsvcs/examples/CosEC/Factory/CosEventChannelFactory.idl b/TAO/orbsvcs/examples/CosEC/Factory/CosEventChannelFactory.idl
index 9e68302b882..63ddf14c056 100644
--- a/TAO/orbsvcs/examples/CosEC/Factory/CosEventChannelFactory.idl
+++ b/TAO/orbsvcs/examples/CosEC/Factory/CosEventChannelFactory.idl
@@ -1,14 +1,14 @@
-// $Id$
 
-// ============================================================================
-//
-// = FILENAME
-//    CosEventChannelFactory.idl
-//
-// = AUTHOR
-//    Pradeep Gore <pradeep@cs.wustl.edu>
-//
-// ============================================================================
+//=============================================================================
+/**
+ *  @file    CosEventChannelFactory.idl
+ *
+ *  $Id$
+ *
+ *  @author Pradeep Gore <pradeep@cs.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef TAO_COSEVENTCHANNELFACTORY_IDL
 #define TAO_COSEVENTCHANNELFACTORY_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosConcurrencyControl.idl b/TAO/orbsvcs/orbsvcs/CosConcurrencyControl.idl
index 11743458188..6f586fc8c36 100644
--- a/TAO/orbsvcs/orbsvcs/CosConcurrencyControl.idl
+++ b/TAO/orbsvcs/orbsvcs/CosConcurrencyControl.idl
@@ -1,24 +1,21 @@
 /* -*- C++ -*- */
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    cos
-//
-// = FILENAME
-//    CosTransaction.idl
-//
-// = DESCRIPTION
-//    Described in CORBAservices: Common Object Services
-//    Specification, chapter 7 The concurrency service description can
-//    be downloaded from
-//    ftp://www.omg.org/pub/docs/formal/97-11-02.idl
-//
-// = AUTHOR
-//    Torben Worm <tworm@cs.wustl.edu>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    CosTransaction.idl
+ *
+ *  $Id$
+ *
+ *  Described in CORBAservices: Common Object Services
+ *  Specification, chapter 7 The concurrency service description can
+ *  be downloaded from
+ *  ftp://www.omg.org/pub/docs/formal/97-11-02.idl
+ *
+ *
+ *  @author Torben Worm <tworm@cs.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef TAO_CONCURRENCY_IDL
 #define TAO_CONCURRENCY_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosLifeCycle.idl b/TAO/orbsvcs/orbsvcs/CosLifeCycle.idl
index d1ed6a3bf82..f6cf190313d 100644
--- a/TAO/orbsvcs/orbsvcs/CosLifeCycle.idl
+++ b/TAO/orbsvcs/orbsvcs/CosLifeCycle.idl
@@ -1,26 +1,25 @@
 /* -*- C++ -*- */
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    cos
-//
-// = FILENAME
-//    CosLifeCycle.idl
-//
-// = DESCRIPTION
-//    Described in CORBAservices: Common Object Services Specification,
-//    chapter 6.
-//    The life cycle service description can be downloaded from:
-//      ftp://www.omg.org/pub/docs/formal/97-12-13.pdf
-//    The original IDL file can be downloaded from:
-//      ftp://www.omg.org/pub/docs/formal/97-11-02.idl
-//
-// = AUTHOR
-//    OMG, Torben Worm <tworm@cs.wustl.edu>, and Michael Kircher <mk1@cec.wustl.edu>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    CosLifeCycle.idl
+ *
+ *  $Id$
+ *
+ *  Described in CORBAservices: Common Object Services Specification,
+ *  chapter 6.
+ *  The life cycle service description can be downloaded from:
+ *    ftp://www.omg.org/pub/docs/formal/97-12-13.pdf
+ *  The original IDL file can be downloaded from:
+ *    ftp://www.omg.org/pub/docs/formal/97-11-02.idl
+ *
+ *
+ *  @author OMG
+ *  @author Torben Worm <tworm@cs.wustl.edu>
+ *  @author and Michael Kircher <mk1@cec.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef TAO_LIFECYCLE_IDL
 #define TAO_LIFECYCLE_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosNaming.idl b/TAO/orbsvcs/orbsvcs/CosNaming.idl
index 476f582c411..593762c22bf 100644
--- a/TAO/orbsvcs/orbsvcs/CosNaming.idl
+++ b/TAO/orbsvcs/orbsvcs/CosNaming.idl
@@ -1,18 +1,15 @@
 /* -*- C++ -*- */
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    cos
-//
-// = FILENAME
-//    CosNaming.idl
-//
-// = AUTHOR
-//    Marina Spivak <marina@cs.wustl.edu>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    CosNaming.idl
+ *
+ *  $Id$
+ *
+ *  @author Marina Spivak <marina@cs.wustl.edu>
+ */
+//=============================================================================
+
 
 #ifndef TAO_NAMING_IDL
 #define TAO_NAMING_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosTrading.idl b/TAO/orbsvcs/orbsvcs/CosTrading.idl
index e922b1db251..c94b745db86 100644
--- a/TAO/orbsvcs/orbsvcs/CosTrading.idl
+++ b/TAO/orbsvcs/orbsvcs/CosTrading.idl
@@ -1,17 +1,19 @@
 /* -*- C++ -*- */
 
-// ========================================================================
-// $Id$
-//
-// = FILENAME
-//   CosTrading.idl
-//
-// = DESCRIPTION
-//   Trader  Service v1.0 described in CORBAservices: Common Object
-//   Services Specification, chapter 16 OMG IDL for Trading Function
-//   Module, p 16-74
-//
-// ========================================================================
+//=============================================================================
+/**
+ *  @file   CosTrading.idl
+ *
+ *  $Id$
+ *
+ * Trader  Service v1.0 described in CORBAservices: Common Object
+ * Services Specification, chapter 16 OMG IDL for Trading Function
+ * Module, p 16-74
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef TAO_TRADING_IDL
 #define TAO_TRADING_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosTradingDynamic.idl b/TAO/orbsvcs/orbsvcs/CosTradingDynamic.idl
index 75534059f6d..8db8df9343e 100644
--- a/TAO/orbsvcs/orbsvcs/CosTradingDynamic.idl
+++ b/TAO/orbsvcs/orbsvcs/CosTradingDynamic.idl
@@ -1,17 +1,19 @@
 /* -*- C++ -*- */
 
-// ========================================================================
-// $Id$
-//
-// = FILENAME
-//   CosTradingDynamic.idl
-//
-// = DESCRIPTION
-//   Trader  Service v1.0 described in CORBAservices: Common Object
-//   Services Specification, chapter 16 OMG IDL for Trading Function
-//   Module, p 16-74
-//
-// ========================================================================
+//=============================================================================
+/**
+ *  @file   CosTradingDynamic.idl
+ *
+ *  $Id$
+ *
+ * Trader  Service v1.0 described in CORBAservices: Common Object
+ * Services Specification, chapter 16 OMG IDL for Trading Function
+ * Module, p 16-74
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef TAO_TRADING_DYNAMIC_IDL
 #define TAO_TRADING_DYNAMIC_IDL
diff --git a/TAO/orbsvcs/orbsvcs/CosTradingRepos.idl b/TAO/orbsvcs/orbsvcs/CosTradingRepos.idl
index 0edde8f9a89..9bc311d3754 100644
--- a/TAO/orbsvcs/orbsvcs/CosTradingRepos.idl
+++ b/TAO/orbsvcs/orbsvcs/CosTradingRepos.idl
@@ -1,17 +1,19 @@
 /* -*- C++ -*- */
 
-// ========================================================================
-// $Id$
-//
-// = FILENAME
-//   CosTradingRepos.idl
-//
-// = DESCRIPTION
-//   Trader  Service v1.0 described in CORBAservices: Common Object
-//   Services Specification, chapter 16 OMG IDL for Trading Function
-//   Module, p 16-74
-//
-// ========================================================================
+//=============================================================================
+/**
+ *  @file   CosTradingRepos.idl
+ *
+ *  $Id$
+ *
+ * Trader  Service v1.0 described in CORBAservices: Common Object
+ * Services Specification, chapter 16 OMG IDL for Trading Function
+ * Module, p 16-74
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef TAO_TRADING_REPOS_IDL
 #define TAO_TRADING_REPOS_IDL
diff --git a/TAO/orbsvcs/orbsvcs/DsEventLogAdmin.idl b/TAO/orbsvcs/orbsvcs/DsEventLogAdmin.idl
index 57c5b44cb01..a43202eb871 100644
--- a/TAO/orbsvcs/orbsvcs/DsEventLogAdmin.idl
+++ b/TAO/orbsvcs/orbsvcs/DsEventLogAdmin.idl
@@ -1,18 +1,18 @@
-// $Id$
-
-// ============================================================================
-//
-// = FILENAME
-//    DsEventLogAdmin.idl
-//
-// = DESCRIPTION
-//    This module defines the EventLog and
-//    EventLogFactory interfaces.
-//
-// = AUTHOR
-//    D A Hanvey (d.hanvey@qub.ac.uk)
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    DsEventLogAdmin.idl
+ *
+ *  $Id$
+ *
+ *  This module defines the EventLog and
+ *  EventLogFactory interfaces.
+ *
+ *
+ *  @author D A Hanvey (d.hanvey@qub.ac.uk)
+ */
+//=============================================================================
+
 
 #ifndef DS_EVENT_LOG_ADMIN_IDL
 #define DS_EVENT_LOG_ADMIN_IDL
diff --git a/TAO/orbsvcs/orbsvcs/DsLogAdmin.idl b/TAO/orbsvcs/orbsvcs/DsLogAdmin.idl
index b127f0cb222..abcb86a0475 100644
--- a/TAO/orbsvcs/orbsvcs/DsLogAdmin.idl
+++ b/TAO/orbsvcs/orbsvcs/DsLogAdmin.idl
@@ -1,15 +1,17 @@
-// $Id$
-
-// ============================================================================
-//
-// = FILENAME
-//    DsLogAdmin.idl
-//
-// = DESCRIPTION
-//    This module defines the Log, Iterator, LogMgr and LogFactory
-//    interfaces for the OMG's Telecom Event Log Service
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    DsLogAdmin.idl
+ *
+ *  $Id$
+ *
+ *  This module defines the Log, Iterator, LogMgr and LogFactory
+ *  interfaces for the OMG's Telecom Event Log Service
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef DS_LOG_ADMIN_IDL
 #define DS_LOG_ADMIN_IDL
diff --git a/TAO/orbsvcs/orbsvcs/DsLogNotification.idl b/TAO/orbsvcs/orbsvcs/DsLogNotification.idl
index a01f38763e8..6b8f5ad4b61 100644
--- a/TAO/orbsvcs/orbsvcs/DsLogNotification.idl
+++ b/TAO/orbsvcs/orbsvcs/DsLogNotification.idl
@@ -1,15 +1,17 @@
-// $Id$
-
-// ============================================================================
-//
-// = FILENAME
-//    DsLogNotification.idl
-//
-// = DESCRIPTION
-//    This module defines the Log Generated Events module
-//    for the OMG's Telecom Event Log Service
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    DsLogNotification.idl
+ *
+ *  $Id$
+ *
+ *  This module defines the Log Generated Events module
+ *  for the OMG's Telecom Event Log Service
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef DS_LOG_NOTIFICATION_IDL
 #define DS_LOG_NOTIFICATION_IDL
diff --git a/TAO/orbsvcs/orbsvcs/DsNotifyLogAdmin.idl b/TAO/orbsvcs/orbsvcs/DsNotifyLogAdmin.idl
index ea4a9f2bf1e..7af25606e86 100644
--- a/TAO/orbsvcs/orbsvcs/DsNotifyLogAdmin.idl
+++ b/TAO/orbsvcs/orbsvcs/DsNotifyLogAdmin.idl
@@ -1,18 +1,18 @@
-// $Id$
 
-// ============================================================================
-//
-// = FILENAME
-//    DsNotifyLogAdmin.idl
-//
-// = DESCRIPTION
-//    This module defines the NotifyLog and
-//    NotifyLogFactory interfaces.
-//
-// = AUTHOR
-//    David Hanvey (d.hanvey@qub.ac.uk)
-//
-// ============================================================================
+//=============================================================================
+/**
+ *  @file    DsNotifyLogAdmin.idl
+ *
+ *  $Id$
+ *
+ *  This module defines the NotifyLog and
+ *  NotifyLogFactory interfaces.
+ *
+ *
+ *  @author David Hanvey (d.hanvey@qub.ac.uk)
+ */
+//=============================================================================
+
 
 #ifndef DS_NOTIFY_LOG_ADMIN_IDL
 #define DS_NOTIFY_LOG_ADMIN_IDL
diff --git a/TAO/orbsvcs/orbsvcs/LifeCycleService.idl b/TAO/orbsvcs/orbsvcs/LifeCycleService.idl
index 8322d49137e..a0877328af3 100644
--- a/TAO/orbsvcs/orbsvcs/LifeCycleService.idl
+++ b/TAO/orbsvcs/orbsvcs/LifeCycleService.idl
@@ -1,18 +1,18 @@
-// $Id$
 
-// ============================================================================
-//
-// = FILENAME
-//    LifeCycleService.idl
-//
-// = DESCRIPTION
-//    A generic creation service named lifecycle service using
-//    the GenericFactory interface of the LifeCycle Service specification.
-//
-// = AUTHOR
-//    Michael Kircher (mk1@cs.wustl.edu)
-//
-// ============================================================================
+//=============================================================================
+/**
+ *  @file    LifeCycleService.idl
+ *
+ *  $Id$
+ *
+ *  A generic creation service named lifecycle service using
+ *  the GenericFactory interface of the LifeCycle Service specification.
+ *
+ *
+ *  @author Michael Kircher (mk1@cs.wustl.edu)
+ */
+//=============================================================================
+
 
 #ifndef TAO_LIFECYCLESERVICE_IDL
 #define TAO_LIFECYCLESERVICE_IDL
diff --git a/TAO/orbsvcs/orbsvcs/RTEventLogAdmin.idl b/TAO/orbsvcs/orbsvcs/RTEventLogAdmin.idl
index 691a8e2199f..75b44da7eee 100644
--- a/TAO/orbsvcs/orbsvcs/RTEventLogAdmin.idl
+++ b/TAO/orbsvcs/orbsvcs/RTEventLogAdmin.idl
@@ -1,18 +1,18 @@
-// $Id$
-
-// ============================================================================
-//
-// = FILENAME
-//    RTEventLogAdmin.idl
-//
-// = DESCRIPTION
-//    This module defines the EventLog and
-//    EventLogFactory interfaces.
-//
-// = AUTHOR
-//    D A Hanvey (d.hanvey@qub.ac.uk)
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    RTEventLogAdmin.idl
+ *
+ *  $Id$
+ *
+ *  This module defines the EventLog and
+ *  EventLogFactory interfaces.
+ *
+ *
+ *  @author D A Hanvey (d.hanvey@qub.ac.uk)
+ */
+//=============================================================================
+
 
 #ifndef RTEVENT_LOG_ADMIN_IDL
 #define RTEVENT_LOG_ADMIN_IDL
diff --git a/TAO/orbsvcs/orbsvcs/miop.idl b/TAO/orbsvcs/orbsvcs/miop.idl
index 8aabf8bc7b3..427adc0c562 100644
--- a/TAO/orbsvcs/orbsvcs/miop.idl
+++ b/TAO/orbsvcs/orbsvcs/miop.idl
@@ -1,20 +1,17 @@
-//
-// $Id$
-//
-// ================================================================
-//
-// = LIBRARY
-//   TAO_PortableGroup
-//
-// = FILENAME
-//   miop.pidl
-//
-// = DESCRIPTION
-//
-//   This file contains MIOP packet and profile information from
-//   the MIOP specification.
-//
-// ================================================================
+//=============================================================================
+/**
+ *  @file   miop.pidl
+ *
+ *  $Id$
+ *
+ *
+ * This file contains MIOP packet and profile information from
+ * the MIOP specification.
+ *
+ *
+ */
+//=============================================================================
+
 
 #ifndef MIOP_IDL
 #define MIOP_IDL
diff --git a/TAO/orbsvcs/tests/HTIOP/AMI/ami_test.idl b/TAO/orbsvcs/tests/HTIOP/AMI/ami_test.idl
index a305f82959f..c4d33f656f8 100644
--- a/TAO/orbsvcs/tests/HTIOP/AMI/ami_test.idl
+++ b/TAO/orbsvcs/tests/HTIOP/AMI/ami_test.idl
@@ -1,21 +1,18 @@
-// $Id$
-
-// ============================================================================
-//
-// = LIBRARY
-//    TAO/tests/AMI
-//
-// = FILENAME
-//    ami_test.idl
-//
-// = DESCRIPTION
-//    IDL description of the AMI Test interface
-//
-// = AUTHOR
-//    Alexander Babu Arulanthu <alex@cs.wustl.edu>,
-//    Michael Kircher <Michael.Kircher@mchp.siemens.de>
-//
-// ============================================================================
+
+//=============================================================================
+/**
+ *  @file    ami_test.idl
+ *
+ *  $Id$
+ *
+ *  IDL description of the AMI Test interface
+ *
+ *
+ *  @author Alexander Babu Arulanthu <alex@cs.wustl.edu>
+ *  @author Michael Kircher <Michael.Kircher@mchp.siemens.de>
+ */
+//=============================================================================
+
 
 
 module A
diff --git a/TAO/orbsvcs/tests/Interoperable_Naming/Web_Server.idl b/TAO/orbsvcs/tests/Interoperable_Naming/Web_Server.idl
index 97bda28066e..dc209bd7343 100644
--- a/TAO/orbsvcs/tests/Interoperable_Naming/Web_Server.idl
+++ b/TAO/orbsvcs/tests/Interoperable_Naming/Web_Server.idl
@@ -1,21 +1,17 @@
-// $Id$
 
-// ============================================================================
-//
-// = LIBRARY
-//    TAO/orbsvcs/tests/Interoperable_Naming/
-//
-// = FILENAME
-//    Web_Server.idl
-//
-// = DESCRIPTION
-//     IDL schema definition for Web server interface.
-//
-// = AUTHORS
-//     Priyanka Gontla <pgontla@ece.uci.edu>
-//
-//
-// ============================================================================
+//=============================================================================
+/**
+ *  @file    Web_Server.idl
+ *
+ *  $Id$
+ *
+ *   IDL schema definition for Web server interface.
+ *
+ *
+ *  @author  Priyanka Gontla <pgontla@ece.uci.edu>
+ */
+//=============================================================================
+
 
 module Web_Server
 {