为什么 asciidoc 给出错误“手册页文档标题是强制性的”？

Question

尝试使用 asciidoc 生成手册页时，如下所示：

a2x -v -f manpage  foobar.1.txt

我收到错误 manpage document title is mandatory。我该如何解决这个问题？

Answer 1

文件顶部的手册页标题下的=s 行必须与它上面的行长度相同。这将导致错误：

FOO-BAR-QUUX(1)
========

这将解决它：

FOO-BAR-QUUX(1)
===============