cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject cvs commit: xml-cocoon2/src/documentation/xdocs/userdocs/generators file-generator.xml
Date Thu, 02 May 2002 04:54:56 GMT
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


Mime
View raw message