On 9/24/13 6:24 PM, Florian Obser wrote:
OpenBSD is working on replacing the (heavily patched) apache 1.3 in
base with nginx. During that work the question was raised if we can
have a nginx.conf(5) man page.
Nice to hear.
As a proof of concept I put a perl script together which scrapes the
pages on http://nginx.org/en/docs/ (below “Modules reference”) and
generates a mdoc(7) file.
- what’s the license of the documentation?
It’s under the same license as the whole nginx distribution:
- is the documentation on http://nginx.org/en/docs/ generated from some
sort of source file? Parsing the html works reasonably well but is not
It is generated from xml files. The whole nginx.org repository is
public (see “Source Code” section):
Also, you can explore it online:
Please note that http://nginx.org/en/docs/ has documentation
for nginx f/oss and nginx-plus, our commercial product under
The features available in nginx-plus only have an appropriate note
in the documentation.
- would there be interest to include a man page into the distribution
once it’s ready?
I think it’s a good idea while we manage to keep a single source for
both nginx.org docs and man page.