openbsd-wip - OpenBSD 开发中的软件包

此代码树用于维护并最终将软件包迁移到官方的 OpenBSD 软件包树中。这意味着此代码树中的软件包正在积极开发中，可能并不总能成功构建，但当然最好以成功构建软件包为目标。

此工作的目标是让更多人积极参与到软件包的开发中。同时，拥有一个工具来更好地跟踪那些（半）完成的软件包，而不是让它们在某封邮件列表的角落里腐烂。

已更新的软件包

也欢迎更新；请通过移除已在上游更新/导入的软件包来保持此代码树的整洁。

如果您正在导入一个更新，请在软件包目录中添加一个 UPDATE 文件，其中包含变更摘要/说明。这将有助于区分更新和新软件包。

如果是一个相当简单的更新，请不要麻烦在此导入，只需将 diff 发送给 ports@ 和/或维护者即可。

已完成的软件包

当一个软件包准备好提交时，请按照以下格式（可能会更改）在 /FINISHED 中添加一个条目：

net/gnaughty:	准备导入，已发送给 ports@ (jasperla)

使用 TODO 文件列出在软件包可以列入 FINISHED 之前存在的未解决问题。

此外，请只提交完整的软件包。不要只提交一个 Makefile 或一个 diff。

管理文件

由于本仓库的主要目标之一是减轻提交者的工作负担，请使用以下文件来保持对当前内容的概览：

FINISHED: 如上所述
TODO: 位于 ports 目录中的文件，说明需要完成的工作
UPDATE: 说明更新内容，可能包含可直接使用的提交信息？ :)
ABANDONED: 近年来没有任何活动，且不存在任何会阻止其导入 CVS 的许可证限制的端口。

工作流程（开放讨论）

在此提交你更新的端口，并附上相应的 UPDATE 文件。
或者在此提交你新的端口 WIP 更新，并附上 TODO/UPDATE 文件，然后继续开发。
发送邮件给 ports@ 和/或维护者。
在 FINISHED 中添加一条条目。
当端口被提交后，移除 FINISHED 条目以及该端口。

本仓库并非旨在让人们停止使用 ports@。在此发布的端口不太可能获得在 ports@ 上所能达到的讨论和测试水平。因此，本仓库旨在跟踪这些提交。

如果你不想再继续开发你未完成或尚未提交的端口，请将其从仓库中移除。将来，其他人可以从 git 历史中恢复你的工作。维护该仓库可以防止其变成被废弃端口的墓地。

分支

理想情况下，此仓库应只包含一个分支，所有开发都在该分支上进行。如果你想创建一个功能分支，请考虑避免这样做。大多数情况下，你的功能分支会与 master 不同步，导致合并困难，并且过一段时间后，在仓库中难以定位。大多数情况下，你只需编辑少数几个端口，因此直接在 master 中编辑它们即可。如果你确实需要一个功能分支，请在确定事情是否成功后，尽快将其合并回去。

如何使用此树

使用此树的一种方法是将其克隆到你的 /usr/ports/ 目录，并在 /etc/mk.conf 中相应地调整 PORTSDIR_PATH：

PORTSDIR_PATH=${PORTSDIR}:${PORTSDIR}/openbsd-wip:${PORTSDIR}/mystuff

在上面的示例中，cvs 中有一个版本为 1 的端口，openbsd-wip 中有一个版本为 2 的端口。然后，cvs 中的版本会在 openbsd-wip 中的版本之前被选取。如果你使用 dpb 构建软件包，这一点很重要。 PORTSDIR_PATH 的顺序很重要。

为了防止 "merge commits" 出现在 git log 中，建议使用以下命令更新你的树：

git fetch && git rebase origin

或者在本地 openbsd-wip 仓库的 .git/config 中设置以下选项（参见 branch.<name>.rebase 和 branch.autosetuprebase 上的 git-config(1)）：

git config branch.master.rebase true

如何贡献

如果你需要此仓库的写入权限，请告诉我。但请遵循本文档中概述的工作流程以及 https://www.openbsd.org/faq/ports/index.html 中的指引