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 等)、哪些文件受到影响以及您正在进行的更改。如果它与特定错误单有关,请也提及它。