3.6.提交新的 port

在提交新的 Port 之前，请阅读 DOs 和 DON’Ts 部分。

如果你对 Port 满意，剩下的就是将它放入 FreeBSD 的主 Ports 树，并让其他人也为它高兴。

重要

我们不需要 work 目录或 pkgname.txz 包，所以现在就删除它们。

接下来，创建一个 patch(1) 文件。假设该 Port 名为 oneko，并位于 games 分类下。

示例 1. 为新 Port 创建 .diff 文件

使用 git add . 添加所有文件，然后用 git diff 查看差异。例如：

% git add .
% git diff --staged

确保所有必要的文件都已包括，然后将更改提交到本地分支，并使用 git format-patch 生成补丁：

% git commit
% git format-patch origin/main

使用 git format-patch 生成的补丁会包括作者的身份和电子邮件地址，使开发人员能够更容易地应用补丁（使用 git am），并给予适当的信用。

为了方便提交者在其 Ports 树的工作副本中应用补丁，请从 Ports 树的根目录生成 .diff 文件。

通过 问题报告提交表单 提交 oneko.diff。选择产品 "Ports & Packages"，组件 "Individual Port(s)"，并遵循那里显示的指南。在 PR 的描述字段中添加该程序的简短描述（也许是 COMMENT 的简短版本），并记得将 oneko.diff 作为附件添加。

注意

在问题报告的总结中给出一个好的说明，可以让 Port 提交者和分类员的工作变得更容易。新 Port 的预期格式是 "[NEW PORT] 类别/port 名 port 简要描述"。使用这个格式可以让提交新 Port 的工作开始得更快更顺利。

提交 Port 后，请耐心等待。将新 Port 纳入 FreeBSD 的时间可能从几天到几个月不等。可以通过 https://bugs.freebsd.org/bugzilla/query.cgi 搜索问题报告数据库的简单搜索表单。

要列出 Open 状态的 Port PR，可以在搜索表单中选择 Open 和 Ports & Packages，然后点击 Search。

在查看新 Port 后，我们会根据需要回复，并将其提交到树中。提交者的名字也会被添加到 Additional FreeBSD Contributors 和其他文件的列表中。

重要

之前提交新 Port 的补丁可以使用 shar(1) 文件；但随着 git(1) 的发展，这已经不再是有效的方式。提交者现在不再接受 shar(1) 文件，因为它容易出错，并且不会在分类的 Makefile 中添加相关条目。