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

Question

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

a2x -v -f manpage  foobar.1.txt

我得到了错误manpage document title is mandatory。我该怎么解决这个问题？

Answer 1

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

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

这将解决以下问题：

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