贡献改变
Getting Sources Formatting Changes Before Submitting Submitting Changes License |
获取来源
Mercurial用于存储源代码。可以使用以下命令克隆 存储库:
hg clone http://hg.nginx.org/nginx
格式更改
更改的格式应根据 nginx 使用的代码风格进行。有时,没有明确的规则;在这种情况下,请检查现有 nginx 源的格式并模仿这种风格。如果样式与周围的代码相对应,则更改将更有可能被接受。
提交更改以创建 Mercurial 变更集。请确保指定的 电子邮件 地址和更改作者的真实姓名正确。
提交消息应该有一个单行概要,空行后面跟着详细描述。第一行最好不超过 67 个符号。可以使用以下命令获取作为补丁的生成的变更集
hg export
:
# 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 扩展。
执照
提交更改意味着授予项目在适当的许可 下使用它的权限。