Welcome! Log In Create A New Profile

Advanced

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Maxim Dounin
September 01, 2023 08:52PM
Hello!

On Wed, Aug 30, 2023 at 12:34:16AM +0300, Sergey A. Osokin wrote:

> Hi,
>
> On Tue, Aug 29, 2023 at 09:21:54PM +0300, Maxim Dounin wrote:
> > > <para>
> > > Enables the specified protocols.
> > > +
> > > +<para>
> >
> > $ make
> > ...
> > xmllint --noout --valid xml/en/docs/http/ngx_http_ssl_module.xml
> > xml/en/docs/http/ngx_http_ssl_module.xml:626: element para:
> > validity error : Element para is not declared in para list of
> > possible children
> > </para>
> > ^
> > gmake[1]: *** [GNUmakefile:164:
> > libxslt/en/docs/http/ngx_http_ssl_module.html] Error 4
> >
> > In this particular case, appropriate solution would be to close
> > the paragraph, and put notes into their own paragraph.
>
> Fixed.
>
> > > +If the directive is specified on the <link id="server"/> level,
> > > +the value from the default will be used.
> >
> > s/the default/the default server/
>
> Fixed.
>
> > Also, reading it again I tend to think that "will be used" might
> > be misleading. It might be good to adjust this somehow to make it
> > clear that ssl_protocols works if used in the default server, but
> > will use the configuration from the default server if used in a
> > name-based virtual server. Not sure how though.
> >
> > Alternatively, just using "can be used" as in other directives
> > might be good enough.
>
> Fixed.
>
> > > +Defails are provided in the
> >
> > s/Defails/Details/
>
> Fixed.
>
> [...]
> > > +</para>
> > > +
> > > <note>
> > > Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal>
> > > (1.1.13, 1.0.12) работают только при использовании OpenSSL 1.0.1 и выше.
> >
> > Same here.
>
> Fixed. Here's the update version of the patch, thanks.
>
> # HG changeset patch
> # User Sergey A. Osokin <osa@FreeBSD.org.ru>
> # Date 1693344638 -10800
> # Wed Aug 30 00:30:38 2023 +0300
> # Node ID 44c3f59a54333249114428eaae2005eabdc57e36
> # Parent 4e25281328fa2152cadedc52e05f8a1b1bf531cd
> Updated ngx_http_ssl_module module documentation.
>
> Provided details about ssl_protocol directive usage by
> adding link to the "Server names" document.
>
> diff -r 4e25281328fa -r 44c3f59a5433 xml/en/docs/http/ngx_http_ssl_module.xml
> --- a/xml/en/docs/http/ngx_http_ssl_module.xml Tue Aug 29 09:11:57 2023 +0100
> +++ b/xml/en/docs/http/ngx_http_ssl_module.xml Wed Aug 30 00:30:38 2023 +0300
> @@ -10,7 +10,7 @@
> <module name="Module ngx_http_ssl_module"
> link="/en/docs/http/ngx_http_ssl_module.html"
> lang="en"
> - rev="61">
> + rev="62">
>
> <section id="summary">
>
> @@ -602,6 +602,17 @@
>
> <para>
> Enables the specified protocols.
> +</para>
> +
> +<para>
> +If the directive is specified on the <link id="server"/> level,
> +the value from the default server can be used.
> +Details are provided in the
> +“<link doc="server_names.xml" id="virtual_server_selection">Virtual
> +server selection</link>” section.
> +</para>
> +
> +<para>
> <note>
> The <literal>TLSv1.1</literal> and <literal>TLSv1.2</literal> parameters
> (1.1.13, 1.0.12) work only when OpenSSL 1.0.1 or higher is used.
> diff -r 4e25281328fa -r 44c3f59a5433 xml/ru/docs/http/ngx_http_ssl_module.xml
> --- a/xml/ru/docs/http/ngx_http_ssl_module.xml Tue Aug 29 09:11:57 2023 +0100
> +++ b/xml/ru/docs/http/ngx_http_ssl_module.xml Wed Aug 30 00:30:38 2023 +0300
> @@ -10,7 +10,7 @@
> <module name="Модуль ngx_http_ssl_module"
> link="/ru/docs/http/ngx_http_ssl_module.html"
> lang="ru"
> - rev="61">
> + rev="62">
>
> <section id="summary">
>
> @@ -607,6 +607,17 @@
>
> <para>
> Разрешает указанные протоколы.
> +</para>
> +
> +<para>
> +Если директива указана на уровне <link id="server"/>, то может
> +использоваться значение из сервера по умолчанию.
> +Подробнее см. в разделе
> +“<link doc="server_names.xml" id="virtual_server_selection">Выбор
> +виртуального сервера</link>”.
> +</para>
> +
> +<para>
> <note>
> Параметры <literal>TLSv1.1</literal> и <literal>TLSv1.2</literal>
> (1.1.13, 1.0.12) работают только при использовании OpenSSL 1.0.1 и выше.

Looks good.

--
Maxim Dounin
http://mdounin.ru/
_______________________________________________
nginx-devel mailing list
nginx-devel@nginx.org
https://mailman.nginx.org/mailman/listinfo/nginx-devel
Subject Author Views Posted

[PATCH] Provided more details about ssl_protocol directive usage by

Sergey A. Osokin 421 August 29, 2023 11:30AM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Maxim Dounin 128 August 29, 2023 12:04PM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Sergey A. Osokin 132 August 29, 2023 01:56PM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Maxim Dounin 124 August 29, 2023 02:22PM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Sergey A. Osokin 120 August 29, 2023 04:00PM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Sergey A. Osokin 121 August 29, 2023 05:36PM

Re: [PATCH] Provided more details about ssl_protocol directive usage by

Maxim Dounin 137 September 01, 2023 08:52PM



Sorry, you do not have permission to post/reply in this forum.

Online Users

Guests: 203
Record Number of Users: 8 on April 13, 2023
Record Number of Guests: 500 on July 15, 2024
Powered by nginx      Powered by FreeBSD      PHP Powered      Powered by MariaDB      ipv6 ready