Config directive inheritance: docs and rules (was: Config variable inheritance)

[Maxim Dounin]

Hello!

On Wed, Apr 04, 2012 at 05:54:44PM +0100, Francis Daly wrote:

[...]

> If that's an adequate analysis, it suggests that
> 
>   allow/deny and xslt_param/xslt_string_param
> 
> are the only distributed directives which don't follow the
> replace-or-inherit-this-directive-only method.

Mechanical analisys of the codebase might miss some cases with 
custom directive handlers used.  But I suppose the result is 
correct as it matches one from my memory.  :)

> > All such cases are more or less obvious though.
> 
> I wonder, is it worth having a note in the documentation for these
> exceptions to the common case?
> 
> I see that there is such a note at
>  
> http://nginx.org/en/docs/http/ngx_http_xslt_module.html#xslt_param,
> 
> but not (yet) at
> 
> http://nginx.org/en/docs/http/ngx_http_access_module.html#allow

Yes, this surely deserves a note.

Maxim Dounin