我可以使用 GhostDoc 将文档添加到整个类或代码文件中吗?

发布于 2024-08-06 04:39:03 字数 59 浏览 6 评论 0原文

我喜欢 GhostDoc,但我希望能够为整个文件“记录此内容”,而不仅仅是一次只记录一个成员。这可能吗?

I love GhostDoc, but I want to be able to "Document This" for an entire file, and not just one member at a time. Is this possible?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(3

夏夜暖风 2024-08-13 04:39:03

当我最初回答这个问题时,这在 GhostDoc 或我的(类似)插件 Atomineer Pro Documentation)。

(这是 Atomineer 中的有意设计选择,大概也是 GhostDoc 中的设计选择,因为自动记录所有内容并继续前进通常是一个坏主意。这两个插件都为方法的文档提供了合理的起点,有时它们将提供足够好的文档,您不需要进行任何调整 - 但大多数时候您会想要调整生成的注释,如果您自动生成整个文档集,那么文档将非常糟糕,因为它们。只会描述代码元素名称已经说明的内容)。

但是,两个插件现在都提供此功能,这在以下情况下非常有用:(

  • 在 Atomineer 中)在 JavaDoc、Doxygen、Qt 和 XML 文档格式之间批量转换旧注释
  • (在 Atomineer 中) 在更改 AtomineerUtils 格式选项后更新文档注释的样式/布局
  • (在两个插件中) 将框架文档快速添加到类中

在所有这些中在这种情况下,强烈建议您查看生成的注释,但自动更新确实可以节省大量时间。

When I originally answered this question, this was not possible in GhostDoc, or in my (similar) addin, Atomineer Pro Documentation).

(This was an intentional design choice in Atomineer, and presumably also in GhostDoc, because it's a generally bad idea to document everything automatically and move on. Both these addins produce a reasonable starting point for documentation of a method, and sometimes they will provide good enough documentation that you don't need to make any adjustments - but most of the time you will want to tweak the resulting comment. If you auto-generate the entire documentation set, then the docs will be pretty poor, because they will do little more than describing what the code element names already state).

However, both addins now now provide this feature, which is very useful in the following situations:

  • (in Atomineer) To batch-convert legacy comments between JavaDoc, Doxygen, Qt and XML Documentation formats
  • (in Atomineer) To update the style/layout of documentation comments after changing the AtomineerUtils formatting options
  • (in both addins) To quickly add skeleton documentation to a class

In all these situations it is strongly recommended that you review the resulting comments, but automating the update does save a lot of time.

温柔女人霸气范 2024-08-13 04:39:03

不,无论如何,我仍然喜欢它。

No. I still love it also regardless.

飘过的浮云 2024-08-13 04:39:03

使用文档文件选项:

在此处输入图像描述

查看为文件中所有成员添加的注释:

在此处输入图像描述

Use document File Option:

enter image description here

see the comment added for all members within the file:

enter image description here

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文