[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#495233: debian-policy: README.source content should be more detailed



Lucas Nussbaum wrote:

> First, section 4.14 should list things that one does not need to
> describe in debian/README.source. For example, the use of one of the
> "standard" patch systems (quilt, dpatch, simple-patchsys) doesn't need
> to be documented, since every NMUer should be able to work with them.
> Another example is build systems: cdbs is used by >20% of our packages,
> so I don't think that one need to document its use.

I think the better way is do it similar to copyright: for
common patch/build system we should include only a link to
the relative document.
Maybe on a common package (build essential or dpkg-dev) or
on patch system package (but in this case we should push stronger
the maintainer to include the relevant informations).

BTW debian/README.source is not only for the MNUer, but also
for our users, so I prefer redundant documentation.


> Also, it would be interesting to extend the use of debian/README.source
> to other areas, such as:
> - whether the maintainer encourages commits for other people directly to
>   the package's VCS.
> - the branch layout in the package's VCS.

I agree with that.

PS: you should provide a patch!

ciao
   cate



Reply to: