Delphi单元的XMLDoc名称

Question

是否可以使用 <summary> XMLDoc 标签在 Delphi 中记录单元目的？如何实现？

我尝试在 unit 前面都放置了 <summary>：

/// <summary> Unit purpose: test </summary>
unit Test;

请提供需要翻译的完整内容。

unit Test;
/// <summary> Unit purpose: test </summary>

两种方法都没有产生任何结果。通过将鼠标悬停在其他单元格的单元名称上进行检查。与此同时，悬停也适用于同一单元格中的其他标识符。

- Serhii Kheilyk

Answer 1

根据Embarcadero的文档： XML文档注释 引用块： 你可以在XML DOC注释中使用以下元素： <summary> 目标函数或类的摘要

因此，似乎不能将<summary>应用于整个单元。

- Remy Lebeau

---

实际上，它也适用于属性和不是类的类型，例如记录、枚举、简单类型（如 type MyInt = type Integer）等，因此文档中的这个备注并不完全准确。但是，如果Serhii尝试将XML注释放在单位之前，但它没有起作用，那么很可能意味着这个问题的答案是“否”（至少在OP的Delphi版本中是如此）。所以，这个问题实际上更像是一个针对Embarcadero的Delphi功能请求！ :) - Andreas Rejbrand