在反向工程期间,将把正好位于元素代码之前的注解视为该元素的注解,并且,注解文本将作为该元素的描述导入到 IBM® Rational® Rhapsody® 中。
您可以使用 <lang>_ReverseEngineering::ImplementationTrait::PreCommentSensibility 属性指定元素代码前的注解的最大行数,只有不超出此行数的注解才会被视为该元素的注解。位于元素之前并超出指定行数的注解将被视为浮动注解。例如,值 1 表示注解必须在元素代码前的那一行中出现才会被视为该元素的注解。缺省值是 2。
如果 C 或 C++ 项目已进行了反向工程,那么注解将作为相关 SourceArtifact 中的文本元素导入,并读入整个块。(不会成为部分导入元素的描述的注解。)然后当生成或双向传递代码时,注解/文本元素将根据其原始位置置于正确的位置中。
以下是缺省为此功能部件设置的属性:
- <lang>_ReverseEngineering::ImplementationTrait::RespectCodeLayout 属性设置为 Ordering。
- <lang>_CG::Configuration:CodeGeneratorTool 属性设置为 Advanced。
- <lang>_Roundtrip::General::RoundtripScheme 属性设置为 Respect。
有关代码保留和 SourceArtifact 的信息,请参阅反向工程 SourceArtifact。
请注意以下信息:
- 如果函数的一个注解在 .h 文件中,而另一个注解在 .cpp 文件中,那么 .cpp 文件中的注解将作为浮动注解导入。
- 如果任意反向工程的文件具有注解作为其第一个元素,那么将关闭任意文件头注解。
对于任意文件页脚注解而言,情况亦如此。
- 反向工程将把文件的第一个/最后一个注解作为常规注解(文本片段)导入。反向工程可通过将这些属性设置为空字符串值来禁用生成自动生成的头/页脚。
- <lang>_CG::File::ImplementationHeader
- <lang>_CG::File::SpecificationHeader
- <lang>_CG::File::ImplementationFooter
- <lang>_CG::File::SpecificationFooter