PM39603: UML-to-C++: comments in front on namespace are lost

Rational Software Architect Interim Fix 1 for 8.0.4.2
Rational Software Architect for WebSphere Software Interim Fix 1 for 8.0.4.2

APAR status

• Closed as program error.

Error description

• Environment:
  
  Rational Software Architect 8.0.2
  Windows, Linux
  
  Problem description:
  
  C++-to-UML followed by UML-to-C++ in Reconciled mode with trace
  relationships
  causes the folowing elements to be lost in the code:
  
  Comments placed in front on namespace declarations in .h files
  
  Steps to reproduce:
  
  If you reverse engineer this code:
  
  /*
  * B.h
  *
  *  Created on: May 17, 2011
  *      Author: 098561
  */
  
  ///some comment
  
  #ifndef B_H_
  #define B_H_
  
  
  
  
  //My namespace text comment
  namespace  MyNamespace
  {
  
  
      class B
      {
  
  
  
          public:
  
              B();
  
  
              virtual ~B();
  
  
  
  
      };  //end class B
  
  
  }//end namespace MyNamespace
  
  
  #endif //MyComment
  
  And then forward engineer (use Trace Relationships):
  
  /*
  * B.h
  *
  *  Created on: May 17, 2011
  *      Author: 098561
  */
  
  ///some comment
  
  #ifndef B_H_
  #define B_H_
  
  
  //Begin section for file B.h
  //TODO: Add definitions that you want preserved
  //End section for file B.h
  
  
  
  namespace MyNamespace
  {
  
  
  
      //This is my class comment
  
  //@uml.annotationsderived_abstraction='platform:/resource/TestCP
  P/CPPBlankModel1.emx#_ksrzAYCDEeCxxtHWf5VymA'
      //@generated 'UML to C++
  (com.ibm.xtools.transform.uml2.cpp.CPPTransformation)'
      class B
      {
  
  
  
          public:
  
  
  //@uml.annotationsderived_abstraction='platform:/resource/TestCP
  P/CPPBlankModel1.emx#_ks_VAICDEeCxxtHWf5VymA'
              //@generated 'UML to C++
  (com.ibm.xtools.transform.uml2.cpp.CPPTransformation)'
              B();
  
  
  
  
  //@uml.annotationsderived_abstraction='platform:/resource/TestCP
  P/CPPBlankModel1.emx#_ks_VAYCDEeCxxtHWf5VymA'
              //@generated 'UML to C++
  (com.ibm.xtools.transform.uml2.cpp.CPPTransformation)'
              virtual ~B();
  
  
  
      };  //end class B
  
  
  }//end namespace MyNamespace
  
  
  #endif //MyComment
  
  
  
  The  comment in front of the namespace gets added to the model
  in the documentation section of the
  Package corresponding to the namespace, but it gets removed from
  the code
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  UML-to-C++ Transformation does not retain comments in front
  of the namespaces.
  

Problem conclusion

• UML-to-C++ Transformation retains the comments in front of
  the namespaces.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  RSA-SE UNIX

• Fixed component ID

  5724V8801

Applicable component levels

• R750 PSN

     UP