11.2.UPDATING 和 MOVED

11.2.1. /usr/ports/UPDATING

如果升级 port 需要一些特殊的步骤，例如修改配置文件或运行特定的程序，则必须在这个文件中加以记录。这个文件中的条目的格式是。

YYYYMMDD:
  AFFECTS: users of portcategory/portname
  AUTHOR: Your name <Your email address>

  Special instructions

技巧
当包括精确的 portmaster、portupgrade 和/或 pkg 说明时，请确保正确地使用 shell 转义。例如，请不要使用。
# pkg delete -g -f docbook-xml* docbook-sk* docbook[2345]??-* docbook-4*
如图所示，该命令只适用于 bourne shells。取而代之的是，使用下面所示的形式，它将在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

这个文件用于列出被移动或删除的 port 。文件中的每一行都是由 port 的名字， port 被移动的位置，时间，以及原因组成。如果 port 被移除，则详细说明其移动位置的部分可以留空。每个部分都必须用 | (pipe) 字符隔开，像这样:

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

日期必须以 YYY-MM-DD 的形式输入。新的条目会被添加到列表的末尾，以保持它的时间顺序，最早的条目在列表的顶部。

如果某个 port 被删除了，但后来又恢复了，请删除这个文件中说明它被删除的那一行。

如果一个 port 被重新命名，然后又被重新命名为原来的名字，则应在旧名字的基础上增加一个新的中间名字，并删除旧的条目，以免造成循环。

注意
任何改变都必须用 Tools/scripts/MOVEDlint.awk 来验证。
如果使用 /usr/ports 以外的 ports 目录，请使用:

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

最后更新于8个月前