a2x无法编译我的联机帮助页

Question

我有一个Asciidoc文档foo.1.txt,并按照这里的说明,我尝试编译它a2x如下:

a2x --doctype manpage --format manpage foo.1.txt

在此之后,我收到以下错误:

a2x: ERROR: "/usr/bin/asciidoc.py" --backend docbook -a 
"a2x-format=manpage"  --doctype manpage  --out-file 
"/home/koz/Documents/foo.1.xml" 
"/home/koz/Documents/foo.1.txt" returned non-zero exit status 1

我不确定发生了什么,或者我怎么能诊断出什么是错的.XML文件被在同一文件夹(标题为产生foo.1.xml)作为这个过程的一部分.所有帮助表示赞赏.

编辑:基于--verbose标志的使用,问题似乎在这一部分:

COPYING
----------
 Copyright \(C) 2015, Koz Ross <koz.ross@runbox.com>. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.

投诉是:[blockdef-listing] missing closing delimiter就行了COPYING.

Answer 1

COPYING
----------
 Copyright \(C) 2015, Koz Ross <koz.ross@runbox.com>. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.
----------

works see http://asciidoctor.org/docs/asciidoc-writers-guide/#delimited-blocks and becomes:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<?asciidoc-toc?>
<?asciidoc-numbered?>

<article lang="en">
<articleinfo>
    <date>2015-10-08</date>
</articleinfo>
<simpara>COPYING</simpara>
<screen> Copyright \(C) 2015, Koz Ross &lt;koz.ross@runbox.com&gt;. Free use of this software
is granted under the terms of the GNU General Public License (GPL) version 3, or
any later version.</screen>
</article>