xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From vgritse...@apache.org
Subject svn commit: r602294 [8/10] - in /xml/site/targets/xindice: ./ 1.0/ 1.1/ 1.1/howto/ 1.2/ 1.2/howto/ dev/ skin/ skin/images/
Date Sat, 08 Dec 2007 02:01:42 GMT
Added: xml/site/targets/xindice/1.2/guide-user.html
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/guide-user.html?rev=602294&view=auto
==============================================================================
--- xml/site/targets/xindice/1.2/guide-user.html (added)
+++ xml/site/targets/xindice/1.2/guide-user.html Fri Dec  7 18:01:36 2007
@@ -0,0 +1,764 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Xindice 1.1 User Guide</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a> &gt; <a href="http://xml.apache.org/xindice/">xindice</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://xml.apache.org"><img class="logoImage" alt="XML Apache" src="../images/group-logo.gif" title="Apache XML Project"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/xindice/"><img class="logoImage" alt="Xindice" src="../images/xindice.gif" title="Apache Xindice: Native XML database"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../1.0/index.html">1.0</a>
+</li>
+<li>
+<a class="unselected" href="../1.1/index.html">1.1</a>
+</li>
+<li class="current">
+<a class="selected" href="../1.2/index.html">1.2-Dev</a>
+</li>
+<li>
+<a class="unselected" href="../dev/index.html">Dev</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Overview</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/index.html">Overview</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../1.2/guide-administrator.html">Administrator Guide</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">User Guide</div>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-developer.html">Developer Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-tools.html">Tool Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-xpath.html">XPath Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/faq.html">FAQ</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="../api/index.html">Javadocs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">How-Tos</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_1.3.2', '../skin/')" id="menu_1.3.2Title" class="menutitle">Compilation</div>
+<div id="menu_1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/compilation-unix.html">Unix</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/howto/compilation-windows.html">Windows</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.3', '../skin/')" id="menu_1.3.3Title" class="menutitle">Installation</div>
+<div id="menu_1.3.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/installation-tomcat.html">Tomcat How-to</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.4', '../skin/')" id="menu_1.3.4Title" class="menutitle">Upgrading</div>
+<div id="menu_1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/upgrading-one-one.html">From 1.1b1 and up</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/howto/upgrading-one-oh.html">From 1.0</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../skin/')" id="menu_1.4Title" class="menutitle">Resources</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="http://xmldb-org.sourceforge.net/">XML:DB Initiative</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<script language="Javascript" type="text/javascript">
+function printit() {
+  if (window.print) {
+    window.focus();
+    window.print();
+  }
+}
+        </script><script language="Javascript" type="text/javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+  document.write('<div title="Print this Page" class="printlink">');
+  document.write('  <a class="dida" href="javascript:printit()">');
+  document.write('    <img alt="print - icon" src="../skin/images/printer.gif" class="skin">');
+  document.write('    <br>');
+  document.write('  PRINT</a>');
+  document.write('</div>');
+}
+        </script>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="guide-user.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Xindice 1.1 User Guide</h1>
+<div class="abstract"></div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Getting+Started+with+Xindice">Getting Started with Xindice</a>
+<ul class="minitoc">
+<li>
+<a href="#Introduction+to+XML+Databases">Introduction to XML Databases</a>
+</li>
+<li>
+<a href="#Apache+Xindice">Apache Xindice</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Introduction+to+Xindice">Introduction to Xindice</a>
+<ul class="minitoc">
+<li>
+<a href="#What+Is+Xindice">What Is Xindice</a>
+</li>
+<li>
+<a href="#Current+Status">Current Status</a>
+</li>
+<li>
+<a href="#Feature+Summary">Feature Summary</a>
+</li>
+<li>
+<a href="#Database+Structure">Database Structure</a>
+<ul class="minitoc">
+<li>
+<a href="#Collection+Path+Example">Collection Path Example</a>
+</li>
+<li>
+<a href="#Collection+Path+Referencing+a+Document">Collection Path Referencing a Document</a>
+</li>
+<li>
+<a href="#Collection+Path+Referencing+a+remote+Document">Collection Path Referencing a remote Document</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Introducing+the+Command+Line+Tools">Introducing the Command Line Tools</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Managing+Documents">Managing Documents</a>
+<ul class="minitoc">
+<li>
+<a href="#Introduction">Introduction</a>
+</li>
+<li>
+<a href="#Adding+Documents">Adding Documents</a>
+<ul class="minitoc">
+<li>
+<a href="#Adding+a+Document+With+a+Given+Key">Adding a Document With a Given Key</a>
+</li>
+<li>
+<a href="#Adding+a+Document+Without+a+Key">Adding a Document Without a Key</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Retrieving+Documents">Retrieving Documents</a>
+<ul class="minitoc">
+<li>
+<a href="#Retrieving+a+Document+Using+an+ID">Retrieving a Document Using an ID</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Deleting+Documents">Deleting Documents</a>
+<ul class="minitoc">
+<li>
+<a href="#Deleting+a+document+using+an+ID">Deleting a document using an ID</a>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Querying+the+Database">Querying the Database</a>
+<ul class="minitoc">
+<li>
+<a href="#Executing+an+XPath+query+against+a+collection+of+XML+documents">Executing an XPath query against a collection of XML documents</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+      
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+        If you notice incorrectness in this documentation, please
+        <a href="../mail.html">notify</a> Xindice community. Your feedback
+        will help create better documentation.
+      </div>
+</div>
+
+      
+<a name="N10024"></a><a name="Getting+Started+with+Xindice"></a>
+<h2 class="h3">Getting Started with Xindice</h2>
+<div class="section">
+<a name="N1002A"></a><a name="Introduction+to+XML+Databases"></a>
+<h3 class="h4">Introduction to XML Databases</h3>
+<a name="N1002F"></a><a name="Apache+Xindice"></a>
+<h3 class="h4">Apache Xindice</h3>
+</div>
+
+      
+<a name="N10035"></a><a name="Introduction+to+Xindice"></a>
+<h2 class="h3">Introduction to Xindice</h2>
+<div class="section">
+<a name="N1003B"></a><a name="What+Is+Xindice"></a>
+<h3 class="h4">What Is Xindice</h3>
+<p>
+               The Xindice Core server is a database server designed from the
+               ground up to store XML data. The
+               Xindice server is what is termed by
+               the
+               <a href="http://xmldb-org.sourceforge.net/">XML:DB Initiative</a>
+               as a Native XML Database. You could also refer to it as a
+               seamless XML database which might be an easier to understand
+               description.
+            </p>
+<p>
+               What this means is that to the largest extent possible you work
+               with XML tools and technologies when working with the data in the
+               server. All data that goes into and out of the server is XML. The
+               query language used is XPath and the programming APIs support DOM
+               and SAX. All things that should be familiar to a developer used
+               to using XML in their applications. When working with XML data and
+               Xindice there is no mapping between different data models. You simply
+               design your data as XML and store it as XML.
+            </p>
+<p>
+               What this gives you can be summed up in one word, flexibility. XML
+               provides an extremely flexible mechanism for modeling application
+               data and in many cases will allow you to model constructs that are
+               difficult or impossible to model in more traditional systems. This
+               model is a semi-structured model and for some applications it is
+               an essential component. By
+               using a native XML database such as Xindice to store this data you can
+               focus on building your applications and not worry about how the
+               complex XML construct maps to the underlying data store or trying
+               force a flexible data model into a rigid set of schema constraints.
+            </p>
+<p>
+               Ultimately though, Xindice is a tool. It will be right for some jobs
+               and completely wrong for others. The job it is best at is simply
+               storing XML data. In fact, that's all it does. If you have lots of
+               XML data then Xindice may just be the right tool. However, if your
+               data isn't XML or if you have the need for precise control over
+               the structure of the data you might be better off using another
+               database solution.
+            </p>
+<a name="N10052"></a><a name="Current+Status"></a>
+<h3 class="h4">Current Status</h3>
+<p>
+               Native XML database technology is a very new area and Xindice is very
+               much a project still in development.
+               The server currently supports storing well formed XML documents.
+               This means it does not have any schema that constrains what
+               can be placed into a document collection. This makes Xindice a
+               semi-structured database and provides tremendous
+               flexiblity in how you store your data, but, also means you give up
+               some common database functionality such as data
+               types.
+               In its current state Xindice is already a powerful tool for managing
+               XML data. However, there is still much that needs to be done.
+               Feedback and contributions are actively encouraged.
+            </p>
+<p>
+               This document attempts to
+               describe those features that are working and can be used today.
+               You should review the README file that is part of the Xindice
+               distribution for the most current status on the project.
+            </p>
+<a name="N1005F"></a><a name="Feature+Summary"></a>
+<h3 class="h4">Feature Summary</h3>
+<p>
+               
+<strong>Document Collections</strong>: Documents are stored in
+               collections that can be queried as a whole. You can create
+               collections that contain just documents of the same type or you
+               can create a collection to store all your documents together.
+               The database doesn't care.
+            </p>
+<p>
+               
+<strong>XPath Query Engine</strong>: To query the Document
+               Collections you use <a href="http://www.w3.org/TR/xpath">XPath</a>
+               as defined by the W3C. This provides a reasonably flexible mechanism
+               for querying documents by navigating and restricting the result tree
+               that is returned.
+            </p>
+<p>
+               
+<strong>XML Indexing</strong>: In order to improve the performance
+               of queries over large numbers of documents you can define indexes on
+               element and attribute values. This can dramatically speed up query
+               response time.
+            </p>
+<p>
+               
+<strong>XML:DB XUpdate Implementation</strong>: When you store XML
+               in the database you may want to be able to change that data without
+               retrieving the entire document. XUpdate is the mechanism to use when
+               you want to do server side updates of the data. It is an XML based
+               language for specifying XML modifications and allows those modifications
+               to be applied to entire document collections as well as single documents.
+            </p>
+<p>
+               
+<strong>Java XML:DB API Implementation</strong>: For Java programmers
+               Xindice provides an implementation of the XML:DB API. This API is
+               intended to bring portability to XML database applications just as
+               JDBC has done for relational databases. Most applications developed
+               for Xindice will use the XML:DB API.
+            </p>
+<p>
+               
+<strong>Command Line Management Tools</strong>: To aid the administrator
+               Xindice provides a full suite of command line driven management tools.
+               Just about everything you can do through the XML:DB API can also be
+               done from the command line.
+            </p>
+<p>
+               
+<strong>Modular Architecture</strong>: The Xindice server is
+               constructed in a very modular manner. This makes it easy to add and
+               remove components to tailor the server to a particular environment or
+               to embed it into another application.
+            </p>
+<a name="N10096"></a><a name="Database+Structure"></a>
+<h3 class="h4">Database Structure</h3>
+<p>
+               The Xindice server is designed to store collections of XML documents.
+               Collections can be arranged in a hierarchy similar to that of a
+               typical UNIX or Windows file system.
+            </p>
+<p>
+               In Xindice the data store is rooted in a database instance that can
+               also be used as a document collection. This
+               database instance can then contain any number of child collections.
+               In a default install of Xindice the database instance is called
+               'db' and all collection paths will begin with /db. It is possible to
+               rename the database instance if desired though it is not necessary
+               to do so.
+            </p>
+<p>
+               Collections are referenced in a similar manner to how you
+               would work with a hierarchical file system.
+            </p>
+<a name="N100A5"></a><a name="Collection+Path+Example"></a>
+<h4>Collection Path Example</h4>
+<p>
+                  If you had a collection
+                  created under 'db' called my-collection and a collection under
+                  that called my-child-collection the path used when accessing the
+                  my-child-collection collection would be
+               </p>
+<pre class="code">
+  /db/my-collection/my-child-collection
+                  </pre>
+<p>
+               Within collections there are several types of objects that can be
+               stored. You can store XML documents, XMLObjects and other
+               collections. Each of these objects can also be referenced via a
+               path.</p>
+<a name="N100B6"></a><a name="Collection+Path+Referencing+a+Document"></a>
+<h4>Collection Path Referencing a Document</h4>
+<p>
+                  Extending the previous example by adding a document to
+                  my-child-collection named my-document it to could be
+                  referenced via a path.
+               </p>
+<pre class="code">
+  /db/my-collection/my-child-collection/my-document
+                  </pre>
+<p>
+               There is one catch to this however. Since you can have more then one
+               object in a collection with the same name
+               there is an order of precedence that is applied when evaluating a
+               path. The order of precendence is collection followed by XMLObject
+               and then document. What this means is that if you have a document
+               and a collection with the same name you will not be able to retrieve
+               the document.
+            </p>
+<p>
+               You can also access collections on remote machines by specifying the host
+               and port of the server.
+            </p>
+<a name="N100CA"></a><a name="Collection+Path+Referencing+a+remote+Document"></a>
+<h4>Collection Path Referencing a remote Document</h4>
+<p>
+                  If the previous example was on a remote machine the path would look
+                  something like this.
+               </p>
+<pre class="code">
+  myhost.domain.com:8080/db/my-collection/my-child-collection/my-document
+                  </pre>
+<p>
+                  This can also take the form of a Xindice URI.
+               </p>
+<pre class="code">
+  xindice://myhost.domain.com:8080/db/my-collection/my-child-collection/my-document
+                  </pre>
+<a name="N100E0"></a><a name="Introducing+the+Command+Line+Tools"></a>
+<h3 class="h4">Introducing the Command Line Tools</h3>
+<p>
+               The Xindice server includes a command line program named
+               <span class="codefrag">xindice</span> that allows you to manage the
+               data stored in the server.
+               A complete list of available commands and more
+               detail about each command can be found in the
+               <a href="guide-tools.html">Command Line Tools Reference Guide</a>.
+            </p>
+<p>
+               The
+               <span class="codefrag">xindice</span> tool is located in the
+               Xindice-Core/bin directory and it is
+               probably a good idea to add this directory to your PATH environment
+               variable. All examples in this manual will assume that the
+               Xindice-Core/bin directory is on the operating system path.
+            </p>
+</div>
+      
+<a name="N100F8"></a><a name="Managing+Documents"></a>
+<h2 class="h3">Managing Documents</h2>
+<div class="section">
+<a name="N100FE"></a><a name="Introduction"></a>
+<h3 class="h4">Introduction</h3>
+<p>
+               In many ways the Xindice database can be viewed as a simple file
+               store. This is of course a highly simplified view of things but
+               is a useful place to get started in learning the functionality of
+               the server.
+            </p>
+<p>
+               The Xindice server provides facilities to store, retrieve and
+               delete well formed XML documents.
+            </p>
+<a name="N1010B"></a><a name="Adding+Documents"></a>
+<h3 class="h4">Adding Documents</h3>
+<p></p>
+<a name="N10113"></a><a name="Adding+a+Document+With+a+Given+Key"></a>
+<h4>Adding a Document With a Given Key</h4>
+<p>
+                  The document fx102.xml will be added to the collection
+                  /db/data/products and will be stored under the key fx102.
+               </p>
+<pre class="code">
+  xindice add_document -c /db/data/products -f fx102.xml -n fx102
+                  </pre>
+<a name="N10121"></a><a name="Adding+a+Document+Without+a+Key"></a>
+<h4>Adding a Document Without a Key</h4>
+<p>
+                  The document fx102.xml will be added to the collection
+                  /db/data/products. No key is provided so one will be generated
+                  automatically by the server. The generated key will look similar
+                  to this 0625df6b0001a5d4000bc49d0060b6f5
+               </p>
+<pre class="code">
+  xindice add_document -c /db/data/products -f fx102.xml
+                  </pre>
+<a name="N10130"></a><a name="Retrieving+Documents"></a>
+<h3 class="h4">Retrieving Documents</h3>
+<p>
+               Documents can be retrieved from the database using the ID that
+               they were inserted under.
+            </p>
+<a name="N10139"></a><a name="Retrieving+a+Document+Using+an+ID"></a>
+<h4>Retrieving a Document Using an ID</h4>
+<p>
+                  The document identified by the key fx102 will be retrieved from
+                  the /db/data/products collection and stored in the file fx102.xml
+               </p>
+<pre class="code">
+  xindice retrieve_document -c /db/data/products -n fx102 -f fx102.xml
+                  </pre>
+<a name="N10148"></a><a name="Deleting+Documents"></a>
+<h3 class="h4">Deleting Documents</h3>
+<p></p>
+<a name="N10150"></a><a name="Deleting+a+document+using+an+ID"></a>
+<h4>Deleting a document using an ID</h4>
+<p>
+                  The document identified by the key fx102 will be removed from the
+                  collection /db/data/products.
+               </p>
+<pre class="code">
+  xindice delete_document -c /db/data/products -n fx102
+                  </pre>
+</div>
+      
+<a name="N10160"></a><a name="Querying+the+Database"></a>
+<h2 class="h3">Querying the Database</h2>
+<div class="section">
+<p>
+            Xindice currently supports XPath as a query language. In many
+            applications XPath is only applied at the document level but in
+            Xindice XPath queries can be executed at either the document level
+            or the collection level. This
+            means that a query can be run against multiple documents and the
+            result set will contain all matching nodes from all documents
+            in the collection.
+            The Xindice server also supports the creation of indexes on
+            XML documents to speed up commonly used XPath queries. Please refer
+            to the
+            <a href="guide-administrator.html">Administrators
+               Guide</a> for more detail about configuring indexes.
+         </p>
+<p>
+            You can execute XPath queries against the database using the command
+            line tools and the result of the query will be displayed.
+         </p>
+<a name="N10170"></a><a name="Executing+an+XPath+query+against+a+collection+of+XML+documents"></a>
+<h3 class="h4">Executing an XPath query against a collection of XML documents</h3>
+<p>
+               Here we assume we have a collection /db/data/products that contains
+               documents that are similar to the following.
+            </p>
+<pre class="code">
+  &lt;?xml version="1.0"?&gt;
+  &lt;product product_id="120320"&gt;
+    &lt;description&gt;Glazed Ham&lt;/description&gt;
+  &lt;/product&gt;
+            </pre>
+<p>
+               The XPath /product[@product_id="120320"] will be executed against
+               the collection /db/data/products and all matching product entries
+               will be returned.
+            </p>
+<pre class="code">
+  xindice xpath_query -c /db/data/products -q "/product[@product_id='120320']"
+            </pre>
+<p>
+               The result of the query is an XPath node-set that contains one
+               node for each result. In this particular example there is only
+               one result and the node that matches is the root element so you
+               get back basically the whole document.
+            </p>
+<p>
+               To make it easy to link the result node back to the originating
+               document, Xindice adds a few attributes to the result. These attributes
+               are added in the Query namespace that has the URI
+               <span class="codefrag">http://xml.apache.org/xindice/Query</span>. The
+               <span class="codefrag">col</span> attribute specifies the collection where the document
+               can be found and the <span class="codefrag">key</span> attribute
+               provides the key of the original document. Using this information it
+               is possible to retrieve the original document that this node was
+               selected from for further processing.
+            </p>
+<pre class="code">
+  &lt;product product_id="120320"
+           xmlns:src="http://xml.apache.org/xindice/Query"
+           src:col="/db/data/products" src:key="120320"&gt;
+    &lt;description&gt;Glazed Ham&lt;/description&gt;
+  &lt;/product&gt;
+            </pre>
+<p>
+               If more then one result is found the results look something like
+               this. This could be the result of the query /product
+            </p>
+<pre class="code">
+  &lt;product product_id="120320"
+           xmlns:src="http://xml.apache.org/xindice/Query"
+           src:col="/db/data/products" src:key="120320"&gt;
+    &lt;description&gt;Glazed Ham&lt;/description&gt;
+  &lt;/product&gt;
+  &lt;product product_id="120321"
+           xmlns:src="http://xml.apache.org/xindice/Query"
+           src:col="/db/data/products" src:key="120321"&gt;
+    &lt;description&gt;Boiled Ham&lt;/description&gt;
+  &lt;/product&gt;
+  &lt;product product_id="120322"
+           xmlns:src="http://xml.apache.org/xindice/Query"
+           src:col="/db/data/products" src:key="120322"&gt;
+    &lt;description&gt;Honey Ham&lt;/description&gt;
+  &lt;/product&gt;
+            </pre>
+<p>
+            While it is certainly useful to be able to query from the command
+            line it is  probably more useful to be able to use the results of a
+            query in an application. For more information on building
+            applications for Xindice, please refer to the
+            <a href="guide-developer.html">Developers Guide</a>.
+         </p>
+</div>
+
+      <!--
+         <section>
+            <title>XMLDB Error codes</title>
+            <p>
+               public static final int UNKNOWN_ERROR = 0;
+               public static final int VENDOR_ERROR = 1;
+               public static final int NOT_IMPLEMENTED = 2;
+               public static final int WRONG_CONTENT_TYPE = 3;
+               public static final int PERMISSION_DENIED = 4;
+               public static final int INVALID_URI = 5;
+               public static final int NO_SUCH_SERVICE = 100;
+               public static final int NO_SUCH_COLLECTION = 200;
+               public static final int INVALID_COLLECTION = 201;
+               public static final int COLLECTION_CLOSED = 202;
+               public static final int NO_SUCH_RESOURCE = 300;
+               public static final int INVALID_RESOURCE = 301;
+               public static final int UNKNOWN_RESOURCE_TYPE = 302;
+               public static final int NO_SUCH_DATABASE = 400;
+               public static final int INVALID_DATABASE = 401;
+            </p>
+         </section>
+      -->
+   
+<p align="right">
+<font size="-2">by&nbsp;Kimbro Staken</font>
+</p>
+<span class="version">
+          version 598114</span>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2001-2007 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: xml/site/targets/xindice/1.2/guide-user.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xml/site/targets/xindice/1.2/guide-user.html
------------------------------------------------------------------------------
    svn:keywords = Id Revision Author Date

