Почему 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) 
===============