.Bl, .It 在 mandoc 中渲染列表在 macOS 和 Ubuntu 16.04 上都不起作用
.Bl, .It to render list in mandoc doesn't work on both macOS and Ubuntu 16.04
我尝试使用适当的宏,如 .Bl
及其 .It
,以使用以下语法(如 mdoc.7 中所示在 mandoc(或每个手册页)中呈现列表)
The arguments are as follows:
.Bl -tag -width Ds
.It Fl v
Print verbose information.
.El
通过放入 .SH DESCRIPTION
在 macOS 和 Ubuntu 16.04 上进行了尝试,但它没有呈现预期的输出。我只看到
The arguments are as follows: Print verbose information.
我这样做的步骤是
- 编辑 mandoc 文件
- 将其符号链接到位于
/usr/local/share/man/man3/
的目标文件
- 查看
man <filename>
的结果
PS。我没去 gzip
.
我错过了什么?如何在 mandoc 中正确呈现列表?
相反,我查看了 /usr/share/man/man1/bash.1
的 mandoc 代码,为了安全起见,我通过 man /usr/share/man/man1/bash.1
查看此类手册页,以确保我查看正确的文件。
它使用以下语法
.TP 10
.BI Item Name
Item description
.TP
.BI Item Name 2
Item 2 description
这将正确呈现第一列宽度为 10 个字符的那两个项目。第二项将使用与之前定义的相同的列宽。比我尝试的更清晰、更简单,但在问题上没有成功。
您将看到使用上述语法的以下输出
我尝试使用适当的宏,如 .Bl
及其 .It
,以使用以下语法(如 mdoc.7 中所示在 mandoc(或每个手册页)中呈现列表)
The arguments are as follows:
.Bl -tag -width Ds
.It Fl v
Print verbose information.
.El
通过放入 .SH DESCRIPTION
在 macOS 和 Ubuntu 16.04 上进行了尝试,但它没有呈现预期的输出。我只看到
The arguments are as follows: Print verbose information.
我这样做的步骤是
- 编辑 mandoc 文件
- 将其符号链接到位于
/usr/local/share/man/man3/
的目标文件
- 查看
man <filename>
的结果
PS。我没去 gzip
.
我错过了什么?如何在 mandoc 中正确呈现列表?
相反,我查看了 /usr/share/man/man1/bash.1
的 mandoc 代码,为了安全起见,我通过 man /usr/share/man/man1/bash.1
查看此类手册页,以确保我查看正确的文件。
它使用以下语法
.TP 10
.BI Item Name
Item description
.TP
.BI Item Name 2
Item 2 description
这将正确呈现第一列宽度为 10 个字符的那两个项目。第二项将使用与之前定义的相同的列宽。比我尝试的更清晰、更简单,但在问题上没有成功。
您将看到使用上述语法的以下输出