You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@uima.apache.org by sc...@apache.org on 2006/12/04 17:50:27 UTC

svn commit: r482245 [1/8] - in /incubator/uima/uimaj/trunk/uima-docbooks/src: docbook/ docbook/overview_and_setup/ docbook/tutorials_and_users_guides/ olink/ olink/overview_and_setup/ olink/references/ olink/tools/ olink/tutorials_and_users_guides/ sty...

Author: schor
Date: Mon Dec  4 08:50:24 2006
New Revision: 482245

URL: http://svn.apache.org/viewvc?view=rev&rev=482245
Log:
UIMA-5 getting most of the olinks to work for 1st 2 books

Added:
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/references/
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/references/html-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/references/htmlsingle-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/references/pdf-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tools/html-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tools/htmlsingle-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tools/pdf-target.db
Modified:
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/entities.ent
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/conceptual_overview.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/eclipse_setup.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/glossary.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/project_overview.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/annotator_analysis_engine_guide.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cas_multiplier.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cpe.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.fc.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.xmi_emf.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tutorials_and_users_guides.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_html.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_htmlsingle.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_pdf.xml
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/overview_and_setup/html-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/overview_and_setup/htmlsingle-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/overview_and_setup/pdf-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tutorials_and_users_guides/html-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tutorials_and_users_guides/htmlsingle-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/olink/tutorials_and_users_guides/pdf-target.db
    incubator/uima/uimaj/trunk/uima-docbooks/src/styles/html.xsl
    incubator/uima/uimaj/trunk/uima-docbooks/src/styles/htmlsingle.xsl
    incubator/uima/uimaj/trunk/uima-docbooks/src/styles/pdf.xsl

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/entities.ent
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/entities.ent?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/entities.ent (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/entities.ent Mon Dec  4 08:50:24 2006
@@ -6,8 +6,8 @@
 <!ENTITY ae "Analysis Engine">
 <!ENTITY aae "Aggregate Analysis Engine">
 
-<!ENTITY uima_docs_overview "uima_docs_overview">
-<!ENTITY uima_docs_tutorial_guides "uima_docs_tutorial_guides">
-<!ENTITY uima_docs_tools "uima_docs_tools">
-<!ENTITY uima_docs_ref "uima_docs_ref">
+<!ENTITY uima_docs_overview "overview_and_setup">
+<!ENTITY uima_docs_tutorial_guides "tutorials_and_users_guides">
+<!ENTITY uima_docs_tools "tools">
+<!ENTITY uima_docs_ref "references">
 

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/conceptual_overview.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/conceptual_overview.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/conceptual_overview.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/conceptual_overview.xml Mon Dec  4 08:50:24 2006
@@ -44,12 +44,12 @@
   <para>This chapter provides a general orientation to UIMA and makes liberal reference to
     the other chapters in the UIMA SDK documentation set, where the reader may find detailed
     treatments of key concepts and development practices. It may be useful to refer to <olink
-      targetdoc="uima_docs_overview" targetptr="ugr.glossary"/>, to become familiar
+      targetdoc="&uima_docs_overview;" targetptr="ugr.glossary"/>, to become familiar
     with the terminology in this overview.</para>
   
   <section id="ugr.conceptual_overview.uima_introduction">
     <title>UIMA Introduction</title>
-    <figure>
+    <figure id="ugr.ovv.conceptual.fig.bridge">
       <title>UIMA helps you build the bridge between the unstructured and structured
         worlds</title>
       <mediaobject>
@@ -164,7 +164,7 @@
       Context.</para>
     </blockquote>
     
-    <section>
+    <section id="ugr.ovv.conceptual.aes_annotators_and_analysis_results">
       <title>Analysis Engines, Annotators and Analysis Results</title>
       <figure id="ugr.conceptual_overview.metadata_in_cas">
         <title>Objects represented in the Common Analysis Structure (CAS)</title>
@@ -192,8 +192,8 @@
         video. The majority of examples we provide are for text. We use the term <emphasis
           role="bold">document, </emphasis>therefore, to generally refer to any unit of
         content that an AE may process, whether it is a text document or a segment of audio, for
-        example. See the section <olink targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.multi_sofas"/> for more information on multimodal processing
+        example. See the section <olink targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.mvs"/> for more information on multimodal processing
         in UIMA.</para>
       
       <para>Analysis results include different statements about the content of a document.
@@ -244,8 +244,8 @@
       
       <para>In UIMA the person who codes analysis algorithms takes on the role of the
           <emphasis role="bold">Annotator Developer</emphasis>. <olink
-          targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.annotator_ae_developers_guide"/> will take the reader
+          targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.aae"/> will take the reader
         through the details involved in creating UIMA annotators and analysis
         engines.</para>
       
@@ -256,7 +256,7 @@
         AEs. </para>
     </section>
     
-    <section>
+    <section id="ugr.ovv.conceptual.representing_results_in_cas">
       <title>Representing Analysis Results in the CAS</title>
       
       <para>How annotators represent and share their results is an important part of the UIMA
@@ -276,7 +276,7 @@
       
       <para>The UIMA framework includes an implementation and interfaces to the CAS. For a
         more detailed description of the CAS and its interfaces see <olink
-          targetdoc="uima_docs_ref" targetptr="cas_ref"/>.</para>
+          targetdoc="&uima_docs_ref;" targetptr="cas_ref"/>.</para>
       
       <para>A CAS that logically contains statement 2 (repeated here for your
         convenience)</para>
@@ -313,7 +313,7 @@
         <emphasis>Organization</emphasis>. <emphasis>NounPhrase</emphasis> may be a
         subtype of a <emphasis>ParseNode</emphasis>.</para>
       
-      <section>
+      <section id="ugr.ovv.conceptual.annotation_type">
         <title>The Annotation Type</title>
         
         <para>A general and common type used in artifact analysis and from which additional
@@ -337,7 +337,7 @@
           create another person annotation to record the detection of a mention of a person in
           the span between positions 101 and 112. </para>
       </section>
-      <section>
+      <section id="ugr.ovv.conceptual.not_just_annotations">
         <title>Not Just Annotations</title>
         
         <para>While the annotation type is a useful type for annotating regions of a
@@ -381,7 +381,7 @@
           with the appropriate features to point to regions of an image.</para>
       </section>
       
-      <section>
+      <section id="ugr.ovv.conceptual.multiple_views_within_a_cas">
         <title>Multiple Views within a CAS</title>
         
         <para>UIMA supports the simultaneous analysis of multiple views of a document. This
@@ -398,13 +398,13 @@
           document. Each translation may be represented with a different CAS View. Each
           translation may be described by a different set of analysis results. For more
           details on CAS Views and Sofas see <olink
-            targetdoc="uima_docs_tutorial_guides"
-            targetptr="ugr.multiple_views"/> and <olink
-            targetdoc="uima_docs_tutorial_guilds" targetptr="ugr.sofas"/>. </para>
+            targetdoc="&uima_docs_tutorial_guides;"
+            targetptr="ugr.tug.mvs"/> and <olink
+            targetdoc="&uima_docs_tutorial_guides;" targetptr="ugr.tug.aas"/>. </para>
       </section>
     </section>
     
-    <section>
+    <section id="ugr.ovv.conceptual.interacting_with_cas_and_external_resources">
       <title>Interacting with the CAS and External Resources</title>
       
       <para>The two main interfaces that a UIMA component developer interacts with are the
@@ -414,7 +414,7 @@
         interfaces. Through these interfaces, the annotator developer interacts with the
         document and reads and writes analysis results. The CAS interfaces provide a suite of
         access methods that allow the developer to obtain indexed iterators to the different
-        objects in the CAS. See <olink targetdoc="uima_docs_ref"
+        objects in the CAS. See <olink targetdoc="&uima_docs_ref;"
           targetptr="ugr.cas_ref"/>. While many objects may exist in a CAS, the annotator
         developer can obtain a specialized iterator to all Person objects associated with a
         particular view, for example.</para>
@@ -424,7 +424,7 @@
         type system appears as a Java Class; the UIMA framework renders the Person type as a
         Person class in Java. As the analysis algorithm detects mentions of persons in the
         documents, it can create Person objects in the CAS. For more details on how to interact
-        with the CAS using this interface, refer to <olink targetdoc="uima_docs_ref"
+        with the CAS using this interface, refer to <olink targetdoc="&uima_docs_ref;"
           targetptr="ugr.jcas_ref"/>.</para>
       
       <para>The component developer, in addition to interacting with the CAS, can access
@@ -432,11 +432,11 @@
         called the <emphasis role="bold">UIMA Context</emphasis>. This interface, among
         other things, can ensure that different annotators working together in an aggregate
         flow may share the same instance of an external file, for example. For details on using
-        the UIMA Context see <olink targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.annotator_analysis_engine_guide"/>.</para>
+        the UIMA Context see <olink targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.aae"/>.</para>
       
     </section>
-    <section>
+    <section id="ugr.ovv.conceptual.component_descriptors">
       <title>Component Descriptors</title>
       <para>UIMA defines interfaces for a small set of core components that users of the
         framework provide implmentations for. Annotators and Analysis Engines are two of
@@ -468,9 +468,9 @@
         reuse, composition and development tooling. The UIMA SDK provides tools for easily
         creating and maintaining the component descriptors that relieve the developer from
         editing XML directly. This tool is described briefly in <olink
-          targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.annotator_analysis_engine_developers_guide"/>, and more
-        thoroughly in <olink targetdoc="uima_docs_tools" targetptr="ugr.cde"/>
+          targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.aae"/>, and more
+        thoroughly in <olink targetdoc="&uima_docs_tools;" targetptr="ugr.cde"/>
         .</para>
       
       <para>Component descriptors contain standard metadata including the
@@ -489,7 +489,7 @@
         composition based on desired results. UIMA analysis engines provide an interface
         for accessing the component metadata represented in their descriptors. For more
         details on the structure of UIMA component descriptors refer to <olink
-          targetdoc="uima_docs_ref" targetptr="component_descriptor"/>.</para>
+          targetdoc="&uima_docs_ref;" targetptr="component_descriptor"/>.</para>
       
     </section>
   </section>
@@ -567,25 +567,25 @@
     <para>The UIMA framework facilitates the deployment of AEs as remote services by using an
       adapter layer that automatically creates the necessary infrastructure in response to
       a declaration in the component&apos;s descriptor. For more details on creating
-      aggregate analysis engines refer to <olink targetdoc="uima_docs_ref"
+      aggregate analysis engines refer to <olink targetdoc="&uima_docs_ref;"
         targetptr="ugr.component_descriptor"/> The component descriptor editor tool
       assists in the specification of aggregate AEs from a repository of available engines.
-      For more details on this tool refer to <olink targetdoc="uima_docs_tools"
+      For more details on this tool refer to <olink targetdoc="&uima_docs_tools;"
         targetptr="ugr.cde"/>.</para>
     
     <para>The UIMA framework implementation has two built-in flow implementations: one
       that support a linear flow between components, and one with conditional branching
       based on the language of the document. It also supports user-provided flow
-      controllers, as described in <olink targetdoc="uima_docs_tutorial_guides"
-        targetptr="ugr.flowcontroller"/>. Furthermore, the application developer is
+      controllers, as described in <olink targetdoc="&uima_docs_tutorial_guides;"
+        targetptr="ugr.tug.fc"/>. Furthermore, the application developer is
       free to create multiple AEs and provide their own logic to combine the AEs in arbitrarily
       complex flows. For more details on this the reader may refer to <olink
-        targetdoc="uima_docs_tutorial_guides"
-        targetptr="ugr.application_developer"/>.</para>
+        targetdoc="&uima_docs_tutorial_guides;"
+        targetptr="ugr.tug.application.using_aes"/>.</para>
     
   </section>
   
-  <section>
+  <section id="ugr.ovv.conceptual.applicaiton_building_and_collection_processing">
     <title>Application Building and Collection Processing</title>
     
     <blockquote role="key_concepts"><para><phrase role="bold">
@@ -593,7 +593,7 @@
       Collection Reader, CAS Consumer, CAS Initializer, Collection Processing Engine,
       Collection Processing Manager.</para></blockquote>
     
-    <section>
+    <section id="ugr.ovv.conceptual.using_framework_from_an_application">
       <title>Using the framework from an Application</title>
       
       <figure id="ugr.conceptual_overview.application_factory_ae">
@@ -635,11 +635,11 @@
       
       <para>The UIMA framework provides methods to support the application developer in
         creating and managing CASes and instantiating, running and managing AEs. Details
-        may be found in <olink targetdoc="uima_docs_tutorial_guides"
-          targetptr="application_developers_guide"/>.</para>
+        may be found in <olink targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.application"/>.</para>
     </section>
     
-    <section>
+    <section id="ugr.ovv.conceptual.graduating_to_collection_processing">
       <title>Graduating to Collection Processing</title>
       <figure id="ugr.conceptual_overview.fig.cpe">
         <title>High-Level UIMA Component Architecture from Source to Sink</title>
@@ -708,8 +708,8 @@
         site</ulink> which will allow the developer to experiment with indexing analysis
         results and querying for documents based on all the annotations in the CAS. See the
         section on integrating text analysis and search in <olink
-          targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.application_developers_guide"/>.</para>
+          targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.application"/>.</para>
       
       <para>A UIMA <emphasis role="bold">Collection Processing Engine</emphasis> (CPE)
         is an aggregate component that specifies a <quote>source to sink</quote> flow from a
@@ -721,7 +721,7 @@
         analysis engines and CAS Consumers) and indicate a flow among them. The flow
         specification allows for filtering capabilities to, for example, skip over AEs
         based on CAS contents. Details about the format of CPE Descriptors may be found in
