贡献更改
获取源代码 格式更改 提交之前 提交更改 网站 许可证 |
获取源代码
Mercurial 用于存储源代码。可以使用以下命令克隆仓库:
hg clone http://hg.nginx.org/nginx
格式更改
更改应根据 nginx 使用的代码风格进行格式化。有时,没有明确的规则;在这种情况下,应查看现有的 nginx 源代码的格式,并模仿此风格。如果风格与周围代码相符,则更改更有可能被接受。
提交更改以创建 Mercurial changeset。请确保更改的作者的指定电子邮件地址和真实姓名是正确的。
提交消息应该有一行摘要,然后是一个空行后的详细说明。第一行最好不要超过 67 个字符。可以使用 hg export
命令获取结果 changeset 作为补丁:
# HG changeset patch # User Filipe Da Silva <username@example.com> # Date 1368089668 -7200 # Thu May 09 10:54:28 2013 +0200 # Node ID 2220de0521ca2c0b664a8ea1e201ce1cb90fd7a2 # Parent 822b82191940ef309cd1e6502f94d50d811252a1 Mail: removed surplus ngx_close_connection() call. It is already called for a peer connection a few lines above. diff -r 822b82191940 -r 2220de0521ca src/mail/ngx_mail_auth_http_module.c --- a/src/mail/ngx_mail_auth_http_module.c Wed May 15 15:04:49 2013 +0400 +++ b/src/mail/ngx_mail_auth_http_module.c Thu May 09 10:54:28 2013 +0200 @@ -699,7 +699,6 @@ ngx_mail_auth_http_process_headers(ngx_m p = ngx_pnalloc(s->connection->pool, ctx->err.len); if (p == NULL) { - ngx_close_connection(ctx->peer.connection); ngx_destroy_pool(ctx->pool); ngx_mail_session_internal_server_error(s); return;
提交之前
在提交更改之前,有几点值得考虑:
- 建议的更改应该在广泛范围的支持平台上正常工作。
- 尽量清楚地解释为何需要建议的更改,并提供用例(如果可能的话)。
- 通过测试套件的更改是确保它们不会导致退化的好方法。可以使用以下命令克隆带有测试的仓库:
hg clone http://hg.nginx.org/nginx-tests
提交更改
建议的更改应发送到nginx 开发邮件列表。提交更改集的首选和方便方法是使用patchbomb扩展。
网站
GitHub 用于存储此网站的源代码。文档更改应作为拉取请求提交。
许可证
提交更改意味着授予项目在适当的许可证下使用它的权限。