Added: xml/site/targets/xindice/1.2/guide-user.pdf
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/guide-user.pdf?rev=602294&view=auto
==============================================================================
Binary file - no diff available.

Propchange: xml/site/targets/xindice/1.2/guide-user.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: xml/site/targets/xindice/1.2/guide-xpath.html
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/guide-xpath.html?rev=602294&view=auto
==============================================================================
--- xml/site/targets/xindice/1.2/guide-xpath.html (added)
+++ xml/site/targets/xindice/1.2/guide-xpath.html Fri Dec  7 18:01:36 2007
@@ -0,0 +1,504 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Xindice 1.2 XPath Guide</title>
+<link type="text/css" href="../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../skin/profile.css" rel="stylesheet">
+<script src="../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a> &gt; <a href="http://xml.apache.org/xindice/">xindice</a><script src="../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://xml.apache.org"><img class="logoImage" alt="XML Apache" src="../images/group-logo.gif" title="Apache XML Project"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/xindice/"><img class="logoImage" alt="Xindice" src="../images/xindice.gif" title="Apache Xindice: Native XML database"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../1.0/index.html">1.0</a>
+</li>
+<li>
+<a class="unselected" href="../1.1/index.html">1.1</a>
+</li>
+<li class="current">
+<a class="selected" href="../1.2/index.html">1.2-Dev</a>
+</li>
+<li>
+<a class="unselected" href="../dev/index.html">Dev</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../skin/')" id="menu_1.1Title" class="menutitle">Overview</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/index.html">Overview</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', '../skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('../skin/images/chapter_open.gif');">Documentation</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../1.2/guide-administrator.html">Administrator Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-user.html">User Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-developer.html">Developer Guide</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/guide-tools.html">Tool Guide</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">XPath Guide</div>
+</div>
+<div class="menuitem">
+<a href="../1.2/faq.html">FAQ</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="../api/index.html">Javadocs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', '../skin/')" id="menu_1.3Title" class="menutitle">How-Tos</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_1.3.2', '../skin/')" id="menu_1.3.2Title" class="menutitle">Compilation</div>
+<div id="menu_1.3.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/compilation-unix.html">Unix</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/howto/compilation-windows.html">Windows</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.3', '../skin/')" id="menu_1.3.3Title" class="menutitle">Installation</div>
+<div id="menu_1.3.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/installation-tomcat.html">Tomcat How-to</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.4', '../skin/')" id="menu_1.3.4Title" class="menutitle">Upgrading</div>
+<div id="menu_1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../1.2/howto/upgrading-one-one.html">From 1.1b1 and up</a>
+</div>
+<div class="menuitem">
+<a href="../1.2/howto/upgrading-one-oh.html">From 1.0</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../skin/')" id="menu_1.4Title" class="menutitle">Resources</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="http://xmldb-org.sourceforge.net/">XML:DB Initiative</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<script language="Javascript" type="text/javascript">
+function printit() {
+  if (window.print) {
+    window.focus();
+    window.print();
+  }
+}
+        </script><script language="Javascript" type="text/javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+  document.write('<div title="Print this Page" class="printlink">');
+  document.write('  <a class="dida" href="javascript:printit()">');
+  document.write('    <img alt="print - icon" src="../skin/images/printer.gif" class="skin">');
+  document.write('    <br>');
+  document.write('  PRINT</a>');
+  document.write('</div>');
+}
+        </script>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="guide-xpath.pdf"><img alt="PDF -icon" src="../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Xindice 1.2 XPath Guide</h1>
+<div class="abstract"></div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Querying+the+Database">Querying the Database</a>
+</li>
+<li>
+<a href="#Sample+Database">Sample Database</a>
+</li>
+<li>
+<a href="#Query+for+Document">Query for Document</a>
+</li>
+<li>
+<a href="#Query+for+Element">Query for Element</a>
+</li>
+<li>
+<a href="#Query+for+Text+Node">Query for Text Node</a>
+</li>
+<li>
+<a href="#Query+for+String">Query for String</a>
+</li>
+<li>
+<a href="#Query+for+Number">Query for Number</a>
+</li>
+<li>
+<a href="#Using+full+text+search+in+XPath">Using full text search in XPath</a>
+</li>
+</ul>
+</div>
+    
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+      If you notice incorrectness in this documentation, please
+      <a href="../mail.html">notify</a> Xindice community. Your feedback
+      will help create better documentation.
+    </div>
+</div>
+
+    
+<a name="N10024"></a><a name="Querying+the+Database"></a>
+<h2 class="h3">Querying the Database</h2>
+<div class="section">
+<p>
+        Xindice currently supports XPath as a query language. Queries can
+        be executed from within client application (please refer to the
+        <a href="guide-developer.html">developers guide</a>), through
+        XML-RPC interface, or via a command line (please refer to the
+        <a href="guide-tools.html">command line tool guide</a>).
+        This document describes what XPath queries are supported and what are
+        the results of the query.
+      </p>
+</div>
+
+    
+<a name="N10036"></a><a name="Sample+Database"></a>
+<h2 class="h3">Sample Database</h2>
+<div class="section">
+<p>
+        XPath queries and results described below were run against sample
+        /db/addressbook collection. There are two documents in the addressbook
+        collection.
+      </p>
+<p>Key: <span class="codefrag">address1</span>
+</p>
+<pre class="code">
+  &lt;?xml version="1.0"?&gt;
+  &lt;person&gt;
+    &lt;fname&gt;John&lt;/fname&gt;
+    &lt;lname&gt;Smith&lt;/lname&gt;
+    &lt;phone type="work"&gt;563-456-7890&lt;/phone&gt;
+    &lt;phone type="home"&gt;534-567-8901&lt;/phone&gt;   
+    &lt;email type="home"&gt;jsmith@somemail.com&lt;/email&gt;
+    &lt;email type="work"&gt;john@lovesushi.com&lt;/email&gt;
+    &lt;address type="home"&gt;34 S. Colon St.&lt;/address&gt;
+    &lt;address type="work"&gt;9967 W. Shrimp Ave.&lt;/address&gt;
+  &lt;/person&gt;
+      </pre>
+<p>Key: <span class="codefrag">address2</span>
+</p>
+<pre class="code">
+  &lt;?xml version="1.0"?&gt;
+  &lt;person&gt;
+    &lt;fname&gt;SlackJawedLocal&lt;/fname&gt;
+    &lt;lname&gt;Cletus&lt;/lname&gt;
+    &lt;phone type="work"&gt;123-456-7890&lt;/phone&gt;
+    &lt;phone type="home"&gt;234-567-8901&lt;/phone&gt;
+    &lt;phone type="cell"&gt;345-678-9012&lt;/phone&gt;
+    &lt;email type="home"&gt;cletus@hotmail.com&lt;/email&gt;
+    &lt;email type="work"&gt;cletus@micrsquish.com&lt;/email&gt;
+    &lt;address type="home"&gt;1234 S. Elm St.&lt;/address&gt;
+    &lt;address type="work"&gt;4567 W. Pine St.&lt;/address&gt;
+  &lt;/person&gt;
+      </pre>
+</div>
+
+    
+<a name="N10052"></a><a name="Query+for+Document"></a>
+<h2 class="h3">Query for Document</h2>
+<div class="section">
+<p>
+        One of the common usages for XPath is to obtain documents satisfying
+        some criteria. Suppose we want to find everybody with the cell phone:
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "/person[phone/@type='cell']"  </pre>
+<p>
+        Result of the query will be one or more documents. If you have only two
+        person entries in the collection, then only one result will be found:
+      </p>
+<pre class="code">
+  &lt;person xmlns:src="http://xml.apache.org/xindice/Query"
+          src:col="/db/addressbook" src:key="address2"&gt;
+    &lt;fname&gt;SlackJawedLocal&lt;/fname&gt;
+    &lt;lname&gt;Cletus&lt;/lname&gt;
+    &lt;phone type="work"&gt;123-456-7890&lt;/phone&gt;
+    &lt;phone type="home"&gt;234-567-8901&lt;/phone&gt;
+    &lt;phone type="cell"&gt;345-678-9012&lt;/phone&gt;
+    &lt;email type="home"&gt;cletus@hotmail.com&lt;/email&gt;
+    &lt;email type="work"&gt;cletus@micrsquish.com&lt;/email&gt;
+    &lt;address type="home"&gt;1234 S. Elm St.&lt;/address&gt;
+    &lt;address type="work"&gt;4567 W. Pine St.&lt;/address&gt;
+  &lt;/person&gt;
+      </pre>
+</div>
+
+    
+<a name="N10067"></a><a name="Query+for+Element"></a>
+<h2 class="h3">Query for Element</h2>
+<div class="section">
+<p>
+        Here we will issue a query resulting only in some elements from the document.
+        Suppose we want to find everybody's home phone numbers:
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "/person/phone[@type='home']"  </pre>
+<p>
+        Result of the query will be all elements satisfying criteria from all documents.
+      </p>
+<pre class="code">
+  &lt;phone src:col="/db/addressbook" src:key="address1"
+         xmlns:src="http://xml.apache.org/xindice/Query"
+         type="home"&gt;534-567-8901&lt;/phone&gt;
+  &lt;phone src:col="/db/addressbook" src:key="address2"
+         xmlns:src="http://xml.apache.org/xindice/Query"
+         type="home"&gt;234-567-8901&lt;/phone&gt;
+      </pre>
+</div>
+
+    
+<a name="N1007C"></a><a name="Query+for+Text+Node"></a>
+<h2 class="h3">Query for Text Node</h2>
+<div class="section">
+<p>
+        With Xindice 1.1b4 and above, it is possible to query for text nodes. Each
+        resulting text node will be wrapped into <span class="codefrag">result</span> element in the
+        Query namespace.
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "/person[fname='John']/phone/text()"  </pre>
+<p>
+        Result of the query will be all phones for all Johns in the collection.
+      </p>
+<pre class="code">
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address1"&gt;563-456-7890&lt;/xq:result&gt;
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address1"&gt;534-567-8901&lt;/xq:result&gt;
+      </pre>
+</div>
+
+    
+<a name="N10094"></a><a name="Query+for+String"></a>
+<h2 class="h3">Query for String</h2>
+<div class="section">
+<p>
+        XPath expressions with String result are also supported.
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "string(/person[fname='John']/phone)"  </pre>
+<p>
+        Result of the query will be first phone number for all Johns in the collection,
+        and empty result for each non-John.
+      </p>
+<pre class="code">
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address1"&gt;563-456-7890&lt;/xq:result&gt;
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address2"&gt;&lt;/xq:result&gt;
+      </pre>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+        Because XPath is evaluated against each document, and because
+        <span class="codefrag">string()</span> function always returns a result, such query will produce
+        result from each document in the collection. In this example, result from second
+        document is empty, as criteria <span class="codefrag">fname='John'</span> was not satisfied.
+      </div>
+</div>
+</div>
+
+    
+<a name="N100B2"></a><a name="Query+for+Number"></a>
+<h2 class="h3">Query for Number</h2>
+<div class="section">
+<p>
+        XPath expressions with Number result are also supported. 
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "count(/person/phone)"  </pre>
+<p>
+        This XPath will return count of phone numbers on file for each person. If person
+        does not have phone numbers, result for this person will be <span class="codefrag">0.0</span>.
+      </p>
+<pre class="code">
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address1"&gt;2.0&lt;/xq:result&gt;
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address2"&gt;3.0&lt;/xq:result&gt;
+      </pre>
+</div>
+
+    
+<a name="N100CA"></a><a name="Using+full+text+search+in+XPath"></a>
+<h2 class="h3">Using full text search in XPath</h2>
+<div class="section">
+<p>
+        Full text search functionality is available in XPath queries in Xindice as an extention function.
+      </p>
+<p>Function: boolean ftcontains(string)</p>
+<p>
+        The ftcontains function returns true if text content of the context
+        node matches full text query passed as the argument, otherwise it
+        returns false. Text query syntax is the same as
+        <a href="http://lucene.apache.org/java/docs/queryparsersyntax.html">Lucene query syntax</a>,
+        except it does not use fields (using fields does not cause errors
+        when parsing the query, but function will return false).
+      </p>
+<pre class="code">  xindice xpath -c /db/addressbook -q "/person/address[@type='work']/text()[ftcontains('pine')]"  </pre>
+<p>
+        This XPath will return all work addresses of all people in database that
+        contain word 'pine'.
+      </p>
+<pre class="code">
+  &lt;xq:result xmlns:xq="http://xml.apache.org/xindice/Query"
+             xq:col="/db/addressbook" xq:key="address2"&gt;4567 W. Pine St.&lt;/xq:result&gt;
+      </pre>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+        Function results depend on the analyzer that is used to tokenize both
+        node text content and a query. If LuceneIndexer exists for the
+        collection being queried, same analyzer will be used for the ftcontains
+        function to produce consistent results. If LuceneIndexer is not found,
+        default analyzer will be used (at this time it is SimpleAnalyzer).
+      </div>
+</div>
+</div>
+  
+<p align="right">
+<font size="-2">by&nbsp;Vadim Gritsenko</font>
+</p>
+<span class="version">
+          version 598114</span>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2001-2007 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: xml/site/targets/xindice/1.2/guide-xpath.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xml/site/targets/xindice/1.2/guide-xpath.html
------------------------------------------------------------------------------
    svn:keywords = Id Revision Author Date

