cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From stef...@locus.apache.org
Subject cvs commit: xml-cocoon/xdocs cocoon2.xml docs-book.xml dynamic.xml faq.xml guide.xml installing.xml livesites.xml site-book.xml sqltaglib.xml xspprocessor.xml
Date Thu, 27 Apr 2000 17:55:23 GMT
stefano     00/04/27 10:55:22

  Modified:    xdocs    cocoon2.xml docs-book.xml dynamic.xml faq.xml
                        guide.xml installing.xml livesites.xml
                        site-book.xml sqltaglib.xml xspprocessor.xml
  Log:
  a bunch of doc cleanups and updates
  
  Revision  Changes    Path
  1.5       +33 -3     xml-cocoon/xdocs/cocoon2.xml
  
  Index: cocoon2.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/cocoon2.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- cocoon2.xml	2000/03/16 23:58:16	1.4
  +++ cocoon2.xml	2000/04/27 17:55:15	1.5
  @@ -265,7 +265,7 @@
   <![CDATA[
     <sitemap>
      <process match="/press/en/*.html">
  -    <generator type="file" src="/docs/english/press/*.xml"
  +    <generator type="file" src="/docs/english/press/*.xml"/>
       <filter type="xslt">
        <parameter name="stylesheet" value="/styles/simple-press-html.xsl"/>
       </filter>
  @@ -273,11 +273,41 @@
      </process>
   
      <process match="/press/en/*.pdf">
  -    <generator type="file" src="/docs/english/press/*.xml"
  +    <generator type="file" src="/docs/english/press/*.xml"/>
       <filter type="xslt">
        <parameter name="stylesheet" value="/styles/simple-press-pdf.xsl"/>
       </filter>
  -    <serializer type="fop"/>
  +    <serializer type="pdf"/>
  +   </process>
  +
  +   <process match="/">
  +    <matcher type="agent">
  +     <parameter name="name" value="Mozilla/5.0">
  +    </matcher>
  +    <generator type="file" src="/docs/root.xml"/>
  +    <filter type="xslt">
  +     <parameter name="stylesheet" value="/styles/fancy-XUL-view.xsl"/>
  +    </filter>
  +    <serializer type="html"/>
  +   </process>
  +
  +   <process match="/">
  +    <matcher type="agent">
  +     <parameter name="capability" value="text/vnd.wap.wml">
  +    </matcher>
  +    <generator type="file" src="/docs/root.xml"/>
  +    <filter type="xslt">
  +     <parameter name="stylesheet" value="/styles/WAP-view.xsl"/>
  +    </filter>
  +    <serializer type="wap"/>
  +   </process>
  +
  +   <process match="/">
  +    <generator type="file" src="/docs/root.xml"/>
  +    <filter type="xslt">
  +     <parameter name="stylesheet" value="/styles/normal-view.xsl"/>
  +    </filter>
  +    <serializer type="html"/>
      </process>
     </sitemap>
   ]]>
  
  
  
  1.7       +2 -1      xml-cocoon/xdocs/docs-book.xml
  
  Index: docs-book.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/docs-book.xml,v
  retrieving revision 1.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- docs-book.xml	2000/04/14 17:13:49	1.6
  +++ docs-book.xml	2000/04/27 17:55:15	1.7
  @@ -1,7 +1,6 @@
   <?xml version="1.0"?>
   
   <book software="Cocoon" title="Cocoon documentation" copyright="@year@ The Apache Software
Foundation">
  -
     <page id="index" label="Index" source="index.xml"/>
     <page id="license" label="License" source="license.xml"/>
     <page id="install" label="Install" source="installing.xml"/>
  @@ -27,6 +26,8 @@
     <faqs id="faqs" label="FAQ" source="faq.xml"/>
     <changes id="changes" label="Changes" source="changes.xml"/>
     <todo id="todo" label="Todo" source="todo.xml"/>
  +<separator/>
  +  <page id="livesites" label="Live Sites" source="livesites.xml"/>
   <separator/>
     <external label="Code Repository" href="http://www.apache.org/websrc/cvsview.cgi/xml-cocoon"/>
     <external label="Dev Snapshots" href="http://xml.apache.org/from-cvs/xml-cocoon/"/>
  
  
  
  1.3       +1 -1      xml-cocoon/xdocs/dynamic.xml
  
  Index: dynamic.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/dynamic.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- dynamic.xml	2000/04/13 10:43:50	1.2
  +++ dynamic.xml	2000/04/27 17:55:15	1.3
  @@ -177,7 +177,7 @@
   </page>
   ]]></source>
     
  -  <p>Our simple example processor will look for the %lg;time/%gt; tags and will 
  +  <p>Our simple example processor will look for the &lt;time/&gt; tags and
