From 4173690b2492680ab504ef0d60498eeb5a3d8ae2 Mon Sep 17 00:00:00 2001
From: Robin Cernin <rcernin@redhat.com>
Date: Thu, 18 Oct 2018 10:39:49 +1000
Subject: [PATCH] Improve document 'openstack complete'

The openstack complete command requires bash-completion package
Without the relevant package the bash completion doesn't work.

Change-Id: I47c77f3e7efe112417d2b96936fcd0cafeb9442e
Closes-Bug: #1798493
---
 doc/source/cli/command-objects/complete.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/source/cli/command-objects/complete.rst b/doc/source/cli/command-objects/complete.rst
index 20e5c41da4..165d5d07d5 100644
--- a/doc/source/cli/command-objects/complete.rst
+++ b/doc/source/cli/command-objects/complete.rst
@@ -11,8 +11,11 @@ Typical usage for this command is::
 
   openstack complete | sudo tee /etc/bash_completion.d/osc.bash_completion > /dev/null
 
-If installing ``python-openstackclient`` from a package (``apt-get`` or ``yum``),
-then this command will likely be run for you.
+It is highly recommended to install ``python-openstackclient`` from a package
+(``apt-get`` or ``yum``). In some distributions the package ``bash-completion`` is shipped
+as dependency, and the `openstack complete` command will be run as a post-install action,
+however not every distribution include this dependency and you might need to install
+``bash-completion`` package to enable autocomplete feature.
 
 complete
 --------