[Distutils] Re: bdist_deb patches

Jeff Dairiki dairiki at gmail.com
Wed Nov 10 15:53:18 CET 2004


On Wed, 10 Nov 2004 11:10:38 +0100, M.-A. Lemburg <mal at egenix.com> wrote:
> BTW, why do you need so many different options for specifying
> doc files ? Is that a Debian thing or requirement ?

Yes, precisely.  It's a Debian thang.

The upstream changelog needs special treatment since, in the Debian package,
it is supposed to be named /usr/share/doc/<package>/changelog.gz. 
(Not ChangeLog,
CHANGES, or whatever.)  Hence the --upstream-changelog option.

The license file needs special treatment because it is supposed to be
incorporated
into the /usr/share/doc/<package>/copyright file.  (The copyright file
is also supposed
to list the upstream author, where the upstream source can be obtained, and
who the Debian packager is.)   Hence --license-file.

Examples are supposed to go in /usr/share/doc/<package>/examples/.
Hence --examples

All other documentation (except man and info pages) just (as you would
naively expect) get copied into /usr/share/doc/<package>/.  That's the
--doc-files option.

References:

http://www.debian.org/doc/debian-policy/ch-docs.html
  In particular:
  http://www.debian.org/doc/debian-policy/ch-docs.html#s-changelogs
  http://www.debian.org/doc/debian-policy/ch-docs.html#s-copyrightfile

Jeff


More information about the Distutils-SIG mailing list