# Crash with 'ansible-doc --list'

**URL:** <https://forum.ansible.com/t/crash-with-ansible-doc-list/17083>\
**Category:** Ansible Project\
**Created:** [December 17, 2014, 1:29am UTC](https://forum.ansible.com/t/crash-with-ansible-doc-list/17083 "2014-12-17T01:29:30Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Hugo\_Posca](https://avatars.discourse-cdn.com/v4/letter/h/6de8d8/32.png) [@Hugo\_Posca](https://forum.ansible.com/u/Hugo_Posca)\
**Post date:** [December 17, 2014, 1:29am UTC](https://forum.ansible.com/t/crash-with-ansible-doc-list/17083/1 "2014-12-17T01:29:30Z")

</div>

Hello there.

I could not believe I missed this wonderful command, ansible-doc, for so long!  
Excited by this new discovery I used it well for reading know modules  
like yum, apt, user and so on.

Then, doing a 'ansible-doc --help' I saw a '--list' option, to list  
available modules!! Wonderful!  
Then... crash!

---

<div class="post-metadata">

**Author:** ![Eduardo\_Bergavera](https://avatars.discourse-cdn.com/v4/letter/e/a8b319/32.png) [@Eduardo\_Bergavera](https://forum.ansible.com/u/Eduardo_Bergavera)\
**Post date:** [December 17, 2014, 2:00am UTC](https://forum.ansible.com/t/crash-with-ansible-doc-list/17083/2 "2014-12-17T02:00:09Z")

</div>

Hi Hugo,

I just updated to 1.8.2 today. It’s my first time to know that there is a command like ansible-doc. My machine is Mac OS X Yosemite 10.10.1. However, the command

`ansible-doc --list`

works on my machine. Here is additional info:

Pip version 1.4.1

Ansible 1.8.2

I suggest that you remove Ansible through pip and install it again.

Hope his helps!

---

<div class="post-metadata">

**Author:** ![Hugo\_Posca](https://avatars.discourse-cdn.com/v4/letter/h/6de8d8/32.png) [@Hugo\_Posca](https://forum.ansible.com/u/Hugo_Posca)\
**Post date:** [December 18, 2014, 12:08am UTC](https://forum.ansible.com/t/crash-with-ansible-doc-list/17083/3 "2014-12-18T00:08:04Z")

</div>

Hi Eduardo, thanks for the feedback!

This problem is very strange indeed...

At my work, with pip 1.5.4 and Ansible 1.8.2, "ansible-doc --list" works!  
Here, I have pip 1.5.6 and it doesn't work ☹

One strange thing here is that when I make a "pip --version", insted  
of simply showing the version I get this: