[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 <lucas@lucas-nussbaum.net> writes:
> On 15/08/08 at 11:01 -0700, Russ Allbery wrote:
>> Giacomo Catenazzi <cate@debian.org> writes:

>>> 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).

>> Which is what Policy already says, and quilt, for example, provides
>> such a document for README.source to link to.  So I don't think Policy
>> should be changed here.

> But that won't work if we want to include more info in README.source.

Why not?  I would think you could include whatever information you want
before or after the pointer to the standard quilt documentation.

> What about moving to a machine-parseable format, such as:
>
> Patch-system: quilt
> Patch-system-doc: /usr/share/doc/quilt/README.source

I think that's kind of pointless for human-readable, human-targetted
documention.  Why would machines need to parse README.source?

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>



Reply to: