FreeBSD Porter's Handbook
Prev | Chapter 10 Upgrading an Individual Port | Next

# 10.2 The Files `UPDATING` and `MOVED`

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

The changes can be validated with `Tools/scripts/MOVEDlint.awk`.

Prev | Home | Next
Upgrading an Individual Port | Up | Ports Security

For questions about the FreeBSD ports system, e-mail <ports@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.