On Thu, Jun 03, 2004 at 09:25:42AM +0100, Julian Gilbey wrote:
> 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?
Uh -- right. Especially since I mentioned that point myself, for this
very proposal :-)
Let's assume I said "should" instead of "must". We can make it a must if
"most" packages that would require it, provide README.source
> > --- 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
>
--
EARTH
smog | bricks
AIR -- mud -- FIRE
soda water | tequila
WATER
-- with thanks to fortune
Attachment:
signature.asc
Description: Digital signature