-          <olink targetdoc="uima_docs_ref" targetptr="ugr.cpe_descriptor_ref"/>.
+          <olink targetdoc="&uima_docs_ref;" targetptr="ugr.cpe_descriptor_ref"/>.
         </para>
       
       <figure id="ugr.conceptual_overview.fig.cpm">
@@ -755,31 +755,31 @@
       <para>This deployment option requires that the CPM run in a separate process or a
         machine distinct from the CPE components. A CPE may be configured to run with a variety
         of deployment options that control the features provided by the CPM. For details see
-          <olink targetdoc="uima_docs_ref" targetptr="ugr.cpe_descriptor_ref"/>
+          <olink targetdoc="&uima_docs_ref;" targetptr="ugr.cpe_descriptor_ref"/>
         .</para>
       
       <para>The UIMA SDK also provides a tool called the CPE Configurator. This tool provides
         the developer with a user interface that simplifies the process of connecting up all
         the components in a CPE and running the result. For details on using the CPE
-        Configurator see <olink targetdoc="uima_docs_tools"
+        Configurator see <olink targetdoc="&uima_docs_tools;"
           targetptr="ugr.cpe_configurator"/>. This tool currently does not provide
         access to the full set of CPE deployment options supported by the CPM; however, you can
         configure other parts of the CPE descriptor by editing it directly. For details on how
-        to create and run CPEs refer to <olink targetdoc="uima_docs_tutorial_guides"
-          targetptr="cpe_developers_guide"/>.</para>
+        to create and run CPEs refer to <olink targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.cpe"/>.</para>
       
     </section>
     
   </section>
   
