You are viewing a plain text version of this content. The canonical link for it is here.
Posted to xindice-dev@xml.apache.org by dv...@apache.org on 2002/11/22 20:39:26 UTC

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

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 (vladimir@apache.org)
  +  - Author: Dave Viner (dviner@apache.org)
     -->
   <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="dviner@apache.org"/>
  -			<person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  -		</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="dviner@apache.org"/>
  +            <person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  +        </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 (vladimir@apache.org)
  +  - Author: Dave Viner (dviner@apache.org)
     -->
   <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="dviner@apache.org"/>
  -			<person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  -		</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="dviner@apache.org"/>
  +            <person name="Vladimir R. Bossicard" email="vladimir@apache.org"/>
  +        </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="dviner@apache.org"/>
  -		</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="dviner@apache.org"/>
  +        </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="dviner@apache.org"/>
  -		</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="dviner@apache.org"/>
  +        </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="dviner@apache.org"/>
  -		</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="dviner@apache.org"/>
  +        </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="dviner@apache.org"/>
  -		</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="dviner@apache.org"/>
  +        </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>
  -