Added: xml/site/targets/xindice/1.2/guide-xpath.pdf
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/guide-xpath.pdf?rev=602294&view=auto
==============================================================================
Binary file - no diff available.

Propchange: xml/site/targets/xindice/1.2/guide-xpath.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: xml/site/targets/xindice/1.2/howto/compilation-unix.html
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/howto/compilation-unix.html?rev=602294&view=auto
==============================================================================
--- xml/site/targets/xindice/1.2/howto/compilation-unix.html (added)
+++ xml/site/targets/xindice/1.2/howto/compilation-unix.html Fri Dec  7 18:01:36 2007
@@ -0,0 +1,400 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Compiling Xindice on Unix</title>
+<link type="text/css" href="../../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../../skin/profile.css" rel="stylesheet">
+<script src="../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a> &gt; <a href="http://xml.apache.org/xindice/">xindice</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://xml.apache.org"><img class="logoImage" alt="XML Apache" src="../../images/group-logo.gif" title="Apache XML Project"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/xindice/"><img class="logoImage" alt="Xindice" src="../../images/xindice.gif" title="Apache Xindice: Native XML database"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../../1.0/index.html">1.0</a>
+</li>
+<li>
+<a class="unselected" href="../../1.1/index.html">1.1</a>
+</li>
+<li class="current">
+<a class="selected" href="../../1.2/index.html">1.2-Dev</a>
+</li>
+<li>
+<a class="unselected" href="../../dev/index.html">Dev</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../../skin/')" id="menu_1.1Title" class="menutitle">Overview</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/index.html">Overview</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', '../../skin/')" id="menu_1.2Title" class="menutitle">Documentation</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/guide-administrator.html">Administrator Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-user.html">User Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-developer.html">Developer Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-tools.html">Tool Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-xpath.html">XPath Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/faq.html">FAQ</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="../../api/index.html">Javadocs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">How-Tos</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../1.2/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3.2', '../../skin/')" id="menu_selected_1.3.2Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Compilation</div>
+<div id="menu_selected_1.3.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Unix</div>
+</div>
+<div class="menuitem">
+<a href="../../1.2/howto/compilation-windows.html">Windows</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.3', '../../skin/')" id="menu_1.3.3Title" class="menutitle">Installation</div>
+<div id="menu_1.3.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/howto/installation-tomcat.html">Tomcat How-to</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.4', '../../skin/')" id="menu_1.3.4Title" class="menutitle">Upgrading</div>
+<div id="menu_1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/howto/upgrading-one-one.html">From 1.1b1 and up</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/howto/upgrading-one-oh.html">From 1.0</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../../skin/')" id="menu_1.4Title" class="menutitle">Resources</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="http://xmldb-org.sourceforge.net/">XML:DB Initiative</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<script language="Javascript" type="text/javascript">
+function printit() {
+  if (window.print) {
+    window.focus();
+    window.print();
+  }
+}
+        </script><script language="Javascript" type="text/javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+  document.write('<div title="Print this Page" class="printlink">');
+  document.write('  <a class="dida" href="javascript:printit()">');
+  document.write('    <img alt="print - icon" src="../../skin/images/printer.gif" class="skin">');
+  document.write('    <br>');
+  document.write('  PRINT</a>');
+  document.write('</div>');
+}
+        </script>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="compilation-unix.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Compiling Xindice on Unix</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Intended audience">Intended audience</a>
+</li>
+<li>
+<a href="#Purpose">Purpose</a>
+</li>
+<li>
+<a href="#Prerequisites">Prerequisites</a>
+</li>
+<li>
+<a href="#Steps">Steps</a>
+<ul class="minitoc">
+<li>
+<a href="#Place+holders+used+in+the+Steps">Place holders used in the Steps</a>
+</li>
+<li>
+<a href="#Verify+your+environment">Verify your environment</a>
+</li>
+<li>
+<a href="#Compile">Compile</a>
+</li>
+<li>
+<a href="#Verify+the+compilation">Verify the compilation</a>
+</li>
+<li>
+<a href="#Feedback">Feedback</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<a name="N1001C"></a><a name="Intended audience"></a>
+<h2 class="h3">Intended audience</h2>
+<div class="section">
+<p>This How-to is aimed at developers who want to compile Xindice from the
+      source distribution or from a Subversion checkout on Unix platform.</p>
+</div>
+<a name="N10024"></a><a name="Purpose"></a>
+<h2 class="h3">Purpose</h2>
+<div class="section">
+<p>Following the steps of this how-to should allow you to compile Xindice on unix platform.</p>
+</div>
+<a name="N1002C"></a><a name="Prerequisites"></a>
+<h2 class="h3">Prerequisites</h2>
+<div class="section">
+<p>
+      Obtain a working version of the JDK 1.4 or higher. You can get the jdk
+      from lots of places, one of which is <a target="_blank" href="http://java.sun.com/j2se/downloads.html">Sun</a>.
+    </p>
+<p>
+      Obtain the Xindice <a href="../../download.html">sources</a> from the download page or via
+      <a href="http://xml.apache.org/svn.html">Subversion checkout</a>.
+    </p>
+</div>
+<a name="N10043"></a><a name="Steps"></a>
+<h2 class="h3">Steps</h2>
+<div class="section">
+<a name="N10048"></a><a name="Place+holders+used+in+the+Steps"></a>
+<h3 class="h4">Place holders used in the Steps</h3>
+<p>
+      
+</p>
+<ul>
+        
+<li>
+          
+<span class="codefrag">{XINDICE_HOME}</span> - Directory where you have untarred your Xindice source files.
+        </li>
+        
+<li>
+          
+<span class="codefrag">{JAVA_VERSION}</span> - Installed JDK Version.
+        </li>
+      
+</ul>
+<a name="N10061"></a><a name="Verify+your+environment"></a>
+<h3 class="h4">Verify your environment</h3>
+<p>
+        Make sure you have the JAVA_HOME environment variable set. If you are
+        running Mac OS X, build script will attempt to guess it so you get away
+        with skipping this step.
+      </p>
+<pre class="code">
+  $ echo $JAVA_HOME
+  /usr/java/jdk{JAVA_VERSION}
+      </pre>
+<a name="N1006F"></a><a name="Compile"></a>
+<h3 class="h4">Compile</h3>
+<p>Navigate to the location where you untarred your Xindice sources
+        (or to your svn checkout of Xindice source code) and run the
+        <span class="codefrag">build.sh</span> script. Your output will resemble:
+      </p>
+<pre class="code">
+  $ cd {XINDICE_HOME}      
+  $ ./build.sh
+
+  Apache Xindice Build System
+  ---------------------------
+  Buildfile: build.xml
+
+  init:
+     [echo] Building with Java {JAVA_VERSION}
+
+  compile-src:
+    [mkdir] Created dir: {XINDICE_HOME}/build/classes-dom
+    [javac] Compiling 4 source files to {XINDICE_HOME}/build/classes-dom
+    [mkdir] Created dir: {XINDICE_HOME}/build/classes
+    [javac] Compiling 287 source files to {XINDICE_HOME}/build/classes
+
+  compile-test:
+    [mkdir] Created dir: {XINDICE_HOME}/build/classes-tests
+    [mkdir] Created dir: {XINDICE_HOME}/build/test-results
+    [javac] Compiling 62 source files to {XINDICE_HOME}/build/classes-tests
+     [copy] Copying 65 files to {XINDICE_HOME}/build/classes-tests
+
+  jar:
+      [jar] Building jar: {XINDICE_HOME}/xindice-1.2.jar
+      [jar] Building jar: {XINDICE_HOME}/xindice-dom-1.2.jar
+
+  bin:
+    [mkdir] Created dir: {XINDICE_HOME}/build/bin
+     [copy] Copying 5 files to {XINDICE_HOME}/build/bin
+
+  war:
+     [copy] Copying 1 file to {XINDICE_HOME}
+      [war] Building war: {XINDICE_HOME}/xindice-1.2.war
+
+  BUILD SUCCESSFUL
+  Total time: 5 seconds
+      </pre>
+<div class="warning">
+<div class="label">Warning</div>
+<div class="content">NOTE: Certain flavors of Unix require a space after the
+        <span class="codefrag">#!</span> in the first line of the shell script.  In this case,
+        edit the <span class="codefrag">build.sh</span> file and change the first line from
+        "<span class="codefrag">#!/bin/sh</span>" to "<span class="codefrag">#! /bin/sh</span>".
+      </div>
+</div>
+<a name="N1008F"></a><a name="Verify+the+compilation"></a>
+<h3 class="h4">Verify the compilation</h3>
+<p>If the compile was succeeded, you will find the output files in the current directory.</p>
+<pre class="code">
+  $ ls xindice-*
+  xindice-1.2.jar     xindice-1.2.war     xindice-1.2.xml     xindice-dom-1.2.jar
+      </pre>
+<a name="N1009D"></a><a name="Feedback"></a>
+<h3 class="h4">Feedback</h3>
+<p>If you run into problems, don't worry.  Be sure to send <a href="../../mail.html">feedback</a> so that we can improve these documents for the next person.</p>
+</div>
+<p align="right">
+<font size="-2">by&nbsp;Dave Viner,&nbsp;Vadim Gritsenko</font>
+</p>
+<span class="version">1.2</span>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2001-2007 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: xml/site/targets/xindice/1.2/howto/compilation-unix.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xml/site/targets/xindice/1.2/howto/compilation-unix.html
------------------------------------------------------------------------------
    svn:keywords = Id Revision Author Date

