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 add .
% git diff --staged

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

% git commit
% git format-patch origin/main

使用 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 中添加相关条目。