Author: hardy.ferentschik Date: 2007-08-06 12:46:15 -0400 (Mon, 06 Aug 2007) New Revision: 12900 Modified: trunk/HibernateExt/search/doc/reference/en/modules/architecture.xml Log: HSEARCH-98 Minor text changes and a few cross references. Modified: trunk/HibernateExt/search/doc/reference/en/modules/architecture.xml =================================================================== --- trunk/HibernateExt/search/doc/reference/en/modules/architecture.xml 2007-08-06 16:45:40 UTC (rev 12899) +++ trunk/HibernateExt/search/doc/reference/en/modules/architecture.xml 2007-08-06 16:46:15 UTC (rev 12900) @@ -3,23 +3,26 @@ <chapter id="search-architecture"> <title>Architecture</title> - <para>Hibernate Search is made of an indexing engine and an index search + <para>Hibernate Search is consists of an indexing engine and an index search engine. Both are backed by Apache Lucene.</para> <para>When an entity is inserted, updated or removed to/from the database, Hibernate Search keeps track of this event (through the Hibernate event system) and schedule an index update. All the index updates are handled for - you without you having to use the Apache Lucene APIs.</para> + you without you having to use the Apache Lucene APIs + (see <xref linkend="search-configuration-event"/>). + </para> <para>To interact with Apache Lucene indexes, Hibernate Search has the - notion of <classname>DirectoryProvider</classname> . A directory provider + notion of <classname>DirectoryProvider</classname>s. A directory provider will manage a given Lucene <classname>Directory</classname> type. You can - configure directory providers to adjust the directory target.</para> + configure directory providers to adjust the directory target + (see <xref linkend="search-configuration-directory"/>).</para> <para>Hibernate Search can also use a Lucene index to search an entity and - return a (list of) managed entity saving you from the tedious Object / - Lucene Document mapping and low level Lucene APIs. The same persistence - context is shared between Hibernate and Hibernate Search ; as a matter of + return a list of managed entities saving you the tedious object to + Lucene document mapping. The same persistence + context is shared between Hibernate and Hibernate Search; as a matter of fact, the Search Session is built on top of the Hibernate Session. The application code use the unified <classname>org.hibernate.Query</classname> or <classname>javax.persistence.Query</classname> APIs exactly the way a