.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.

我这样做的步骤是

  1. 编辑 mandoc 文件
  2. 将其符号链接到位于 /usr/local/share/man/man3/
  3. 的目标文件
  4. 查看 man <filename>
  5. 的结果

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 个字符的那两个项目。第二项将使用与之前定义的相同的列宽。比我尝试的更清晰、更简单,但在问题上没有成功。

您将看到使用上述语法的以下输出