5.2 命名

5.2.2.1 PORTREVISION (port 的修订版本号)

　　PORTEREVISION 变量是一个单调递增的值， 如果不为 0， 就会被加到包名的后面， 当 PORTVERSION 增加 的时候应被置 0 (也就是当官方有新版本发布的时候)。 PORTREVISION 会被自动化工具 (比如 pkg_version(1)) 用来检测是否存在可用的新版本。

　　每当 port 发生变化并对生成的 package 的内容或结构有显著影响时， 都应增加 PORTREVISION 值。

　　下面是一些应当修改 PORTREVISION 的情况：

• 有新的补丁用来修正安全漏洞、 错误， 或给 port 添加了新的功能。

• 修改了 Makefile 里编译时开启或禁用的选项。

• 修改了要安装文件的列表或安装时的行为 (例如， 修改了一个用来给 package 初始化数据的脚本， 如 ssh host keys)。

• 一个port依赖的共享库版本改变 (在这种情况下， 当安装了新版本的共享库， 后再去安装较早的软件就会出错， 因为它们要依赖老的 libfoo.x 而不是libfoo.(x+1))。

• 原作者修改了 port distfile， 并且 distfile 的新老版本之间用 diff -ru 只能发现一些细微的变化， 这时我们只需要对 distinfo 做相应的修正， 而不需要修改 PORTVERSION。

　　不需要修改 PORTREVISION 的例子：

• port 结构风格的改变， 但对于打成的包没有功能的上的变化。

• MASTER_SITES 发生变化， 或进行了对 port 功能的修改， 但不致影响最后打成的包。

• 对 distfiles 诸如修正拼写错误之类的补丁， 对用户而言没有升级上的麻烦。

• 对一个原本编译失败的包的修改， 使其可编译， 而没有加入新功能。 因为 PORTREVISION 表示包的内容发生了变化， 如果先前没有可编译的包， 也就不需要修改 PORTREVISION 来表示变化。

　　一个修改并提交 port 的原则是： 使得别人能从中受益 (改进、 修改已有错误， 或使新的 package 能够运行)， 您还要权衡一下这是否应让那些经常更新 ports 树的人升级， 如果回答是 “是” 的话， PORTREVISION 就应该修改了。

5.2.2.2 PORTEPOCH (port 的加权版本号)

　　有时软件商或 FreeBSD 的 porter 会使用比旧版的版本号小的数字做为新版本号的情况。 举例来说， 从 foo-20000801 到 foo-1.0 (从形式上来说这是不对的， 因为 20000801 在数值上比1大很多)。

　　在这种情况下， PORTEPOCH 应当增加。 如果 PORTEPOCH 非 0， 就应当加到包名字的后面。 PORTEPOCH 永远不能被减少或清零， 因为那样会导致与前一时期的 package 比较版本时产生不正确的结果。 (就是说， 那个 package 就不会被检测到已经过时了。) 新的版本号 (比如前面在前面那个例子中的 1.0,1) 在数值上比前一个版本 (20000801) 小， 但多数自动化的工具会认为 ,1 后缀意味着比前一个包的后缀 ,0 大。

　　错误的去除或重置 PORTEPOCH 会导致很多不幸发生； 如果您还不明白前面的讨论， 请多阅读几次直至明白为止， 或到邮件列表上来提问。

　　大多数 port 都不会用到 PORTEPOCH， 并且如果某个软件的下一个版本改变了版本号结构的话， 用巧妙的方法来设定 PORTVERSION 也能避免使用 PORTEPOCH。 然而， FreeBSD porter 也需要注意， 当有新版本的软件发布， 但并非正式版本时 ── 比如 “snapshot” 版本， 原作者可能会使用当时的日期来命名， 这在新的 “官方” 版本发布的时候， 就很容易引起前面提到的问题。

　　举个例子， 如果 snapshot 版本的发布日期是 20000917， 这个软件的上一个版本是1.2， 那么这个版本的 PORTVERSIN 应该设为 1.2.20000917 或类似的样子， 而不是20000917， 这样在 1.3 发布以后， 新版本就可以在数值上大于旧的版本了。

5.2.2.3 关于 PORTREVISION 和 PORTEPOCH 的用例

　　gtkmumble port，版本号 0.10， 被提交到 ports collection:

PORTNAME=       gtkmumble
PORTVERSION=    0.10

　　PKGNAME 变成 gtkmumble-0.10。

　　然后有人发现了一个安全漏洞， 需要用一个FreeBSD的补丁。 PORTREVISION 就要相应的增加。

PORTNAME=       gtkmumble
PORTVERSION=    0.10
PORTREVISION=   1

　　PKGNAME变成了 gtkmumble-0.10_1

　　软件的作者发布了新的版本， 版本为 0.2 (作者本来的意思是， 用 0.10 表示 0.1.0，“而不是指 0.9 之后的那个版本” - 但是现在太迟了)。 因为现在的次版本号 2 在数值上比上一个版本 10 小， PORTEPOCH 必须增加， 以使新的 package 被认为是 “更新的”。 由于那是作者发布的一个新版本， 因此 PORTREVISION 应被置0 (或者从 Makefile 里面删除它)。

PORTNAME=       gtkmumble
PORTVERSION=    0.2
PORTEPOCH=      1

　　PKGNAME 变成了 gtkmumble-0.2,1

　　下一个版本将会是 0.3。 由于 PORTEPOCH 从不减少， 那么就无须改动：

PORTNAME=       gtkmumble
PORTVERSION=    0.3
PORTEPOCH=      1

　　PKGNAME 变成 gtkmumble-0.3,1