Geoffrey Thomas <[email protected]> writes:

> I don't think any of the config-package-dev maintainers actually use
> displace-extension files,.... so feedback on this interface in general
> is welcome.

Well, if you really want me to complain, I'll complain :)

The interface is fine, but it was very difficult to find. The only
shipped documentation (/usr/share/doc/config-package-dev/DOCUMENTATION)
has no documentation in it, but says to look at
http://debathena.mit.edu/config-package-dev. This webpage hints that the
extension is configurable, but does not say at all how to do it. It
should explicitly mention the .displace-extension file.

The dh_configpackage manpage DOES mention the .displace-extension file,
but not where you'd expect. The last paragraph of the DESCRIPTION talks
about the concept of the extension and how it's usually determined, but
mentions nothing about .displace-extension. It should. Finally, when the
file is described further down in that manpage, it says to see the
CAVEATS section, which implies that there's some caveat to using a
.displace-extension file; there is not. The CAVEATS section describes an
issue with doing something else, to which a .displace-extension file is
a solution, so the "See CAVEATS" sentence is a bit misleading.

That's about it. I can give you patches, but they're trivial.

Thanks

dima


-- 
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to