Repository: ansible/ansible

Issue:
--help for --flush-cache is unclear whether it applies for whole cache or selected hosts only
<!---
Verify first that your issue/request is not already reported on GitHub.
Also test if the latest release, and master branch are affected too.
-->

##### ISSUE TYPE
<!--- Pick one below and delete the rest: -->
 - Documentation Report

##### COMPONENT NAME
ansible-playbook

##### ANSIBLE VERSION
<!--- Paste verbatim output from "ansible --version" between quotes below -->
```
ansible 2.3.1.0
  config file = /etc/ansible/ansible.cfg
  configured module search path = Default w/o overrides
  python version = 2.7.5 (default, Aug  2 2016, 04:20:16) [GCC 4.8.5 20150623 (Red Hat 4.8.5-4)]
```

##### CONFIGURATION
any

##### OS / ENVIRONMENT
any

##### SUMMARY
Right now it states: "Clear the fact cache."

Does it apply for all hosts, whole cache file, or just hosts that playbook will run for?

##### STEPS TO REPRODUCE
run "man ansible-playbook"

<!--- You can also paste gist.github.com links for larger files -->

##### EXPECTED RESULTS
Proper help

##### ACTUAL RESULTS
Lame help
--help for --flush-cache is unclear whether it applies for whole cache or selected hosts only
<!---
Verify first that your issue/request is not already reported on GitHub.
Also test if the latest release, and master branch are affected too.
-->

##### ISSUE TYPE
<!--- Pick one below and delete the rest: -->
 - Documentation Report

##### COMPONENT NAME
ansible-playbook

##### ANSIBLE VERSION
<!--- Paste verbatim output from "ansible --version" between quotes below -->
```
ansible 2.3.1.0
  config file = /etc/ansible/ansible.cfg
  configured module search path = Default w/o overrides
  python version = 2.7.5 (default, Aug  2 2016, 04:20:16) [GCC 4.8.5 20150623 (Red Hat 4.8.5-4)]
```

##### CONFIGURATION
any

##### OS / ENVIRONMENT
any

##### SUMMARY
Right now it states: "Clear the fact cache."

Does it apply for all hosts, whole cache file, or just hosts that playbook will run for?

##### STEPS TO REPRODUCE
run "man ansible-playbook"

<!--- You can also paste gist.github.com links for larger files -->

##### EXPECTED RESULTS
Proper help

##### ACTUAL RESULTS
Lame help


Discussion:
@benapetr Greetings! Thanks for taking the time to open this issue. In order for the community to handle your issue effectively, we need a bit more information. 

Here are the items we could not find in your description:
- issue type
- ansible version
- component name

Please set the description of this issue with this template:
https://raw.githubusercontent.com/ansible/ansible/devel/.github/ISSUE_TEMPLATE.md

[click here for bot help](https://github.com/ansible/ansibullbot/blob/master/ISSUE_HELP.md)
<!--- boilerplate: issue_missing_data --->
info provided
Looks like it applies to all hosts in inventory https://github.com/ansible/ansible/blob/5553b208281d723ead1e61be5c37227ec2b2736e/lib/ansible/cli/playbook.py#L201-L204
@benapetr Greetings! Thanks for taking the time to open this issue. In order for the community to handle your issue effectively, we need a bit more information. 

Here are the items we could not find in your description:
- issue type
- ansible version
- component name

Please set the description of this issue with this template:
https://raw.githubusercontent.com/ansible/ansible/devel/.github/ISSUE_TEMPLATE.md

[click here for bot help](https://github.com/ansible/ansibullbot/blob/master/ISSUE_HELP.md)
<!--- boilerplate: issue_missing_data --->
info provided
Looks like it applies to all hosts in inventory https://github.com/ansible/ansible/blob/5553b208281d723ead1e61be5c37227ec2b2736e/lib/ansible/cli/playbook.py#L201-L204

Resolving patch:
diff --git a/lib/ansible/cli/__init__.py b/lib/ansible/cli/__init__.py
--- a/lib/ansible/cli/__init__.py
+++ b/lib/ansible/cli/__init__.py
@@ -544,7 +544,7 @@ def base_parser(usage="", output_opts=False, runas_opts=False, meta_opts=False,
             parser.add_option('--force-handlers', default=C.DEFAULT_FORCE_HANDLERS, dest='force_handlers', action='store_true',
                               help="run handlers even if a task fails")
             parser.add_option('--flush-cache', dest='flush_cache', action='store_true',
-                              help="clear the fact cache")
+                              help="clear the fact cache for every host in inventory")
 
         if basedir_opts:
             parser.add_option('--playbook-dir', default=None, dest='basedir', action='store',


Test patch: