基本信息

源代码仓库

文档

参与进来

子项目

相关项目

其他

文档项目:Subversion

Apache HTTP 服务器的文档与代码位于同一个 Subversion 版本控制仓库中。如果您想参与文档工作,可以检出整个源代码仓库,也可以只检出文档部分。

要检出整个仓库,您需要执行以下操作

svn checkout https://svn.apache.org/repos/asf/httpd/httpd/trunk httpd-trunk
svn checkout https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x httpd-2.4

通过检出主干和 2.4 版本,您可以针对开发版本和当前最新发布版本提交补丁。

要检出仓库中仅包含文档的部分,请在上面显示的检出 URL 末尾添加 ' /docs '。这样会得到一个更小的检出内容,但您可能缺少验证文档更改所需的一些资源。

创建补丁

完成检出后,创建补丁需要四个步骤。

更新您的检出内容,确保您拥有仓库中的最新更改,以防其他人自您上次处理文档以来进行了更改。

svn update

编辑您要修改的文件。进行所需的更改,然后保存更改。文档文件位于检出内容的 /docs/manual 子目录中。

在命令行中,键入以下命令以创建补丁文件

svn diff > patch.txt

docs@httpd.apache.org 邮件列表发送电子邮件,并附加 patch.txt

如果您有多个已更改的文件,可以在 svn diff 命令行中提供文件名,以便仅记录一个文件中的更改。

svn diff mod_rewrite.xml > mod_rewrite_patch.txt

另请参阅

另请参阅有关 文档格式和转换 的文档,了解有关验证您的更改是否符合我们的文档格式和标准的详细信息。在您的电子邮件中,请说明补丁针对代码的哪个分支(主干、2.4、2.2 等)、哪些文件受到影响以及您正在进行的更改。如果它与特定错误单有关,请也提及它。