# ERROR: AsciiDoc 'a2x' command is not installed but is required to build

**URL:** <https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495>\
**Category:** Ansible Project\
**Created:** [February 5, 2014, 5:28pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495 "2014-02-05T17:28:06Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Yuri\_Lukyanov](https://avatars.discourse-cdn.com/v4/letter/y/ed655f/32.png) [@Yuri\_Lukyanov](https://forum.ansible.com/u/Yuri_Lukyanov)\
**Post date:** [February 5, 2014, 5:28pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/1 "2014-02-05T17:28:06Z")

</div>

The recent devel branch requires a2x to make rpm.

sed “s/%VERSION%/1.5/” docs/man/man1/ansible-pull.1.asciidoc.in \> docs/man/man1/ansible-pull.1.asciidoc  
ERROR: AsciiDoc ‘a2x’ command is not installed but is required to build docs/man/man1/ansible.1 docs/man/man1/ansible-playbook.1 docs/man/man1/ansible-pull.1 docs/man/man1/ansible-doc.1  
make: \*\*\* [docs/man/man1/ansible-pull.1] Error 1  
rm docs/man/man1/ansible-pull.1.asciidoc

What am I supposed to do about that?

---

<div class="post-metadata">

**Author:** ![tannerjc](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/tannerjc/32/985_2.png) [@tannerjc](https://forum.ansible.com/u/tannerjc)\
**Post date:** [February 5, 2014, 6:23pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/2 "2014-02-05T18:23:18Z")

</div>

Please provide details about what OS/version you are building the RPM on.

---

<div class="post-metadata">

**Author:** ![adam2](https://avatars.discourse-cdn.com/v4/letter/a/ecae2f/32.png) [@adam2](https://forum.ansible.com/u/adam2)\
**Post date:** [February 5, 2014, 6:24pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/3 "2014-02-05T18:24:48Z")

</div>

root@urk:~# apt-file search bin/a2x  
asciidoc: /usr/bin/a2x

And "yum search asciidoc" comes up with results.

Does rpm.spec have a way to list a series of build dependencies? I'm a Debian guy, and that would be done thru debian/control:Build-Depends

---

<div class="post-metadata">

**Author:** ![Michael\_DeHaan1](https://avatars.discourse-cdn.com/v4/letter/m/5e9695/32.png) [@Michael\_DeHaan1](https://forum.ansible.com/u/Michael_DeHaan1)\
**Post date:** [February 5, 2014, 6:30pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/4 "2014-02-05T18:30:29Z")

</div>

Asciidoc produces no results on what platform? Confused by your apt-file command above.

It could be added to BuildRequires, though this is more for packaging relative to the tarball.

The build system will attempt to do this prior to building the RPM (and we are ok with this, because RPM is only one of many things we use and should not drive the build system)

We do “make rpm” from checkout, which calls the docs target.

---

<div class="post-metadata">

**Author:** ![C\_Morgan\_Hamill](https://avatars.discourse-cdn.com/v4/letter/c/ebca7d/32.png) [@C\_Morgan\_Hamill](https://forum.ansible.com/u/C_Morgan_Hamill)\
**Post date:** [February 5, 2014, 6:31pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/5 "2014-02-05T18:31:02Z")

</div>

Excerpts from Adam Heath's message of 2014-02-05 13:24:48 -0500:

> root@urk:~# apt-file search bin/a2x  
> asciidoc: /usr/bin/a2x
> 
> And "yum search asciidoc" comes up with results.
> 
> Does rpm.spec have a way to list a series of build dependencies? I'm a  
> Debian guy, and that would be done thru debian/control:Build-Depends

In the spec file, 'BuildRequires: asciidoc' in the metadata section at  
the top of the file.

---

<div class="post-metadata">

**Author:** ![adam2](https://avatars.discourse-cdn.com/v4/letter/a/ecae2f/32.png) [@adam2](https://forum.ansible.com/u/adam2)\
**Post date:** [February 5, 2014, 6:36pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/6 "2014-02-05T18:36:48Z")

</div>



---

<div class="post-metadata">

**Author:** ![adam2](https://avatars.discourse-cdn.com/v4/letter/a/ecae2f/32.png) [@adam2](https://forum.ansible.com/u/adam2)\
**Post date:** [February 5, 2014, 6:38pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/7 "2014-02-05T18:38:29Z")

</div>



---

<div class="post-metadata">

**Author:** ![Michael\_DeHaan1](https://avatars.discourse-cdn.com/v4/letter/m/5e9695/32.png) [@Michael\_DeHaan1](https://forum.ansible.com/u/Michael_DeHaan1)\
**Post date:** [February 5, 2014, 6:40pm UTC](https://forum.ansible.com/t/error-asciidoc-a2x-command-is-not-installed-but-is-required-to-build/14495/8 "2014-02-05T18:40:04Z")

</div>

This is because there are pre-build steps that happen before the package build step.

Adding it to BuildRequires hurts nothing, but it would not build the docs (which is ok, as they are in the release tarball that the RPM build references).
