Fri Mar 23 23:29:21 UTC 2012 Johnny Willemsen <jwillemsen@remedy.nl>

        * TAO_IDL/be/be_visitor_component/executor_exh.cpp:
        * TAO_IDL/be/be_visitor_component/executor_private_exh.cpp:
        * TAO_IDL/be/be_visitor_component/facet_exh.cpp:
        * TAO_IDL/be/be_visitor_component_scope.cpp:
        * TAO_IDL/be/be_visitor_home/home_exh.cpp:
          Generate more documentation into the generated executor

6 files changed, 26 insertions, 7 deletions

diff --git a/TAO/ChangeLog b/TAO/ChangeLog
index 01c086cec8c..b2e27e5955b 100644
--- a/TAO/ChangeLog
+++ b/TAO/ChangeLog
@@ -1,3 +1,12 @@
+Fri Mar 23 23:29:21 UTC 2012  Johnny Willemsen  <jwillemsen@remedy.nl>
+
+        * TAO_IDL/be/be_visitor_component/executor_exh.cpp:
+        * TAO_IDL/be/be_visitor_component/executor_private_exh.cpp:
+        * TAO_IDL/be/be_visitor_component/facet_exh.cpp:
+        * TAO_IDL/be/be_visitor_component_scope.cpp:
+        * TAO_IDL/be/be_visitor_home/home_exh.cpp:
+          Generate more documentation into the generated executor
+
 Fri Mar 23 21:57:44 UTC 2012  Johnny Willemsen  <jwillemsen@remedy.nl>
 
         * TAO_IDL/be/be_visitor_component/executor_exh.cpp:
diff --git a/TAO/TAO_IDL/be/be_visitor_component/executor_exh.cpp b/TAO/TAO_IDL/be/be_visitor_component/executor_exh.cpp
index d2eef381442..2e996b33b20 100644
--- a/TAO/TAO_IDL/be/be_visitor_component/executor_exh.cpp
+++ b/TAO/TAO_IDL/be/be_visitor_component/executor_exh.cpp
@@ -72,7 +72,7 @@ be_visitor_executor_exh::visit_component (be_component *node)
       << lname << "_exec_i" << be_nl
       << comment_end_border_;
 
-  os_ << be_nl_2
+  os_ << be_nl
       << "class ";
 
   os_ << lname
@@ -168,7 +168,7 @@ be_visitor_executor_exh::visit_component (be_component *node)
 
   os_ << be_uidt << be_nl_2
       << "private:" << be_idt_nl
-      << "/// @copydoc " << sname << "::CCM_" << lname << "_Context" << be_nl
+      << "/// Member to store " << sname << "::CCM_" << lname << " context" << be_nl
       << global << sname << "::CCM_" << lname
       << "_Context_var ciao_context_;" << be_nl_2;
 
diff --git a/TAO/TAO_IDL/be/be_visitor_component/executor_private_exh.cpp b/TAO/TAO_IDL/be/be_visitor_component/executor_private_exh.cpp
index 4b6f0e33e80..115e44d51b4 100644
--- a/TAO/TAO_IDL/be/be_visitor_component/executor_private_exh.cpp
+++ b/TAO/TAO_IDL/be/be_visitor_component/executor_private_exh.cpp
@@ -58,6 +58,8 @@ be_visitor_executor_private_exh::visit_attribute (be_attribute *node)
 
   os_ << be_nl_2;
 
+  os_ << "/// @copydoc " << node->full_name () << be_nl;
+
   be_visitor_member_type_decl v (this->ctx_);
 
   if (node->field_type ()->accept (&v) == -1)
diff --git a/TAO/TAO_IDL/be/be_visitor_component/facet_exh.cpp b/TAO/TAO_IDL/be/be_visitor_component/facet_exh.cpp
index d0ba6a4fed3..08eeb404124 100644
--- a/TAO/TAO_IDL/be/be_visitor_component/facet_exh.cpp
+++ b/TAO/TAO_IDL/be/be_visitor_component/facet_exh.cpp
@@ -58,7 +58,7 @@ be_visitor_facet_exh::visit_provides (be_provides *node)
       << lname << "_exec_i" << be_nl
       << comment_end_border_;
 
-  os_ << be_nl_2
+  os_ << be_nl
       << "class "
       << lname << "_exec_i" << be_idt_nl
       << ": public virtual " << global << sname << "::CCM_"
diff --git a/TAO/TAO_IDL/be/be_visitor_component_scope.cpp b/TAO/TAO_IDL/be/be_visitor_component_scope.cpp
index b7ede5b3039..15c01eb028d 100644
--- a/TAO/TAO_IDL/be/be_visitor_component_scope.cpp
+++ b/TAO/TAO_IDL/be/be_visitor_component_scope.cpp
@@ -285,6 +285,7 @@ void
 be_visitor_component_scope::gen_exec_entrypoint_decl (void)
 {
   os_ << be_nl_2
+      << "/// Factory method for " << node_->full_name () << be_nl
       << "extern \"C\" " << export_macro_.c_str ()
       << " ::Components::EnterpriseComponent_ptr" << be_nl
       << "create_" << node_->flat_name ()
diff --git a/TAO/TAO_IDL/be/be_visitor_home/home_exh.cpp b/TAO/TAO_IDL/be/be_visitor_home/home_exh.cpp
index 8781fc60d70..e96c25743cd 100644
--- a/TAO/TAO_IDL/be/be_visitor_home/home_exh.cpp
+++ b/TAO/TAO_IDL/be/be_visitor_home/home_exh.cpp
@@ -79,6 +79,7 @@ int
 be_visitor_home_exh::visit_factory (be_factory *node)
 {
   os_ << be_nl_2
+      << "/// @copydoc " << node->full_name () << be_nl
       << "virtual ::Components::EnterpriseComponent_ptr" << be_nl
       << node->local_name ();
 
@@ -108,6 +109,10 @@ be_visitor_home_exh::gen_exec_class (void)
     node_->original_local_name ()->get_string ();
 
   os_ << be_nl
+      << "/**" << be_nl
+      << " * Home Executor Implementation Class: "
+      << lname << "_exec_i" << be_nl
+      << " */" << be_nl
       << "class " << export_macro_.c_str () << " " << lname
       << "_exec_i" << be_idt_nl
       << ": public virtual " << lname << "_Exec," << be_idt_nl
@@ -117,9 +122,11 @@ be_visitor_home_exh::gen_exec_class (void)
       << "public:" << be_idt;
 
   os_ << be_nl
+      << "/// Constructor" << be_nl
       << lname << "_exec_i (void);";
 
   os_ << be_nl_2
+      << "/// Destructor" << be_nl
       << "virtual ~" << lname << "_exec_i (void);";
 
   be_home *h = node_;
@@ -163,11 +170,10 @@ be_visitor_home_exh::gen_exec_class (void)
     }
 
   os_ << be_nl_2
-      << "// Implicit operations.";
+      << "/// Factory method";
 
-  os_ << be_nl_2
-      << "virtual ::Components::EnterpriseComponent_ptr" << be_nl
-      << "create (void);";
+  os_ << be_nl
+      << "virtual ::Components::EnterpriseComponent_ptr create (void);";
 
   os_ << be_uidt_nl
       << "};";
@@ -179,6 +185,7 @@ void
 be_visitor_home_exh::gen_entrypoint (void)
 {
   os_ << be_nl_2
+      << "/// Factory method for " << node_->full_name () << be_nl
       << "extern \"C\" " << export_macro_.c_str ()
       << " ::Components::HomeExecutorBase_ptr" << be_nl
       << "create_" << node_->flat_name ()