"Doing the deed" on portupgrade

[Chris Rees]

Hi all,

Even since its deprecation, portupgrade has proven to be very popular
with newcomers, which I might be inclined to blame on the fact that
the Handbook lists it first.

Two patches:

http://www.bayofrum.net/~crees/patches/move-portupgrade.diff -- move
the portupgrade section to the bottom

http://www.bayofrum.net/~crees/patches/deprecate-portupgrade.diff --
add a note to suggest it's a bad idea to use it.

Rendered at http://www.bayofrum.net/~crees/rendered/portupgrade.html

Thoughts?  Anyone want to risk approving it?

Chris