will 
     expand them to the current local time, creating this result document:</p>
     
   <source><![CDATA[
  
  
  
  1.11      +8 -64     xml-cocoon/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/faq.xml,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- faq.xml	2000/04/04 11:09:29	1.10
  +++ faq.xml	2000/04/27 17:55:16	1.11
  @@ -7,9 +7,12 @@
   <faq>
    <question>I get the exception <em>java.lang.NoClassDefFoundError: sun/tools/javac/Main</em></question>
    <answer>
  - <p>
  -  Look at the question below.
  - </p>
  +  <p>
  +   This happens because Cocoon requires the java compiler to be present in your 
  +   classpath, so, if you have Java 1.2.x, you have to set the <code>tools.jar</code>
  +   package you find in <code>[jdk_home]/lib/tools.jar</code> in your classpath
(either
  +   system classpath or your servlet engine's classpath).
  +  </p>
    </answer>
   </faq>
   
  @@ -33,17 +36,6 @@
       Since this directory may contain security sensible information, make sure
       you deny access (even read-only) to untrusted users.
     </note>
  -
  -  <p>
  -   Another common problem is the system complaining about missing classes such as:
  -  </p>
  -
  -  <source>java.lang.NoClassDefFoundError: sun/tools/javac/Main</source>
  -
  -  <p>
  -   If this happens, make sure you have installed the <code>tools.jar</code>
  -   package you find in <code>[jdk_home]/lib/tools.jar</code>.
  -  </p>
    </answer>
   </faq>
   
  @@ -90,10 +82,10 @@
   <faq>
    <question>can I place <em>cocoon.jar</em> in my servlet context or servlet
zone instead of my classpath?</question>
    <answer>
  -  <p>Due to a problem in most custom classloader implementations (for example, both
JServ and Tomcat suffer from this problem) local resources
  +  <p>Due to a problem in some classloader implementations (for example, Apache JServ
1.1) local resources
     cannot be loaded if they are located in custom repositories and packaged inside zip/jar
files.</p>
     <p>A workaround is to expand the <em>cocoon.jar</em> file and like
that directory as your servlet context repository
  -  or place the required resources in your classpath or wait for this problem to be fixed.</p>
  +  or place the required resources in your classpath or use a servlet engine that doesn't
have this limitation (Tomcat 3.1).</p>
    </answer>
   </faq>
   
  @@ -228,54 +220,6 @@
     and we are not resposible for any lack of synch between the official Cocoon
     documentation and the translated version. For this reason, do not contact
     the Cocoon Project but directly the people that provide the translation. Thank you.</note>
  - </answer>
  -</faq>
  -
  -<faq>
  - <question>Why do I keep getting FileNotFoundException under Tomcat 3.0?</question>
  - <answer><p>See question below</p></answer>
  -</faq>
  -
  -<faq>
  - <question>How come Cocoon doesn't work on Tomcat 3.0?</question>
  - <answer>
  -  <p>You must apply this patch to Tomcat 3.0 and recompile it or it won't work.
  -  This patch is already present in latest CVS code but in case you don't want
  -  to download the latest code you can apply this:</p>
  -
  -  <source><![CDATA[ Index: RequestMapper.java
  -   ===================================================================
  -   RCS file: /home/cvs/jakarta-tomcat/src/share/org/apache/tomcat/core/RequestMapper.java,v
  -
  -   retrieving revision 1.5
  -   retrieving revision 1.6
  -   diff -u -r1.5 -r1.6
  -   --- RequestMapper.java 1999/11/05 18:36:33  1.5
  -   +++ RequestMapper.java 1999/12/17 18:59:14  1.6
  -   @@ -285,13 +285,7 @@
  -                mapPath = "/" + s;
  -            } else if (mapPath == null &&
  -                this.resourceName != null) {
  -   -            // XXX
  -   -            // hack to differentiate amongst a mapped servlet and a jsp
  -   -      if (! wrapper.getServletClass().equals(Constants.JSP.CLASSNAME)) {
  -   -                mapPath = "/" + wrapper.getServletClass();
  -   -            } else {
  -   -                mapPath = this.resourceName;
  -   -            }
  -   +            mapPath = this.resourceName;
  -            }
  -
  -            return mapPath;]]></source>
  - </answer>
  -</faq>
  -
  -<faq>
  - <question>Are external entities still broken?</question>
  - <answer>
  -  <p>No, external entity support has been fixed for both absolute and relative
  -  URIs. Note that ProjectX and Xerces behave differently on these but this
  -  is not something we are in control of.</p>
    </answer>
   </faq>
   
  
  
  
  1.3       +1 -1      xml-cocoon/xdocs/guide.xml
  
  Index: guide.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/guide.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- guide.xml	2000/04/18 12:53:33	1.2
  +++ guide.xml	2000/04/27 17:55:16	1.3
  @@ -76,7 +76,7 @@
     follow a <link href="http://www.w3.org/TR/WD-xml-stylesheet">W3C recommendation</link>
     and add the XML processing instruction to map a stylesheet to a document:</p>
     
  -  <source>&lt;xml-stylesheet href"hello.xsl" type="text/xsl"&gt;</source>
  +  <source>&lt;?xml-stylesheet href="hello.xsl" type="text/xsl"?&gt;</source>
     
     <p>Now that our content layer is done, we need to create a stylesheet to
     convert it to a format readable by our web clients. Since most available web
  
  
  
  1.11      +7 -6      xml-cocoon/xdocs/installing.xml
  
  Index: installing.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/installing.xml,v
  retrieving revision 1.10
  retrieving revision 1.11
  diff -u -r1.10 -r1.11
  --- installing.xml	2000/04/13 10:43:50	1.10
  +++ installing.xml	2000/04/27 17:55:16	1.11
  @@ -61,6 +61,13 @@
      use them. Note, however, that they were all redistributed untouched from
      their original distributions.
     </p>
  +  
  +  <p>
  +   If you use Java 1.2.x, you also have to treat the file 
  +   <code>[jdk_home]/lib/tools.jar</code> as another Cocoon component and include
  +   this into your classpath. This package contains the java compiler that
  +   is required for Cocoon page compilation.
  +  </p>
   
     <note>
      The Ant and Stylebook packages are only used in the build system and
  @@ -492,12 +499,6 @@
     </tr>
     </table>
   
  -  <note>
  -   Due to a bug in <link href="http://www.blackdown.org">Blackdown
  -   JDK 1.2pre2</link> for Linux, we suggest you to use green threads instead of the
  -   native ones which are much less stable, expecially highly concurrent operations
  -   like servlet engines and servlet execution.
  -  </note>
     <p>
      Please, submit your feedback on the cocoon user mail list (nowhere else!) if
      you were able to install Cocoon on a different combination not listed above.
  
  
  
  1.2       +22 -10    xml-cocoon/xdocs/livesites.xml
  
  Index: livesites.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/livesites.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- livesites.xml	2000/04/26 16:49:37	1.1
  +++ livesites.xml	2000/04/27 17:55:16	1.2
  @@ -3,17 +3,29 @@
   
   <document>
    <header>
  - <title>Live Sites using Cocoon</title>
  - <authors>
  -  <person name="Donald Ball" email="balld@webslingerZ.com"/>
  - </authors>
  +  <title>Live Sites powered by Cocoon</title>
  +  <authors>
  +   <person name="Donald Ball" email="balld@webslingerZ.com"/>
  +  </authors>
    </header>
  + 
    <body>
  - <ol>
  -  <li><link href="http://www.zen.co.za/">http://www.zen.co.za/</link></li>
  -  <li><link href="http://www.randshow.co.za/">http://www.randshow.co.za/</link></li>
  -  <li><link href="http://www.mtnartinst.com/">http://www.mtnartinst.com/</link></li>
  -  <li><link href="http://www.trilug.org/">http://www.trilug.org/</link></li>
  - </ol>
  +  <s1 title="Live Sites powered by Cocoon">
  +   <p>
  +    Here is a list of web sites that are proudly powered by Cocoon.
  +   </p>
  +   
  +   <ul>
  +    <li><link href="http://www.zen.co.za/">http://www.zen.co.za/</link></li>
  +    <li><link href="http://www.randshow.co.za/">http://www.randshow.co.za/</link></li>
  +    <li><link href="http://www.mtnartinst.com/">http://www.mtnartinst.com/</link></li>
  +    <li><link href="http://www.trilug.org/">http://www.trilug.org/</link></li>
  +   </ul>
  +   
  +   <p>
  +    If you don't find your site upthere, make sure you tell us. We want this list
  +    to grow bigger every day :-)
  +   </p>
  +  </s1>
    </body>
   </document>
  
  
  
  1.8       +2 -2      xml-cocoon/xdocs/site-book.xml
  
  Index: site-book.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/site-book.xml,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -r1.7 -r1.8
  --- site-book.xml	2000/04/14 17:13:50	1.7
  +++ site-book.xml	2000/04/27 17:55:17	1.8
  @@ -1,7 +1,6 @@
   <?xml version="1.0"?>
   
   <book title="Cocoon documentation" copyright="@year@ The Apache Software Foundation">
  -
     <external href="../index.html"  label="Back"/>
   <separator/>
     <external href="./dist"  label="Download"/>
  @@ -30,9 +29,10 @@
     <changes id="changes" label="Changes" source="changes.xml"/>
     <todo id="todo" label="Todo" source="todo.xml"/>
   <separator/>
  +  <page id="livesites" label="Live Sites" source="livesites.xml"/>
  +<separator/>
     <external label="Code Repository" href="http://xml.apache.org/websrc/cvsweb.cgi/xml-cocoon/"/>
     <external label="Dev Snapshots" href="http://xml.apache.org/from-cvs/xml-cocoon/"/>
     <external label="Mail Archive" href="http://xml-archive.webweaving.org"/>
     <external label="Bug Database" href="http://xml.apache.org/bugs/"/>
  -
   </book>
  
  
  
  1.2       +1 -1      xml-cocoon/xdocs/sqltaglib.xml
  
  Index: sqltaglib.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/sqltaglib.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- sqltaglib.xml	2000/04/12 20:18:28	1.1
  +++ sqltaglib.xml	2000/04/27 17:55:17	1.2
  @@ -16,7 +16,7 @@
   	<s1 title="Configuration">
   		<p>Map the</p>
   		<source>http://www.apache.org/1999/SQL</source>
  -		<p>namespace to the sql prefix (FIXME - how do we avoid doing this now?). Elements
in the sql taglib namespace will be interpreted as input to the sql taglib and will be stripped
from the output.</p>
  +		<p>namespace to the sql prefix. Elements in the sql taglib namespace will be interpreted
as input to the sql taglib and will be stripped from the output.</p>
   		<p>This is typically done like this:</p>
   		<source><![CDATA[
   <xsp:page
  
  
  
  1.4       +2 -3      xml-cocoon/xdocs/xspprocessor.xml
  
  Index: xspprocessor.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/xspprocessor.xml,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- xspprocessor.xml	2000/04/08 23:12:11	1.3
  +++ xspprocessor.xml	2000/04/27 17:55:17	1.4
  @@ -130,9 +130,8 @@
         </p>
   
         <p>
  -        These concepts are illustrated in the
  -	<link href="http://www.plenix.com/xsp/samples/">XSP Samples</link>
  -	included in the distribution.
  +        These concepts are illustrated in the XSP Samples included in the 
  +        distribution.
         </p>
   
       </s1>
  
  
  

Mime
View raw message