如何在NaturalDocs中禁用“摘要”部分的生成？

Question

我尝试使用Natural Docs生成工具来处理一些自动代码文档，但我发现了＆＃34;摘要＆＃34;在我工作的环境中生成的部分不恰当和误导。特别是，使用来自各种＆＃34;关于＆＃34;的第一句话的行为。类别不适合我的需要。

我很乐意完全压制该部分，但不知道这是否可行。有谁知道这是否可以做到？

Answer 1

简短的回答是：没有办法禁用＆＃34;摘要＆＃34;部分通过设置或选项。

答案很长：

我想达到同样的目标。由于我没有找到它的文档，我看一下NaturalDocs源代码。

HTMLBase.pm中有一行（搜索＆＃34; BuildSummary＆＃34;）会触发摘要的生成。应该很容易将其删除或添加一个选项以禁止某些文件。

改变或扩展NaturalDocs的简单性是我完全使用它的理由。