默认情况下,mdoc 宏集在非 BSD 系统上可用吗?

默认情况下,mdoc 宏集在非 BSD 系统上可用吗?

通常用于创建 BSD 联机帮助页的 MDoc 宏通常在非 BSD 系统(例如 Ubuntu 和其他 GNU Linux 发行版)上可用吗?在编写跨平台文档时使用它们设计联机帮助页是否安全?

答案1

我认为您可以毫无问题地使用这些宏。

我查看了 3 个示例操作系统:ubuntu 14.04、debian 7.8、fedora 21,它们都使用 groff 包来包含 mandoc 宏(尽管不是 mandoc 命令)并提供有关它们的手册页:mdoc(7) 。

我检查了是否实际使用这些宏安装了任何手册页:

find /usr/share/man/man1/ -type f |
while read f;do if gzip -d <$f | fgrep '.Dd'; then echo $f; fi; done

并找到几个文件,例如 ftp(1)、ssh-agent(1)、ncal(1)。我尝试了man 这些命令,它们显示正确。

因此,如果大多数系统安装了 groff,他们就可以阅读这些手册页。有人有 mac osx 可以试试吗?

答案2

典型的 UNIX 系统不支持 mdoc 宏,如果您喜欢编写可移植的手册页,请不要使用 mdoc。

相关内容