-  <section>
+  <section id="ugr.ovv.conceptual.exploiting_analysis_results">
     <title>Exploiting Analysis Results</title>
     
     <blockquote role="key_concepts"><para><phrase role="bold">
       &key_concepts;</phrase> Semantic Search, XML Fragment Queries.</para>
     </blockquote>
     
-    <section>
+    <section id="ugr.ovv.conceptual.semantic_search">
       <title>Semantic Search</title>
       
       <para>In a simple UIMA Collection Processing Engine (CPE), a Collection Reader reads
@@ -842,11 +842,11 @@
       
       <para>For more details about using UIMA and Semantic Search see the section on
         integrating text analysis and search in <olink
-          targetdoc="uima_docs_tutorial_guides"
-          targetptr="ugr.application_developers_guide"/>.</para>
+          targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.application"/>.</para>
     </section>
     
-    <section>
+    <section id="ugr.ovv.conceptual.databases">
       <title>Databases</title>
       
       <para>Search engine indices are not the only place to deposit analysis results for use
@@ -859,7 +859,7 @@
     </section>
   </section>
   
-  <section>
+  <section id="ugr.ovv.conceptual.multimodal_processing">
     <title>Multimodal Processing in UIMA</title>
     <para>In previous sections we&apos;ve seen how the CAS is initialized with an initial
       artifact that will be subsequently analyzed by Analysis engines and CAS Consumers. The
@@ -911,8 +911,8 @@
       single-view mode components, it is up to the person assembling the component to supply
       the needed information to insure a particular view is passed to the component at run
       time. This is done using XML descriptors for Sofa mapping (see <olink
-        targetdoc="uima_docs_tutorial_guides"
-        targetptr="ugr.sofa.sofa_name_mapping"/>).</para>
+        targetdoc="&uima_docs_tutorial_guides;"
+        targetptr="ugr.tug.mvs.sofa_name_mapping"/>).</para>
     
     <para>Multi-View capability brings benefits to text-only processing as well. An input
       document can be transformed from one format to another. Examples of this include
@@ -920,7 +920,7 @@
       </para>
   </section>
   
-  <section>
+  <section id="ugr.ovv.conceptual.next_steps">
     <title>Next Steps</title>
     
     <para>This chapter presented a high-level overview of UIMA concepts. Along the way, it
@@ -929,7 +929,7 @@
       SDK.</para>
     
     <para>At this point the reader may return to the documentation guide in <olink
-        targetdoc="uima_docs_overview" targetptr="ugr.project_overview_doc_use"/>
+        targetdoc="&uima_docs_overview;" targetptr="ugr.project_overview_doc_use"/>
       to learn how they might proceed in getting started using UIMA.</para>
     
     <para>For a more detailed overview of the UIMA architecture, framework and development

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/eclipse_setup.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/eclipse_setup.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/eclipse_setup.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/eclipse_setup.xml Mon Dec  4 08:50:24 2006
@@ -23,286 +23,235 @@
 specific language governing permissions and limitations
 under the License.
 -->
-<chapter id="ugr.eclipse_setup">  
+<chapter id="ugr.eclipse_setup">
   <title>Setting up Eclipse IDE to work with UIMA</title>
-
-
-
-
-
-<para>This chapter describes how to set up the UIMA SDK to work
-with Eclipse.  Eclipse (<ulink url="&url_eclipse;"/>)
-is a popular open-source Integrated Development Environment for many things,
-including Java. The UIMA SDK does not require that you use Eclipse.  However, we recommend that you do use Eclipse
-because some useful UIMA SDK tools run as plug-ins to the Eclipse platform and
-because the UIMA SDK examples are provided in a form that's easy to import into
-your Eclipse environment.</para>
-
-<para>If you are not planning on using the UIMA SDK with
-Eclipse, you may skip this chapter and read 
-  <olink targetdoc="uima_docs_tutorial_guides" targetptr="ugr.annotator_ae_dev_guide" />next.</para>
-
-<para>This chapter provides instructions for
-
-<itemizedlist spacing="compact"><listitem><para>installing Eclipse, </para></listitem>
-
-
-<listitem><para>installing the UIMA SDK's Eclipse
-plugins into your Eclipse environment, and </para></listitem>
-
-
-<listitem><para>importing the example UIMA code
-into an Eclipse project.
-</para></listitem></itemizedlist></para>
-
-<para>The UIMA Eclipse plugins are designed to be used with
-Eclipse version 3.1 or later.</para>
-
-
-
-<section>
-  <title>Installation</title>
-<section>
-  <title>Install Eclipse</title>
-  
-  <itemizedlist spacing="compact"><listitem><para>Go to 
-    <ulink url="&url_eclipse;"/> and follow the instructions there to download Eclipse.
-  </para></listitem>
-
-<listitem><para>We recommend using the latest
-release level (not an <quote>Integration level</quote>).  Navigate to the Eclipse Release version you
-want and download the archive for your platform.</para></listitem>
-
-
-<listitem><para>Unzip the archive to install
-Eclipse somewhere, e.g., c:\</para></listitem>
-
-
-<listitem><para>Eclipse has a bit of a learning
-curve.  If you plan to make significant
-use of Eclipse, check out the tutorial under the help menu.  It is well worth the effort.
-</para></listitem></itemizedlist>
-
-</section>
-
-<section>
-  <title>Install additional Eclipse component: EMF</title>
-
-
-<para>EMF stands for Eclipse Modeling
-Framework.  It is an add-on to Eclipse,
-and is used by the UIMA Eclipse tooling.  
-  Before installing it, please go to <ulink url="&url_emf;"/> and read the installation
-  instructions, and then click on the "Update Manager" link to see what url
-  to use in the next step, where you use the built-in facilities in Eclipse 
-  to find and install new features.
-</para>
-
-<para>Activate the software feature finding by
-using the menu: help &rarr; Software Updates &rarr; Find and Install.  Select <quote>Search for new features to
-install</quote>, push <quote>Next</quote>. Specify the update site where EMF is
-found as a site to search, making sure the <quote>Ignore features not applicable
-to this environment</quote> box is checked, and push <quote>Finish</quote>.  If your computer is on an internet connection
-which uses a proxy server, you can configure Eclipse to know about that.  Put your proxy settings into Ecluse using the
-Eclipse preferences by accessing the menus: Window &rarr; Preferences... &rarr;
-Install/Update, and Enable HTTP proxy connection under the Proxy Settings with
-the information about your proxy. </para>
-
-<para>This will launch a search for updates to
-Eclipse; it may show a list of update site mirrors &ndash; click OK.  When it finishes, it shows a list of possible
-updates in an expandable tree.  Expand
-the tree nodes to find EMF SDK.  The
-specific level may vary from the level shown below as newer versions are
-released.</para>
-
-<informalfigure>
-   <mediaobject>
-      <imageobject>
-        <imagedata format="JPG" fileref="&imgroot;image002.jpg"/>
-      </imageobject>
-      <textobject><phrase>Screenshot showing search results for EMF</phrase>
-      </textobject>
-    </mediaobject>
-</informalfigure>
-
-<para>Click <quote>Next</quote>.  Then pick Eclipse Modeling Framework (EMF),
-and push <quote>Next</quote>, accept any licensing agreements, etc., until it
-finishes the installation.  It may say
-it's an <quote>unsigned feature</quote>; proceed by clicking
-<quote>Install</quote>.  If it recommends
-restarting, you may do that.</para>
-
-<para>This will install EMF, without any
-extras.  (If you want the whole EMF
-system, including source and documentation, you can pick the <quote>EMF
-SDK</quote> and the <quote>Examples for Eclipse Modeling Framework</quote>.)</para>
-
-</section>
-
-<section>
-  <title>Install the UIMA SDK</title>
-  <para>If you haven't already done so, please
-download and install the UIMA SDK from <ulink url="&url_apache_uima_download;"/>.</para>
-</section>
   
