在進行反向工程期間,在某元素程式碼之前緊接出現的註解,會被視為是該元素的註解,而註解文字將會被帶入 IBM® Rational® Rhapsody® 作為該元素的說明。
您可以使用 <lang>_ReverseEngineering::ImplementationTrait::PreCommentSensibility 內容,來指定註解在某元素程式碼之前,仍可被視為是該元素之註解的行數上限。任何在元素之前超過所指定行數的註解,將會被視為是浮動註解。例如,值 1 表示註解必須出現在某元素程式碼的前一行,才能被視為是該元素的註解。預設值是 2。
如果 C 或 C++ 專案已經執行過反向工程,會將註解匯入作為相關 SourceArtifacts 中的文字元素,且以整個區塊方式讀取。(這些註解尚未變成已匯入某個元素的說明)。於是當程式碼產生或來回轉換時,會根據註解/文字元素的原始位置,將其放置在正確位置。
針對此特性依預設來設定下列內容:
- <lang>_ReverseEngineering::ImplementationTrait::RespectCodeLayout 內容設定為 Ordering。
- <lang>_CG::Configuration:CodeGeneratorTool 內容設定為 Advanced。
- <lang>_Roundtrip::General::RoundtripScheme 內容設定為 Respect。
如需程式碼保留及 SourceArtifacts 的相關資訊,請參閱對來源構件進行反向工程。
請注意下列資訊:
- 如果函數在 .h 檔案中有個註解,而在 .cpp 檔案中有另一個註解,則 .cpp 檔案中的註解會匯入作為浮動註解。
- 當任何執行過反向工程的檔案將註解作為其第一個元素,則會關閉任何檔案標頭註解。
對於任何檔案標底註解也是如此。
- 反向工程將檔案的第一個/最後一個註解匯入作為一般註解(如文字片段)。將這些內容設定為空字串值,反向工程會停用產生自動產生的標頭/標底。
- <lang>_CG::File::ImplementationHeader
- <lang>_CG::File::SpecificationHeader
- <lang>_CG::File::ImplementationFooter
- <lang>_CG::File::SpecificationFooter