I tend to think that the Right Thing is to mention that each directive has documentation which says what its AllowOverride needs are.
On Jul 19, 2011, at 7:59 PM, Daniel Ruggeri wrote: > Hello, folks; > I wanted to plant a bug in everyone's ear about an issue I came across. > I'll open a formal bug and a final list of what is and is not allowed when > time permits. I have found that the documentation (example: > http://httpd.apache.org/docs/trunk/mod/core.html#allowoverride) provides an > incomplete list of directives permitted by the four AllowOverride options. > > > The bug I wanted to plant is to get opinions/thoughts on... > *How should this be organized and presented? I can foresee that this could > get "cluttery" for AllowOverride documentation. > *Should we try to document all directives? As things are added/removed the > list could get out of sync easily. > *I think it's a good idea to ad a note that the AllowOverride > documentation can't possibly cover directives for 3rd party modules that have > overrides. > *Maybe The Right Thing to do is to implement something in mod_info that > will show the overrides and point documentation there? > > > > As an example and why I brought this up: > 23 directives are called out in the documentation for AllowOverride FileInfo, > but in my research, I found these 45 directives outside of core and in the > modules directory. > > mod_charset_lite > CharsetSourceEnc > CharsetDefault > CharsetOptions > > mod_mime > AddCharset > AddEncoding > AddHandler > AddInputFilter > AddLanguage > AddOutputFilter > AddType > DefaultLanguage > MultiviewsMatch > RemoveCharset > RemoveEncoding > RemoveHandler > RemoveInputFilter > RemoveLanguage > RemoveOutputFilter > RemoveType > > mod_actions > Action > > mod_alias > Redirect > RedirectMatch > RedirectTemp > RedirectPermanent > > mod_negotiation > LanguagePriority > ForceLanguagePriority > > mod_rewrite > RewriteEngine > RewriteOptions > RewriteBase > RewriteCond > RewriteRule > > mod_env > PassEnv > SetEnv > UnsetEnv > > mod_headers > Header > RequestHeader > > mod_setenvif > SetEnvIf > SetEnvIfNoCase > BrowserMatch > BrowserMatchNoCase > > mod_usertrack > CookieExpires > CookieDomain > CookieStyle > CookieTracking > CookieName > > -- > -- > -- Rich Bowen rbo...@rcbowen.com rbo...@apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscr...@httpd.apache.org For additional commands, e-mail: docs-h...@httpd.apache.org