-<section>
-  <title>Install the UIMA Eclipse Plugins</title>
-  
-<para>In the directory %UIMA_HOME%/eclipsePlugin (The environment
-variable %UIMA_HOME% is where you installed the UIMA SDK),
-you will a set of folders.  Copy these to your
-%ECLIPSE_HOME%/eclipse/plugins directory (%ECLIPSE_HOME% is where you installed Eclipse).</para>
-
-</section>
-
-<section>
-  <title>Start Eclipse</title>
-  <para>If you have Eclipse running, restart it (shut it down, and
-start it again) using the <code>-clean</code> option; you can do this by
-    running the command <command>eclipse -clean</command> (see explanation in the next section) in
-the directory where you installed Eclipse.  You may want to set up a desktop shortcut at this point for
-Eclipse. Eclipse has a bit of a learning
-curve.  If you plan to make significant
-use of Eclipse, check out the tutorial under the help menu.  It is well worth the effort.  There are also books you can get that
-describe Eclipse and its use.</para>
-
-<para>The first time Eclipse starts up it will take a bit longer
-as it completes its installation.  A
-<quote>welcome</quote> page will come up.  After you are through reading the welcome information, click on the
-arrow to exit the welcome page and get to the main Eclipse screens.</para>
-
-  <section>
-    <title>Special startup parameter for Eclipse: -clean</title>
-    <para>If you have modified the plugin structure (by copying or
-files directly in the file system) in Eclipse 3.x after you started
-it for the first time, please include the <quote>-clean</quote> parameter in the startup
-arguments to Eclipse, <emphasis>one time</emphasis>
-(after any plugin modifications were done).  This is needed because Eclipse may not notice the changes you made,
-otherwise.  This parameter forces Eclipse to reexamine all of its plugins at startup and recompute any cached information
-about them.</para>
-</section>
+  <para>This chapter describes how to set up the UIMA SDK to work with Eclipse. Eclipse (<ulink
+      url="&url_eclipse;"/>) is a popular open-source Integrated Development
+    Environment for many things, including Java. The UIMA SDK does not require that you use
+    Eclipse. However, we recommend that you do use Eclipse because some useful UIMA SDK tools
+    run as plug-ins to the Eclipse platform and because the UIMA SDK examples are provided in a
+    form that's easy to import into your Eclipse environment.</para>
+  
+  <para>If you are not planning on using the UIMA SDK with Eclipse, you may skip this chapter and
+    read <olink targetdoc="&uima_docs_tutorial_guides;" targetptr="ugr.aae"/>
+    next.</para>
+  
+  <para>This chapter provides instructions for
+    
+    <itemizedlist spacing="compact"><listitem><para>installing Eclipse, </para>
+      </listitem>
+      
+      <listitem><para>installing the UIMA SDK's Eclipse plugins into your Eclipse
+        environment, and </para></listitem>
+      
+      <listitem><para>importing the example UIMA code into an Eclipse project. </para>
+        </listitem></itemizedlist></para>
+  
+  <para>The UIMA Eclipse plugins are designed to be used with Eclipse version 3.1 or
+    later.</para>
+  
+  <section id="ugr.ovv.eclipse_setup.installation">
+    <title>Installation</title>
+    <section id="ugr.ovv.eclipse_setup.install_eclipse">
+      <title>Install Eclipse</title>
+      
+      <itemizedlist spacing="compact"><listitem><para>Go to <ulink
+          url="&url_eclipse;"/> and follow the instructions there to download Eclipse.
+        </para></listitem>
+        
+        <listitem><para>We recommend using the latest release level (not an
+          <quote>Integration level</quote>). Navigate to the Eclipse Release version you
+          want and download the archive for your platform.</para></listitem>
+        
+        <listitem><para>Unzip the archive to install Eclipse somewhere, e.g., c:\</para>
+          </listitem>
+        
+        <listitem><para>Eclipse has a bit of a learning curve. If you plan to make
+          significant use of Eclipse, check out the tutorial under the help menu. It is well
+          worth the effort. </para></listitem></itemizedlist>
+      
+    </section>
+    
+    <section id="ugr.ovv.eclipse_setup.install_emf">
+      <title>Install additional Eclipse component: EMF</title>
+      
+      <para>EMF stands for Eclipse Modeling Framework. It is an add-on to Eclipse, and is used
+        by the UIMA Eclipse tooling. Before installing it, please go to <ulink
+          url="&url_emf;"/> and read the installation instructions, and then click on the
+        "Update Manager" link to see what url to use in the next step, where you use the built-in
+        facilities in Eclipse to find and install new features. </para>
+      
+      <para>Activate the software feature finding by using the menu: help &rarr; Software
+        Updates &rarr; Find and Install. Select <quote>Search for new features to
+        install</quote>, push <quote>Next</quote>. Specify the update site where EMF is
+        found as a site to search, making sure the <quote>Ignore features not applicable to
+        this environment</quote> box is checked, and push <quote>Finish</quote>. If your
+        computer is on an internet connection which uses a proxy server, you can configure
+        Eclipse to know about that. Put your proxy settings into Ecluse using the Eclipse
+        preferences by accessing the menus: Window &rarr; Preferences... &rarr;
+        Install/Update, and Enable HTTP proxy connection under the Proxy Settings with the
+        information about your proxy. </para>
+      
+      <para>This will launch a search for updates to Eclipse; it may show a list of update site
+        mirrors &ndash; click OK. When it finishes, it shows a list of possible updates in an
+        expandable tree. Expand the tree nodes to find EMF SDK. The specific level may vary
+        from the level shown below as newer versions are released.</para>
+      
+      <informalfigure>
+        <mediaobject>
+          <imageobject>
+            <imagedata format="JPG" fileref="&imgroot;image002.jpg"/>
+          </imageobject>
+          <textobject><phrase>Screenshot showing search results for EMF</phrase>
+          </textobject>
+        </mediaobject>
+      </informalfigure>
+      
+      <para>Click <quote>Next</quote>. Then pick Eclipse Modeling Framework (EMF), and
+        push <quote>Next</quote>, accept any licensing agreements, etc., until it
+        finishes the installation. It may say it's an <quote>unsigned feature</quote>;
+        proceed by clicking <quote>Install</quote>. If it recommends restarting, you may
+        do that.</para>
+      
+      <para>This will install EMF, without any extras. (If you want the whole EMF system,
+        including source and documentation, you can pick the <quote>EMF SDK</quote> and the
+        <quote>Examples for Eclipse Modeling Framework</quote>.)</para>
+      
+    </section>
+    
+    <section id="ugr.ovv.eclipse_setup.install_uima_sdk">
+      <title>Install the UIMA SDK</title>
+      <para>If you haven't already done so, please download and install the UIMA SDK from
+          <ulink url="&url_apache_uima_download;"/>.</para>
+    </section>
+    
+    <section id="ugr.ovv.eclipse_setup.install_uima_eclipse_plugins">
+      <title>Install the UIMA Eclipse Plugins</title>
+      
+      <para>In the directory %UIMA_HOME%/eclipsePlugin (The environment variable
+        %UIMA_HOME% is where you installed the UIMA SDK), you will a set of folders. Copy these
+        to your %ECLIPSE_HOME%/eclipse/plugins directory (%ECLIPSE_HOME% is where you
+        installed Eclipse).</para>
+      
+    </section>
+    
+    <section id="ugr.ovv.eclipse_setup.start_eclipse">
+      <title>Start Eclipse</title>
+      <para>If you have Eclipse running, restart it (shut it down, and start it again) using
+        the
+        <code>-clean</code> option; you can do this by running the command
+        <command>eclipse -clean</command> (see explanation in the next section) in the
+        directory where you installed Eclipse. You may want to set up a desktop shortcut at
+        this point for Eclipse. Eclipse has a bit of a learning curve. If you plan to make
+        significant use of Eclipse, check out the tutorial under the help menu. It is well
+        worth the effort. There are also books you can get that describe Eclipse and its
+        use.</para>
+      
+      <para>The first time Eclipse starts up it will take a bit longer as it completes its
+        installation. A <quote>welcome</quote> page will come up. After you are through
+        reading the welcome information, click on the arrow to exit the welcome page and get to
+        the main Eclipse screens.</para>
+      
+      <section id="ugr.ovv.eclipse_setup.special_startup_parameter_clean">
+        <title>Special startup parameter for Eclipse: -clean</title>
+        <para>If you have modified the plugin structure (by copying or files directly in the
+          file system) in Eclipse 3.x after you started it for the first time, please include
+          the <quote>-clean</quote> parameter in the startup arguments to Eclipse,
+          <emphasis>one time</emphasis> (after any plugin modifications were done). This
+          is needed because Eclipse may not notice the changes you made, otherwise. This
+          parameter forces Eclipse to reexamine all of its plugins at startup and recompute
+          any cached information about them.</para>
+      </section>
+      
+    </section>
+  </section>
+  <section id="ugr.eclipse_setup.example_code">
+    <title>Setting up Eclipse to view Example Code</title>
+    <para>Later chapters refer to example code. You can create a special project in Eclipse to
+      hold the examples. Here's how:</para>
+    
+    <itemizedlist spacing="compact"><listitem><para>In Eclipse, if the Java
+      perspective is not already open, switch to it by going to Window &rarr; Open Perspective
+      &rarr; Java.</para></listitem>
+      
+      <listitem><para>Set up a class path variable named UIMA_HOME, whose value is the
+        directory where you installed the UIMA SDK. This is done as follows:
+        
+        <itemizedlist><listitem><para>Go to Window &rarr; Preferences &rarr; Java
+          &rarr; Build Path &rarr; Classpath Variables.</para></listitem>
+          
+          <listitem><para>Click <quote>New</quote></para></listitem>
+          
+          <listitem><para>Enter UIMA_HOME (all capitals, exactly as written) in the
+            <quote>Name</quote> field.</para></listitem>
+          
+          <listitem><para>Enter your installation directory (e.g. <literal>C:/Program
+            Files/apache-uima</literal>) in the <quote>Path</quote> field</para>
+            </listitem>
+          
+          <listitem><para>Click <quote>OK</quote> in the <quote>New Variable
+            Entry</quote> dialog</para></listitem>
+          
+          <listitem><para>Click <quote>OK</quote> in the <quote>Preferences</quote>
+            dialog</para></listitem>
+          
+          <listitem><para>If it asks you if you want to do a full build, click
+            <quote>Yes</quote> </para></listitem></itemizedlist></para>
+        </listitem>
+      
+      <listitem><para>Select the File &rarr; Import menu option</para></listitem>
+      
+      <listitem><para>Select <quote>Existing Project into Workspace</quote> and click
+        the <quote>Next</quote> button.</para></listitem>
+      
+      <listitem><para>Click <quote>Browse</quote> and browse to the
+        %UIMA_HOME%/docs/examples directory</para></listitem>
+      
+      <listitem><para>Click <quote>Finish.</quote> This will create a new project called
+        <quote>uima_examples</quote> in your Eclipse workspace. There should be no
+        compilation errors. </para></listitem></itemizedlist>
+    
+    <para>To verify that you have set up the project correctly, check that there are no error
+      messages in the <quote>Problems</quote> view.</para>
+    
+  </section>
+  
+  <section id="ugr.ovv.eclipse_setup.running_external_tools_from_eclipse">
+    <title>Running external tools from Eclipse</title>
+    
+    <para>You can run many tools without using Eclipse at all, by using the shell scripts in the
+      UIMA SDK's bin directory. In addition, many tools can be run from inside Eclipse;
+      examples are the Document Analyzer, CPE Configurator, CAS Visual Debugger, Semantic
+      Search, and JCasGen. The uima_examples project provides Eclipse launch
+      configurations that make this easy to do.</para>
+    
+    <para>To run these tools from Eclipse:</para>
+    
+    <itemizedlist spacing="compact"><listitem><para>If the Java perspective is not
+      already open, switch to it by going to Window &rarr; Open Perspective &rarr;
+      Java.</para></listitem>
+      
+      <listitem><para>Go to Run &rarr; Run... </para></listitem>
+      
+      <listitem><para>In the window that appears, select <quote>UIMA CPE GUI</quote>,
+        <quote>UIMA CAS Visual Debugger</quote>, <quote>UIMA JCasGen</quote>,
+        <quote>UIMA Document Analyzer</quote>, or <quote>UIMA Semantic Search</quote>
+        from the list of run configurations on the left. (If you don't see, these, please
+        select the uima_examples project and do a Menu &rarr; File
+        &rarr; Refresh).</para></listitem>
+      
+      <listitem><para>Press the <quote>Run</quote> button. The tools should start. Close
+        the tools by clicking the <quote>X</quote> in the upper right corner on the GUI.
+        </para></listitem></itemizedlist>
+    
+    <para>For instructions on using the Document Analyzer and CPE Configurator, see <olink
+        targetdoc="&uima_docs_tools;" targetptr="ugr.document_analyzer"/>, and
+        <olink targetdoc="&uima_docs_tools;" targetptr="ugr.cpe_configurator"/> For
+      instructions on using the CAS Visual Debugger and JCasGen, see <olink
+        targetdoc="&uima_docs_tools;" targetptr="ugr.cas_visual_debugger"/> and
+        <olink targetdoc="&uima_docs_tools;" targetptr="ugr.jcasgen"/></para>
+    
+  </section>
   
