23得票1回答
通过Roxygen添加useDynLib

我正在使用roxygen2包将我的软件包转换为使用roxygen文档。 现在,我的软件包无法加载,我认为这是由于在NAMESPACE文件中缺少useDynLib(mypackage)调用导致的。 我该如何生成这个调用?

51得票5回答
记录 C++/CLI 库代码以供从 C# 使用 - 最佳工具和实践?

我正在从事一个项目,其中一个c++/cli库主要被一个c#应用程序使用。 有没有办法让c++/cli中的代码注释在Visual Studio中对c# IntelliSense可见? 假设没有,那么记录c++/cli代码以便更容易地从c#中使用(当然还包括在c++/cli中),最好的方法是什么?...

26得票5回答
我应该在类图中包含getter和setter吗?

我需要为我的JSF应用程序绘制一个类图,以备项目文档所需。因此,我有很多作为托管bean的类,每个类都有许多属性和许多getter和setter。 当我绘制类图时,是否应该将getter和setter包括在图中,还是可以简单地省略它们?

16得票1回答
直接从源代码生成JavaScript文档

我正在寻找一种工具,即使没有适当格式的注释块与这些函数或属性相关联(像Doxygen一样),也可以生成JavaScript函数和属性的文档。 这篇关于JSDoc和其他文档工具的比较的文章提到,JSDoc可以解析源代码以生成文档,即使没有注释块(就像我上面提到的Doxygen一样)。他们说所有...

28得票2回答
使用Doxygen记录命名空间

我在使用Doxygen时遇到了命名空间和模块识别的问题。我认为问题在于是否将\addtogroup放在命名空间内部还是外部。 示例1,放在命名空间外: /*! * \addtogroup Records * @{ */ //! Generic record interfaces...

21得票3回答
Grails:除Grails Doc外的替代方案?

我认为通过运行grails doc创建的文档并不完全令人满意。例如,在文档中,控制器中的操作显示为属性,但我希望有一个额外的部分来将操作与实际属性(如字符串等)分开。 是否有任何工具可以处理类似JavaDoc的注释并为Grails项目生成更好的输出?它应该要么是Grails感知的(即理解控制...

8得票1回答
有没有可能以一种既满足Github又满足Doxygen的方式编写Markdown链接?

我的项目当前的目录结构是<ProjectRooot>/wiki,并且在wiki目录下有三个Markdown文件。 其中一个文件链接到其他两个文件,我已经尝试了两种编写链接的方式。 第一种方式 [Kernel API & Core Negotiation Protoco...

25得票1回答
使用Sphinx-apidoc从C++代码生成文档

以前有一些帖子谈论过这个话题,声称Sphinx根本不支持这个。我有些怀疑,但它可能已经更新了,或者文档被很好地隐藏起来了,因为这里有一个链接表明了相反的情况: http://www.sphinx-doc.org/en/master/usage/restructuredtext/domains....

246得票3回答
JSDoc:返回对象结构

我该怎样告诉JSDoc一个返回对象的结构。我找到了@return {{field1: type, field2: type, ...}} description这种语法并尝试过: 如何在 JSDoc 中指定返回的对象结构?我看到了 @return {{field1: type, field...

19得票3回答
Django-Rest-Swagger无法正确呈现带只读字段的嵌套序列化器。

我正在使用django-rest-framework构建一个API,并开始使用django-rest-swagger进行文档编写。 我有一个嵌套的序列化器,其中包含一些只读字段,如下所示: # this is the nested serializer class Nested(serial...