Thanks for the detailed response. I am forwarding your critique to the [EMAIL PROTECTED] list where we discuss documentation improvements.
Thanks again. Joshua. > -----Original Message----- > From: Craig Arno [mailto:[EMAIL PROTECTED] > > Joshua is correct, I was looking in the wrong file. I tried to understand > why? > > I went back with Joshua's information to gain an understanding of how I > could be so wrong headed. (Normally, I'm not). I ended up with this > page: > > http://httpd.apache.org/docs/vhosts/name-based.html > > Given all my confusion with a large set of terminology new to me, and a > large body of documentation, it would help if the first heading > "Name-based vs. IP-based virtual hosts" section started with a very simple > explanation of the form; > > "Name-based virtual hosts are machines with multiple names associated with > any one particular network adapter/IP interface. i.e. > [192.168.1.1-www.myDomain1.com,www.myDomain2.org,www.myDomain3.com], > [192.168.1.2-www.myDomain4.net,www.mydomain5.com] > > "IP-based virtual hosts will associate only one domain with one or more > network adapters/IP's in the host computer." i.e. > [192.168.1.1-www.myDomain1.com], [192.168.1.2-www.myDomain2.com], > [192.168.1.3-www.myDomain3.net], etc. > > The writing rule I would apply is get directly and clearly to the point. > Save additional point development and history discussion for following > paragraphs. The first sentence and paragraph should help the user decide > they found the needed section and should keep reading. I enjoy reading > all the supporting history and thought after I am convinced I found what I > need. > > Your users, if they are anything like me, are installing and maintaining > many different applications. Each application contains large amounts of > documentation where the user must determine the logical layout and new > terminology used and navigate quickly to an answer to a question. > > This confusion is compounded when these users must update all their > applications as time permits to prevent the latest internet security > breaches. > > Now, if you've read this far, I'd like to thank Joshua for being patient, > kind and helpful while I clubbed my way through this process. > > Craig Arno > > [My problem is closed now too!] > > > On 10 Oct 2001 [EMAIL PROTECTED] wrote: > > > [In order for any reply to be added to the PR database, you need] > > [to include <[EMAIL PROTECTED]> in the Cc line and make sure the] > > [subject line starts with the report component and number, with ] > > [or without any 'Re:' prefixes (such as "general/1098:" or ] > > ["Re: general/1098:"). If the subject doesn't match this ] > > [pattern, your message will be misfiled and ignored. The ] > > ["apbugs" address is not added to the Cc line of messages from ] > > [the database automatically because of the potential for mail ] > > [loops. If you do not include this Cc, your reply may be ig- ] > > [nored unless you are responding to an explicit request from a ] > > [developer. Reply only with text; DO NOT SEND ATTACHMENTS! ] > > > > > > Synopsis: IP based Virtual Host firewall implementation must > use ifconfig IP, not DNS IP > > > > State-Changed-From-To: feedback-closed > > State-Changed-By: slive > > State-Changed-When: Wed Oct 10 11:39:53 PDT 2001 > > State-Changed-Why: > > > > User was looking in the wrong documentation file. > > > > > > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
