added UPGRADING, improved package notes. refs #265