为什么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)
===============