Added: xml/site/targets/xindice/1.2/howto/compilation-unix.pdf
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/howto/compilation-unix.pdf?rev=602294&view=auto
==============================================================================
Binary file - no diff available.

Propchange: xml/site/targets/xindice/1.2/howto/compilation-unix.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: xml/site/targets/xindice/1.2/howto/compilation-windows.html
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/howto/compilation-windows.html?rev=602294&view=auto
==============================================================================
--- xml/site/targets/xindice/1.2/howto/compilation-windows.html (added)
+++ xml/site/targets/xindice/1.2/howto/compilation-windows.html Fri Dec  7 18:01:36 2007
@@ -0,0 +1,404 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>Compiling Xindice on Windows</title>
+<link type="text/css" href="../../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../../skin/profile.css" rel="stylesheet">
+<script src="../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../../">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> &gt; <a href="http://xml.apache.org/">xml.apache</a> &gt; <a href="http://xml.apache.org/xindice/">xindice</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://xml.apache.org"><img class="logoImage" alt="XML Apache" src="../../images/group-logo.gif" title="Apache XML Project"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://xml.apache.org/xindice/"><img class="logoImage" alt="Xindice" src="../../images/xindice.gif" title="Apache Xindice: Native XML database"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="xml.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="../../index.html">Home</a>
+</li>
+<li>
+<a class="unselected" href="../../1.0/index.html">1.0</a>
+</li>
+<li>
+<a class="unselected" href="../../1.1/index.html">1.1</a>
+</li>
+<li class="current">
+<a class="selected" href="../../1.2/index.html">1.2-Dev</a>
+</li>
+<li>
+<a class="unselected" href="../../dev/index.html">Dev</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', '../../skin/')" id="menu_1.1Title" class="menutitle">Overview</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/index.html">Overview</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', '../../skin/')" id="menu_1.2Title" class="menutitle">Documentation</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/guide-administrator.html">Administrator Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-user.html">User Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-developer.html">Developer Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-tools.html">Tool Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/guide-xpath.html">XPath Guide</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/faq.html">FAQ</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="../../api/index.html">Javadocs</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', '../../skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">How-Tos</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../1.2/howto/index.html">Overview</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3.2', '../../skin/')" id="menu_selected_1.3.2Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Compilation</div>
+<div id="menu_selected_1.3.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../1.2/howto/compilation-unix.html">Unix</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Windows</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.3', '../../skin/')" id="menu_1.3.3Title" class="menutitle">Installation</div>
+<div id="menu_1.3.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/howto/installation-tomcat.html">Tomcat How-to</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3.4', '../../skin/')" id="menu_1.3.4Title" class="menutitle">Upgrading</div>
+<div id="menu_1.3.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../1.2/howto/upgrading-one-one.html">From 1.1b1 and up</a>
+</div>
+<div class="menuitem">
+<a href="../../1.2/howto/upgrading-one-oh.html">From 1.0</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', '../../skin/')" id="menu_1.4Title" class="menutitle">Resources</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://wiki.apache.org/xindice">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="http://xmldb-org.sourceforge.net/">XML:DB Initiative</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<script language="Javascript" type="text/javascript">
+function printit() {
+  if (window.print) {
+    window.focus();
+    window.print();
+  }
+}
+        </script><script language="Javascript" type="text/javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+  document.write('<div title="Print this Page" class="printlink">');
+  document.write('  <a class="dida" href="javascript:printit()">');
+  document.write('    <img alt="print - icon" src="../../skin/images/printer.gif" class="skin">');
+  document.write('    <br>');
+  document.write('  PRINT</a>');
+  document.write('</div>');
+}
+        </script>
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="compilation-windows.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Compiling Xindice on Windows</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Intended audience">Intended audience</a>
+</li>
+<li>
+<a href="#Purpose">Purpose</a>
+</li>
+<li>
+<a href="#Prerequisites">Prerequisites</a>
+</li>
+<li>
+<a href="#Steps">Steps</a>
+<ul class="minitoc">
+<li>
+<a href="#Place+holders+used+in+the+Steps">Place holders used in the Steps</a>
+</li>
+<li>
+<a href="#Verify+your+environment">Verify your environment</a>
+</li>
+<li>
+<a href="#Compile">Compile</a>
+</li>
+<li>
+<a href="#Verify+the+compilation">Verify the compilation</a>
+</li>
+<li>
+<a href="#Feedback">Feedback</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<a name="N10018"></a><a name="Intended audience"></a>
+<h2 class="h3">Intended audience</h2>
+<div class="section">
+<p>
+      This How-to is aimed at developers who want to compile Xindice from the
+      source distribution or from a Subversion checkout on Windows.
+    </p>
+</div>
+<a name="N10020"></a><a name="Purpose"></a>
+<h2 class="h3">Purpose</h2>
+<div class="section">
+<p>
+      Following the steps of this how-to should allow you to compile Xindice on Windows.
+    </p>
+</div>
+<a name="N10028"></a><a name="Prerequisites"></a>
+<h2 class="h3">Prerequisites</h2>
+<div class="section">
+<p>
+      Obtain a working version of the JDK 1.4 or higher. You can get the jdk
+      from lots of places, one of which is <a target="_blank" href="http://java.sun.com/j2se/downloads.html">Sun</a>.
+    </p>
+<p>
+      Obtain the Xindice <a href="../../download.html">sources</a> from the download page or via
+      <a href="http://xml.apache.org/svn.html">Subversion checkout</a>.
+    </p>
+</div>
+<a name="N1003F"></a><a name="Steps"></a>
+<h2 class="h3">Steps</h2>
+<div class="section">
+<a name="N10044"></a><a name="Place+holders+used+in+the+Steps"></a>
+<h3 class="h4">Place holders used in the Steps</h3>
+<p>
+      
+</p>
+<ul>
+        
+<li>
+          
+<span class="codefrag">{XINDICE_HOME}</span> - Directory where you have unzipped your Xindice source files.
+        </li>
+        
+<li>
+          
+<span class="codefrag">{JAVA_VERSION}</span> - Installed JDK Version.
+        </li>
+      
+</ul>
+<a name="N1005D"></a><a name="Verify+your+environment"></a>
+<h3 class="h4">Verify your environment</h3>
+<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>
+<pre class="code">
+  &gt; echo %JAVA_HOME%
+  C:\j2sdk{JAVA_VERSION}
+      </pre>
+<a name="N1006E"></a><a name="Compile"></a>
+<h3 class="h4">Compile</h3>
+<p>Navigate to the location where you unzipped your Xindice sources
+        (or to your svn checkout of Xindice source code) and run the
+        <span class="codefrag">build</span> batch file. Your output will resemble:
+      </p>
+<pre class="code">
+  &gt; cd {XINDICE_HOME}
+  &gt; build
+  Using Java from C:\j2sdk{JAVA_VERSION}
+  Buildfile: build.xml
+
+  init:
+     [echo] Building with Java {JAVA_VERSION}
+
+  compile-src:
+    [mkdir] Created dir: {XINDICE_HOME}\build\classes-dom
+    [javac] Compiling 4 source files to {XINDICE_HOME}\build\classes-dom
+    [mkdir] Created dir: {XINDICE_HOME}\build\classes
+    [javac] Compiling 287 source files to {XINDICE_HOME}\build\classes
+
+  compile-test:
+    [mkdir] Created dir: {XINDICE_HOME}\build\classes-tests
+    [mkdir] Created dir: {XINDICE_HOME}\build\test-results
+    [javac] Compiling 62 source files to {XINDICE_HOME}\build\classes-tests
+     [copy] Copying 65 files to {XINDICE_HOME}\build\classes-tests
+
+  jar:
+      [jar] Building jar: {XINDICE_HOME}\xindice-1.2.jar
+      [jar] Building jar: {XINDICE_HOME}\xindice-dom-1.2.jar
+
+  bin:
+    [mkdir] Created dir: {XINDICE_HOME}\build\bin
+     [copy] Copying 5 files to {XINDICE_HOME}\build\bin
+
+  war:
+     [copy] Copying 1 file to {XINDICE_HOME}
+      [war] Building war: {XINDICE_HOME}\xindice-1.2.war
+
+  BUILD SUCCESSFUL
+  Total time: 13 seconds
+      </pre>
+<a name="N1007F"></a><a name="Verify+the+compilation"></a>
+<h3 class="h4">Verify the compilation</h3>
+<p>If the compile was succeeded, you will find the output files in the current directory.</p>
+<pre class="code">
+  &gt; dir xindice-*
+  
+   Directory of {XINDICE_HOME}
+
+  09/27/2007  09:24 PM           628,694 xindice-1.2.jar
+  09/27/2007  09:24 PM         5,184,315 xindice-1.2.war
+  09/27/2007  09:24 PM             1,791 xindice-1.2.xml
+  09/27/2007  09:24 PM             6,535 xindice-dom-1.2.jar
+               4 File(s)      5,821,335 bytes
+               0 Dir(s)   3,745,992,704 bytes free
+      </pre>
+<a name="N1008D"></a><a name="Feedback"></a>
+<h3 class="h4">Feedback</h3>
+<p>If you run into problems, don't worry.  Be sure to send <a href="../../mail.html">feedback</a> so that we can improve these documents for the next person.</p>
+</div>
+<p align="right">
+<font size="-2">by&nbsp;Dave Viner</font>
+</p>
+<span class="version">1.2</span>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2001-2007 The Apache Software Foundation.</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Propchange: xml/site/targets/xindice/1.2/howto/compilation-windows.html
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: xml/site/targets/xindice/1.2/howto/compilation-windows.html
------------------------------------------------------------------------------
    svn:keywords = Id Revision Author Date

Added: xml/site/targets/xindice/1.2/howto/compilation-windows.pdf
URL: http://svn.apache.org/viewvc/xml/site/targets/xindice/1.2/howto/compilation-windows.pdf?rev=602294&view=auto
==============================================================================
Binary file - no diff available.

Propchange: xml/site/targets/xindice/1.2/howto/compilation-windows.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf



---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message