[12819] in athena10
Bug#760200: config-package-dev: [PATCH] .displace-extension can now contain ".extension" or "extension"
daemon@ATHENA.MIT.EDU (Dima Kogan)
Tue Sep 2 02:39:30 2014
Reply-To: Dima Kogan <dima@secretsauce.net>, 760200@bugs.debian.org
Resent-From: Dima Kogan <dima@secretsauce.net>
Resent-To: debian-bugs-dist@lists.debian.org
From: Dima Kogan <dima@secretsauce.net>
To: Geoffrey Thomas <geofft@ldpreload.com>
Cc: 760200@bugs.debian.org
Date: Mon, 01 Sep 2014 23:26:34 -0700
In-reply-to: <alpine.DEB.2.10.1409012133040.28960@cactuar.ldpreload.com>
Message-ID: <874mwqmsut.fsf@secretsauce.net>
MIME-Version: 1.0
Content-Type: text/plain
Geoffrey Thomas <geofft@ldpreload.com> 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
