Return-Path: 
 <cocoon-cvs-return-6706-apmail-xml-cocoon-cvs-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-cocoon-cvs-archive@xml.apache.org
Received: (qmail 58502 invoked by uid 500); 2 May 2002 04:54:58 -0000
Mailing-List: contact cocoon-cvs-help@xml.apache.org; run by ezmlm
Precedence: bulk
Reply-To: cocoon-dev@xml.apache.org
list-help: <mailto:cocoon-cvs-help@xml.apache.org>
list-unsubscribe: <mailto:cocoon-cvs-unsubscribe@xml.apache.org>
list-post: <mailto:cocoon-cvs@xml.apache.org>
Delivered-To: mailing list cocoon-cvs@xml.apache.org
Received: (qmail 58493 invoked by uid 500); 2 May 2002 04:54:58 -0000
Delivered-To: apmail-xml-cocoon2-cvs@apache.org
Date: 2 May 2002 04:54:56 -0000
Message-ID: <20020502045456.33916.qmail@icarus.apache.org>
From: crossley@apache.org
To: xml-cocoon2-cvs@apache.org
Subject: cvs commit: xml-cocoon2/src/documentation/xdocs/userdocs/generators
 file-generator.xml
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

crossley    02/05/01 21:54:56

  Modified:    src/documentation/xdocs faq.xml
               src/documentation/xdocs/userdocs/concepts sitemap.xml
               src/documentation/xdocs/userdocs/generators
                        file-generator.xml
  Log:
  Added explanation and clarification of file:// URLs.
  Obtained from: J.Pietschmann
  
  Revision  Changes    Path
  1.9       +27 -8     xml-cocoon2/src/documentation/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/faq.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- faq.xml	30 Apr 2002 07:47:36 -0000	1.8
  +++ faq.xml	2 May 2002 04:54:56 -0000	1.9
  @@ -147,7 +147,7 @@
         Cocoon uses an initial parameter in the "web.xml" file to automatically load
         classes on startup.  This way, the class is loaded only once and the server's
         time is spent doing more productive things.  Make sure the following entry
  -      is in your "web.xml" file:
  +      is in your "web.xml" file.
       </p>
   
       <source><![CDATA[
  @@ -484,9 +484,10 @@
   </map:pipeline>
   ]]></source>
   
  -   <p>The "file:" type of source forces Cocoon to search the sub-sitemap under
  -     the specified directory (which happens to be "c:\foo", since this is a
  -     Windows system).
  +   <p>The "file:" type of source instructs Cocoon to search the sub-sitemap
  +     under the specified directory (which happens to be "c:\foo", since this
  +     is a Windows system). See explanation of
  +     <link href="userdocs/concepts/sitemap.html#file-url">file: URLs</link>
      </p>
      <p>Now, you just need to copy everything which was under the
        webapps/cocoon/foo directory to the /foo directory, and it should work
  @@ -568,7 +569,7 @@
       <source><![CDATA[
   <map:pipeline>
       <map:match pattern="Foo/**">
  -      <map:mount uri-prefix="Fru" src="/www/Foo/"
  +      <map:mount uri-prefix="Fru" src="file:///www/Foo/"
                    check-reload="yes" reload-method="synchron"/>
       </map:match>
   </map:pipeline>
  @@ -578,9 +579,6 @@
       Here, <code>/www/Foo</code> is a some directory on the local file system where the 
       xml, xsp, .., files of the application Foo live.
       </p>
  -    <note>
  -    The src attribute may have to include "file://"
  -    </note>
     </answer>
   </faq>
   <faq>
  @@ -789,6 +787,27 @@
        Contribution page. It also explains how to get branches other than the
        current HEAD branch.
       </p>
  +  </answer>
  +</faq>
  +
  +<faq>
  +  <question>
  +    What is the syntax for absolute filesystem pathnames.
  +  </question>
  +  <answer>
  +   <p>
  +    In your sitemaps you may need to refer to some resource that is outside
  +    the webapp context (e.g. UNIX /foo/bar/this.xsl
  +    e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention.
  +   </p>
  +   <ul>
  +    <li>UNIX ... <code>file:///foo/bar/this.xsl</code></li>
  +    <li>Windows ... <code>file:///C:/foo/bar/this.xsl</code></li>
  +   </ul>
  +   <p>
  +    See further explanation of
  +    <link href="userdocs/concepts/sitemap.html#file-url">file: URLs</link>
  +   </p>
     </answer>
   </faq>
   
  
  
  
  1.4       +27 -1     xml-cocoon2/src/documentation/xdocs/userdocs/concepts/sitemap.xml
  
  Index: sitemap.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/concepts/sitemap.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- sitemap.xml	23 Feb 2002 16:47:39 -0000	1.3
  +++ sitemap.xml	2 May 2002 04:54:56 -0000	1.4
  @@ -620,7 +620,7 @@
         coming from a jar via http connection. 
        </li>
        <li>
  -      Use <code>file://foo/bar</code> to merge in xml content from the filesystem.
  +      Use <code>file:///foo/bar</code> to merge in xml content from the filesystem.
        </li>
        <li>
         Use <code>xmldb:&lt;your driver here&gt;://your.xmldb.host/db/foo/bar</code> to merge in xml content from a XML:DB compliant database.
  @@ -920,6 +920,32 @@
        </p>
       </s3>
      </s2>
  +  </s1>
  +
  +  <anchor id="file-url"/>
  +  <s1 title="File: URLs">
  +   <p>
  +    In your sitemaps you may need to refer to some resource that is outside
  +    the webapp context (e.g. UNIX /foo/bar/this.xsl
  +    e.g. Windows C:\foo\bar\this.xsl). You need to use the file: convention
  +    with the following syntax for absolute filesystem pathnames.
  +   </p>
  +
  +   <ul>
  +    <li>UNIX ... <code>file:///foo/bar/this.xsl</code></li>
  +    <li>Windows ... <code>file:///C:/foo/bar/this.xsl</code></li>
  +   </ul>
  +
  +   <p>
  +    Everything starting with a URI scheme identifer like &quot;file:&quot;
  +    or &quot;http:&quot; is an absolute URI. An absolute file URL is
  +    <code>file://some.host/some/path/to/file.ext</code>
  +   </p>
  +
  +   <p>
  +    The host can be omitted, defaulting to localhost, so you can write
  +    <code>file:///some/path/to/file.ext</code>
  +   </p>
     </s1>
   
     <s1 title="Protocols">
  
  
  
  1.2       +4 -0      xml-cocoon2/src/documentation/xdocs/userdocs/generators/file-generator.xml
  
  Index: file-generator.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/userdocs/generators/file-generator.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- file-generator.xml	3 Jan 2002 12:31:04 -0000	1.1
  +++ file-generator.xml	2 May 2002 04:54:56 -0000	1.2
  @@ -29,6 +29,10 @@
     <!-- The type attribute can be omitted as it is the default generator. -->
        ]]>
   </source>
  +   <p>
  +    You can use an absolute filesystem pathname. See explanation of
  +    <link href="../concepts/sitemap.html#file-url">file: URLs</link>
  +   </p>
   		</s1>
   	</body>
   </document>
  
  
  

----------------------------------------------------------------------
In case of troubles, e-mail:     webmaster@xml.apache.org
To unsubscribe, e-mail:          cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org