Update to r42918:

• adds missing introductory explanations and clarifies some

sections

• puts portmaster before portupgrade
• adds instructions for both portmaster/portupgrade where needed
• moves 5.6.3.1 into an Important box

Reviewed by: bcr
Differential Revision: https://reviews.freebsd.org/D5658