[Bash-completion-devel] Bug#506560: say how to start using

[jidanni at jidanni.org]

Package: bash-completion

There should be a README.debian file that answers the question:
Q: OK, I installed the bash-completion package. Now how do I start
enjoying its benefits?

I recall seeing a friend or even myself when I was younger doing
$ apt-get --TAB
etc. and seeing all the completions, but I can't find instructions now
how to do it anymore.

Maybe it is one of the shopt or set -o's? Can't really guess.

Looking all over the bash docs doesn't reveal how one gets one's bash
to know about /etc/bash_completion. And of course that file itself
doesn't mention what to do either.

OK, looking at
/usr/share/doc/abs-guide/html/sample-bashrc.html
I'm starting to guess that maybe
$ . /etc/bash_completion
is what one needs to do.
And it indeed seems to be.
So please mention in README.debian and /etc/bash_completion:

To start enjoying the benefits of bash_completion, so that e.g.,
$ apt-get --<TAB>
will show --assume-yes --fix-broken...
Use
. /etc/bash_completion
in your .bashrc

(Ah, you might say the README file mentions what to do
   INSTALLATION
   ------------

   The easiest way to install this software is to use a package, such as
   the RPM that I maintain for Red Hat Linux, the .deb package for
   Debian/GNU Linux or Ubuntu, etc.

   If that's not an option or you simply don't want to do this, put the
   bash_completion file somewhere on your system and source it from either
   /etc/bashrc or ~/.bashrc.

But after the first paragraph we get the impression that since we
already installed the .deb, we have already accomplished INSTALLATION.

Therefore you need another README.debian, which answers the question:
How can I, Joe User, start enjoying the benefits of the
bash_completion package today?)

P.S., even http://bash-completion.alioth.debian.org/ assumes one knows
what to do. (But not all users are connected to the Internet always,
so do make a README.debian).
P.S., in the package Description, bashs should be bash's.
P.S., bummer, no
# man aptitude|grep -- --sched|sed q
       --schedule-only
(No, --help doesn't show it. Only the aptitude man page.)