11.2.UPDATING 和 MOVED

11.2.1. /usr/ports/UPDATING

如果升级 Port 需要特定步骤，例如更改配置文件或运行特定程序，必须在此文件中记录。文件中的条目格式如下：

YYYYMMDD:
  AFFECTS: users of portcategory/portname
  AUTHOR: 你的名字 <你的电子邮箱地址>

  Special instructions

技巧

在包含确切的 portmaster、portupgrade、pkg 指令时，请确保正确处理 shell 转义。例如，不要 使用：

# pkg delete -g -f docbook-xml* docbook-sk* docbook[2345]??-* docbook-4*

如上所示，此命令仅在 Bourne Shell 下有效。或使用如下形式，该形式在 Bourne Shell 和 C-Shell 下均可正常工作：

# pkg delete -g -f docbook-xml\* docbook-sk\* docbook\[2345\]\?\?-\* docbook-4\*

注意

推荐 AFFECTS 行包含一个匹配所有受此条目影响的 Port 的 glob，以便自动化工具可以尽可能轻松地解析它。如果更新涉及所有现有的 BIND 9 版本，则 AFFECTS 内容应为 users of dns/bind9*，而不应为 users of BIND 9。

11.2.2. /usr/ports/MOVED

此文件用于列出被移动或删除的 Ports。文件中的每一行由 Port 的名称、该 Port 移动到的位置、移动日期以及原因组成。如果 Port 被删除，可以将移动位置部分留空。每个部分必须用 |（管道）字符分隔，如下所示：

old name|new name (blank for deleted)|date of move|reason

日期必须以 YYYY-MM-DD 的形式输入。新条目会被添加到列表的末尾，以保持按时间顺序排列，最旧的条目位于顶部。

如果某个 Port 被删除但后来又恢复了，删除该文件中记录其被删除的行。

如果某个 Port 被重命名后又恢复为原名称，需将中间的名称条目添加到旧名称的条目下，并删除旧的条目以避免形成循环。

注意

任何更改都必须通过 Tools/scripts/MOVEDlint.awk 进行验证。如果使用的是 /usr/ports 以外的 Ports 目录，使用以下命令：

% cd /home/user/ports
% env PORTSDIR=$PWD Tools/scripts/MOVEDlint.awk