If upgrading the port requires special steps like changing configuration files or running a specific program, you should document this in the file /usr/ports/UPDATING. The format of an entry in this file is as follows:
YYYYMMDD: AFFECTS: users of portcategory/portname AUTHOR: Your name <Your email address> Special instructions
If you are including exact portmaster or portupgrading instructions, please make sure to get the shell escaping right.
If your port is deleted or renamed, you should add an entry to /usr/ports/MOVED. Entries in this file use the following format:
old name|new name (blank for deleted)|date of move|reason