[hibernate-commits] Hibernate SVN: r12884 - trunk/HibernateExt/search/doc/reference/en.

[hibernate-commits at lists.jboss.org]

Author: hardy.ferentschik
Date: 2007-08-02 11:49:25 -0400 (Thu, 02 Aug 2007)
New Revision: 12884

Modified:
   trunk/HibernateExt/search/doc/reference/en/master.xml
Log:
Some changes to the preface.

Modified: trunk/HibernateExt/search/doc/reference/en/master.xml
===================================================================
--- trunk/HibernateExt/search/doc/reference/en/master.xml	2007-08-02 15:49:05 UTC (rev 12883)
+++ trunk/HibernateExt/search/doc/reference/en/master.xml	2007-08-02 15:49:25 UTC (rev 12884)
@@ -2,6 +2,7 @@
 <!--  $Id$ -->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN"
 "../../../../../Hibernate3/doc/reference/support/docbook-dtd/docbookx.dtd" [
+<!ENTITY getting-started SYSTEM "modules/getting-started.xml">
 <!ENTITY architecture SYSTEM "modules/architecture.xml">
 <!ENTITY configuration SYSTEM "modules/configuration.xml">
 <!ENTITY mapping SYSTEM "modules/mapping.xml">
@@ -33,21 +34,24 @@
     <title>Preface</title>
 
     <para>Full text search engines like <productname>Apache
-    Lucene</productname> are a very powerful technology to bring free
-    text/efficient queries to applications. If suffers several mismatches when
-    dealing with a object domain model (keeping the index up to date, mismatch
-    between the index structure and the domain model, querying mismatch...)
+    Lucene</productname> are very powerful technologies to add efficient free
+    text queries to applications. However, they suffer several mismatches when
+    dealing with object domain models, eg indeces have to be kept up to date,
+    mismatches between index structure and domain model as well as query mismatches 
+    have to be avoided. <sbr/>
     Hibernate Search indexes your domain model thanks to a few annotations,
-    takes care of the database / index synchronization and brings you back
-    regular managed objects from free text queries. Hibernate Search is using
-    <ulink url="http://lucene.apache.org">Apache Lucene</ulink> under the
+    takes care of the database/index synchronization and brings you back
+    regular managed objects from free text queries. To achieve this Hibernate Search
+    is using <ulink url="http://lucene.apache.org">Apache Lucene</ulink> under the
     cover.</para>
 
-    <para>Hibernate Search is a work in progress and new features are cooking
+    <important>Hibernate Search is a work in progress and new features are cooking
     in this area. So expect some compatibility changes in subsequent
-    versions.</para>
+    versions.</important>
   </preface>
 
+  <!--  &getting-started; -->
+
   &architecture;
 
   &configuration;