httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rich Bowen <rbo...@rcbowen.com>
Subject Re: NameVirtualHost and <VirtualHost>
Date Mon, 12 Jun 2006 13:53:26 GMT
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Vincent Bray wrote:
> Hi,
> http://issues.apache.org/bugzilla/show_bug.cgi?id=33656
> In response to this bug and the countless questions asked on #apache,
> I'd like to find some way to make /vhosts/name-based.html more explicit.
> The text currently states "The argument to the <VirtualHost> directive
> should be the same as the argument to the NameVirtualHost directive (ie,
> an IP address, or * for all addresses).".
> 
> Matt Lewandowsky suggests changing that sentence to: "The argument to
> the <VirtualHost> directive must be the same as the argument to an
> already-defined NameVirtualHost directive (ie, an IP address, or * for
> all addresses)."
> 
> Otherwise perhaps a box similar to "Main host goes away" with a caution
> message. Or, given that people often seem to skim the examples rather
> than reading the text, a block showing the right and wrong ways to do it.

I'm always +1 to more explicit examples, however, I'm (almost) always -1
on showing anyone the wrong way to do it. We've seen again and again
folks skimming for a grey box, cut-n-paste the example, and then ask why
it doesn't work. So we have a pretty firm policy about never showing the
wrong way to do it, even if it says in blinking red letters "WRONG WAY!!!"

So, yes, +1 to the changed phrasing and providing an example. Maybe it
will help.

- --
Rich Bowen
rbowen@rcbowen.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFEjXHWXP03+sx4yJMRAhdWAKCpblPE3TXfVPkMCbuitwAszxd+/ACgxKKT
Q8/t4KbCJ+WnXvtcgWbAB1w=
=1azf
-----END PGP SIGNATURE-----

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


Mime
View raw message