Update upgrading notes with a description of deprecated flags