历史上和今天一样，用于显示其帮助页面的命令的普遍接受的默认参数是什么或现在是什么？

Question

当我第一次想向-h我的程序添加一个选项时，我偶然发现了一个-h已经在使用的错误：使用add_help=True，Python 会argparse自动为参数-h和--help.

但是对于大多数程序来说，同时使用-hand--help来显示帮助页面不是这样的，是吗？哪些流行的命令甚至有-h缩写--help？我查看了一些命令，通常它是--human-readable或其他与帮助无关的选项的缩写。使用-h您的帮助消息不工作，ls，cd，df和diff例如-短短的命令是我测试过，当然不是一个详尽的或代表名单，但很受欢迎的命令。

可能-h在历史上一直用作显示帮助页面的默认参数，--help后来才出现？man或info页面从哪里进入？

-h如果这是流行的默认设置，我不想通过使用帮助页面以外的其他内容来混淆用户。但是，就个人而言，我从未使用过-h并且一直在使用--help.

Answer 1

-h是一个非常古老的约定。在 DOS 系统中，您也会经常看到-?或/?。

不要听那些说手册页是给新手的。它们非常有价值，并且在 Unix诞生仅两年后的1971 年就已添加到 Unix 系统中。它们在 1973 年就已经用 troff 排版了。它仍然需要符合 POSIX（但可以是 的别名info）。它有很长的历史，遗憾的是它没有对当今这个疯狂的网络世界产生更多的兴趣。斥责手册页或其用户的人经常“忘记”（不会被打扰）自己创建它们。文档很重要。

不幸的是，Linux 上的手册页没有很好地保存，因此许多用户认为它们已经过时了。但是在 FreeBSD 上（我相信其他 BSD 也是如此）它们会保持最新状态，并且是了解系统和命令的最佳方式。

info来自 1980 年代后期的 GNU 背景并且基于超文本。它在 Linux 系统上很流行，但不幸的是没有很好地集成。您会发现许多没有信息页面的工具。

--help再次是 GNU 主义，并在 90 年代初在GNU C 库中引入了很长的选项。这是后来的约定——但如果你支持长选项，这是一个很好的约定。

对我来说，一个好的程序会使用-h. 如果您的程序支持长选项，则对--help And然后执行相同的操作，然后将正确的说明放入手册页。

然而，这些只是约定。但即使你不想跟随他们 --h除了帮助之外，我也会非常谨慎地使用任何东西。或者至少确保它是一个非破坏性的选项，例如df -h.

今天我会用mdoc写一个手册页。它相当简单，有很多工具可以将其处理为 Markdown、PDF 或 HTML，以便在其他地方使用。

来自mdoc的相关引用

没有手册的实用程序根本没有用处。