You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by gr...@locus.apache.org on 2000/09/28 01:31:20 UTC

cvs commit: xml-cocoon/xdocs faq.xml fptaglib.xml installing.xml

greenrd     00/09/27 16:31:20

  Modified:    .        todo.xml
               xdocs    faq.xml fptaglib.xml installing.xml
  Log:
  minor docs updates
  
  Revision  Changes    Path
  1.34      +8 -4      xml-cocoon/todo.xml
  
  Index: todo.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/todo.xml,v
  retrieving revision 1.33
  retrieving revision 1.34
  diff -u -r1.33 -r1.34
  --- todo.xml	2000/09/22 22:56:47	1.33
  +++ todo.xml	2000/09/27 23:31:04	1.34
  @@ -3,7 +3,7 @@
   <!DOCTYPE todo SYSTEM "./xdocs/dtd/todo-v10.dtd">
   
   <!--
  -  $Id: todo.xml,v 1.33 2000/09/22 22:56:47 greenrd Exp $
  +  $Id: todo.xml,v 1.34 2000/09/27 23:31:04 greenrd Exp $
   -->
   
   <todo title="Things To Do for Cocoon 1.x">
  @@ -16,6 +16,10 @@
    </devs>
   
    <actions priority="high">
  +  <action context="code">
  +   Work out how to integrate inline XSP docs (such as inline esql docs)
  +   into the build docs procedure.
  +  </action>
     <action context="code" assigned-to="RDG">
      Workaround redirect problem with Tomcat and IE
      (code written; just needs to be merged in.)
  @@ -37,10 +41,6 @@
     <action context="docs">
      Cleanup and improve documentation. (in progress.)
     </action>
  -  <action context="code">
  -   Work out how to integrate inline XSP docs (such as inline esql docs)
  -   into the build docs procedure.
  -  </action>
     <action context="code" assigned-to="RDG">
      Class auto-reloading for XSP pages
      (code written; just needs to be merged in and documented.)
  @@ -53,6 +53,10 @@
     </action>
     <action context="code">
      Better error reporting for typos in stylesheet URIs.
  +  </action>
  +  <action context="code">
  +   Prepared statements for ESQL for speed and to avoid escaping problems
  +   (for both security and bug-preventing reasons).
     </action>
    </actions>
   
  
  
  
  1.19      +17 -1     xml-cocoon/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/faq.xml,v
  retrieving revision 1.18
  retrieving revision 1.19
  diff -u -r1.18 -r1.19
  --- faq.xml	2000/09/22 22:56:52	1.18
  +++ faq.xml	2000/09/27 23:31:07	1.19
  @@ -484,9 +484,11 @@
     <question>Is there a way to fake the requesting
      UserAgent from my browser? That would make testing easier.</question>
     <answer>
  -   <p>Yes - just append <code>?user-agent=xxx</code> to your requested URI and
  +   <p>Yes - just append <code>?user-Agent=xxx</code> to your requested URI and
       Cocoon will ignore the userAgent description that your browser is sending and
       use the one you specified instead.</p>
  +
  +   <note>user-Agent is case-sensitive.</note>
     </answer>
    </faq>
   </faqsection>
  @@ -899,6 +901,20 @@
       <link href="http://www.mulberrytech.com/xsl/">"Mulberrytech list"</link>,
       which is more appropriate than the cocoon-users list for general
       XSL questions.</p>
  +  </answer>
  + </faq>
  +
  + <faq id="articles">
  +  <question>Are there any articles explaining Cocoon technologies, apart from
  +   the Cocoon documentation itself?</question>
  +  <answer>
  +   <p>Yes. In <em>XML Magazine</em>, Fall 2000, there is an article entitled
  +    <link href="http://www.xmlmag.com/upload/free/features/xml/2000/04fal00/kj0004/kj0004.asp">"A
  +    Better Way for Web Development"</link> by Kevin Jones, from page 72. 
  +    This article discusses XML, XSLT, Using XPath in XSLT, processing XML/XSLT, 
  +    using Cocoon, how to write a Producer and other helpful hints. 
  +    Although incomplete in one important respect (lacking a mention of XSP!),
  +    it's a good introductory read.</p>
     </answer>
    </faq>
   
  
  
  
  1.3       +1 -1      xml-cocoon/xdocs/fptaglib.xml
  
  Index: fptaglib.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/fptaglib.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- fptaglib.xml	2000/08/16 15:30:28	1.2
  +++ fptaglib.xml	2000/09/27 23:31:10	1.3
  @@ -25,7 +25,7 @@
   		<source><![CDATA[
   <xsp:page
   	language="java"
  -	xmlns:sql="http://apache.org/cocoon/XSP/FP/1.0"
  +	xmlns:fp="http://apache.org/cocoon/XSP/FP/1.0"
   	xmlns:xsp="http://www.apache.org/1999/XSP/Core"
   >
   
  
  
  
  1.25      +16 -4     xml-cocoon/xdocs/installing.xml
  
  Index: installing.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/installing.xml,v
  retrieving revision 1.24
  retrieving revision 1.25
  diff -u -r1.24 -r1.25
  --- installing.xml	2000/09/22 22:56:53	1.24
  +++ installing.xml	2000/09/27 23:31:10	1.25
  @@ -228,24 +228,24 @@
       <code>$COCOON_HOME/lib</code> to <code>$TOMCAT_HOME/lib</code> that are necessary for Cocoon to run.
       In addition, you must copy <code>$COCOON_HOME/bin/cocoon.jar</code> to <code>$TOMCAT_HOME/lib</code>.
      </p>
  - 
  +
      <p>
       In recent versions of Tomcat under Unix, Tomcat will automatically
       detect any <code>.jar</code> files
       in the <code>$TOMCAT_HOME/lib</code> directory. But under Windows, you must explicitly add the new
       <code>.jar</code> files in the appropriate place in the file <code>$TOMCAT_ROOT/bin/tomcat.bat</code>.
      </p>
  - 
  +
      <p>
       Next you must tell Tomcat about the new context which will run Cocoon requests. To do
       this edit the file <code>$TOMCAT_HOME/conf/server.xml</code> and add the following line:
      </p>
  - 
  +
    <source><![CDATA[
    <Context path="/cocoon" docBase="webapps/cocoon" debug="0" reloadable="true" >
    </Context>
    ]]></source>
  - 
  +
         <p>
         This tells Tomcat that requests that come in under that partial path "/cocoon" should
         be mapped to the context defined in the directory "webapps/cocoon". We will set that up
  @@ -663,6 +663,12 @@
      <td>JDK 1.2.2_006</td>
     </tr>
     <tr>
  +   <td>RedHat Linux 6.2</td>
  +   <td>Apache 1.3.12</td>
  +   <td>JRun 3.0</td>
  +   <td>Sun JDK 1.2.2</td>
  +  </tr>
  +  <tr>
      <td>RedHat Linux 6.2 (i686)</td>
      <td>Apache 1.3.12 + mod_ssl 2.6.5</td>
      <td>JRun 2.3.3</td>
  @@ -748,6 +754,12 @@
     <tr>
      <td>Windows NT 4.0 SP4</td>
      <td colspan="2">BEA WebLogic Server 5.1 SP3</td>
  +   <td>Sun JDK 1.2.2</td>
  +  </tr>
  +  <tr>
  +   <td>Windows NT 4.0 SP5</td>
  +   <td>IIS 4.0</td>
  +   <td>JRun 3.0</td>
      <td>Sun JDK 1.2.2</td>
     </tr>
     <tr>