Modelmaker 是一个非常好用的建模工具, 9.0 之后还可以与 VS 环境结合生成代码.
但默认设置是生成代码文件时不输出注释文本的, 连原有的函数注释也会被抹去。
本文将介绍怎样在 Modelmaker 7.0 中输出注释,以 Delphi 为例。
我的习惯是在:interface 位置使用单行注释, 在implementation位置的函数声明前用
块注释(多行注释),在函数体内单行注释和块注释并用。下面设置就是按这个习惯做
的。
1. 修改注释标志
[Source Doc Import] ->
1.1 Documentation Import Signature (注释输入标志)
{{ => { (多行注释标志改为单个 {)
1.2 Initial number of lines to ignore
1.3 Terminating number of lines to ignore
1.4 One liner Signature (单行注释标志)
{1 => // (单行注释标志改为 //)
V. Pre doc scheme (文档在前)
2. 多行文档保存在 implementation 中,单行文档保存在 interface 中的设置:
[Source Doc Generation] ->
2.1.1 设置多行注释的位置
In source Documentation generation (多行注释)
V. Module(Unit)
V. Event type definitons
X. Class interface (一般情况下 Interface 位置我都只用单行注释: //)
V. Class implementation
2.1.2
Class interface members ( Interface 位置不用多行注释: {})
X. Fields
X. Methods
X. Properties
X. Method resolution clauses
2.1.3
Member visibility filter (过滤)
Designer(+private)
2.1.4
Methods Implementation
X. None
V. Before declaration (在函数声明之前)
X. After declaration
V. Abstract Methods
2.2.1 设置单行注释的位置
In source One Liner generation (单行注释)
V. Module(Unit)
V. Event type definitons
V. Class interface (一般情况下 Interface 位置我都只用单行注释: //)
V. Class implementation
2.2.2
Class interface members ( Interface 位置用单行注释: //)
V. Fields
V. Methods
V. Properties
V. Method resolution clauses
2.1.3
Member visibility filter (过滤)
Designer(+private)
2.1.4
Methods Implementation
V. None (Implementation,不用单行注释,否则会在函数声明行的前面出现单行和多行各一份注释)
X. Before declaration
X. After declaration
X. Abstract Methods
3 General
V. Method implementation end docmentation (函数结束处加上函数名)