-
-  </section>
-  </section>
-<section id="ugr.eclipse_setup.example_code">
-  <title>Setting up Eclipse to view Example Code</title>
-<para>Later chapters refer to example code. You can create a
-special project in Eclipse to hold the examples.  Here's how:</para>
-
-<itemizedlist spacing="compact"><listitem><para>In Eclipse, if the Java
-perspective is not already open, switch to it by going to Window &rarr;
-Open Perspective &rarr; Java.</para></listitem>
-
-
-<listitem><para>Set up a class path variable named
-UIMA_HOME, whose value is the directory where you installed the UIMA SDK.  This is done as follows:
-
-
-<itemizedlist><listitem><para>Go to Window &rarr; Preferences &rarr;
-Java &rarr;
-Build Path &rarr;
-Classpath Variables.</para></listitem>
-
-
-<listitem><para>Click <quote>New</quote></para></listitem>
-
-
-<listitem><para>Enter UIMA_HOME (all capitals,
-exactly as written) in the <quote>Name</quote> field.</para></listitem>
-
-
-<listitem><para>Enter your installation directory
-(e.g. <literal>C:/Program Files/apache-uima</literal>) in the
-<quote>Path</quote> field</para></listitem>
-
-
-<listitem><para>Click <quote>OK</quote> in the
-<quote>New Variable Entry</quote> dialog</para></listitem>
-
-
-<listitem><para>Click <quote>OK</quote> in the
-<quote>Preferences</quote> dialog</para></listitem>
-
-
-<listitem><para>If it asks you if you want to do a
-full build, click <quote>Yes</quote>
-</para></listitem></itemizedlist></para></listitem>
-
-
-<listitem><para>Select the File &rarr; Import menu
-option</para></listitem>
-
-
-<listitem><para>Select <quote>Existing Project into
-Workspace</quote> and click the <quote>Next</quote> button.</para></listitem>
-
-
-<listitem><para>Click <quote>Browse</quote> and
-browse to the %UIMA_HOME%/docs/examples directory</para></listitem>
-
-
-<listitem><para>Click <quote>Finish.</quote>  This will create a new project called
-<quote>uima_examples</quote> in your Eclipse workspace.  There should be no compilation errors. 
-</para></listitem></itemizedlist>
-
-<para>To verify that you have set up the project correctly,
-check that there are no error messages in the
-<quote>Problems</quote> view.</para>
-
-
-
-
-  
-</section> 
-
-
-
-
-  
-  
-<section>
-  <title>Running external tools from Eclipse</title>
-
-<para>You can run many tools without using Eclipse at all, by using the shell scripts in
-the UIMA SDK's bin directory.  In
-addition, many tools can be run from inside Eclipse; examples are the Document
-Analyzer, CPE Configurator, CAS Visual Debugger, Semantic Search, and JCasGen.  The uima_examples project provides Eclipse
-launch configurations that make this easy to do.</para>
-
-<para>To run these tools from Eclipse:</para>
-
-<itemizedlist spacing="compact"><listitem><para>If the Java perspective is not
-already open, switch to it by going to Window &rarr; Open Perspective &rarr;
-Java.</para></listitem>
-
-
-<listitem><para>Go to Run &rarr; Run... </para></listitem>
-
-
-<listitem><para>In the window that appears, select
-<quote>UIMA CPE GUI</quote>, <quote>UIMA CAS Visual Debugger</quote>, <quote>UIMA
-JCasGen</quote>, <quote>UIMA Document Analyzer</quote>, or <quote>UIMA Semantic
-Search</quote> from the list of run configurations on the left. (If you don't
-see, these, please select the uima_examples project and do a Menu &rarr; File
-&rarr; Refresh).</para></listitem>
-
-
-<listitem><para>Press the <quote>Run</quote>
-button.  The tools should start.  Close the tools by clicking the <quote>X</quote>
-in the upper right corner on the GUI. 
-</para></listitem></itemizedlist>
-
-<para>For instructions on using the Document Analyzer and CPE
-Configurator, see 
-  <olink targetdoc="&uima_docs_tools;" targetptr="ugr.document_analyzer"/>, and
-  <olink targetdoc="&uima_docs_tools;" targetptr="ugr.cpe_configurator"/>
-For
-instructions on using the CAS Visual Debugger and JCasGen, see 
-  <olink targetdoc="&uima_docs_tools;" targetptr="ugr.cas_visual_debugger"/> and
-  <olink targetdoc="&uima_docs_tools;" targetptr="ugr.jcasgen"/></para>
-
-
-  </section>
-
 </chapter>

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/glossary.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/glossary.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/glossary.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/glossary.xml Mon Dec  4 08:50:24 2006
@@ -25,7 +25,7 @@
 <chapter id="ugr.glossary">
   <title>Glossary of Key Terms and Concepts</title>
   <para></para>
-  <glossary>
+  <glossary id="ugr.glossary.glossary">
     <!--
     <glossentry id="ugr.glossary.">
       <glossterm></glossterm>

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/project_overview.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/project_overview.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/project_overview.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/overview_and_setup/project_overview.xml Mon Dec  4 08:50:24 2006
@@ -318,7 +318,7 @@
           included with the SDK.</para>
       </listitem>
       <listitem>
-        <para> Read <olink targetdoc="uima_docs_overview"
+        <para> Read <olink targetdoc="&uima_docs_overview;"
             targetptr="ugr.conceptual_overview"/> to get a broad view of the basic UIMA
           concepts and philosophy with reference to the other documents included in the
           documentation set which provide greater detail. </para>
@@ -337,8 +337,8 @@
       </listitem>
       <listitem>
         <para> Develop sample UIMA annotators, run them and explore the results. Read <olink
-            targetdoc="uima_docs_tutorial_guides"
-            targetptr="annotators_and_analysis_engines"/> and follow it like a
+            targetdoc="&uima_docs_tutorial_guides;"
+            targetptr="ugr.tug.aae"/> and follow it like a
           tutorial to learn how to develop your first UIMA annotator and set up and run your
           first UIMA analysis engines.
           <itemizedlist>
@@ -347,12 +347,12 @@
                 <itemizedlist>
                   <listitem>
                     <para> The UIMA Component Descriptor Editor, described in more detail
-                      in <olink targetdoc="uima_docs_tools"
+                      in <olink targetdoc="&uima_docs_tools;"
                         targetptr="cde_chapter"/> and </para>
                   </listitem>
                   <listitem>
                     <para> The Document Analyzer, described in more detail in <olink
-                        targetdoc="uima_docs_tools"
+                        targetdoc="&uima_docs_tools;"
                         targetptr="document_analyzer_chapter"/>. </para>
                   </listitem>
                   
@@ -361,17 +361,17 @@
             </listitem>
             <listitem>
               <para>While following along in <olink
-                  targetdoc="uima_docs_tutorial_guides"
-                  targetptr="annotators_and_analysis_engines_chapter"/>,
+                  targetdoc="&uima_docs_tutorial_guides;"
+                  targetptr="ugr.tug.aae"/>,
                 reference documents that may help are:
                 <itemizedlist>
                   <listitem>
-                    <para> <olink targetdoc="uima_docs_ref"
+                    <para> <olink targetdoc="&uima_docs_ref;"
                         targetptr="ref_ae_descriptors_chapter"/> for understanding
                       the analysis engine descriptors </para>
                   </listitem>
                   <listitem>
-                    <para> <olink targetdoc="uima_docs_ref"
+                    <para> <olink targetdoc="&uima_docs_ref;"
                         targetptr="ref_jcas_chapter"/> for understanding the JCas
                       </para>
                   </listitem>
@@ -384,16 +384,15 @@
           application. <phrase condition="juru">Connect your analysis engine to the
           provided semantic search engine to learn how a complete analysis and search
           application may be built with the UIMA SDK.</phrase> <olink
