Bug#250202: "debian/README.source" file for packages with non-trivial source

[Wouter Verhelst <w@uter.be>]

On Tue, Jan 08, 2008 at 12:36:07PM -0800, Russ Allbery wrote:
> Jörg Sommer <joerg@alea.gnuu.de> writes:
> > The rest looks good and I agree that such a source is useful, but it
> > should also be allowed to refer to a central document like
> > /u/s/d/dpatch/README.source. I expect that many README.source look the
> > same.
> 
> I don't think that needs any change to the above wording.  If
> README.source refers to another existing file that documents those things,
> that seems to me to satisfy the above.  Although I suppose we could
> explicitly add something like "The instructions may refer to a
> documentation file installed by one of the package build dependencies,
> provided that it clearly explains these tasks and isn't a general
> reference manual."

That seems like a good idea, actually; not because I expect people won't
refer to other documents in the absense of such a clause, but rather
because I feel it to be quite likely that they _will_ refer to general
reference manuals otherwise.

Thanks,

-- 
<Lo-lan-do> Home is where you have to wash the dishes.
  -- #debian-devel, Freenode, 2004-09-22