httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: Apache documentation comment
Date Mon, 11 Sep 2006 20:10:07 GMT

On Sep 8, 2006, at 06:42, Vincent Bray wrote:

> On 9/6/06, Rich Bowen <rbowen@rcbowen.com> wrote:
>> FYI - Request for documentation change. Thoughts?
>>
>> Begin forwarded message:
>>
>> > On two separate occassions, I have confused
>> > DescriptionWidth for NameWidth in the IndexOptions
>> > Directive. I don't assume that other Apache users
>> > often mistake the two, but wouldn't it be advisable to
>> > put a note or emphasis under the explanation of
>> > DescriptionWidth that it does *not* adjust filename
>
> -1
>
> As you suggested to me previously in relation to the vhost docs,
> showing how not to do something, even surrounded by flashy red letters
> will lead some people to do just that.

Yes, I tend to agree. Also, listing all the things that a particular  
directive doesn't do could have scalability problems. ;-)

--
rbowen@rcbowen.com
Come to ApacheCon US 2006!
http://us.apachecon.com/




---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message