[buildd-tools-devel] Bug#626221: Bug#626221: confusing warning: Unknown key ‘union-type’ used

[Brian May]

On 10 May 2011 18:39, Roger Leigh <rleigh at codelibre.net> wrote:

> The problem is, from the POV of the keyfile parser, it really *is*
> unknown: the chroot object reads all the keys it knows about, and
> anything left over is unknown.  chroots not supporting unions don't
> posess the union "facet" which provides the unioning functionality,
> and so they simply are unable to process that key.  The chroot
> objects are (internally) extensible via the addition of "facets",
> each of which can process arbitrary keys; in consequence it's not
> possible to know at the time of the error that an "unknown" key is
> valid in other contexts.
>

In that case, maybe just improvements to the man page. i.e.

1. List which types support unions. Or list which types don't support
unions.

2. Also mention that the default type is 'plain'. I see a reference that
says 'directory' is recommended but unfortunately it fails to mention that
the default is 'plain'.

If the documentation was acceptable on this point, I would have been less
confused.

Also maybe the wording of the message could be improved. e.g.

Unknown key ‘union-type’ used for type 'plain'

Just to emphasis that the the type may be relevant to the error.
-- 
Brian May <brian at microcomaustralia.com.au>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.alioth.debian.org/pipermail/buildd-tools-devel/attachments/20110510/835e60d9/attachment.htm>