Re: shell completion documentation

[Richard Stallman]

    The description with exactly that much detail has to exist, so that
    maintainers can quickly get to it and not ask users to educate them on
    package they are supposed to maintain.  Perhaps the description is
    indeed too detailed for regular user.  Then it just should be placed
    not in user manual, but elsewhere in emacs distribution, with
    reference to it from manual.

Maybe you are right in this point.  Which are the maintainers that
need to know this information?  Is it maintainers of shell.el, or
maintainers of other parts of Emacs?  If just shell.el, let's
put it in a comment.  If maintainers of other parts, let's
put it in some doc string.