On Wed, 10 Nov 2004 11:10:38 +0100, M.-A. Lemburg <mal@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