diff --git a/docs/usage.rst b/docs/usage.rst index f9658368dd45d304455928d518366655dff0e90b..e7a473a2f7a034ba34b256cbab224faa757f1f9b 100644 --- a/docs/usage.rst +++ b/docs/usage.rst @@ -2290,7 +2290,7 @@ handler execution. To help handle this situation, Majic Ansible Roles all come with a special way to invoke the handlers explicitly. Each role will include handlers as tasks, -provided that a special variable (``handlers``) is passed in to playbook run. To +provided that a special variable (``run_handlers``) is passed in to playbook run. To make the run shorter, the handlers in such a run are also tagged with ``handlers``. This doubling of environment variable + tagging stems from current limitations of Ansible (it is not possible to specify that certain task should @@ -2299,9 +2299,10 @@ used). Handlers alone can be invoked specifically with command similar to:: - ansible-playbook -t handlers -e handlers=true playbooks/site.yml + ansible-playbook -t handlers -e run_handlers=true playbooks/site.yml -The ``handlers`` variable is treated as boolean, and by default it is not set. +The ``run_handlers`` variable is treated as boolean, and by default it +is not set. Checking for available package upgrades