手册页引用的“另请参阅”文档

手册页引用的“另请参阅”文档

我注意到,在“另请参阅”部分中的一些手册页底部引用了其他手册页以外的文档。例如,在bash 的手册页它引用了以下文件:

  • Bash 参考手册,Brian Fox 和 Chet Ramey
  • Gnu Readline 库,Brian Fox 和 Chet Ramey
  • Gnu 历史图书馆,Brian Fox 和 Chet Ramey
  • 可移植操作系统接口 (POSIX) 第 2 部分:Shell 和实用程序,IEEE

我知道我可以通过 Google 找到它们,但它们是否已经隐藏在我的系统中了?我知道 Bash 参考手册可通过 获得info bash。其他的有类似的吗(非 PDF --- HTML、ASCII、手册页或其他信息页)?

答案1

不幸的是,每个软件包维护者都会为软件包提供的应用程序提供一个或多个手册页,但手册页的内容

  1. 静态 - 无法根据特定机器上是否安装的内容而改变

  2. 主观 - 除了应遵循一般方案的结构之外,由维护者(或上游开发人员)选择写入的内容,并且应在语法上正确,以便从委托工具中进行解析

因此,无法保证所指示的文档在存储库中可用,也无法保证它通常是免费提供的(有时其他参考的手册页也不存在)。

您可以针对该包触发一个错误,以表明没有参考(甚至是 URL)表明可以在哪里找到该文档。

相关内容