Re: Bug#99714: dh_installexamples: install examples in /usr/share/$package/examples/ (with symlink from /usr/share/doc/$package/examples)
On Sat, Jun 02, 2001 at 05:51:50PM -0500, Steve Greenland wrote:
> On 02-Jun-01, 17:35 (CDT), Julian Gilbey <J.D.Gilbey@qmw.ac.uk> wrote:
> > On Sat, Jun 02, 2001 at 01:02:38PM -0400, Joey Hess wrote:
> > > That is not the intent of policy (I should know; I drafted that
> > > modification). The intent is that packages may, rarely, have
> > > architecture dependant example files. Such files cannot go in
> > > /usr/share, so policy now says put them in /usr/lib, with a symlink to
> > > the other location.
> >
> > Not quite ;-)
> >
> > The intent was that *template* files which are used by maintainer
> > scripts to initialise configuration files cannot live in
> > /usr/share/doc.
>
> Configuration templates != examples. The former are covered by 11.7.3
> (penultimate paragraph) , the latter by 13.7.
But config templates may also function as examples. Here's the full
story:
Arch-specific examples were moved from /usr/share to /usr/lib with
appropriate symlinks in policy version 3.1.0.0.
Configuration templates should be in /usr/{share,lib}/<package> and
not /usr/share/doc as of policy 3.5.3.0; the symlink from
/usr/share/doc/<package>/examples is appropriate if the templates can
also function as examples.
The upgrading-checklist note for 3.5.3.0 was unfortunately slightly
misleading: it appeared to say that *all* examples should be in
/usr/{share,lib}/<package>, whereas this was not the intention (and is
not what policy says). This has now been corrected, and an
explanatory note added in the 3.5.5.0 checklist section to this
effect.
And now let's return to our regular scheduled service.
Julian
--
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Julian Gilbey, Dept of Maths, Queen Mary, Univ. of London
Debian GNU/Linux Developer, see http://people.debian.org/~jdg
Donate free food to the world's hungry: see http://www.thehungersite.com/
Reply to: