installation tomcat.xml

dviner 22 Nov 2002 19:39:27 -0000

dviner      2002/11/22 11:39:26


  Modified:    src/documentation/content/xdocs/community/howto book.xml
                        index.xml
               src/documentation/content/xdocs/community/howto/compilation
                        book.xml index.xml prereqs.xml unix.xml windows.xml
               src/documentation/content/xdocs/community/howto/installation
                        tomcat.xml
  Log:
  converting all tabs to 4 whitespaces as the dev/doc-contributing.html.
  also removed all DOCTYPE uris that point to localhost.  Using XML Catalogs
  is the preferred mechanism, as per Forrest documentation.
  
  --dviner
  
  Revision  Changes    Path
  1.3       +10 -9     
xml-xindice/src/documentation/content/xdocs/community/howto/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/book.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- book.xml  21 Nov 2002 22:39:50 -0000      1.2
  +++ book.xml  22 Nov 2002 19:39:25 -0000      1.3
  @@ -1,15 +1,16 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" 
"http://localhost/forrest/dtd/book-cocoon-v10.dtd";>
  +<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" 
"book-cocoon-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
     - Author: Vladimir R. Bossicard ([EMAIL PROTECTED])
  +  - Author: Dave Viner ([EMAIL PROTECTED])
     -->
   <book software="Xindice" title="Xindice installation HOWTOs" copyright="2002 
The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink";>
  -     <menu label="Compilation How-Tos">
  -             <menu-item label="Windows" href="compilation/windows.html"/>
  -             <menu-item label="Unix" href="compilation/unix.html"/>
  -     </menu>
  -     <menu label="Installation How-Tos">
  -             <menu-item label="Tomcat How-to" 
href="installation/tomcat.html"/>
  -     </menu>
  +    <menu label="Compilation How-Tos">
  +        <menu-item label="Windows" href="compilation/windows.html"/>
  +        <menu-item label="Unix" href="compilation/unix.html"/>
  +    </menu>
  +    <menu label="Installation How-Tos">
  +        <menu-item label="Tomcat How-to" href="installation/tomcat.html"/>
  +    </menu>
   </book>
  
  
  
  1.3       +41 -57    
xml-xindice/src/documentation/content/xdocs/community/howto/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml 21 Nov 2002 22:39:50 -0000      1.2
  +++ index.xml 22 Nov 2002 19:39:25 -0000      1.3
  @@ -1,63 +1,47 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" 
"http://localhost/forrest/dtd/document-v11.dtd";>
  +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" 
"document-v11.dtd">
   <!--
     - Version: $Revision$ $Date$
       -->
   <document>
  -     <header>
  -             <title>Xindice Compilation How-Tos</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -                     <person name="Vladimir R. Bossicard" email="[EMAIL 
PROTECTED]"/>
  -             </authors>
  -     </header>
  -     <!--
  -     <audience title="Intended audience">
  -             <p>These How-tos are aimed at developers who want to compile 
Xindice sources on their local platform.</p>
  -     </audience>
  -     <prerequisites title="Prerequisites">
  -             <p>The most important prerequisite is patience.  Take lots of 
deep breaths.  It will work.  It just might take some time.</p>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <p>Just choose your platform, and give it a try.</p>
  -             <ul>
  -                     <li><link href="windows.html">Windows</link></li>
  -                     <li><link href="unix.html">Unix</link></li>
  -             </ul>
  -             <p>If you run into problems, don't worry.  Be sure to send 
<link href="../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  -     </steps>
  --->
  -     <body>
  -             <section>
  -                     <title>Overview</title>
  -                     <p>This is a collection of How-tos. The Xindice project 
is actively
  +    <header>
  +        <title>Xindice Compilation How-Tos</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +            <person name="Vladimir R. Bossicard" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +    </header>
  +    <body>
  +        <section>
  +            <title>Overview</title>
  +            <p>This is a collection of How-tos. The Xindice project is 
actively
               seeking additional How-to contributors to expand this 
collection. Look for the fixme tables if you want to contribute, but don't know 
which parts are lacking.</p>
  -                     <section>
  -                             <title>Compiling Xindice</title>
  -                             <ul>
  -                                     <li>
  -                                             <link 
href="compilation/index.html">Introduction</link>
  -                                     </li>
  -                                     <li>
  -                                             <link 
href="compilation/windows.html">Windows</link>
  -                                     </li>
  -                                     <li>
  -                                             <link 
href="compilation/unix.html">Unix</link>
  -                                     </li>
  -                             </ul>
  -                     </section>
  -                     <section>
  -                             <title>Installing Xindice</title>
  -                             <ul>
  -                                     <li>
  -                                             <link 
href="installation/tomcat.html">Tomcat installation</link>
  -                                     </li>
  -                             </ul>
  -                     </section>
  -                     <section>
  -                             <title>Configuring Xindice</title>
  -                     </section>
  -             </section>
  -     </body>
  +            <section>
  +                <title>Compiling Xindice</title>
  +                <ul>
  +                    <li>
  +                        <link 
href="compilation/index.html">Introduction</link>
  +                    </li>
  +                    <li>
  +                        <link href="compilation/windows.html">Windows</link>
  +                    </li>
  +                    <li>
  +                        <link href="compilation/unix.html">Unix</link>
  +                    </li>
  +                </ul>
  +            </section>
  +            <section>
  +                <title>Installing Xindice</title>
  +                <ul>
  +                    <li>
  +                        <link href="installation/tomcat.html">Tomcat 
installation</link>
  +                    </li>
  +                </ul>
  +            </section>
  +            <section>
  +                <title>Configuring Xindice</title>
  +            </section>
  +        </section>
  +    </body>
   </document>
  
  
  
  1.2       +12 -11    
xml-xindice/src/documentation/content/xdocs/community/howto/compilation/book.xml
  
  Index: book.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/compilation/book.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- book.xml  21 Nov 2002 22:39:50 -0000      1.1
  +++ book.xml  22 Nov 2002 19:39:25 -0000      1.2
  @@ -1,17 +1,18 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" 
"http://localhost/forrest/dtd/book-cocoon-v10.dtd";>
  +<!DOCTYPE book PUBLIC "-//APACHE//DTD Cocoon Documentation Book V1.0//EN" 
"book-cocoon-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
     - Author: Vladimir R. Bossicard ([EMAIL PROTECTED])
  +  - Author: Dave Viner ([EMAIL PROTECTED])
     -->
   <book software="Xindice" title="Xindice compilation HOWTOs" copyright="2002 
The Apache Foundation" xmlns:xlink="http://www.w3.org/1999/xlink";>
  -     <menu label="How-Tos">
  -             <menu-item label="Index" href="../index.html"/>
  -     </menu>
  -     <menu label="Compilation How-Tos">
  -             <menu-item label="Introduction" href="index.html"/>
  -             <menu-item label="Prerequisites" href="prereqs.html"/>
  -             <menu-item label="Windows" href="windows.html"/>
  -             <menu-item label="Unix" href="unix.html"/>
  -     </menu>
  +    <menu label="How-Tos">
  +        <menu-item label="Index" href="../index.html"/>
  +    </menu>
  +    <menu label="Compilation How-Tos">
  +        <menu-item label="Introduction" href="index.html"/>
  +        <menu-item label="Prerequisites" href="prereqs.html"/>
  +        <menu-item label="Windows" href="windows.html"/>
  +        <menu-item label="Unix" href="unix.html"/>
  +    </menu>
   </book>
  
  
  
  1.2       +29 -68    
xml-xindice/src/documentation/content/xdocs/community/howto/compilation/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/compilation/index.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.xml 21 Nov 2002 22:39:50 -0000      1.1
  +++ index.xml 22 Nov 2002 19:39:25 -0000      1.2
  @@ -1,73 +1,34 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" 
