branches: 1.2.32;
- convert sun2/upgrade to use ../sun3/upgrade, rather than unnecessarily
duplicating the contents of the latter
- fix some types in sun3/upgrade

branches: 1.1.2;
Added sun2 content to the release notes.

Pull up revision 1.2 (requested by lukem):
- convert sun2/upgrade to use ../sun3/upgrade, rather than unnecessarily
duplicating the contents of the latter
- fix some types in sun3/upgrade

Sync with HEAD.