[gentoo-dev] bash-completion-r1: a quick migration guide

[Michał Górny]

Hello,

As new bash-completion-r1 eclass is in the tree now, a quick migration
guide follows.

The new eclass is simpler and more consistent. It doesn't enforce
USE=bash-completion or put any bash-completion-specific deps on
packages. If any package _really_ needs that, it should put out
the necessary IUSE and deps explicitly.

pkg_postinst() was removed as well. Users are expected to know how to
use 'eselect bashcomp list', like packages don't list what they've
installed in */bin.

Usually, migrating packages means replacing:

1) inherit bash-completion
-> inherit bash-completion-r1

2) bash-completion_pkg_postinst
-> :

3) dobashcompletion foo
-> dobashcomp foo || die

4) dobashcompletion foo bar
-> newbashcomp foo bar || die

5) BASHCOMPLETION_NAME=bar dobashcompletion foo
-> newbashcomp foo bar || die

6) BASHCOMPFILES='foo bar baz' dobashcompletion
-> dobashcomp foo bar baz || die

I'm listing '|| die' explicitly to ensure one doesn't forget about it.
It's necessary only in EAPI<4, like for doins/newins.

-- 
Best regards,
Michał Górny