Hello!

On Wed, Feb 05, 2014 at 03:10:03PM +0000, Francis Daly wrote:

> On Wed, Feb 05, 2014 at 05:52:21PM +0400, Maxim Dounin wrote:
> > On Wed, Feb 05, 2014 at 01:33:34PM +0000, Francis Daly wrote:
>
> Hi there,
>
> > > Can you say where you got that impression? Perhaps documentation can be
> > > clarified or corrected.
> >
> > It looks like add_header documentation doesn't have our usual
> > clause for array-like directives, and something like this should
> > be helpful:
>
> I'm not sure where the best place for it is; but I'd suggest not putting
> this on every directive, but only marking the few that don't follow the
> common inheritance rules.
>
> And then have an obvious document which describes what the common
> inheritance rules are.

Having some generic description of directive inheritance is
certainly a plus (just in case, it likely should be in
/syntax.xml, which currently only contains some basics about size
and time units and needs to be actually written), but it's yet to
find somebody who'll sign up for this work.

On the other hand, writing this information explicitly for
array-like directives matches our current practice and seems to
help a lot. Especially keeping in mind that there are only a few
array-like directives where inheritance is important, and most of
them already have the clause in question.

[...]

--
Maxim Dounin
http://nginx.org/

_______________________________________________
nginx mailing list
nginx@nginx.org
http://mailman.nginx.org/mailman/listinfo/nginx