"http://localhost/forrest/dtd/howto-v10.dtd";>
  +<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "howto-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
       -->
   <howto>
  -     <header>
  -             <title>Xindice Compilation How-Tos</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -                     <person name="Vladimir R. Bossicard" email="[EMAIL 
PROTECTED]"/>
  -             </authors>
  -             <last-modified-content-date date="2002-11-21"/>
  -     </header>
  -     <audience title="Intended audience">
  -             <p>These How-tos are aimed at developers who want to compile 
Xindice sources on their local platform.</p>
  -     </audience>
  -     <prerequisites title="Prerequisites">
  -             <p>The most important prerequisite is patience.  Take lots of 
deep breaths.  It will work.  It just might take some time.</p>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <p>Just choose your platform, and give it a try.</p>
  -             <ul>
  -                     <li><link href="windows.html">Windows</link></li>
  -                     <li><link href="unix.html">Unix</link></li>
  -             </ul>
  -             <p>If you run into problems, don't worry.  Be sure to send 
<link href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  -     </steps>
  -<!--
  -     <body>
  -             <section>
  -                     <title>Overview</title>
  -                     <p>This is a collection of How-tos. The Xindice project 
is actively
  -            seeking additional How-to contributors to expand this 
collection.</p>
  -                     <section>
  -                             <title>Compiling Xindice</title>
  -                             <ul>
  -                                     <li>
  -                                             <link 
href="compilation/index.html">Introduction</link>
  -                                     </li>
  -                                     <li>
  -                                             <link 
href="compilation/windows.html">Windows</link>
  -                                     </li>
  -                                     <li>
  -                                             <link 
href="compilation/unix.html">Unix</link>
  -                                     </li>
  -                             </ul>
  -                     </section>
  -                     <section>
  -                             <title>Installing Xindice</title>
  -                             <ul>
  -                                     <li>
  -                                             <link 
href="installation/tomcat.html">Tomcat installation</link>
  -                                     </li>
  -                                     <li>
  -                                             Obtain the Xindice release code.
  -                                     </li>
  -                                     <li>
  -                                             Compile the Xindice source code
  -                                     </li>
  -                                     <li>
  -                                             Copy the xindice*.war file from 
dist/xindice*.war to $CATALINA_HOME/webapps
  -                                     </li>
  -                                     <li>
  -                                             Restart Tomcat
  -                                     </li>
  -                             </ul>
  -                     </section>
  -             </section>
  -     </body>
  --->
  +    <header>
  +        <title>Xindice Compilation How-Tos</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +            <person name="Vladimir R. Bossicard" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +        <last-modified-content-date date="2002-11-21"/>
  +    </header>
  +    <audience title="Intended audience">
  +        <p>These How-tos are aimed at developers who want to compile Xindice 
sources on their local platform.</p>
  +    </audience>
  +    <prerequisites title="Prerequisites">
  +        <p>The most important prerequisite is patience.  Take lots of deep 
breaths.  It will work.  It just might take some time.</p>
  +    </prerequisites>
  +    <steps title="Steps">
  +        <p>Just choose your platform, and give it a try.</p>
  +        <ul>
  +            <li>
  +                <link href="windows.html">Windows</link>
  +            </li>
  +            <li>
  +                <link href="unix.html">Unix</link>
  +            </li>
  +        </ul>
  +        <p>If you run into problems, don't worry.  Be sure to send <link 
href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  +    </steps>
   </howto>
  
  
  
  1.2       +23 -23    
xml-xindice/src/documentation/content/xdocs/community/howto/compilation/prereqs.xml
  
  Index: prereqs.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/compilation/prereqs.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- prereqs.xml       21 Nov 2002 22:39:50 -0000      1.1
  +++ prereqs.xml       22 Nov 2002 19:39:25 -0000      1.2
  @@ -1,28 +1,28 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" 
"http://localhost/forrest/dtd/howto-v10.dtd";>
  +<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "howto-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
     -->
   <howto>
  -     <header>
  -             <title>Compilation Prerequisites</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -             </authors>
  -             <last-modified-content-date date="2002-11-21"/>
  -     </header>
  -     <audience title="Intended audience">
  -             <p>This How-to is aimed at developers who want to prepare for 
compiling the Xindice sources.</p>
  -     </audience>
  -     <purpose title="Purpose">
  -             <p> Following the steps of this how-to should allow you to 
compile Xindice on windows.</p>
  -     </purpose>
  -     <prerequisites title="Prerequisites">
  -             <p>All you need is an internet connection and some patience.</p>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <p>Obtain a working version of the JDK 1.3 or higher.  You can 
get the jdk from lots of places, one of which is <fork 
href="http://java.sun.com/j2se/downloads.html";>Sun</fork>.</p>
  -             <p>Obtain the Xindice <link 
href="../../../download.html">sources</link> from the download page.</p>
  -     </steps>
  +    <header>
  +        <title>Compilation Prerequisites</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +        <last-modified-content-date date="2002-11-21"/>
  +    </header>
  +    <audience title="Intended audience">
  +        <p>This How-to is aimed at developers who want to prepare for 
compiling the Xindice sources.</p>
  +    </audience>
  +    <purpose title="Purpose">
  +        <p> Following the steps of this how-to should allow you to compile 
Xindice on windows.</p>
  +    </purpose>
  +    <prerequisites title="Prerequisites">
  +        <p>All you need is an internet connection and some patience.</p>
  +    </prerequisites>
  +    <steps title="Steps">
  +        <p>Obtain a working version of the JDK 1.3 or higher.  You can get 
the jdk from lots of places, one of which is <fork 
href="http://java.sun.com/j2se/downloads.html";>Sun</fork>.</p>
  +        <p>Obtain the Xindice <link 
href="../../../download.html">sources</link> from the download page.</p>
  +    </steps>
   </howto>
  
  
  
  1.2       +47 -48    
xml-xindice/src/documentation/content/xdocs/community/howto/compilation/unix.xml
  
  Index: unix.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/compilation/unix.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- unix.xml  21 Nov 2002 22:39:50 -0000      1.1
  +++ unix.xml  22 Nov 2002 19:39:25 -0000      1.2
  @@ -1,53 +1,52 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" 
"http://localhost/forrest/dtd/howto-v10.dtd";>
  +<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "howto-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
       -->
   <howto>
  -     <header>
  -             <title>Compiling Xindice on Unix</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -             </authors>
  -             <last-modified-content-date date="2002-11-21"/>
  -     </header>
  -     
  -     <audience title="Intended audience">
  -             <p>This How-to is aimed at developers who want to compile 
Xindice on Unix.</p>
  -     </audience>
  -     <purpose title="Purpose">
  -             <p>Following the steps of this how-to should allow you to 
compile Xindice on unix.</p>
  -     </purpose>
  -     <prerequisites title="Prerequisites">
  -             <p>See the <link href="prereqs.html">prerequisites</link> 
page.</p>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <fixme author="dviner">Can someone verify these steps on a unix 
machine?</fixme>
  -             <section>
  -                     <title>Don't skip the prerequisites</title>
  -                     <p>Be sure to follow the <link 
href="prereqs.html">prerequisites.</link>
  -                     </p>
  -             </section>
  -             <section>
  -                     <title>Verify your environment</title>
  -                     <p>Get a new xterm window</p>
  -                     <p>Make sure you have the JAVA_HOME environment 
variable set.</p>
  -                     <source>
  +    <header>
  +        <title>Compiling Xindice on Unix</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +        <last-modified-content-date date="2002-11-21"/>
  +    </header>
  +    <audience title="Intended audience">
  +        <p>This How-to is aimed at developers who want to compile Xindice on 
Unix.</p>
  +    </audience>
  +    <purpose title="Purpose">
  +        <p>Following the steps of this how-to should allow you to compile 
