代码之家  ›  专栏  ›  技术社区  ›  Winston Chen

如何在目标C中进行文档记录?[关闭]

  •  6
  • Winston Chen  · 技术社区  · 14 年前

    有人能在目标C中分享文档的实现方法吗?有没有像Java那样的标准方法?

    4 回复  |  直到 6 年前
        1
  •  7
  •   albert    6 年前

    我不知道你在用什么IDE,但是 doxygen 让您从Objtovi-C中的注释生成文档(以及C、C++、Java和其他一些)。

    如果您使用的是Xcode(假设,因为您使用的是Objective-C),那么似乎存在某种程度的集成(我没有测试过,只是在Google上找到的): http://developer.apple.com/tools/creatingdocsetswithdoxygen.html

        2
  •  8
  •   Diego Palomar    11 年前

    好消息!:d在等待了很长时间之后,苹果终于为我们的项目引入了一个解析器注释。根据 new features 在XCODE 5中:

    来自框架API参考文档和 您自己的源代码中的结构化注释将显示在 帮助面板和代码内完成弹出视图。强生公司 支持结构化注释格式。

    Clang 3.2 发行说明:

    Clang可以解析注释并检测语法和语义错误 在评论中。默认情况下,这些警告处于关闭状态。通过-W文件 用于启用有关文档注释的警告的标志。

    如果您想看到这个新特性的一个例子,我建议您看一下下面的文章: Documentation in Xcode 5

        3
  •  3
  •   Eric    10 年前

    正如@diegopalomar建议的那样, standard way将使用Apple自己的工具在源代码中嵌入结构化注释。

    它附带Xcode,所以不需要安装。它附带了一个命令行脚本,可以生成文档的HTML输出。

    总部文件:

    举个例子:

    <预> <代码> /*! *接受一个数字并加上4。 * *@param mynumber一个nsinteger类型的数字。 * *@返回添加了4的数字。 */ -(nsinteger)addfour:(nsinteger)我的号码{ 返回mynumber+4; } < /代码>

    大优点:当你点击你的文档方法时,你的文档会出现在气球里:

    HeaderDoc也是开源的: http://www.open source.apple.com/source/headerDoc/

    德尔多克苹果自己的工具,用于在源代码中嵌入结构化注释。

    它附带Xcode,所以不需要安装。它附带了一个命令行脚本,可以生成文档的HTML输出。

    总部文件:

    下面是一个例子:

    /*!
     *  Takes in a number and adds 4 to it.
     *
     *  @param myNumber a number of type NSInteger.
     *
     *  @return The number with 4 added to it.
     */
    - (NSInteger)addFour:(NSInteger)myNumber {
        return myNumber + 4;
    }
    

    大优点:当你点击你的记录方法时,你的文档会出现在气球里:

    enter image description here

    HeaderDoc也是开源的: http://www.opensource.apple.com/source/headerdoc/

        4
  •  2
  •   albert    6 年前

    我想你在找 Doxygen .