Suggested improvements for ports

[Mark Linimon]

On Fri, Jan 11, 2008 at 11:10:45AM -0600, Paul Schmehl wrote:
> The porters handbook seems written from the standpoint of a guide more
> than a manual.

That's something that I was going to work on, um, last year :-)

We need both.  Right now we have this hybrid which isn't a completely
satisfactory solution for either one.

This is historical; it kind of grew out of an initial short how-to
document, then, as new things were stuffed into the ports infrastructure,
there was no better place to document them.

The "quick porting" text should turn into a "guide"; the "slow porting"
text should become the reference.

Of course, I say this, without the cycles to work on it.

mcl