December 05, 2019 06:06AM
On Sun, Dec 01, 2019 at 04:41:23AM +0300, Sergey A. Osokin wrote:
> # HG changeset patch
> # User Sergey A. Osokin <osa@FreeBSD.org.ru>
> # Date 1575163872 -10800
> # Sun Dec 01 04:31:12 2019 +0300
> # Node ID 477a78d1b14e415a80b6bfb3d829eb408f33f390
> # Parent d13eddd9e2529b4bc30dc00aad959bd10ced4c33
> Update nginx(8) manual page.
> Sort the command line options.
>
> diff -r d13eddd9e252 -r 477a78d1b14e docs/man/nginx.8
> --- a/docs/man/nginx.8 Tue Nov 19 17:18:58 2019 +0300
> +++ b/docs/man/nginx.8 Sun Dec 01 04:31:12 2019 +0300
> @@ -1,5 +1,5 @@
> .\"
> -.\" Copyright (C) 2010 Sergey A. Osokin
> +.\" Copyright (C) 2010, 2019 Sergey A. Osokin
> .\" Copyright (C) Nginx, Inc.
> .\" All rights reserved.
> .\"

The document date should be updated.

> @@ -42,9 +42,9 @@
> .Nm
> (pronounced
> .Dq engine x )
> -is an HTTP and reverse proxy server, as well as a mail proxy server.
> -It is known for its high performance, stability, rich feature set, simple
> -configuration, and low resource consumption.
> +is an HTTP and reverse proxy server, a mail proxy server, and a generic
> +TCP/UDP proxy server. It is known for its high performance, stability,
> +rich feature set, simple configuration, and low resource consumption.

Each new sentence should start on its own line.

> .Pp
> The options are as follows:
> .Bl -tag -width ".Fl d Ar directives"
> @@ -91,16 +91,16 @@
> Same as
> .Fl t ,
> but additionally dump configuration files to standard output.
> +.It Fl v
> +Print the
> +.Nm
> +version.
> .It Fl V
> Print the
> .Nm
> version, compiler version, and
> .Pa configure
> script parameters.
> -.It Fl v
> -Print the
> -.Nm
> -version.
> .El
> .Sh SIGNALS
> The master process of

In ASCII, capital letters come first, and mdoc(7) follows the same
sorting order. The correct fix would be to interchange -T with -t.

# HG changeset patch
# User Sergey A. Osokin <osa@FreeBSD.org.ru>
# Date 1575543437 -10800
# Thu Dec 05 13:57:17 2019 +0300
# Node ID 5186ed8aa6330230205b69ba05ff449457b67410
# Parent 03bd76ca0fd8ce0628503a0a4cd453fbb206bafe
Update manpage, sort command line options.

diff --git a/docs/man/nginx.8 b/docs/man/nginx.8
--- a/docs/man/nginx.8
+++ b/docs/man/nginx.8
@@ -1,5 +1,5 @@
.\"
-.\" Copyright (C) 2010 Sergey A. Osokin
+.\" Copyright (C) 2010, 2019 Sergey A. Osokin
.\" Copyright (C) Nginx, Inc.
.\" All rights reserved.
.\"
@@ -25,7 +25,7 @@
.\" SUCH DAMAGE.
.\"
.\"
-.Dd June 16, 2015
+.Dd December 5, 2019
.Dt NGINX 8
.Os
.Sh NAME
@@ -42,7 +42,8 @@
.Nm
(pronounced
.Dq engine x )
-is an HTTP and reverse proxy server, as well as a mail proxy server.
+is an HTTP and reverse proxy server, a mail proxy server, and a generic
+TCP/UDP proxy server.
It is known for its high performance, stability, rich feature set, simple
configuration, and low resource consumption.
.Pp
@@ -82,15 +83,15 @@ The following table shows the correspond
.It Cm reload
.Dv SIGHUP
.El
+.It Fl T
+Same as
+.Fl t ,
+but additionally dump configuration files to standard output.
.It Fl t
Do not run, just test the configuration file.
.Nm
checks the configuration file syntax and then tries to open files
referenced in the configuration file.
-.It Fl T
-Same as
-.Fl t ,
-but additionally dump configuration files to standard output.
.It Fl V
Print the
.Nm
_______________________________________________
nginx-devel mailing list
nginx-devel@nginx.org
http://mailman.nginx.org/mailman/listinfo/nginx-devel
Subject Author Views Posted

[PATCH] Update nginx(8) manual page

Sergey A. Osokin 484 November 30, 2019 08:42PM

Re: [PATCH] Update nginx(8) manual page

ru@nginx.com 394 December 05, 2019 06:06AM

Re: [PATCH] Update nginx(8) manual page

Sergey A. Osokin 289 December 05, 2019 07:18PM



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

Online Users

Guests: 235
Record Number of Users: 8 on April 13, 2023
Record Number of Guests: 421 on December 02, 2018
Powered by nginx      Powered by FreeBSD      PHP Powered      Powered by MariaDB      ipv6 ready