Bug#250202: mandate a common name for "patched source" and/or "unpacked source"
On Thu, Jun 03, 2004 at 08:57:05AM +0200, Wouter Verhelst wrote:
> I propose that the following paragraph be added to the current Debian
> policy. I'm looking for seconds.
I second this proposal, in principle, but do we want to instantly make
packages RC-buggy by introducing a must?
> --- policy.sgml.orig 2004-06-03 08:48:43.000000000 +0200
> +++ policy.sgml 2004-06-03 08:55:59.000000000 +0200
> @@ -2105,7 +2105,33 @@
> and <prgn>dpkg-distaddfile</prgn> should be called to add
> the file to the list in <file>debian/files</file>.</p>
> </sect>
> -
> +
> + <sect id="readmesource">
> + <heading>Source package handling: debian/README.source</heading>
> +
> + <p>
> + When running <prgn>dpkg-source -x</prgn> does not
> + immediately give one a directory with editable source, a
> + package must provide a file debian/README.source which
> + enumerates and documents the debian/rules targets for at
> + least <em>unpacking the source</em> and <em>applying
> + debian-specific patches</em> (if any, or a simple statement
> + that such a target does not exist or is not required if
> + none).</p>
> +
> + <p>
> + At the maintainer's option, the file may also document any
> + other bits of the source package that may be of interest to
> + someone unfamiliar with the package (although not
> + necessarily with the upstream source), interested in making
> + modifications to it.</p>
> +
> + <p>
> + Although this file is only required in one specific case
> + (see above), maintainers may include a README.source file if
> + they deem it appropriate, even if the above condition is not
> + fulfilled.</p>
> + </sect>
> </chapt>
>
Julian
--
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Julian Gilbey, website: http://www.polya.uklinux.net/
Debian GNU/Linux Developer, see: http://people.debian.org/~jdg/
Visit http://www.thehungersite.com/ to help feed the hungry
Reply to: