You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cactus-dev@jakarta.apache.org by vm...@apache.org on 2001/11/05 22:57:42 UTC

cvs commit: jakarta-cactus/docs/framework/xdocs faq.xml doc-book.xml site-book.xml todo.xml

vmassol     01/11/05 13:57:42

  Modified:    docs/framework/xdocs doc-book.xml site-book.xml todo.xml
  Added:       docs/framework/xdocs faq.xml
  Log:
  new FAQ page to replace old one which was hosted on Jyve (but downtime of Jyve is to important to continue so we're now hosting our FAQ, which is probably better anyway as we can have the entries in CVS)
  
  Revision  Changes    Path
  1.32      +1 -2      jakarta-cactus/docs/framework/xdocs/doc-book.xml
  
  Index: doc-book.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/doc-book.xml,v
  retrieving revision 1.31
  retrieving revision 1.32
  diff -u -r1.31 -r1.32
  --- doc-book.xml	2001/09/22 19:20:35	1.31
  +++ doc-book.xml	2001/11/05 21:57:42	1.32
  @@ -28,6 +28,7 @@
       <menu-item label="Getting Started" source="getting_started.xml"/>
       <menu-item label="Mock vs Container" source="mockobjects.xml"/>
       <menu-item type="external" label="API Reference" href="javadoc/index.html"/>
  +    <menu-item label="FAQ" source="faq.xml"/>
     </menu>
   
     <menu label="Howto Guides">
  @@ -62,8 +63,6 @@
       <menu-item type="external" label="Bug database"
           href="http://jakarta.apache.org/site/bugs.html"/>
       <menu-item label="Mailing list" source="mailinglist.xml"/>
  -    <menu-item type="external" label="FAQ"
  -        href="http://jakarta.apache.org:8080/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/46"/>
     </menu>
   
     <menu label="Misc.">
  
  
  
  1.28      +1 -2      jakarta-cactus/docs/framework/xdocs/site-book.xml
  
  Index: site-book.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/site-book.xml,v
  retrieving revision 1.27
  retrieving revision 1.28
  diff -u -r1.27 -r1.28
  --- site-book.xml	2001/09/22 19:20:35	1.27
  +++ site-book.xml	2001/11/05 21:57:42	1.28
  @@ -28,6 +28,7 @@
       <menu-item label="Getting Started" source="getting_started.xml"/>
       <menu-item label="Mock vs Container" source="mockobjects.xml"/>
       <menu-item label="API Reference" source="javadoc.xml"/>
  +    <menu-item label="FAQ" source="faq.xml"/>
     </menu>
   
     <menu label="Howto Guides">
  @@ -62,8 +63,6 @@
       <menu-item type="external" label="Bug database"
           href="http://jakarta.apache.org/site/bugs.html"/>
       <menu-item label="Mailing list" source="mailinglist.xml"/>
  -    <menu-item type="external" label="FAQ"
  -        href="http://jakarta.apache.org:8080/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/46"/>
     </menu>
   
     <menu label="Misc.">
  
  
  
  1.65      +4 -0      jakarta-cactus/docs/framework/xdocs/todo.xml
  
  Index: todo.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-cactus/docs/framework/xdocs/todo.xml,v
  retrieving revision 1.64
  retrieving revision 1.65
  diff -u -r1.64 -r1.65
  --- todo.xml	2001/10/27 22:33:02	1.64
  +++ todo.xml	2001/11/05 21:57:42	1.65
  @@ -32,6 +32,10 @@
     <version title="Version 1.3">
   
       <category title="Documentation">
  +      <action assigned-to="Vincent Massol">
  +        Move all documentation to docbook and cocoon2 and generate PDF containing full Cactus
  +        documentation.
  +      </action>
         <action>
           Add a tutorial for VAJava with Tomcat environment (the current
           tutorial on the web site is for VAJava with WTE). Needed steps
  
  
  
  1.1                  jakarta-cactus/docs/framework/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
  
  <document>
    <header>
      <title>FAQ</title>
      <authors>
        <person name="Vincent Massol" email="vmassol@apache.org"/>
      </authors>
    </header>
  
    <body>
  
      <s1 title="FAQ Content">
        <ul>
          <li>
            <jump anchor="faq1_web_xml_production">How can I have a web.xml that is valid both for
            testing and for production ?</jump>
          </li>
        </ul>
      </s1>
  
      <anchor id="faq1_web_xml_production"/>
      <s1 title="How can I have a web.xml that is valid both for testing and for production ?">
  
        <p>
          <em>submitted by <link href="mailto:lists@ehatchersolutions.com">Erik Hatcher</link></em>
        </p>
  
        <s2 title="Question">
          <p>
            Cactus needs to have a few entries set in the <code>web.xml</code> file (redirector
            definition and mappings mostly). The application to test also needs its own entries.
            What would be nice would be to be able to use the same <code>web.xml</code> file in
            the build process for both application testing and deployment to production.
          </p>
        </s2>
        <s2 title="Solution">
          <p>
              Here's how I accomplished conditional inclusion
              of Cactus web.xml configuration.  My web.xml file is capable of working
              standalone without requiring any filtered copy to work.   In Ant I'm doing
              this:
          </p>
  <source><![CDATA[
  <!-- Activate the Cactus web.xml configuration -->
  <copy todir="${admin.build.dir}/WEB-INF"
        file="web/admin/WEB-INF/web.xml"
        overwrite="yes">
    <filterset>
      <filter token="start.cactus.config" value="--&gt;" />
      <filter token="end.cactus.config" value="&lt;!--" />
    </filterset>
  </copy>]]></source>
  
          <p>
            In <code>web.xml</code> I have this:
          </p>
  
  <source><![CDATA[
  <!-- Cactus configuration
  Note: Do not place any XML comments in this Cactus configuration section
  (Ant's filtered copy is used to activate this configuration when the test
  web application is built)
  -->
  <!-- Begin Cactus Configuration @start.cactus.config@
  <servlet>
    <servlet-name>ServletRedirector</servlet-name>
    <servlet-class>org.apache.cactus.server.ServletTestRedirector</servlet-class>
  </servlet>
  
  <servlet>
      <servlet-name>JspRedirector</servlet-name>
      <jsp-file>/somewhere/jspRedirector.jsp</jsp-file>
  </servlet>
  
  <servlet-mapping>
      <servlet-name>ServletRedirector</servlet-name>
      <url-pattern>/ServletRedirector/</url-pattern>
  </servlet-mapping>
  
  <servlet-mapping>
      <servlet-name>JspRedirector</servlet-name>
      <url-pattern>/JspRedirector/</url-pattern>
  </servlet-mapping>
  
  @end.cactus.config@ End Cactus Configuration -->
  ]]></source>
  
        </s2>
  
      </s1>
  
    </body>
  </document>
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>