-            targetdoc="uima_docs_tutorial_guides"
-            targetptr="application_dev_chapter"/> will guide you through this process.
+            targetdoc="&uima_docs_tutorial_guides;"
+            targetptr="ugr.tug.application"/> will guide you through this process.
           <itemizedlist>
             <listitem>
               <para> As part of this you will use the document analyzer (described in more
-                detail in <olink targetdoc="uima_docs_tools"
-                  targetptr="document_analyzer_chapter"/> <phrase
-                  condition="juru">and semantic search GUI tools (see <olink
-                  targetdoc="uima_docs_tutorial_guides"
-                  targetptr="search_query_tool"/></phrase>. </para>
+                detail in <olink targetdoc="&uima_docs_tools;"
+                  targetptr="document_analyzer_chapter"/> and semantic search GUI tools (see <olink
+                  targetdoc="&uima_docs_tutorial_guides;"
+                  targetptr="ugr.tug.application.search.query_tool"/>. </para>
             </listitem>
           </itemizedlist> </para>
       </listitem>
@@ -408,26 +407,26 @@
       <listitem>
         <para> Develop and run a Collection Processing Engine (CPE) to analyze and gather the
           results of an entire collection of documents. <olink
-            targetdoc="uima_docs_tutorial_guides" targetptr="cpe_chapter"/> will
+            targetdoc="&uima_docs_tutorial_guides;" targetptr="ugr.tug.cpe"/> will
           guide you through this process.
           <itemizedlist>
             <listitem>
               <para> As part of this you will use the CPE Configurator tool. For details see
-                  <olink targetdoc="uima_docs_tools"
+                  <olink targetdoc="&uima_docs_tools;"
                   targetptr="cpe_configurator_chapter"/>. </para>
             </listitem>
             <listitem>
               <para> You will also learn about CPE Descriptors. The detailed format for
-                these may be found in <olink targetdoc="uima_docs_ref"
-                  targetptr="cpe_chapter"/>. </para>
+                these may be found in <olink targetdoc="&uima_docs_ref;"
+                  targetptr="ugr.tug.cpe"/>. </para>
             </listitem>
           </itemizedlist> </para>
       </listitem>
       <listitem>
         <para> Learn how to package up an analysis engine for easy installation into another
-          UIMA environment. <olink targetdoc="uima_docs_tools"
+          UIMA environment. <olink targetdoc="&uima_docs_tools;"
             targetptr="pear_packager_chapter"/> and <olink
-            targetdoc="uima_docs_tools" targetptr="pear_installer_chapter"/> will
+            targetdoc="&uima_docs_tools;" targetptr="pear_installer_chapter"/> will
           teach you how to create UIMA analysis engine archives so that you can easily share
           your components with a broader community. </para>
       </listitem>
@@ -450,7 +449,7 @@
           integers), and Double (64 bit floating point) primitive types, and arrays of
           these. These types can be used like all the other primitive types.</para>
       </section>
-      <section>
+      <section id="ugr.ovv.simpler_aes_and_cases">
         <title>Simpler Analysis Engines and CASes</title>
         <para>Version 1.x made a distinction between Analysis Engines and Text Analysis
           Engines. This distinction has been eliminated in Version 2 - new code should just
@@ -462,33 +461,37 @@
           Java-friendly way to work with CAS types remains; we clarify that the JCas is just
           (one of potentially several) interfaces to the CAS.</para>
       </section>
-      <section>
+      <section id="ugr.ovv.sofas_and_cas_views_simplified">
         <title>Sofas and CAS Views simplified</title>
         <para>The APIs for manipulating multiple subjects of analysis (Sofas) and their
           corresponding CAS Views have been simplified.</para>
       </section>
-      <section>
+      <section id="ugr.ovv.ae_support_multiple_new_cases">
         <title>Analysis Component generalized to support multiple new CAS
           outputs</title>
         <para>Analysis Components, in general, can make use of new capabilities to return
           multiple new CASes, in addition to returning the original CAS that is passed in.
           This allows components to have Collection Reader-like capabilities, but be
-          placed anywhere in the flow. See <olink targetdoc="uima_docs_tutorial_guides"
-            targetptr="cas_multiplier_chapter"/>.</para>
+          placed anywhere in the flow. See <olink targetdoc="&uima_docs_tutorial_guides;"
+            targetptr="ugr.tug.cm"/>.</para>
       </section>
-      <section>
+      <section id="ugr.ovv.user_customized_fc">
         <title>User-customized Flow Controllers</title>
         <para>A new component, the Flow Controller, can be supplied by the user to implement
           arbitrary flow control for CASes within an Aggregate. This is in addition to the two
           built-in flow control choices of linear and language-capability flow. See <olink
-            targetdoc="uima_docs_tutoria_guilds"
-            targetptr="flow_controller_chapter"/>.</para>
+            targetdoc="&uima_docs_tutorial_guides;"
+            targetptr="ugr.tug.fc"/>.</para>
       </section>
-      <section>
-        <title>Search Engine</title>
+      <section id="ugr.ovv.search_engine_repackaged">
+        <title>Search Engine Repackaged</title>
         <para>The versions of the UIMA SDK prior to the move into Apache came with a semantic
-          search engine. The Apache version does not include this search engine. The intent
-          is to hook up (over time) with the Lucene search engine project in Apache.</para>
+          search engine. The Apache version does not include this search engine.  The search engine
+          has been repackaged and is separately available from 
+          <ulink url="http://www.alphaworks.ibm.com/tech/uima"/>.  
+          The intent
+          is to hook up (over time) with other open source search engines, such as the Lucene 
+          search engine project in Apache.</para>
       </section>
     </section>
     <section id="ugr.project_overview_backwards_compatibility">
@@ -530,7 +533,7 @@
         </itemizedlist> </para>
       
     </section>
-    <section>
+    <section id="ugr.ovv.other_changes">
       <title>Other Changes</title>
       <para>TextAnalysisEngine has been deprecated - it is now no different than
         AnalysisEngine. Previous code that uses this should still continue to work,
@@ -547,7 +550,7 @@
   </section>
   <section id="ugr.project_overview_summary">
     <title>Apache UIMA SDK Summary</title>
-    <section>
+    <section id="ugr.ovv.summary.general">
       <title>General</title>
       <para>The UIMA SDK supports the development, discovery, composition and deployment
         of multi-modal analytics for the analysis of unstructured information and its
@@ -562,7 +565,7 @@
         indexing the results of analysis and for using this semantic index to perform more
         advanced search. </para>
     </section>
-    <section>
+    <section id="ugr.ovv.summary.programming_language_support">
       <title>Programming Language Support</title>
       <para>UIMA supports the development and integration of analysis algorithms
         developed in different programming languages. </para>
@@ -580,23 +583,22 @@
         filled in).</phrase></para>
       
     </section>
-    <section>
+    <section id="ugr.ovv.general.summary.multi_modal_support">
       <title>Multi-Modal Support</title>
       <para>The UIMA architecture supports the development, discovery, composition and
         deployment of multi-modal analytics, including text, audio and video. <olink
-          targetdoc="uima_docs_tutorial_guides"
-          targetptr="sofa_chapter_annotations_artifacts"/> discuss this is more
+          targetdoc="&uima_docs_tutorial_guides;"
+          targetptr="ugr.tug.aas"/> discuss this is more
         detail.</para>
     </section>
-    <section>
+    <section id="ugr.ovv.summary.general.semantic_search_components">
       <title>Semantic Search Components</title>
       <para> The Lucene search engine as of this writing (November, 2006) does not support
-        searching with annotations. <phrase
-          condition="juru_apache_pkg_on_alphaworks_ready">The site <ulink
+        searching with annotations. The site <ulink
           url="http://www.alphaworks.ibm.com/tech/uima"/> provides a download of a
         semantic search engine, a simple demo query tool, some documentation on the semantic
         search engine, and a component that connects the results of UIMA analysis to the
-        indexer so that the annotations as well as key-words can be indexed.</phrase>
+        indexer so that the annotations as well as key-words can be indexed.
         </para>
       
       <para>Previous versions of the UIMA SDK (prior to the Apache versions) are available

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/annotator_analysis_engine_guide.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/annotator_analysis_engine_guide.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/annotator_analysis_engine_guide.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/annotator_analysis_engine_guide.xml Mon Dec  4 08:50:24 2006
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.aae/" >
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.aae/">
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml Mon Dec  4 08:50:24 2006
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.application/" >
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.application/">
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cas_multiplier.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cas_multiplier.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cas_multiplier.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cas_multiplier.xml Mon Dec  4 08:50:24 2006
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.cas_multiplier/" >
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.cas_multiplier/">
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cpe.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cpe.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cpe.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.cpe.xml Mon Dec  4 08:50:24 2006
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.cpe/" >
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.cpe/">
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.fc.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.fc.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.fc.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.fc.xml Mon Dec  4 08:50:24 2006
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.fc" >
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY imgroot "../images/tutorials_and_users_guides/tug.fc">
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml Mon Dec  4 08:50:24 2006
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.xmi_emf.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.xmi_emf.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.xmi_emf.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.xmi_emf.xml Mon Dec  4 08:50:24 2006
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-<!ENTITY % uimaents SYSTEM "../entities.ent" >  
+<!ENTITY % uimaents SYSTEM "../entities.ent">  
 %uimaents;
 ]>
 <!--

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tutorials_and_users_guides.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tutorials_and_users_guides.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tutorials_and_users_guides.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tutorials_and_users_guides.xml Mon Dec  4 08:50:24 2006
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd"[
-  <!ENTITY % xinclude SYSTEM "xinclude.mod">
+  <!ENTITY % xinclude SYSTEM "../xinclude.mod">
   %xinclude;
   ]>
 <!--
@@ -24,7 +24,7 @@
 -->
 <book lang="en">
   <title>Apache UIMA SDK Tutorial and Developers' Guides</title>
-  <xi:include href="common_book_info.xml"/>
+  <xi:include href="../common_book_info.xml"/>
 
   <toc/>
   

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_html.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_html.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_html.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_html.xml Mon Dec  4 08:50:24 2006
@@ -1,37 +1,38 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE targetset SYSTEM "http://docbook.sourceforge.net/release/xsl/current/common/targetdatabase.dtd" [
-<!ENTITY otarget_overview SYSTEM "olink_ovv.db">
-<!ENTITY otarget_tutorial_users_guides SYSTEM "olink_tug.db">
-<!ENTITY otarget_tools SYSTEM "olink_tools.db">
-<!ENTITY otarget_references SYSTEM "olink_ref.db">
-<!ENTITY % uimaents SYSTEM "../../../src/docbook/uima/entities.ent">  
+<!ENTITY % uimaents SYSTEM "../docbook/entities.ent" >  
 %uimaents;
+<!ENTITY otarget_overview SYSTEM "overview_and_setup/html-target.db">
+<!ENTITY otarget_tug      SYSTEM "tutorials_and_users_guides/html-target.db">
+<!ENTITY otarget_refs     SYSTEM "references/html-target.db">
+<!ENTITY otarget_tools    SYSTEM "tools/html-target.db">
 ]>
 <targetset>
   <targetsetinfo>UIMA books olinks</targetsetinfo>
   
   <!-- Site map for generating relative paths between documents -->
   <sitemap>
-    <dir name="html">
-      <dir name="UIMA-overview">
+    <dir name="target">
+      <dir name="overview_and_setup">
         <document targetdoc="&uima_docs_overview;">
           &otarget_overview;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="tutorials_and_users_guides">
+        <document targetdoc="&uima_docs_tutorial_guides;">
+          &otarget_tug;
         </document>
       </dir>
-      <dir name="UIMA-Tools">
-        <document targetdoc="&target_tools;">
-          &otarget_tutorial_users_guides;
+      <dir name="tools">
+        <document targetdoc="&uima_docs_tools;">
+          &otarget_tools;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="references">
+        <document targetdoc="&uima_docs_ref;">
+          &otarget_refs;
         </document>
-      </dir>    
+      </dir> 
+    </dir>   
   </sitemap>
 </targetset>

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_htmlsingle.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_htmlsingle.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_htmlsingle.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_htmlsingle.xml Mon Dec  4 08:50:24 2006
@@ -1,37 +1,38 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE targetset SYSTEM "http://docbook.sourceforge.net/release/xsl/current/common/targetdatabase.dtd" [
-<!ENTITY otarget_overview SYSTEM "olink_ovv.db">
-<!ENTITY otarget_tutorial_users_guides SYSTEM "olink_tug.db">
-<!ENTITY otarget_tools SYSTEM "olink_tools.db">
-<!ENTITY otarget_references SYSTEM "olink_ref.db">
-<!ENTITY % uimaents SYSTEM "../../../src/docbook/uima/entities.ent">  
+<!ENTITY % uimaents SYSTEM "../docbook/entities.ent" >  
 %uimaents;
+<!ENTITY otarget_overview SYSTEM "overview_and_setup/htmlsingle-target.db">
+<!ENTITY otarget_tug      SYSTEM "tutorials_and_users_guides/htmlsingle-target.db">
+<!ENTITY otarget_refs     SYSTEM "references/htmlsingle-target.db">
+<!ENTITY otarget_tools    SYSTEM "tools/htmlsingle-target.db">
 ]>
 <targetset>
   <targetsetinfo>UIMA books olinks</targetsetinfo>
   
   <!-- Site map for generating relative paths between documents -->
   <sitemap>
-    <dir name="html">
-      <dir name="UIMA-overview">
+    <dir name="target">
+      <dir name="overview_and_setup">
         <document targetdoc="&uima_docs_overview;">
           &otarget_overview;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="tutorials_and_users_guides">
+        <document targetdoc="&uima_docs_tutorial_guides;">
+          &otarget_tug;
         </document>
       </dir>
-      <dir name="UIMA-Tools">
-        <document targetdoc="&target_tools;">
-          &otarget_tutorial_users_guides;
+      <dir name="tools">
+        <document targetdoc="&uima_docs_tools;">
+          &otarget_tools;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="references">
+        <document targetdoc="&uima_docs_ref;">
+          &otarget_refs;
         </document>
-      </dir>    
+      </dir>  
+    </dir>  
   </sitemap>
 </targetset>

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_pdf.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_pdf.xml?view=diff&rev=482245&r1=482244&r2=482245
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_pdf.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/olink/olink_db_pdf.xml Mon Dec  4 08:50:24 2006
@@ -1,37 +1,38 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE targetset SYSTEM "http://docbook.sourceforge.net/release/xsl/current/common/targetdatabase.dtd" [
-<!ENTITY otarget_overview SYSTEM "olink_ovv.db">
-<!ENTITY otarget_tutorial_users_guides SYSTEM "olink_tug.db">
-<!ENTITY otarget_tools SYSTEM "olink_tools.db">
-<!ENTITY otarget_references SYSTEM "olink_ref.db">
-<!ENTITY % uimaents SYSTEM "../../../src/docbook/uima/entities.ent">  
+<!ENTITY % uimaents SYSTEM "../docbook/entities.ent" >  
 %uimaents;
+<!ENTITY otarget_overview SYSTEM "overview_and_setup/pdf-target.db">
+<!ENTITY otarget_tug      SYSTEM "tutorials_and_users_guides/pdf-target.db">
+<!ENTITY otarget_refs     SYSTEM "references/pdf-target.db">
+<!ENTITY otarget_tools    SYSTEM "tools/pdf-target.db">
 ]>
 <targetset>
   <targetsetinfo>UIMA books olinks</targetsetinfo>
   
   <!-- Site map for generating relative paths between documents -->
   <sitemap>
-    <dir name="html">
-      <dir name="UIMA-overview">
+    <dir name="target">
+      <dir name="overview_and_setup">
         <document targetdoc="&uima_docs_overview;">
           &otarget_overview;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="tutorials_and_users_guides">
+        <document targetdoc="&uima_docs_tutorial_guides;">
+          &otarget_tug;
         </document>
       </dir>
-      <dir name="UIMA-Tools">
-        <document targetdoc="&target_tools;">
-          &otarget_tutorial_users_guides;
+      <dir name="tools">
+        <document targetdoc="&uima_docs_tools;">
+          &otarget_tools;
         </document>
       </dir>
-      <dir name="UIMA-Tutorials-and-Users-Guide">
-        <document targetdoc="&target_tutorial_users_guides;">
-          &otarget_tutorial_users_guides;
+      <dir name="references">
+        <document targetdoc="&uima_docs_ref;">
+          &otarget_refs;
         </document>
-      </dir>    
+      </dir>  
+    </dir>  
   </sitemap>
 </targetset>