.

3 files changed, 49 insertions, 36 deletions

diff --git a/TAO/examples/Callback_Quoter/Consumer.idl b/TAO/examples/Callback_Quoter/Consumer.idl
index 71712deb5eb..f37d1728078 100644
--- a/TAO/examples/Callback_Quoter/Consumer.idl
+++ b/TAO/examples/Callback_Quoter/Consumer.idl
@@ -6,30 +6,38 @@
 
 module Callback_Quoter
 {
-
   // = TITLE
   // The Consumer interface is implemented by the consumer-client.
   // The interface functions are called by the Supplier.
 
-  // Requested stock does not exist
-  exception Invalid_Stock {};
+  exception Invalid_Stock 
+  {
+    // = TITLE
+    //   Requested stock does not exist
+  };
 
   struct Info
   {
+    // = TITLE
+    // @@ Please fill in here.
+
     string stock_name;
     long value;
   };
 
-
   interface Consumer
     {
+      // = TITLE
+      // @@ Please fill in here.
+
       // supplier sends data to the consumer.
       void push (in Callback_Quoter::Info data);
+      // @@ Make sure to put the comments "underneath"
+      // the operation/method names...
 
       // Called by the chat server before it goes away.
       oneway void shutdown ();
     };
 };
 
-
-#endif // _CONSUMER_IDL
+#endif /* _CONSUMER_IDL */
diff --git a/TAO/examples/Callback_Quoter/Supplier.idl b/TAO/examples/Callback_Quoter/Supplier.idl
index ad51709b7f2..2fa3950e06b 100644
--- a/TAO/examples/Callback_Quoter/Supplier.idl
+++ b/TAO/examples/Callback_Quoter/Supplier.idl
@@ -8,30 +8,36 @@
 
 interface Supplier
 {
-   // Consumer handle doesnt exist.
-    exception Invalid_Handle {};
-
-   // Register a distributed callback handler that is invoked
-   // when the given stock reaches the desired threshold value.
-
-   void register_callback (in string stock_name,
-    		           in long threshold_value,
-			   in Callback_Quoter::Consumer consumer_handler)
-      raises (Callback_Quoter::Invalid_Stock);
-
-   // Remove the handler.
-
-   void unregister_callback (in Callback_Quoter::Consumer consumer_handler)
-      raises (Invalid_Handle);
-
-   // get market status.
-
-   void market_status (in string stock_name,
-	     	       in long stock_value)
-     raises (Callback_Quoter::Invalid_Stock);
-
-   oneway void shutdown ();
-   // shuts the server down.
+  // = TITLE
+  //   @@ Please fill in here.
+
+  exception Invalid_Handle 
+    {
+      // = TITLE
+      //   Consumer handle doesnt exist.
+    };
+
+  // @@ Make sure to put the comments AFTER the operation/method
+  // names.
+
+  // Register a distributed callback handler that is invoked
+  // when the given stock reaches the desired threshold value.
+  void register_callback (in string stock_name,
+                          in long threshold_value,
+                          in Callback_Quoter::Consumer consumer_handler)
+    raises (Callback_Quoter::Invalid_Stock);
+
+  // Remove the handler.
+  void unregister_callback (in Callback_Quoter::Consumer consumer_handler)
+    raises (Invalid_Handle);
+
+  // get market status.
+  void market_status (in string stock_name,
+                      in long stock_value)
+    raises (Callback_Quoter::Invalid_Stock);
+
+  oneway void shutdown ();
+  // shuts the server down.
 };
 
-#endif // _SUPPLIER_IDL
+#endif /* _SUPPLIER_IDL */
diff --git a/TAO/examples/Callback_Quoter/Supplier_i.h b/TAO/examples/Callback_Quoter/Supplier_i.h
index bb5a5743d09..1b546a521d7 100644
--- a/TAO/examples/Callback_Quoter/Supplier_i.h
+++ b/TAO/examples/Callback_Quoter/Supplier_i.h
@@ -21,10 +21,8 @@
 #define SUPPLIER_I_H
 
 #include "SupplierS.h"
-
 #include "ConsumerC.h"
 
-
 #include "tao/TAO.h"
 #include "ace/Containers.h"
 #include "ace/SString.h"
@@ -82,9 +80,10 @@ private:
     // Stores the stock threshold value.
   };
 
-  typedef ACE_Unbounded_Set<Consumer_Data> CONSUMERS;
-  typedef ACE_Hash_Map_Manager<ACE_CString, CONSUMERS *, ACE_Null_Mutex> CONSUMER_MAP;
-
+  typedef ACE_Unbounded_Set<Consumer_Data> 
+          CONSUMERS;
+  typedef ACE_Hash_Map_Manager<ACE_CString, CONSUMERS *, ACE_Null_Mutex> 
+          CONSUMER_MAP;
   CONSUMER_MAP consumer_map_;
 };