[PATCH] Documented the http2 directive

Sergey Kandaurov pluknet at nginx.com
Tue Jun 13 14:14:22 UTC 2023


> On 13 Jun 2023, at 17:56, Yaroslav Zhuravlev <yar at nginx.com> wrote:
> 
> xml/en/docs/http/ngx_http_core_module.xml |  13 +++++++++----
> xml/en/docs/http/ngx_http_grpc_module.xml |   6 ++++--
> xml/en/docs/http/ngx_http_v2_module.xml   |  22 ++++++++++++++++++++--
> xml/ru/docs/http/ngx_http_core_module.xml |   8 ++++++--
> xml/ru/docs/http/ngx_http_grpc_module.xml |   6 ++++--
> xml/ru/docs/http/ngx_http_v2_module.xml   |  22 ++++++++++++++++++++--
> 6 files changed, 63 insertions(+), 14 deletions(-)
> 
> 
> # HG changeset patch
> # User Yaroslav Zhuravlev <yar at nginx.com>
> # Date 1686664161 -3600
> #      Tue Jun 13 14:49:21 2023 +0100
> # Node ID d0b3b7889bfa45ce03845acdc51919463f455874
> # Parent  2fa6471cd138071038f055031a7a379a7e9ab108
> Documented the http2 directive.
> 
> diff --git a/xml/en/docs/http/ngx_http_core_module.xml b/xml/en/docs/http/ngx_http_core_module.xml
> --- a/xml/en/docs/http/ngx_http_core_module.xml
> +++ b/xml/en/docs/http/ngx_http_core_module.xml
> @@ -10,7 +10,7 @@
> <module name="Module ngx_http_core_module"
>         link="/en/docs/http/ngx_http_core_module.html"
>         lang="en"
> -        rev="105">
> +        rev="106">
> 
> <section id="directives" name="Directives">
> 
> @@ -1378,12 +1378,17 @@
> handles both HTTP and HTTPS requests.
> </para>
> 
> -<para>
> -The <literal>http2</literal> parameter (1.9.5) configures the port to accept
> -<link doc="ngx_http_v2_module.xml">HTTP/2</link> connections.
> +<para id="http2">

this anchor looks unused

> +The <literal>http2</literal> parameter (1.9.5) configures the port
> +to accept <link doc="ngx_http_v2_module.xml">HTTP/2</link> connections.

unnecessary line re-wrap

> Normally, for this to work the <literal>ssl</literal> parameter should be
> specified as well, but nginx can also be configured to accept HTTP/2
> connections without SSL.
> +<note>
> +The parameter is deprecated,
> +the <link doc="ngx_http_v2_module.xml" id="http2">http2</link> directive
> +should be used instead.
> +</note>
> </para>

[..]

-- 
Sergey Kandaurov


More information about the nginx-devel mailing list