add option changes to notes on upgrading

closes #1524