Xindice on unix.</p>
  +    </purpose>
  +    <prerequisites title="Prerequisites">
  +        <p>See the <link href="prereqs.html">prerequisites</link> page.</p>
  +    </prerequisites>
  +    <steps title="Steps">
  +        <fixme author="dviner">Can someone verify these steps on a unix 
machine?</fixme>
  +        <section>
  +            <title>Don't skip the prerequisites</title>
  +            <p>Be sure to follow the <link 
href="prereqs.html">prerequisites.</link>
  +            </p>
  +        </section>
  +        <section>
  +            <title>Verify your environment</title>
  +            <p>Get a new xterm window</p>
  +            <p>Make sure you have the JAVA_HOME environment variable set.</p>
  +            <source>
   quintara:~&gt; echo $JAVA_HOME
   /usr/java/jdk1.3.1_02
   quintara:~&gt; 
                        </source>
  -             </section>
  -             <section>
  -                     <title>Compile</title>
  -                     <p>Navigate to your the location where you untarred 
your Xindice sources and run the compile.</p>
  -                     <fixme author="dviner">What does the compilation look 
like in Unix?</fixme>
  -             </section>
  -             <section>
  -                     <title>Verify the compilation</title>
  -                     <p>If the compile was succeeded, you will find the 
output files in the dist/ subdirectory.</p>
  -                     <source>
  +        </section>
  +        <section>
  +            <title>Compile</title>
  +            <p>Navigate to your the location where you untarred your Xindice 
sources and run the compile.</p>
  +            <fixme author="dviner">What does the compilation look like in 
Unix?</fixme>
  +        </section>
  +        <section>
  +            <title>Verify the compilation</title>
  +            <p>If the compile was succeeded, you will find the output files 
in the dist/ subdirectory.</p>
  +            <source>
   quintara:~&gt;ls -l dist
   total 2778
   -rw-r--r--  1 dviner  users     9467 Nov 21 11:56 xindice-1.1b-examples.jar
  @@ -55,10 +54,10 @@
   -rw-r--r--  1 dviner  users  2421719 Nov 21 11:56 xindice-1.1b.war
   quintara:~&gt;
                        </source>
  -             </section>
  -             <section>
  -                     <title>Feedback</title>
  -                     <p>If you run into problems, don't worry.  Be sure to 
send <link href="../../../mail.html">feedback</link> so that we can improve 
these documents for the next person.</p>
  -             </section>
  -     </steps>
  +        </section>
  +        <section>
  +            <title>Feedback</title>
  +            <p>If you run into problems, don't worry.  Be sure to send <link 
href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  +        </section>
  +    </steps>
   </howto>
  
  
  
  1.2       +48 -47    
xml-xindice/src/documentation/content/xdocs/community/howto/compilation/windows.xml
  
  Index: windows.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/compilation/windows.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- windows.xml       21 Nov 2002 22:39:50 -0000      1.1
  +++ windows.xml       22 Nov 2002 19:39:25 -0000      1.2
  @@ -1,49 +1,50 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" 
"http://localhost/forrest/dtd/howto-v10.dtd";>
  +<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "howto-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
       -->
   <howto>
  -     <header>
  -             <title>Compiling Xindice on Windows</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -             </authors>
  -             <last-modified-content-date date="2002-11-21"/>
  -     </header>
  -     <audience title="Intended audience">
  -             <p>This How-to is aimed at developers who want to compile 
Xindice on Windows.</p>
  -     </audience>
  -     <purpose title="Purpose">
  -             <p> 
  +    <header>
  +        <title>Compiling Xindice on Windows</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +        <last-modified-content-date date="2002-11-21"/>
  +    </header>
  +    <audience title="Intended audience">
  +        <p>This How-to is aimed at developers who want to compile Xindice on 
Windows.</p>
  +    </audience>
  +    <purpose title="Purpose">
  +        <p> 
                 Following the steps of this how-to should allow you to compile 
Xindice on windows.
           </p>
  -     </purpose>
  -     <prerequisites title="Prerequisites">
  -             <p>See the <link href="prereqs.html">prerequisites</link> 
page.</p>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <section>
  -                     <title>Don't skip the prerequisites</title>
  -                     <p>Be sure to follow the <link 
href="prereqs.html">prerequisites.</link></p>
  -             </section>
  -             <section>
  -                     <title>Verify your environment</title>
  -                     <p>Open a new command window.  Click Start, choose Run. 
 Enter cmd and hit return.  A new command window should appear.</p>
  -                     <p>Make sure you have the JAVA_HOME environment 
variable set.</p>
  -                     <source>
  +    </purpose>
  +    <prerequisites title="Prerequisites">
  +        <p>See the <link href="prereqs.html">prerequisites</link> page.</p>
  +    </prerequisites>
  +    <steps title="Steps">
  +        <section>
  +            <title>Don't skip the prerequisites</title>
  +            <p>Be sure to follow the <link 
href="prereqs.html">prerequisites.</link>
  +            </p>
  +        </section>
  +        <section>
  +            <title>Verify your environment</title>
  +            <p>Open a new command window.  Click Start, choose Run.  Enter 
cmd and hit return.  A new command window should appear.</p>
  +            <p>Make sure you have the JAVA_HOME environment variable set.</p>
  +            <source>
   C:\&gt;echo %JAVA_HOME%
   C:\j2sdk1.4.1_01
   
   C:\&gt;                      
                        </source>
  -             </section>
  -             <section>
  -                     <title>Compile</title>
  -                     <p>Navigate to your the location where you unzipped 
your Xindice sources and run the compile.</p>
  -                     <note>This example assumes that you unzip the Xindice 
sources into D:\xindice\current.  If you unzip the sources elsewhere, just 
substitute that path for D:\xindice\current.</note>
  -                     <source>
  +        </section>
  +        <section>
  +            <title>Compile</title>
  +            <p>Navigate to your the location where you unzipped your Xindice 
sources and run the compile.</p>
  +            <note>This example assumes that you unzip the Xindice sources 
into D:\xindice\current.  If you unzip the sources elsewhere, just substitute 
that path for D:\xindice\current.</note>
  +            <source>
   C:\&gt;d:
   
   D:\&gt;cd xindice\current\xml-xindice
  @@ -120,12 +121,12 @@
   
   D:\xindice\current\xml-xindice&gt;                                           
                        </source>
  -                     <note>Your compile will probably show a few more lines 
reporting that some files were compiled.  I omitted those for brevity.</note>
  -             </section>
  -             <section>
  -                     <title>Verify the compilation</title>
  -                     <p>If the compile was succeeded, you will find the 
output files in the dist\ subdirectory.</p>
  -                     <source>
  +            <note>Your compile will probably show a few more lines reporting 
that some files were compiled.  I omitted those for brevity.</note>
  +        </section>
  +        <section>
  +            <title>Verify the compilation</title>
  +            <p>If the compile was succeeded, you will find the output files 
in the dist\ subdirectory.</p>
  +            <source>
   D:\xindice\current\xml-xindice&gt;dir dist
    Volume in drive D is Data
    Volume Serial Number is A3EB-9689
  @@ -142,10 +143,10 @@
   
   D:\xindice\current\xml-xindice&gt;                                           
                        </source>
  -             </section>      
  -             <section>
  -                     <title>Feedback</title>
  -                     <p>If you run into problems, don't worry.  Be sure to 
send <link href="../../../mail.html">feedback</link> so that we can improve 
these documents for the next person.</p>
  -             </section>
  -     </steps>
  +        </section>
  +        <section>
  +            <title>Feedback</title>
  +            <p>If you run into problems, don't worry.  Be sure to send <link 
href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  +        </section>
  +    </steps>
   </howto>
  
  
  
  1.2       +47 -48    
xml-xindice/src/documentation/content/xdocs/community/howto/installation/tomcat.xml
  
  Index: tomcat.xml
  ===================================================================
  RCS file: 
