4

我正在尝试为我的一个项目生成苹果文档。我正在使用以下命令生成文档...

headerdoc2html -o OutPutDirectory InputDirectory

我收到以下消息...

Processing /Users/Ankit/Documents/Projects/pos/trunk/TestProject/TestProject/Test.h
    Skipping. No HeaderDoc comments found.
No default encoding.  Guessing.  If date formats are wrong, try
specifying an appropriate value in the LANG environment variable.

任何帮助表示赞赏。

4

3 回答 3

4

我有同样的问题。我通过改变所有来修复它

/// Comments

和

/**
 * Comments
 */

评论到

/*!
 * Comments
 */

一切对我来说都很好。

于 2014-12-24T00:21:52.787 回答
3

LANG 环境变量未设置在 Xcode 可以到达的任何位置。可能是因为它没有在您的构建设置中设置。

运行下面的命令将打印所有环境变量，LANG不会在其中。 

xcodebuild -project Path/To/Your.xcodeproj -target "YourTarget" -showBuildSettings

环境变量在“环境变量”表下的方案中进行管理，但我没有运气在那里更改它们。我最终所做的（因为我的 headerdoc2html 调用是在我的文档目标的构建阶段中的构建脚本中）将此行添加到我的 bash 脚本的顶部：

export LANG=en_US.US-ASCII

在那之后消息就消失了。


我的总剧本，为了好奇。

export LANG=en_US.US-ASCII
/Applications/Xcode.app/Contents/Developer/usr/bin/headerdoc2html -o ~/Development/Path/To/My/Documentation ~/Development/Path/To/My/Project/Headers
/Applications/Xcode.app/Contents/Developer/usr/bin/gatherheaderdoc ~/Development/Path/To/My/Documentation

（Xcode 版本 4.6.3）

于 2013-09-06T12:06:34.157 回答
0

您还可以使用 -j 标志来启用 javadoc 语法，而不必更改任何文档代码。

headerdoc2html -j -o OutputDirectory InputDirectory
于 2015-07-09T14:41:53.393 回答