update/add comments to reflect new defintions of media fields