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

Re: Bug#207132: debian-policy is missing gcc transition plans



On Tue, Aug 26, 2003 at 06:54:31PM +1000, Anthony Towns wrote:
> But doing any of that requires a document that's willing to cover all
> the things we're trying to achieve. Having many documents doesn't work,
> because packagers coming to Debian need to be able to find *everything*
> that affects them;

That's just non sequitur. If packagers coming to Debian aren't able to grasp
the concept of having different things documented in two different pieces of
documentation, well that just says something about their intelligence,
doesn't it?

Stuffing everything into one document is not a magical cure-for-all. The
abundance of policy violations due to people simply not reading the most
essential sections of the Policy Manual indicates to me that at least some
of those people did not find their way through the 290-page manual.
And at least some of the fault for that lies on the manual, rather than
the readers.

> it was a mistake when we did it to the packaging manual, one which
> continues to make policy confusing and difficult to follow,

Actually, the main mistake there was that we conjoined the two documents
pretty much ad hoc. Had they been left separated properly, or joined
properly, there would be no confusion. The fact the generic dpkg part
of the old packaging manual was never composed into its own document
also didn't help.

You might notice that in 3.6 a lot of the confusion was eliminated.
I will continue fixing it.

-- 
     2. That which causes joy or happiness.



Reply to: