Hi Donovan,

Donovan Watteau wrote on Sat, Jan 11, 2014 at 04:18:59PM +0100:

> OpenBSD now provides an nginx.conf(5) manual page and I love this,
> thanks!

Florian, who did all the work on the formatting, will no doubt
enjoy that statement.  :)

> But it ends with an EXAMPLES section which only deals with some
> horrible use of whitespace, which is "not recommended".  I don't
> get it.  This manpage is a relief, but it ends in a really sad
> and not really useful way...  I'd rather see a mention that this
> manpage is an OpenBSD improvement!

Heh...  You propose to remove one of the two parts of the text
that was originally written for OpenBSD (by me, actually) and
in the same patch, you propose to claim this page as an OpenBSD
invention.  That's kind of contradictory.  ;-)

Almost all of the text comes from upstream:
  http://nginx.org/en/docs/#development
For that reason, i object to the wording "first appeared in",
it is misleading.

However, if somebody wants to commit something like the following,
that would be fine with me.

Yours,
  Ingo


Index: nginx.conf.5
===================================================================
RCS file: /cvs/src/usr.sbin/nginx/man/nginx.conf.5,v
retrieving revision 1.6
diff -u -p -r1.6 nginx.conf.5
--- nginx.conf.5        16 Dec 2013 11:19:03 -0000      1.6
+++ nginx.conf.5        11 Jan 2014 17:53:49 -0000
@@ -8736,3 +8736,17 @@ www;# but not here
 .Ed
 .Sh SEE ALSO
 .Xr nginx 8
+.Sh HISTORY
+This manual has been available since
+.Ox 5.5 .
+.Sh AUTHORS
+.An -nosplit
+The bulk of the text was semi-automatically converted
+from the XML sources of
+.Lk http://nginx.org/en/docs/#development
+to
+.Xr mdoc 7
+by
+.An Florian Obser Aq Mt [email protected] .
+The description of the grammar was written by
+.An Ingo Schwarze Aq Mt [email protected] .

Reply via email to