Contributing Changes

贡献更改

获取源代码

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 用于存储此网站的源代码。文档更改应作为拉取请求提交。

许可证

提交更改意味着授予项目在适当的许可证下使用它的权限。