☰

手册页排版和正确的破折号

tag-icon • tag-icon man unicode
手册页排版和正确的破折号

手册页是否应该避免使用像 m 破折号 (—) 这样的 unicode 字符？我注意到大多数手册页在其标语中使用连字符/减号，我相信，实际的破折号在印刷上会更正确。 dash shell 的手册页名副其实，并使用正确的 m-dash。

我已在以下地址提交了临时拉取请求https://github.com/rtomayko/ronn/pull/94修复了 (?) 这个问题ronn。

意见？

答案1

Unix 手册页（使用 man 宏）在 NAME 部分中使用单个连字符将名称与描述分开。

.SH NAME
sh \- command language

Unix 文档和论文经常在适当的情况下使用长破折号（\(emtroff 中）。

最近的手册页基于文档宏，并使用.Nd宏输出全破折号。例如，dash 的手册页包括

.Sh NAME
.Nm dash
.Nd command interpreter (shell)

的定义.Nd是

.de Nd
.nop \[em] \$*
..

最好使用\(em或.Nd宏，但使用 UTF-8 编码的破折号也可能没问题。

相关内容