diff --git a/bash-completion.changes b/bash-completion.changes
index ee33bc1..31cd427 100644
--- a/bash-completion.changes
+++ b/bash-completion.changes
@@ -1,3 +1,9 @@
+-------------------------------------------------------------------
+Wed Apr 27 11:54:07 UTC 2016 - werner@suse.de
+
+- Add documentation for this packages below to get the reference
+  of the e.g. the variable COMP_FILEDIR_FALLBACK (boo#977336) 
+
 -------------------------------------------------------------------
 Wed Jan 27 15:42:34 UTC 2016 - werner@suse.de
 
diff --git a/bash-completion.spec b/bash-completion.spec
index f4c34af..f04b461 100644
--- a/bash-completion.spec
+++ b/bash-completion.spec
@@ -47,6 +47,8 @@ Patch8:         respect-variables-boo940837.patch
 Patch9:         rm-completion-smart-boo958462.patch
 # PATCH-FIX-SUSE boo#963140
 Patch10:        backticks-bsc963140.patch
+BuildRequires:  asciidoc
+BuildRequires:  libxslt-tools
 BuildRequires:  pkg-config
 Requires:       bash
 BuildRoot:      %{_tmppath}/%{name}-%{version}-build
@@ -73,9 +75,17 @@ of the programmable completion feature of Bash 2.04 and later.
 %build
 %configure
 make %{?_smp_mflags}
+pushd doc
+    mkdir html
+    a2x -D html -d book -f xhtml --asciidoc-opts="--unsafe" main.txt
+popd
 
 %install
 %make_install
+pushd doc
+    mkdir -p  %{buildroot}%{_defaultdocdir}/%{name}/html
+    install -m 0644 html/* %{buildroot}%{_defaultdocdir}/%{name}/html/
+popd
 
 # shipping in latest systemd now
 rm -f %{buildroot}%{_datadir}/bash-completion/completions/udevadm