/home/cvs/xml-xindice/src/documentation/content/xdocs/community/howto/installation/tomcat.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- tomcat.xml        21 Nov 2002 22:39:51 -0000      1.1
  +++ tomcat.xml        22 Nov 2002 19:39:26 -0000      1.2
  @@ -1,35 +1,35 @@
   <?xml version="1.0" encoding="UTF-8"?>
  -<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" 
"http://localhost/forrest/dtd/howto-v10.dtd";>
  +<!DOCTYPE howto PUBLIC "-//APACHE//DTD How-to V1.0//EN" "howto-v10.dtd">
   <!--
     - Version: $Revision$ $Date$
       -->
   <howto>
  -     <header>
  -             <title>Xindice Tomcat How-To</title>
  -             <version>1.0</version>
  -             <authors>
  -                     <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  -             </authors>
  -             <last-modified-content-date date="2002-11-21"/>
  -     </header>
  -     <audience title="Intended audience">
  -             <p>This How-to is aimed at developers or administrators who 
want to install Xindice with Tomcat.</p>
  -     </audience>
  -     <prerequisites title="Prerequisites">
  -             <p>The most important prerequisite is patience.  Take lots of 
deep breaths.  It will work.  It just might take some time.</p>
  -             <ul>
  -                     <li>You should have already compiled <link 
href="../compilation/index.html">Xindice</link>.</li>
  -                     <li>You must have an existing installation of Tomcat.  
You should use version 4.1.12 or higher. You can install <fork 
href="http://jakarta.apache.org/tomcat/";>Tomcat</fork> from the Jakarta website.
  +    <header>
  +        <title>Xindice Tomcat How-To</title>
  +        <version>1.0</version>
  +        <authors>
  +            <person name="Dave Viner" email="[EMAIL PROTECTED]"/>
  +        </authors>
  +        <last-modified-content-date date="2002-11-21"/>
  +    </header>
  +    <audience title="Intended audience">
  +        <p>This How-to is aimed at developers or administrators who want to 
install Xindice with Tomcat.</p>
  +    </audience>
  +    <prerequisites title="Prerequisites">
  +        <p>The most important prerequisite is patience.  Take lots of deep 
breaths.  It will work.  It just might take some time.</p>
  +        <ul>
  +            <li>You should have already compiled <link 
href="../compilation/index.html">Xindice</link>.</li>
  +            <li>You must have an existing installation of Tomcat.  You 
should use version 4.1.12 or higher. You can install <fork 
href="http://jakarta.apache.org/tomcat/";>Tomcat</fork> from the Jakarta website.
                        </li>
  -                     <li>Be sure to set the CATALINA_HOME environmental 
variable to point to the location of your Tomcat installation.</li>
  -             </ul>
  -     </prerequisites>
  -     <steps title="Steps">
  -             <section>
  -                     <title>Copy the war file</title>
  -                     <p>If you've followed the prerequisites, then you will 
have a working version of Tomcat installed, and the sources of Xindice 
compiled.  Now, copy the xindice*.war file from dist to 
%CATALINA_HOME%/webapps</p>
  -                     <p>Here's what that looks like in Windows</p>
  -                     <source>
  +            <li>Be sure to set the CATALINA_HOME environmental variable to 
point to the location of your Tomcat installation.</li>
  +        </ul>
  +    </prerequisites>
  +    <steps title="Steps">
  +        <section>
  +            <title>Copy the war file</title>
  +            <p>If you've followed the prerequisites, then you will have a 
working version of Tomcat installed, and the sources of Xindice compiled.  Now, 
copy the xindice*.war file from dist to %CATALINA_HOME%/webapps</p>
  +            <p>Here's what that looks like in Windows</p>
  +            <source>
   D:\xindice\current\xml-xindice&gt;dir dist
    Volume in drive D is Data
    Volume Serial Number is A3EB-9689
  @@ -50,14 +50,14 @@
   
   D:\xindice\current\xml-xindice&gt;
                        </source>
  -                     <note>In this example, I have built Xindice in 
