[PATCH] -h output note addition: Testing of configuration can lead to a correction of path/file permissions

[Maxim Dounin]

Hello!

On Fri, Jan 12, 2018 at 09:59:37AM +0100, Jörg Kost wrote:

> still feel, that the -t switch behavior might be not so good documented. 
> In some border cases this might not be the intention of running a test.

While it might not be the intention, certainly configuration test 
is not the same as syntax check, and would never be.  The idea 
behind configuration test is to be able to check that nginx will 
be able to start with the configuration in question, but without 
actually starting it - to avoid interference with already running 
nginx, if any.

Configuration testing may have side effects, this is expected.  
Some of these side effects are documented at 
http://nginx.org/en/docs/switches.html, though certainly there are 
others.

If you think that the documentation is insufficient - consider 
submitting a patch to improve it.  If you think that certain side 
effects should be avoided - feel free to submit a patch to avoid 
them.

> Currently it will log this things to the error file only on failure, but 
> I am thinking of a more general approach -> always log?

Not sure it's a good idea.

-- 
Maxim Dounin
http://mdounin.ru/