3.6.提交新的 port
在提交新的 Port 之前,请阅读 [3.6 DOs and DON'Ts] 部分。
对 Port 感到满意之后,只剩下将其放入主 FreeBSD Ports 中,以及确保其他人也对此满意了。
重要:
我们不需要
.work
目录或.pkgname.txz
包,因此现在可以将它们删除。
接下来,创建一个 .diff
文件,假设 Port 名称为 oneko
,位于 games
类别中。
3.6.1 创建一个 .diff 文件用于新的 Port
首先,将所有文件添加到 Git 中,然后使用 git diff
查看差异。例如:
确保所有所需文件都已包含,然后将更改提交到您的本地分支,并使用 git format-patch
生成补丁:
使用 git format-patch
生成的补丁将包含作者身份和电子邮件地址,这会使开发人员更容易应用(使用 git am
)并给予适当的荣誉。
重要:
为了使提交者能够在他们 ports 的工作副本上更轻松地应用补丁,请从 ports 的基本位置生成
.diff
文件。
使用 bug submission form 提交 oneko.diff
。使用产品“Ports & Packages”,组件“Individual Port(s)”,并按照其中显示的指南操作。在问题报告的“描述”字段中添加程序的简短描述(可能是 COMMENT
的简短版本),并记得将 oneko.diff
作为附件添加。
注意:
在问题报告的摘要中提供一个好的描述可以极大地简化 port 提交者和处理人员的工作。新 port 的预期格式是“[NEW PORT] category/portname port 的简短描述”。使用这个方案可以更轻松、更快地开始提交新 port 的工作。
提交 port 后,请耐心等待。将新 port 包含在 FreeBSD 中所需的时间可能会从几天到几个月不等。可以在Problem Report database中进行简单的搜索。
要获取“打开”的 port 问题报告列表,选择搜索表单中的“Open”和“Ports & Packages”,然后单击“Search”按钮。
在查看了新的 port 后,如果需要,我们会进行回复,并将其提交到树中。提交者的名字还将被添加到Additional FreeBSD Contributors等文件中。
重要:
随着 [3.6 The Evolution of Git] 的发展,以前可以使用 [3.6.2 Using a shar File to Submit New Ports] 文件提交新 port 的补丁;现在不再适用。提交者不再接受 [3.6.3 The Problem with Using shar] 文件,因为使用这种文件容易出错,而且不会在类别的
.Makefile
中添加相关条目。
最后更新于