On Tue, Aug 12, 2008 at 04:29:04PM -0300, Lucas Nussbaum wrote:
> > `debian/README.source' may also include any other information that
> > would be helpful to someone modifying the source package.
> Sure, but with the way the policy is currently written, it's still not
> the _main purpose_ of debian/README.source.
Ack. I indeed think the wording should be improvement, and IIRC Russ
acknowledge that. But right now it is how you said.
> Looking at the 306 source packages using README.source (see
> gluck:~lucas/readme.source), it's obvious that the lack of guidelines on
> how to use this file is limiting its usefulness (unless the goal is to
> generate lots of variants of quilt howtos ;)
:-)
> I don't garantee that I'll accept it, but could you prepare a patch
> that would mention README.source, staying vague on the gory details?
> You can use gluck:~lucas/pkgs.dbk as a basis.
Actually I had already thought about preparing the patch upon my first
post, but I refrained to do so because I didn't find the good place
where to mention it in the current DEP text. At a second look though,
the section "When and how to do an NMU" seems appropriate.
Patch attached.
(Note that I haven't tried building the resulting dbk.)
Cheers.
--
Stefano Zacchiroli -*- PhD in Computer Science \ PostDoc @ Univ. Paris 7
zack@{upsilon.cc,pps.jussieu.fr,debian.org} -<>- http://upsilon.cc/zack/
I'm still an SGML person,this newfangled /\ All one has to do is hit the
XML stuff is so ... simplistic -- Manoj \/ right keys at the right time
--- pkgs.dbk.orig 2008-08-13 16:44:44.000000000 -0600 +++ pkgs.dbk 2008-08-13 16:52:12.000000000 -0600 @@ -1892,6 +1892,14 @@ might be helpful). </para> <para> +While preparing the patch, you should better be aware of any package-specific +practices that the maintainer might be using. Taking them into account reduces +the burden of getting your changes integrated back in the normal package +workflow and thus increases the possibilities that that will happen. A good +place where to look for for possible package-specific practices is +<ulink url="&url-debian-policy;ch-source.html#s-readmesource"><literal>debian/README.source</literal></ulink>. +</para> +<para> Unless you have an excellent reason not to do so, you must then give some time to the maintainer to react (for example, by uploading to the <literal>DELAYED</literal> queue). Here are some delays that you could use as
Attachment:
signature.asc
Description: Digital signature