[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#276953: debian-policy: please clarify section 12.7.



Hi,
On Sun, 17 Oct 2004 20:37:54 +0200, Adrian Bunk <bunk@stusta.de> said: 

> The first paragraph of section 12.7. of your policy is:

>> -- snip -->

>      Packages that are not Debian-native must contain a compressed
>      copy of the `debian/changelog' file from the Debian source tree
>      in `/usr/share/doc/<package>' with the name
>      `changelog.Debian.gz'.

>> -- snip -->

> My personal opinion:

> I'd read this section of your policy that
> /usr/share/doc/<package>/changelog.Debian.gz must always point to "a
> compressed copy of the `debian/changelog' file from the Debian
> source tree" <package> was built from.

	Quite so.

> Therefore, if the /usr/share/doc/<package>/changelog.Debian.gz comes
> from another binary package (built from the same source package), a
> strict dependency on exactly the same version is
> required. Otherwise, e.g. apt-listchanges can't work correctly on
> partial upgrades.

> Other people disagree and say that only an unversioned or less
> strict versioned dependency was required (see the discussions in
> #249414 and #276822).

	These are implementation details. Policy merely states what
 the requirements are. How it is implemented is up to the maintainer,
 as lonmg as the requirements are met, policy is not concerned.

> Could you clarify this issue in your policy?

	What's there to clarify? If I install foo-x.y.z, I expect to
 find the changelog for foo version x.y.z in the /usr/share/doc/foo
 directory. How the maintainer arranges for it to be present is left
 up to the maintainer.

	If the package does not show me the changelog for foo x.y.z,
 then the package is violating a must directive in policy.

	manoj

-- 
Saints should always be judged guilty until they are proved
innocent. George Orwell, "Reflections on Gandhi"
Manoj Srivastava   <srivasta@debian.org>  <http://www.debian.org/%7Esrivasta/>
1024D/BF24424C print 4966 F272 D093 B493 410B  924B 21BA DABB BF24 424C



Reply to: