Bug#698030: debian-policy: document micro binary packages (udebs).

[Russ Allbery <rra@debian.org>]

Charles Plessy <plessy@debian.org> writes:

> How about the following change to the first paragraph of section 1.1 ?

>           This manual describes the policy requirements for the Debian
>           distribution. This includes the structure and
>           contents of the Debian archive and several design issues of the
>           operating system, as well as technical requirements that
> -         each package must satisfy to be included in the
> -         distribution.
> +         each source and binary package must satisfy to be included in the
> +         distribution. Micro binary packages, described in more details
> +         in the the <url name="Debian Installer internals manual"
> +         id="http://d-i.alioth.debian.org/doc/internals/ch03.html";>,
> +         are not fully covered in this manual.

I think we should probably say explicitly that they don't follow all of
the requirements laid out in this document.

I vote for just calling them "udebs" instead of "micro binary packages."
The latter sounds more formal, but I don't think anyone calls them that in
practice, so it may be confusing.  Perhaps:

    udebs (stripped-down binary packages used by the Debian Installer) are
    not fully covered in this manual and do not comply with all of the
    requirements discussed here.  See the
    <url name="Debian Installer internals manual"
    id="http://d-i.alioth.debian.org/doc/internals/ch03.html";> for more
    information about them.

?

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>