254得票13回答
Swift是否支持生成文档的功能?

许多编程语言支持文档注释,通过解析相同的代码允许生成器(如javadoc或doxygen)生成代码文档。 Swift是否具有类似的类型文档注释功能?

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

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

243得票9回答
如何为带参数的方法编写文档?

如何使用Python的文档字符串记录带参数的方法? PEP 257 给出了以下示例: def complex(real=0.0, imag=0.0): """Form a complex number. Keyword arguments: real -- the...

99得票6回答
如何使用Swift文档注释

我有几个关于Swift文档注释的问题: 是否有办法创建一个“相关声明”(Related declarations)部分,就像一些苹果官方文档中的那样?例如,当我使用 Option+Click 点击 tablewView(_:heightForRowAtIndexPath:) 方法时,它会在...

92得票5回答
如何使用Pydoc创建文档?

我正在尝试从我的模块创建一个文档。我在Windows 7上使用Python 3.2.3中的命令行使用pydoc:python "<path_to_pydoc_>\pydoc.py" -w myModule 这导致我的shell中填充了文本,每个文件在模块中占用一行,内容为:no P...

74得票3回答
Objective-C文档生成器:HeaderDoc vs. Doxygen vs. AppleDoc。

我需要为我的工作场所实现一个文档生成解决方案,并将其缩小到标题中提到的三个选项。我只能从初始阶段得出以下信息: HeaderDoc 优点:与苹果现有文档保持一致,兼容制作苹果 docsets HeaderDoc 缺点:难以修改行为,项目没有得到积极开发,许多人已经放弃使用它(这意味着其中必须...

67得票8回答
生成 Protobuf 文档?

有人知道一款好的工具来使用.proto源文件生成Google Protobuf文档吗?

65得票3回答
如何使用roxygen文档化数据集?

在roxygen过程中,是否可以将.R文件包含在数据目录中? 我已经将多个.R文件放入数据目录中。当它们通过data()被调用时,它们会读取原始数据文件并执行一些转换。

61得票6回答
记录TypeScript代码的工具和指南?

有没有针对TypeScript源代码生成文档的工具?还是应该使用像NaturalDocs这样的通用工具?块注释/为独立文档准备的注释,推荐使用哪种风格? 我应该使用什么:///<foo>bar</foo> MSVS kind of comments? 或者/** @j...

56得票4回答
自动生成所有Python包内容的文档

我正在尝试使用Sphinx自动生成我的代码库的基本文档。然而,我很难指示Sphinx递归地扫描我的文件。 我的Python代码库具有以下文件夹结构:<workspace> └── src └── mypackage ├── __init__.py ...