CMake 命令行选项文档答案

【问题标题】：CMake command line option documentationCMake 命令行选项文档
【发布时间】：2011-02-13 13:34:39
【问题描述】：

我正在学习 CMake，正在阅读“Mastering CMake”一书和其他在线可用的资料。我想知道是否有一些命令行选项的详细文档，例如生成文件使用的 -H 和 -B 。或者“-E echo”有额外的着色选项等。我还没有找到一些文档。

更新：现在我看到了 CMake 版本 3.14.4：

$ cmake --help
  ...
  cmake [options] -S <path-to-source> -B <path-to-build>
  ...
  -S <path-to-source>          = Explicitly specify a source directory.
  -B <path-to-build>           = Explicitly specify a build directory.
  ...

这是-H和-B的正式版吗？

【问题讨论】：

cmake.org/cmake/help/v3.2/manual/cmake.1.html#options 用于已记录的，互联网用于未记录的（例如 stackoverflow.com/questions/31090821/… 和 stackoverflow.com/a/13713684/110118 用于 -H 和 -B）:)

标签： command-line cmake options

【解决方案1】：

绝对不是。你得看看CMake的源代码。

在线文档很好，但是我们故意在官方文档中省略了一些私有的实现细节。我们从生成的项目和 makefile 中使用的命令行内容就是其中的一些细节。

在线文档：

http://cmake.org/cmake/help/v2.8.8/cmake.html

此处记录的命令行选项：

http://cmake.org/cmake/help/v2.8.8/cmake.html#section_Options

概览页面，指向其他信息来源：

http://cmake.org/cmake/help/documentation.html

【讨论】：

感谢戴夫提供此信息。老实说，我对一些隐藏的命令行选项非常感兴趣，因为它对我自己的一组组合项目很有帮助。尤其是颜色回显输出的可能性有助于阅读 makefile 消息。并且无需先使用 -B 和 -H 创建 build-dir 即可调用 cmake 进行源外构建的可能性听起来非常有趣。也许你会在未来的版本中发布它。亲切的问候，安迪
你为什么要这样做？你为什么要故意让事情变得困难？
我不认为 CMake 开发人员故意让事情变得困难。我很确定这不是他们的目标之一......
@DLRdave 也许，对于那些感兴趣的人，您可以参考在源代码中可以找到这些选项的位置？

【解决方案2】：

Cmake documentation 在此期间得到了显着改进，但 -H<directory> 和 -B 一直被隐藏，这可能是有充分理由的（它们不应该在 CMake 开发环境之外使用）。

-H<directory> 和-B 都解释为here。

对于cmake -E，选项记录在this section。

【讨论】：

我无法证实您对 -H 和 -B 的怀疑。我使用带有此选项的 CMake 版本 3.5.1，它仍然有效。如果您只尝试“cmake -H”，它会打印帮助，但使用“cmake -H”。例如显示一条错误消息，如“CMake 错误：源目录 ... 似乎不包含 CMakeLists.txt。”。 -B 也很好。
好吧，如果它没有记录，你就不能依赖它。他们可能随时更改或破坏它。
@usr1234567 没错！

【解决方案3】：

可能不会。您可能需要查看 CMake 的源代码。

【讨论】：