DPML Notify

[niclas AT netcompartner.com]

Author: niclas
Date: Mon Jan  3 13:07:07 2005
New Revision: 1355

Modified:
   
development/main/central/site/src/docs/products/transit/properties/hosts/index.xml
   
development/main/central/site/src/docs/products/transit/properties/index.xml
Log:
Updated the docs to reflect reality.

Modified: 
development/main/central/site/src/docs/products/transit/properties/hosts/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/properties/hosts/index.xml
  (original)
+++ 
development/main/central/site/src/docs/products/transit/properties/hosts/index.xml
  Mon Jan  3 13:07:07 2005
@@ -60,19 +60,23 @@
       <username>fred</username>
       <password>blogs</password>
     </credentials>
+    <scheme>basic</scheme>
+    <prompt>repository</prompt>
   </host>
 
 </hosts>
 ]]></source>
 
       <p>
-        The default host configuration file is shown below.
+        The default host configuration file is shown below, and find the 
+        description of the elements in the <strong>properties</strong> 
section
+        below.
       </p>
 
 <source><![CDATA[
 <hosts>
 
-  <host href="http://www.dpml.net";>
+  <host href="http://www.dpml.net/repository";>
     <priority>20</priority>
   </host>
 
@@ -101,7 +105,6 @@
           <th>Property</th>
           <th>Default Value</th>
           <th>Description</th>
-          <th>Note</th>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.enabled</td>
@@ -110,13 +113,11 @@
             If true, the remote host repository will be used. If false, it 
             will be skipped completely.
           </td>
-          <td> </td>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.base</td>          
           <td></td>          
           <td>This defines the base URL of the remote host repository.</td>  
        
-          <td></td>          
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.class</td>          
@@ -124,7 +125,6 @@
           <td>
             Defines the class to use for the management of the remote host.
           </td>
-          <td></td>          
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.knowngroups</td>          
@@ -132,21 +132,31 @@
           <td>
             A URL pointing to a file containing a line-separated list of 
             groups that are known to be installed on the remote host 
-            repository.
+            repository. (named &lt;index&gt; in the hosts.xml file.)
           </td>
-          <td></td>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.username</td>
           <td></td>
           <td>The username required for the remote host.</td>
-          <td>Not Tested</td>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.password</td>
           <td></td>
           <td>The password for the user required to access the remote 
host.</td>
-          <td>Not Tested</td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.scheme</td>
+          <td></td>
+          <td>The authentication scheme used for the connection.</td>
+        </tr>
+        <tr>
+          <td>dpml.transit.resourcehost.prompt</td>
+          <td></td>
+          <td>
+            The authentication <strong>prompt</strong> or 
+            <strong>realm</strong> sent by the server.
+          </td>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.policy</td>
@@ -155,7 +165,6 @@
             Download policy. "fast"=if the artifact exist in the cache, use
             it.
           </td>
-          <td></td>
         </tr>
         <tr>
           <td>dpml.transit.resourcehost.priority</td>
@@ -165,19 +174,18 @@
             another host for obtaining the artifact. A lower number indicates
             a higher priority.
           </td>
-          <td></td>
         </tr>
-        <!--
         <tr>
           <td>dpml.transit.resourcehost.trusted</td>
           <td>false</td>
           <td>
-            If true, the host is trusted, and checksums and signatures will 
-            be downloaded fom the host, to verify artifacts downloaded from 
-            elsewhere.
+            If true, the host is trusted. Currently, this is only used by 
+            https:// connections. If set to "true", then the SSL certificate
+            chain does not need to end with a known CA root, and self-signed
+            certificates can be used.
           </td>
-          <td>Not Implemented</td>
         </tr>
+        <!--
         <tr>
           <td>dpml.transit.resourcehost.upload</td>
           <td>false</td>

Modified: 
development/main/central/site/src/docs/products/transit/properties/index.xml
==============================================================================
--- 
development/main/central/site/src/docs/products/transit/properties/index.xml  
      (original)
+++ 
development/main/central/site/src/docs/products/transit/properties/index.xml  
      Mon Jan  3 13:07:07 2005
@@ -71,16 +71,19 @@
 </pre>
 
         <p>
-          If no host.xml file is available Transit will attempt to resolve 
-          hosts using property based host descriptors.  If the value of 
-          ${dpml.transit.authority} is a file url host properties files will 
be 
-          resolved relative to the following path:
+          Transit will also look for property based host descriptors.  If the
+          value of ${dpml.transit.authority} is a file url host properties 
files 
+          will be resolved relative to the following path:
         </p>
 
 <pre>
   ${dpml.transit.authority}/hosts/*.*
 </pre>
-
+        <p>
+          All files found in the hosts/ directory will be read one by one.
+          The priority property will determine in which order the hosts are
+          queried for artifacts.
+        </p>
         <p>
           If the location is a remote URL, it will read the file 
           "index.lst" at that location. "index.lst" must contain a line