D:\xindice\current.  If you compile the source in another location, just 
substitute that path for D:\xindice\current.</note>
  -                     <fixme author="dviner">Need some unix examples 
here.</fixme>
  -             </section>
  -             <section>
  -                     <title>Restart Tomcat</title>
  -                     <p>Restart your Tomcat server to be certain that it 
picks up the Xindice servlet.</p>
  -                     <p>Here's what that looks like in Windows</p>
  -                     <source>
  +            <note>In this example, I have built Xindice in 
D:\xindice\current.  If you compile the source in another location, just 
substitute that path for D:\xindice\current.</note>
  +            <fixme author="dviner">Need some unix examples here.</fixme>
  +        </section>
  +        <section>
  +            <title>Restart Tomcat</title>
  +            <p>Restart your Tomcat server to be certain that it picks up the 
Xindice servlet.</p>
  +            <p>Here's what that looks like in Windows</p>
  +            <source>
   D:\xindice\current\xml-xindice&gt;cd %CATALINA_HOME%\bin
   
   D:\jakarta-tomcat-4.1.12\bin&gt;startup
  @@ -67,13 +67,13 @@
   Using JAVA_HOME:       C:\j2sdk1.4.1_01
   D:\jakarta-tomcat-4.1.12\bin&gt;
                        </source>
  -                     <note>In this example, I have installed Tomcat in 
D:\jakarta-tomcat-4.1.12.  If you've installed it in another location, just 
ensure that the CATALINA_HOME environmental variable points to your Tomcat 
installation directory, or substitute that path for 
D:\jakarta-tomcat-4.1.12.</note>
  -                     <fixme author="dviner">Need some unix examples 
here.</fixme>
  -             </section>
  -             <section>
  -                     <title>Verify the installation</title>
  -                     <p>When Tomcat restarts on Windows, you should see a 
new window open entitled 'Tomcat', and it should look something like this.  
(Note the xindice classes loading.)</p>
  -                     <source>
  +            <note>In this example, I have installed Tomcat in 
D:\jakarta-tomcat-4.1.12.  If you've installed it in another location, just 
ensure that the CATALINA_HOME environmental variable points to your Tomcat 
installation directory, or substitute that path for 
D:\jakarta-tomcat-4.1.12.</note>
  +            <fixme author="dviner">Need some unix examples here.</fixme>
  +        </section>
  +        <section>
  +            <title>Verify the installation</title>
  +            <p>When Tomcat restarts on Windows, you should see a new window 
open entitled 'Tomcat', and it should look something like this.  (Note the 
xindice classes loading.)</p>
  +            <source>
   Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry loadRegistry
   INFO: Loading registry information
   Nov 21, 2002 1:42:07 PM org.apache.commons.modeler.Registry getRegistry
  @@ -95,12 +95,11 @@
   Nov 21, 2002 1:42:24 PM org.apache.jk.server.JkMain start
   INFO: Jk running ID=0 time=20/70  
config=D:\jakarta-tomcat-4.1.12\conf\jk2.properties
                        </source>
  -                     <fixme author="dviner">Need some unix examples 
here.</fixme>
  -                     <p>In addition, you should be able to verify that 
xindice is running by loading this URL in your browser 
http://localhost:8080/xindice-1.1b
  +            <fixme author="dviner">Need some unix examples here.</fixme>
  +            <p>In addition, you should be able to verify that xindice is 
running by loading this URL in your browser http://localhost:8080/xindice-1.1b
                        If it works, you should see something that says "THIS 
IS AN UGLY DEBUG TOOL!".
                        </p>
  -             </section>              
  -             <p>If you run into problems, don't worry.  Be sure to send 
<link href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  -     </steps>
  +        </section>
  +        <p>If you run into problems, don't worry.  Be sure to send <link 
href="../../../mail.html">feedback</link> so that we can improve these 
documents for the next person.</p>
  +    </steps>
   </howto>
  -

cvs commit: xml-xindice/src/documentation/content/xdocs/community/howto/installation tomcat.xml

Reply via email to