Improve VirtualHostMonster documentation

[Pieter Biemond]

I had many troubles finding good VHM-docs.
I didn't know how to specify the id, and was able to find the information on the VHM object page *after* I installed the VHM.

I moved some information to the Add-page (lib/python/Products/SiteAccess/www/VirtualHostMonsterAdd.dtml), and added a link to the
<a href="http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/VirtualHosti
ng.stx">Zope book</a>

<pre>
*** VirtualHostMonsterAdd.dtml.default Mon Feb 24 14:26:06 2003
--- VirtualHostMonsterAdd.dtml Mon Feb 24 15:30:39 2003
***************
*** 9,15 ****
  within the same Folder, using information passed to it in special URL
  path elements. This is useful if you are using some rewriting tool
  (Apache or an Access Rule, for example) to insert these special
! elements into your URL.
  </p>

  <p class="form-help">
--- 9,23 ----
  within the same Folder, using information passed to it in special URL
  path elements. This is useful if you are using some rewriting tool
  (Apache or an Access Rule, for example) to insert these special
! elements into your URL.
! </p>
!
! <p class="form-help">
! Using a Virtual Host Monster and setting up virtual hosting using
! Zope should be done with caution. Be sure to read the <a
! href="http://www.zope.org/Documentation/Books/ZopeBook/2_6Edition/VirtualHosti
ng.stx">virtual
! hosting chapter</a> of the Zope book before installing a Virtual
! Host Monster to your Zope site.
  </p>

  <p class="form-help">
***************
*** 31,36 ****
--- 39,49 ----
  the absolute_url() methods of objects.
  </p>

+ <p class="form-help">
+ A single Virtual Host Monster in your Zope root can handle all of
+ your virtual hosting needs. It doesn't matter what Id you give it,
+ as long as nothing else in your site has the same Id (e.g. 'VHM').
+ </p>

  <form action="manage_addVirtualHostMonster" method="post">
  <table cellspacing="0" cellpadding="2" border="0">
</pre>

[Patrick Gerken (do3cc)]

Changes: classification (doc request => feature+solution), new comment

Still a documentation request but it already has the solution, so its a nobrainer for anybody with svn write access.

[Jens Vagelpohl (dataflake-deactivatedaccount-deactivatedaccount)]

I removed any reason to be confused by getting rid of the Add view altogether. The VHM now uses a default Id and users will see a clear error message if an object with the same Id or another VHM instance exists in the container. Users cannot add more than a single VHM to any container now.

Zope 2.12 branch: http://svn.zope.org/?view=rev&rev=112531

Zope trunk: http://svn.zope.org/?view=rev&rev=112531