Bring Porters Handbook up to date and fix small errors. CH 3

[ak]

Summary

• Add closing bracket and change wording slightly
• Use check-plist instead of check-orphans as more preferred target
• Update package format to pkgng one
• Update link to open ports prs

[mat]

en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml

388 ↗

(On Diff #2119)

That is somewhat wrong, I don't think we should hardcode such urls, it would be better to tell people to go to /bugzilla and where to click.

[ak]

That is somewhat wrong, I don't think we should hardcode such urls, it would be better to tell people to go to /bugzilla and where to click.

While it looks somewhat ugly, this url is stable and shouldn't change in observable future. So it's convenience versus aesthetics.

[gjb]

Is there a reason doceng@ is added, instead of a more wider audience?

I see no reason for doceng@ to be involved in review of such a trivial change.

[wblock]

en_US.ISO8859-1/books/porters-handbook/quick-porting/chapter.xml

133 ↗

(On Diff #2119)

The colon was used as a vertical ellipsis there (...). It might be reasonable to replace it with a real ellipsis or an explanation:

the screen.
<replaceable>...additional description lines...</replaceable>

WWW: http://www.oneko.org/</programlisting>

145 ↗

(On Diff #2119)

No whitespace after the paren, put it on the next line.

388 ↗

(On Diff #2119)

The parameters could change, yes.

[ak]

• Use check-plist instead of check-orphans as more preferred target
• Update package format to pkgng one