📝 docs(tsl): document {Unit.}Type source annotation
This commit is contained in:
parent
3dceaf71fd
commit
41fc43b79e
|
|
@ -179,6 +179,19 @@ end;
|
||||||
|
|
||||||
- 签名尽量自解释:对外 API 的参数/返回值建议显式写类型注解;并用注释写清契约(可复用 3.2 的模板)。
|
- 签名尽量自解释:对外 API 的参数/返回值建议显式写类型注解;并用注释写清契约(可复用 3.2 的模板)。
|
||||||
- 类型注解不支持 `xxx.xxx` 形式;使用单一类型名。
|
- 类型注解不支持 `xxx.xxx` 形式;使用单一类型名。
|
||||||
|
- 若需标注类型来源,允许在类型名前用块注释写 `{Unit.}` 前缀,例如 `style_: {DocxML.}Style;`。该前缀仅为注释,不参与语义或类型检查,工具可能忽略;类型名仍是 `Style`(建议紧贴类型名书写)。
|
||||||
|
- 示例(`{Unit.}` 前缀仅用于阅读,不改变类型名):
|
||||||
|
|
||||||
|
```tsl
|
||||||
|
type DocxContext = class
|
||||||
|
public
|
||||||
|
property Style read style_ write style_;
|
||||||
|
private
|
||||||
|
style_: {DocxML.}Style;
|
||||||
|
end;
|
||||||
|
|
||||||
|
function RenderParagraph(para_: {DocxML.}Paragraph): void;
|
||||||
|
```
|
||||||
- 无返回值函数显式标注返回类型为 `void`;`create`/`destroy` 作为构造/析构函数不写返回类型。
|
- 无返回值函数显式标注返回类型为 `void`;`create`/`destroy` 作为构造/析构函数不写返回类型。
|
||||||
|
|
||||||
```tsl
|
```tsl
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue