通常用于创建 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。