[jboss-cvs] JBossAS SVN: r90364 - projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Jun 17 20:53:28 EDT 2009
Author: xhuang at jboss.com
Date: 2009-06-17 20:53:28 -0400 (Wed, 17 Jun 2009)
New Revision: 90364
Removed:
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Architecture.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Author_Group.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Batch_Index.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Book_Info.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Configuration.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Feedback.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Getting_Started.pot
projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Hibernate_Search_Reference_Guide_CP03_FP01.pot
Log:
update
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Architecture.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Architecture.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Architecture.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,368 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Architecture.xml:6
-#, no-c-format
-msgid "Architecture"
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:9
-#, no-c-format
-msgid "Overview"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:11
-#, no-c-format
-msgid ""
-"Hibernate Search consists of an indexing and an index search engine. Both "
-"are backed by Apache Lucene."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:14
-#, no-c-format
-msgid ""
-"When an entity is inserted, updated or removed in/from the database, "
-"Hibernate Search keeps track of this event (through the Hibernate event "
-"system) and schedules an index update. All the index updates are handled for "
-"you without you having to use the Apache Lucene APIs (see <xref linkend="
-"\"Hibernate_Search-Configuration-Event\"/>)."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:19
-#, no-c-format
-msgid ""
-"To interact with Apache Lucene indexes, Hibernate Search has the 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 (see <xref linkend="
-"\"Hibernate_Search-Configuration-Directory\"/>)."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:24
-#, no-c-format
-msgid ""
-"Hibernate Search can also use the Lucene index to search an entity and "
-"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 HQL, JPA-QL or native queries would "
-"do."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:33
-#, no-c-format
-msgid ""
-"To be more efficient, Hibernate Search batches the write interactions with "
-"the Lucene index. There is currently two types of batching depending on the "
-"expected scope."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:37
-#, no-c-format
-msgid ""
-"Outside a transaction, the index update operation is executed right after "
-"the actual database operation. This scope is really a no scoping setup and "
-"no batching is performed."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:41
-#, no-c-format
-msgid ""
-"It is however recommended, for both your database and Hibernate Search, to "
-"execute your operation in a transaction be it JDBC or JTA. When in a "
-"transaction, the index update operation is scheduled for the transaction "
-"commit and discarded in case of transaction rollback. The batching scope is "
-"the transaction. There are two immediate benefits:"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:50
-#, no-c-format
-msgid ""
-"Performance: Lucene indexing works better when operation are executed in "
-"batch."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:55
-#, no-c-format
-msgid ""
-"ACIDity: The work executed has the same scoping as the one executed by the "
-"database transaction and is executed if and only if the transaction is "
-"committed."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:60
-#, no-c-format
-msgid ""
-"Disclaimer, the work in not ACID in the strict sense of it, but ACID "
-"behavior is rarely useful for full text search indexes since they can be "
-"rebuilt from the source at any time."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:67
-#, no-c-format
-msgid ""
-"You can think of those two scopes (no scope vs transactional) as the "
-"equivalent of the (infamous) auto-commit vs transactional behavior. From a "
-"performance perspective, the <emphasis>in transaction</emphasis> mode is "
-"recommended. The scoping choice is made transparently: Hibernate Search "
-"detects the presence of a transaction and adjust the scoping."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:74
-#, no-c-format
-msgid ""
-"Hibernate Search works perfectly fine in the Hibernate / EntityManager long "
-"conversation pattern aka. atomic conversation."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:80
-#, no-c-format
-msgid ""
-"Depending on user demand, additional scoping will be considered, the "
-"pluggability mechanism being already in place."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:87
-#, no-c-format
-msgid "Back End"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:89
-#, no-c-format
-msgid ""
-"Hibernate Search offers the ability to let the scoped work being processed "
-"by different back ends. Two back ends are provided out of the box for two "
-"different scenarios."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:96
-#, no-c-format
-msgid ""
-"Hibernate Search is an extensible architecture. While not yet part of the "
-"public API, plugging a third party back end is possible. Feel free to drop "
-"ideas to <literal>hibernate-dev at lists.jboss.org</literal>."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:102
-#, no-c-format
-msgid "Lucene"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:104
-#, no-c-format
-msgid ""
-"In this mode, all index update operations applied on a given node (JVM) will "
-"be executed to the Lucene directories (through the directory providers) by "
-"the same node. This mode is typically used in non clustered environment or "
-"in clustered environments where the directory store is shared."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:120
-#, no-c-format
-msgid ""
-"This mode targets non clustered applications, or clustered applications "
-"where the Directory is taking care of the locking strategy."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:126
-#, no-c-format
-msgid ""
-"The main advantage is simplicity and immediate visibility of the changes in "
-"Lucene queries (a requirement is some applications)."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:133
-#, no-c-format
-msgid "<title>JMS</title>"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:135
-#, no-c-format
-msgid ""
-"All index update operations applied on a given node are sent to a JMS queue. "
-"A unique reader will then process the queue and update the master Lucene "
-"index. The master index is then replicated on a regular basis to the slave "
-"copies. This is known as the master / slaves pattern. The master is the sole "
-"responsible for updating the Lucene index. The slaves can accept read as "
-"well as write operations. However, they only process the read operation on "
-"their local index copy and delegate the update operations to the master."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:153
-#, no-c-format
-msgid ""
-"This mode targets clustered environments where throughput is critical, and "
-"index update delays are affordable. Reliability is ensured by the JMS "
-"provider and by having the slaves working on a local copy of the index."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:161
-#, no-c-format
-msgid "Work Execution"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:163
-#, no-c-format
-msgid ""
-"The indexing work (done by the back end) can be executed synchronously with "
-"the transaction commit (or update operation if out of transaction), or "
-"asynchronously."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:168
-#, no-c-format
-msgid "Synchronous"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:170
-#, no-c-format
-msgid ""
-"This is the safe mode where the back end work is executed in concert with "
-"the transaction commit. Under highly concurrent environment, this can lead "
-"to throughput limitations (due to the Apache Lucene lock mechanism) and it "
-"can increase the system response time if the backend is significantly slower "
-"than the transactional process and if a lot of IO operations are involved."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:179
-#, no-c-format
-msgid "Asynchronous"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:181
-#, no-c-format
-msgid ""
-"This mode delegates the work done by the back end to a different thread. "
-"That way, throughput and response time are (to a certain extend) "
-"decorrelated from the back end performance. The drawback is that a small "
-"delay appears between the transaction commit and the index update and a "
-"small overhead is introduced to deal with thread management."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:187
-#, no-c-format
-msgid ""
-"It is recommended to use synchronous execution first and evaluate "
-"asynchronous execution if performance problems occur and after having set up "
-"a proper benchmark (i.e. not a lonely cowboy hitting the system in a "
-"completely unrealistic way)."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:195
-#, no-c-format
-msgid "Reader Strategy"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:197
-#, no-c-format
-msgid ""
-"When executing a query, Hibernate Search interacts with the Apache Lucene "
-"indexes through a reader strategy. Choosing a reader strategy will depend on "
-"the profile of the application (frequent updates, read mostly, asynchronous "
-"index update etc). See also"
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:204
-#, no-c-format
-msgid "Shared"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:206
-#, no-c-format
-msgid ""
-"With this strategy, Hibernate Search will share the same IndexReader, for a "
-"given Lucene index, across multiple queries and threads provided that the "
-"IndexReader is still up-to-date. If the IndexReader is not up-to-date, a new "
-"one is opened and provided. Generally speaking, this strategy provides much "
-"better performances than the <literal>not-shared</literal> strategy. It is "
-"especially true if the number of updates is much lower than the reads. This "
-"strategy is the default."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:217
-#, no-c-format
-msgid "Not-shared"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:219
-#, no-c-format
-msgid ""
-"Every time a query is executed, a Lucene IndexReader is opened. This "
-"strategy is not the most efficient since opening and warming up an "
-"IndexReader can be a relatively expensive operation."
-msgstr ""
-
-#. Tag: title
-#: Architecture.xml:225
-#, no-c-format
-msgid "Custom"
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:227
-#, no-c-format
-msgid ""
-"You can write your own reader strategy that suits your application needs by "
-"implementing <classname>org.hibernate.search.reader.ReaderProvider</"
-"classname>. The implementation must be thread safe."
-msgstr ""
-
-#. Tag: para
-#: Architecture.xml:233
-#, no-c-format
-msgid ""
-"Some additional strategies are planned in future versions of Hibernate Search"
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Author_Group.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Author_Group.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Author_Group.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,29 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: author
-#: Author_Group.xml:6
-#, no-c-format
-msgid "<firstname>Hibernate Development Team</firstname> <surname></surname>"
-msgstr ""
-
-#. Tag: editor
-#: Author_Group.xml:10
-#, no-c-format
-msgid ""
-"<firstname>Red Hat Inc. Engineering Content Services</firstname> <surname></"
-"surname>"
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Batch_Index.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Batch_Index.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Batch_Index.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,212 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Batch_Index.xml:6
-#, no-c-format
-msgid "Manual Indexing"
-msgstr ""
-
-#. Tag: title
-#: Batch_Index.xml:9
-#, no-c-format
-msgid "Indexing"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:11
-#, no-c-format
-msgid ""
-"It is sometimes useful to index an object even if this object is not "
-"inserted nor updated to the database. This is especially true when you want "
-"to build your index for the first time. You can achieve that goal using the "
-"<classname>FullTextSession</classname>."
-msgstr ""
-
-#. Tag: programlisting
-#: Batch_Index.xml:16
-#, no-c-format
-msgid ""
-"FullTextSession fullTextSession = Search.createFullTextSession(session);\n"
-" Transaction tx = fullTextSession.beginTransaction();\n"
-" for (Customer customer : customers) {\n"
-" <emphasis role=\"bold\">fullTextSession.index(customer);</"
-"emphasis>\n"
-" }\n"
-" tx.commit(); //index are written at commit time"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:18
-#, no-c-format
-msgid ""
-"For maximum efficiency, Hibernate Search batches index operations and "
-"executes them at commit time (Note: you don't need to use <classname>org."
-"hibernate.Transaction</classname> in a JTA environment)."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:23
-#, no-c-format
-msgid ""
-"If you expect to index a lot of data, you need to be careful about memory "
-"consumption: since all documents are kept in a queue until the transaction "
-"commit, you can potentially face an <classname>OutOfMemoryException</"
-"classname>."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:28
-#, no-c-format
-msgid ""
-"To avoid that, you can set up the <literal>hibernate.search.worker."
-"batch_size</literal> property to a sensitive value: all index operations are "
-"queued until <literal>batch_size</literal> is reached. Every time "
-"<literal>batch_size</literal> is reached (or if the transaction is "
-"committed), the queue is processed (freeing memory) and emptied. Be aware "
-"that the changes cannot be rolled-back if the number of index elements goes "
-"beyond <literal>batch_size</literal>. Be also aware that the queue limits "
-"are also applied on regular transparent indexing (and not only when "
-"<literal>session.index()</literal> is used). That's why a sensitive "
-"<literal>batch_size</literal> value is expected."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:40
-#, no-c-format
-msgid ""
-"Other parameters which also can affect indexing time and memory consumption "
-"are <literal>hibernate.search.[default|<indexname>].batch."
-"merge_factor</literal> , <literal>hibernate.search.[default|<"
-"indexname>].batch.max_merge_docs</literal> and <literal>hibernate.search."
-"[default|<indexname>].batch.max_buffered_docs</literal> . These "
-"parameters are Lucene specific and Hibernate Search is just passing these "
-"parameters through - see <xref linkend=\"Hibernate_Search-Configuration-"
-"Lucene_Index_Performance\"/> for more details."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:50
-#, no-c-format
-msgid ""
-"Here is an especially efficient way to index a given class (useful for index "
-"(re)initialization):"
-msgstr ""
-
-#. Tag: programlisting
-#: Batch_Index.xml:53
-#, no-c-format
-msgid ""
-"fullTextSession.setFlushMode(FlushMode.MANUAL);\n"
-" fullTextSession.setCacheMode(CacheMode.IGNORE);\n"
-" transaction = fullTextSession.beginTransaction();\n"
-" //Scrollable results will avoid loading too many objects in "
-"memory\n"
-" ScrollableResults results = fullTextSession.createCriteria"
-"( Email.class ).scroll(\n"
-" ScrollMode.FORWARD_ONLY );\n"
-" int index = 0;\n"
-" while( results.next() ) {\n"
-" index++;\n"
-" fullTextSession.index( results.get(0) ); //index each "
-"element\n"
-" if (index % batchSize == 0) s.clear(); //clear every "
-"batchSize since the queue is processed\n"
-" }\n"
-" transaction.commit();"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:55
-#, no-c-format
-msgid ""
-"It is critical that <literal>batchSize</literal> in the previous example "
-"matches the <literal>batch_size</literal> value described previously."
-msgstr ""
-
-#. Tag: title
-#: Batch_Index.xml:61
-#, no-c-format
-msgid "Purging"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:63
-#, no-c-format
-msgid ""
-"It is equally possible to remove an entity or all entities of a given type "
-"from a Lucene index without the need to physically remove them from the "
-"database. This operation is named purging and is done through the "
-"<classname>FullTextSession</classname>."
-msgstr ""
-
-#. Tag: programlisting
-#: Batch_Index.xml:68
-#, no-c-format
-msgid ""
-"FullTextSession fullTextSession = Search.createFullTextSession(session);\n"
-" Transaction tx = fullTextSession.beginTransaction();\n"
-" for (Customer customer : customers) {\n"
-" <emphasis role=\"bold\">fullTextSession.purge( Customer."
-"class, customer.getId() );</emphasis>\n"
-" }\n"
-" tx.commit(); //index are written at commit time"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:70
-#, no-c-format
-msgid ""
-"Purging will remove the entity with the given id from the Lucene index but "
-"will not touch the database."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:73
-#, no-c-format
-msgid ""
-"If you need to remove all entities of a given type, you can use the "
-"<command>purgeAll</command> method."
-msgstr ""
-
-#. Tag: programlisting
-#: Batch_Index.xml:76
-#, no-c-format
-msgid ""
-"FullTextSession fullTextSession = Search.createFullTextSession(session);\n"
-" Transaction tx = fullTextSession.beginTransaction();\n"
-" <emphasis role=\"bold\">fullTextSession.purgeAll( Customer."
-"class );</emphasis>\n"
-" //optionally optimize the index\n"
-" //fullTextSession.getSearchFactory().optimize( Customer."
-"class );\n"
-" tx.commit(); //index are written at commit time"
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:78
-#, no-c-format
-msgid "It is recommended to optimize the index after such an operation."
-msgstr ""
-
-#. Tag: para
-#: Batch_Index.xml:82
-#, no-c-format
-msgid ""
-"Methods <command>index</command>, <command>purge</command> and "
-"<command>purgeAll</command> are available on "
-"<classname>FullTextEntityManager</classname> as well"
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Book_Info.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Book_Info.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Book_Info.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,55 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Book_Info.xml:6
-#, no-c-format
-msgid "Hibernate Search Reference Guide CP04 FP01"
-msgstr ""
-
-#. Tag: subtitle
-#: Book_Info.xml:7
-#, no-c-format
-msgid "Apache <trademark>Lucene</trademark> Integration"
-msgstr ""
-
-#. Tag: subtitle
-#: Book_Info.xml:8
-#, no-c-format
-msgid ""
-"For use with JBoss Enterprise Application Platform 4.3.0 Cumulative Patch 4 "
-"Feature Pack 1"
-msgstr ""
-
-#. Tag: para
-#: Book_Info.xml:15
-#, no-c-format
-msgid ""
-"This book is a Reference Guide to Hibernate Search for JBoss Enterprise "
-"Application Platform 4.3.0 CP04 FP01"
-msgstr ""
-
-#. Tag: phrase
-#: Book_Info.xml:24
-#, no-c-format
-msgid "Logo"
-msgstr ""
-
-#. Tag: holder
-#: Book_Info.xml:29
-#, no-c-format
-msgid "&HOLDER;"
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Configuration.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Configuration.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Configuration.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,1156 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Configuration.xml:6
-#, no-c-format
-msgid "Configuration"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:9
-#, no-c-format
-msgid "Directory Configuration"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:11
-#, no-c-format
-msgid ""
-"Apache Lucene has a notion of <literal>Directory</literal> to store the "
-"index files. The Directory implementation can be customized, but Lucene "
-"comes bundled with a file system (<literal>FSDirectoryProvider</literal>) "
-"and a in memory (<literal>RAMDirectoryProvider</literal>) implementation. "
-"Hibernate Search has the notion of <literal>DirectoryProvider</literal> that "
-"handles the configuration and the initialization of the Lucene Directory."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:20
-#, no-c-format
-msgid ""
-"List of built-in Directory Providers in the namespace of org.hibernate."
-"search.store."
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:25
-#, no-c-format
-msgid "Class"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:27 Configuration.xml:243 Configuration.xml:528
-#, no-c-format
-msgid "Description"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:29
-#, no-c-format
-msgid "Properties"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:35
-#, no-c-format
-msgid "FSDirectoryProvider"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:37
-#, no-c-format
-msgid ""
-"File system based directory. The directory used will be <indexBase>/"
-"< <literal>@Indexed.name</literal> >"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:41
-#, no-c-format
-msgid "<literal>indexBase</literal> : Base directory"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:42 Configuration.xml:60 Configuration.xml:85
-#, no-c-format
-msgid ""
-"<literal>indexName</literal>: override @Index.name (useful for sharded "
-"indexes)"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:47
-#, no-c-format
-msgid "FSMasterDirectoryProvider"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:49
-#, no-c-format
-msgid ""
-"File system based directory. Like FSDirectoryProvider. It also copies the "
-"index to a source directory (aka copy directory) on a regular basis."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:52 Configuration.xml:77
-#, no-c-format
-msgid ""
-"The recommended value for the refresh period is (at least) 50% higher that "
-"the time to copy the information (default 3600 seconds - 60 minutes)."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:53 Configuration.xml:79
-#, no-c-format
-msgid ""
-"Note that the copy is based on an incremental copy mechanism reducing the "
-"average copy time."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:55
-#, no-c-format
-msgid ""
-"DirectoryProvider typically used on the master node in a JMS back end "
-"cluster."
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:56
-#, no-c-format
-msgid ""
-"<entry>DirectoryProvider typically used on slave nodes using a JMS back end."
-"</entry>"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:59 Configuration.xml:84
-#, no-c-format
-msgid "<literal>indexBase</literal>: Base directory"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:62 Configuration.xml:87
-#, no-c-format
-msgid "<literal>sourceBase</literal>: Source (copy) base directory."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:63 Configuration.xml:88
-#, no-c-format
-msgid ""
-"<literal>source</literal>: Source directory suffix (default to "
-"<literal>@Indexed.name</literal>). The actual source directory name being "
-"<filename><sourceBase>/<source></filename>"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:67 Configuration.xml:92
-#, no-c-format
-msgid ""
-"refresh: refresh period in second (the copy will take place every refresh "
-"seconds)."
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:72
-#, no-c-format
-msgid "FSSlaveDirectoryProvider"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:74
-#, no-c-format
-msgid ""
-"File system based directory. Like FSDirectoryProvider, but retrieves a "
-"master version (source) on a regular basis. To avoid locking and "
-"inconsistent search results, 2 local copies are kept."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:81
-#, no-c-format
-msgid ""
-"<para>DirectoryProvider typically used on slave nodes using a JMS back end.</"
-"para>"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:97
-#, no-c-format
-msgid "RAMDirectoryProvider"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:99
-#, no-c-format
-msgid ""
-"Memory based directory, the directory will be uniquely identified (in the "
-"same deployment unit) by the <literal>@Indexed.name</literal> element"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:103
-#, no-c-format
-msgid "none"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:109
-#, no-c-format
-msgid ""
-"If the built-in directory providers does not fit your needs, you can write "
-"your own directory provider by implementing the <classname>org.hibernate."
-"store.DirectoryProvider</classname> interface"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:114
-#, no-c-format
-msgid ""
-"Each indexed entity is associated to a Lucene index (an index can be shared "
-"by several entities but this is not usually the case). You can configure the "
-"index through properties prefixed by <command>hibernate.search.</"
-"command><replaceable>indexname</replaceable> . Default properties inherited "
-"to all indexes can be defined using the prefix <command>hibernate.search."
-"default.</command>"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:121
-#, no-c-format
-msgid ""
-"To define the directory provider of a given index, you use the property "
-"<literal>hibernate.search.<replaceable>indexname</replaceable>."
-"directory_provider </literal>."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:125
-#, no-c-format
-msgid ""
-"hibernate.search.default.directory_provider org.hibernate.search.store."
-"FSDirectoryProvider\n"
-" hibernate.search.default.indexBase=/usr/lucene/"
-"indexes\n"
-" \n"
-" hibernate.search.Rules.directory_provider org."
-"hibernate.search.store.RAMDirectoryProvider"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:127
-#, no-c-format
-msgid "applied on"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:129
-#, no-c-format
-msgid ""
-"@Indexed(name=\"Status\")\n"
-"public class Status { ... }\n"
-" \n"
-"@Indexed(name=\"Rules\")\n"
-"public class Rule { ... }"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:131
-#, no-c-format
-msgid ""
-"will create a file system directory in <filename>/usr/lucene/indexes/Status</"
-"filename> where the Status entities will be indexed, and use an in memory "
-"directory named <literal>Rules</literal> where Rule entities will be indexed."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:136
-#, no-c-format
-msgid ""
-"You can easily define common rules like the directory provider and base "
-"directory, and override those default later on on a per index basis."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:140
-#, no-c-format
-msgid ""
-"Writing your own <classname>DirectoryProvider</classname>, you can utilize "
-"this configuration mechanism as well."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:145
-#, no-c-format
-msgid "Index Sharding"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:147
-#, no-c-format
-msgid ""
-"In some extreme cases involving huge indexes (in size), it is necessary to "
-"split (shard) the indexing data of a given entity type into several Lucene "
-"indexes. This solution is not recommended until you reach significant index "
-"sizes and index update time are slowing down. The main drawback of index "
-"sharding is that searches will end up being slower since more files have to "
-"be opened for a single search. In other words don't do it until you have "
-"problems :)"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:155
-#, no-c-format
-msgid ""
-"Despite this strong warning, Hibernate Search allows you to index a given "
-"entity type into several sub indexes. Data is sharded into the different sub "
-"indexes thanks to an <classname>IndexShardingStrategy</classname>. By "
-"default, no sharding strategy is enabled, unless the number of shards is "
-"configured. To configure the number of shards use the following property"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:162
-#, no-c-format
-msgid "hibernate.search.<indexName>.sharding_strategy.nbr_of_shards 5"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:164
-#, no-c-format
-msgid "This will use 5 different shards."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:166
-#, no-c-format
-msgid ""
-"The default sharding strategy, when shards are set up, splits the data "
-"according to the hash value of the id string representation (generated by "
-"the Field Bridge). This ensures a fairly balanced sharding. You can replace "
-"the strategy by implementing <literal>IndexShardingStrategy</literal> and by "
-"setting the following property"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:173
-#, no-c-format
-msgid ""
-"hibernate.search.<indexName>.sharding_strategy my.shardingstrategy."
-"Implementation"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:175
-#, no-c-format
-msgid ""
-"Each shard has an independent directory provider configuration as described "
-"in <xref linkend=\"Hibernate_Search-Configuration-Directory\"/>. The "
-"DirectoryProvider default name for the previous example are <literal><"
-"indexName>.0</literal> to <literal><indexName>.4</literal>. In "
-"other words, each shard has the name of it's owning index followed by "
-"<command>.</command> (dot) and its index number."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:183
-#, no-c-format
-msgid ""
-"hibernate.search.default.indexBase /usr/lucene/indexes\n"
-" \n"
-" hibernate.search.Animal.sharding_strategy."
-"nbr_of_shards 5\n"
-" hibernate.search.Animal.directory_provider org."
-"hibernate.search.store.FSDirectoryProvider\n"
-" hibernate.search.Animal.0.indexName Animal00\n"
-" hibernate.search.Animal.3.indexBase /usr/lucene/"
-"sharded\n"
-" hibernate.search.Animal.3.indexName Animal03"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:185
-#, no-c-format
-msgid ""
-"This configuration uses the default id string hashing strategy and shards "
-"the Animal index into 5 sub-indexes. All sub-indexes are FSDirectoryProvider "
-"instances and the directory where each sub-index is stored is as followed:"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:192
-#, no-c-format
-msgid ""
-"for subindex 0: /usr/lucene/indexes/Animal00 (shared indexBase but "
-"overridden indexName)"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:197
-#, no-c-format
-msgid ""
-"for subindex 1: /usr/lucene/indexes/Animal.1 (shared indexBase, default "
-"indexName)"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:202
-#, no-c-format
-msgid ""
-"for subindex 2: /usr/lucene/indexes/Animal.2 (shared indexBase, default "
-"indexName)"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:207
-#, no-c-format
-msgid ""
-"for subindex 3: /usr/lucene/shared/Animal03 (overridden indexBase, "
-"overridden indexName)"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:212
-#, no-c-format
-msgid ""
-"for subindex 4: /usr/lucene/indexes/Animal.4 (shared indexBase, default "
-"indexName)"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:219
-#, no-c-format
-msgid "Worker Configuration"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:221
-#, no-c-format
-msgid ""
-"It is possible to refine how Hibernate Search interacts with Lucene through "
-"the worker configuration. The work can be executed to the Lucene directory "
-"or sent to a JMS queue for later processing. When processed to the Lucene "
-"directory, the work can be processed synchronously or asynchronously to the "
-"transaction commit."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:227
-#, no-c-format
-msgid "You can define the worker configuration using the following properties"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:231
-#, no-c-format
-msgid "Worker Configuration (in the namespace of hibernate.worker)"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:241 Configuration.xml:526
-#, no-c-format
-msgid "Property"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:247
-#, no-c-format
-msgid "backend"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:249
-#, no-c-format
-msgid ""
-"Out of the box support for the Apache Lucene back end and the JMS back end. "
-"Default to <literal>lucene</literal>. Supports also <literal>jms</literal>."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:255
-#, no-c-format
-msgid "execution"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:257
-#, no-c-format
-msgid ""
-"Supports synchronous and asynchrounous execution. Default to "
-"<literal><literal>sync</literal></literal>. Supports also <literal>async</"
-"literal>."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:263
-#, no-c-format
-msgid "thread_pool.size"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:265
-#, no-c-format
-msgid ""
-"Defines the number of threads in the pool. useful only for asynchrounous "
-"execution. Default to 1."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:270
-#, no-c-format
-msgid "buffer_queue.max"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:272
-#, no-c-format
-msgid ""
-"Defines the maximal number of work queue if the thread poll is starved. "
-"Useful only for asynchrounous execution. Default to infinite. If the limit "
-"is reached, the work is done by the main thread."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:279
-#, no-c-format
-msgid "jndi.*"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:281
-#, no-c-format
-msgid ""
-"Defines the JNDI properties to initiate the InitialContext (if needed). JNDI "
-"is only used by the JMS back end."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:286
-#, no-c-format
-msgid "jms.connection_factory"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:289
-#, no-c-format
-msgid ""
-"Mandatory for the JMS back end. Defines the JNDI name to lookup the JMS "
-"connection factory from (<literal>java:/ConnectionFactory</literal> by "
-"default in JBoss AS)"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:296
-#, no-c-format
-msgid "jms.queue"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:298
-#, no-c-format
-msgid ""
-"Mandatory for the JMS back end. Defines the JNDI name to lookup the JMS "
-"queue from. The queue will be used to post work messages."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:304
-#, no-c-format
-msgid "batch_size"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:306
-#, no-c-format
-msgid ""
-"Defines the maximum number of elements indexed before flushing the "
-"transaction-bound queue. Default to 0 (i.e. no limit). See <xref linkend="
-"\"Hibernate_Search-Batch_Index\"/> for more information."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:317
-#, no-c-format
-msgid "JMS Master/Slave Configuration"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:319
-#, no-c-format
-msgid ""
-"This section describes in greater detail how to configure the Master / "
-"Slaves Hibernate Search architecture."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:323
-#, no-c-format
-msgid "Slave Nodes"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:325
-#, no-c-format
-msgid ""
-"Every index update operation is sent to a JMS queue. Index querying "
-"operations are executed on a local index copy."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:328
-#, no-c-format
-msgid ""
-"### slave configuration\n"
-" \n"
-" ## DirectoryProvider\n"
-" # (remote) master location\n"
-" hibernate.search.default.sourceBase = /mnt/"
-"mastervolume/lucenedirs/mastercopy\n"
-" \n"
-" # local copy location\n"
-" hibernate.search.default.indexBase = /Users/"
-"prod/lucenedirs\n"
-" \n"
-" # refresh every half hour\n"
-" hibernate.search.default.refresh = 1800\n"
-" \n"
-" # appropriate directory provider\n"
-" hibernate.search.default.directory_provider "
-"= org.hibernate.search.store.FSSlaveDirectoryProvider\n"
-" \n"
-" ## Backend configuration\n"
-" hibernate.search.worker.backend = jms\n"
-" hibernate.search.worker.jms."
-"connection_factory = java:/ConnectionFactory\n"
-" hibernate.search.worker.jms.queue = queue/"
-"hibernatesearch\n"
-" #optional jndi configuration (check your JMS "
-"provider for more information)\n"
-" \n"
-" ## Optional asynchronous execution strategy\n"
-" # org.hibernate.worker.execution = async\n"
-" # org.hibernate.worker.thread_pool.size = 2\n"
-" # org.hibernate.worker.buffer_queue.max = 50"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:330
-#, no-c-format
-msgid "A file system local copy is recommended for faster search results."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:333 Configuration.xml:345
-#, no-c-format
-msgid "The refresh period should be higher that the expected time copy."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:338
-#, no-c-format
-msgid "Master node"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:340
-#, no-c-format
-msgid ""
-"Every index update operation is taken from a JMS queue and executed. The "
-"master index(es) is(are) copied on a regular basis."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:343
-#, no-c-format
-msgid ""
-"### master configuration\n"
-" \n"
-" ## DirectoryProvider\n"
-" # (remote) master location where information "
-"is copied to\n"
-" hibernate.search.default.sourceBase = /mnt/"
-"mastervolume/lucenedirs/mastercopy\n"
-" \n"
-" # local master location\n"
-" hibernate.search.default.indexBase = /Users/"
-"prod/lucenedirs\n"
-" \n"
-" # refresh every half hour\n"
-" hibernate.search.default.refresh = 1800\n"
-" \n"
-" # appropriate directory provider\n"
-" hibernate.search.default.directory_provider "
-"= org.hibernate.search.store.FSMasterDirectoryProvider\n"
-" \n"
-" ## Backend configuration\n"
-" #Backend is the default lucene one"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:348
-#, no-c-format
-msgid ""
-"In addition to the Hibernate Search framework configuration, a Message "
-"Driven Bean should be written and set up to process index works queue "
-"through JMS."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:352
-#, no-c-format
-msgid ""
-"@MessageDriven(activationConfig = {\n"
-" @ActivationConfigProperty(propertyName="
-"\"destinationType\", propertyValue=\"javax.jms.Queue\"),\n"
-" @ActivationConfigProperty(propertyName="
-"\"destination\", propertyValue=\"queue/hiebrnatesearch\"),\n"
-" @ActivationConfigProperty(propertyName="
-"\"DLQMaxResent\", propertyValue=\"1\")\n"
-" } )\n"
-" public class MDBSearchController extends "
-"AbstractJMSHibernateSearchController implements MessageListener {\n"
-" @PersistenceContext EntityManager em;\n"
-" \n"
-" //method retrieving the appropriate session\n"
-" protected Session getSession() {\n"
-" return (Session) em.getDelegate();\n"
-" }\n"
-" \n"
-" //potentially close the session opened in "
-"#getSession(), not needed here\n"
-" protected void cleanSessionIfNeeded(Session "
-"session) \n"
-" }\n"
-" }"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:354
-#, no-c-format
-msgid ""
-"This example inherit the abstract JMS controller class available and "
-"implements a JavaEE 5 MDB. This implementation is given as an example and, "
-"while most likely more complex, can be adjusted to make use of non Java EE "
-"Message Driven Beans. For more information about the <command>getSession()</"
-"command> and <command>cleanSessionIfNeeded()</command>, please check "
-"<classname>AbstractJMSHibernateSearchController</classname>'s javadoc."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:364
-#, no-c-format
-msgid ""
-"Hibernate Search test suite makes use of JBoss Embedded to test the JMS "
-"integration. It allows the unit test to run both the MDB container and JBoss "
-"Messaging (JMS provider) in a standalone way (marketed by some as "
-"\"lightweight\")."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:373
-#, no-c-format
-msgid "Reader Strategy Configuration"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:375
-#, no-c-format
-msgid ""
-"The different reader strategies are described in <xref linkend="
-"\"Hibernate_Search-Architecture-Reader_Strategy\"/>. The default reader "
-"strategy is <literal>shared</literal>. This can be adjusted:"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:378
-#, no-c-format
-msgid "hibernate.search.reader.strategy = not-shared"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:380
-#, no-c-format
-msgid ""
-"Adding this property switch to the <literal>non shared</literal> strategy."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:383
-#, no-c-format
-msgid "Or if you have a custom reader strategy:"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:385
-#, no-c-format
-msgid "hibernate.search.reader.strategy = my.corp.myapp.CustomReaderProvider"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:387
-#, no-c-format
-msgid ""
-"where <classname>my.corp.myapp.CustomReaderProvider</classname> is the "
-"custom strategy implementation"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:392
-#, no-c-format
-msgid "Enabling Hibernate Search and automatic indexing"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:395
-#, no-c-format
-msgid "Enabling Hibernate Search"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:397
-#, no-c-format
-msgid ""
-"Hibernate Search is enabled out of the box when using Hibernate Annotations "
-"or Hibernate EntityManager. If, for some reason you need to disable it, set "
-"<literal>hibernate.search.autoregister_listeners</literal> to false. Note "
-"that there is no performance runtime when the listeners are enabled while no "
-"entity is indexable."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:404
-#, no-c-format
-msgid ""
-"To enable Hibernate Search in Hibernate Core, add the "
-"<literal>FullTextIndexEventListener</literal> for the three Hibernate events "
-"that occur after changes are executed to the database. Once again, such a "
-"configuration is not useful with Hibernate Annotations or Hibernate "
-"EntityManager."
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:410
-#, no-c-format
-msgid ""
-"<hibernate-configuration>\n"
-" <session-factory>\n"
-" ...\n"
-" <event type=\"post-update\"/>\n"
-" <listener class=\"org.hibernate.search."
-"event.FullTextIndexEventListener\"/>\n"
-" </event>\n"
-" <event type=\"post-insert\"/>\n"
-" <listener class=\"org.hibernate.search."
-"event.FullTextIndexEventListener\"/>\n"
-" </event>\n"
-" <event type=\"post-delete\"/>\n"
-" <listener class=\"org.hibernate.search."
-"event.FullTextIndexEventListener\"/>\n"
-" </event>\n"
-" </session-factory>\n"
-" </hibernate-configuration>"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:412
-#, no-c-format
-msgid ""
-"Be sure to add the appropriate jar files in your classpath. Check "
-"<literal>lib/README.TXT</literal> for the list of third party libraries. A "
-"typical installation on top of Hibernate Annotations will add:"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:418
-#, no-c-format
-msgid "<filename>hibernate-search.jar</filename>: the core engine"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:423
-#, no-c-format
-msgid "<filename>lucene-core-*.jar</filename>: Lucene core engine"
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:429
-#, no-c-format
-msgid "Hibernate Core 3.2.6 and beyond"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:431
-#, no-c-format
-msgid ""
-"If you use Hibernate Core 3.2.6 and beyond, make sure to add three "
-"additional event listeners that cope with collection events"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:435
-#, no-c-format
-msgid ""
-"<hibernate-configuration>\n"
-" <session-factory>\n"
-" ...\n"
-" <event type=\"post-collection-"
-"recreate\"/>\n"
-" <listener class=\"org.hibernate."
-"search.event.FullTextIndexCollectionEventListener\"/>\n"
-" </event>\n"
-" <event type=\"post-collection-"
-"remove\"/>\n"
-" <listener class=\"org.hibernate."
-"search.event.FullTextIndexCollectionEventListener\"/>\n"
-" </event>\n"
-" <event type=\"post-collection-"
-"update\"/>\n"
-" <listener class=\"org.hibernate."
-"search.event.FullTextIndexCollectionEventListener\"/>\n"
-" </event>\n"
-" </session-factory>\n"
-" </hibernate-configuration>"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:437
-#, no-c-format
-msgid ""
-"Those additional event listeners have been introduced in Hibernate 3.2.6. "
-"note the <classname>FullTextIndexCollectionEventListener</classname> usage. "
-"You need to explicitly reference those event listeners unless you use "
-"Hibernate Annotations 3.3.1 and above."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:446
-#, no-c-format
-msgid "Automatic indexing"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:448
-#, no-c-format
-msgid ""
-"By default, every time an object is inserted, updated or deleted through "
-"Hibernate, Hibernate Search updates the according Lucene index. It is "
-"sometimes desirable to disable that features if either your index is read-"
-"only or if index updates are done in a batch way (see <xref linkend="
-"\"Hibernate_Search-Batch_Index\"/>)."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:453
-#, no-c-format
-msgid "To disable event based indexing, set"
-msgstr ""
-
-#. Tag: programlisting
-#: Configuration.xml:455
-#, no-c-format
-msgid "hibernate.search.indexing_strategy manual"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:458
-#, no-c-format
-msgid ""
-"In most case, the JMS backend provides the best of both world, a lightweight "
-"event based system keeps track of all changes in the system, and the "
-"heavyweight indexing process is done by a separate process or machine."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:467
-#, no-c-format
-msgid "Tuning Lucene indexing performance"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:469
-#, no-c-format
-msgid ""
-"Hibernate Search allows you to tune the Lucene indexing performance by "
-"specifying a set of parameters which are passed through to underlying Lucene "
-"<literal>IndexWriter</literal> such as <literal>mergeFactor</literal>, "
-"<literal>maxMergeDocs</literal> and <literal>maxBufferedDocs</literal>. You "
-"can specify these parameters either as default values applying for all "
-"indexes or on a per index basis."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:477
-#, no-c-format
-msgid ""
-"There are two sets of parameters allowing for different performance settings "
-"depending on the use case. During indexing operations triggered by database "
-"modifications, the following ones are used: <itemizedlist> <listitem> "
-"<para><literal>hibernate.search.[default|<indexname>].transaction."
-"merge_factor</literal></para> </listitem> <listitem> "
-"<para><literal>hibernate.search.[default|<indexname>].transaction."
-"max_merge_docs</literal></para> </listitem> <listitem> "
-"<para><literal>hibernate.search.[default|<indexname>].transaction."
-"max_buffered_docs</literal></para> </listitem> </itemizedlist>When indexing "
-"occurs via <literal>FullTextSession.index()</literal> (see <xref linkend="
-"\"Hibernate_Search-Batch_Index\"/>), the following properties are used:"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:495
-#, no-c-format
-msgid "hibernate.search.[default|<indexname>].batch.merge_factor"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:499
-#, no-c-format
-msgid "hibernate.search.[default|<indexname>].batch.max_merge_docs"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:503
-#, no-c-format
-msgid "hibernate.search.[default|<indexname>].batch.max_buffered_docs"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:507
-#, no-c-format
-msgid ""
-"Unless the corresponding <literal>.batch</literal> property is explicitly "
-"set, the value will default to the <literal>.transaction</literal> property."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:511
-#, no-c-format
-msgid ""
-"For more information about Lucene indexing performances, please refer to the "
-"Lucene documentation."
-msgstr ""
-
-#. Tag: title
-#: Configuration.xml:515
-#, no-c-format
-msgid ""
-"List of indexing performance properties in the namespace of hibernate.search."
-"[default|<indexname>]"
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:530
-#, no-c-format
-msgid "Default Value"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:536
-#, no-c-format
-msgid "transaction.merge_factor"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:538 Configuration.xml:578
-#, no-c-format
-msgid "Controls segment merge frequency and size."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:539 Configuration.xml:579
-#, no-c-format
-msgid ""
-"Determines how often segment indices are merged when insertion occurs. With "
-"smaller values, less RAM is used while indexing, and searches on unoptimized "
-"indices are faster, but indexing speed is slower. With larger values, more "
-"RAM is used during indexing, and while searches on unoptimized indices are "
-"slower, indexing is faster. Thus larger values (> 10) are best for batch "
-"index creation, and smaller values (< 10) for indices that are "
-"interactively maintained. The value must no be lower than 2."
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:547 Configuration.xml:557 Configuration.xml:569
-#, no-c-format
-msgid ""
-"Used by Hibernate Search during index update operations as part of database "
-"modifications."
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:550 Configuration.xml:572 Configuration.xml:590
-#: Configuration.xml:611
-#, no-c-format
-msgid "<entry>10</entry>"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:554
-#, no-c-format
-msgid "transaction.max_merge_docs"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:556 Configuration.xml:596
-#, no-c-format
-msgid "Defines the largest number of documents allowed in a segment."
-msgstr ""
-
-#. Tag: entry
-#: Configuration.xml:560 Configuration.xml:600
-#, no-c-format
-msgid "Unlimited (Integer.MAX_VALUE)"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:564
-#, no-c-format
-msgid "transaction. max_buffered_docs"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:567 Configuration.xml:606
-#, no-c-format
-msgid ""
-"Controls the amount of documents buffered in memory during indexing. The "
-"bigger the more RAM is consumed."
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:576
-#, no-c-format
-msgid "batch.merge_factor"
-msgstr ""
-
-#. Tag: para
-#: Configuration.xml:587 Configuration.xml:597 Configuration.xml:608
-#, no-c-format
-msgid "Used during indexing via <literal>FullTextSession.index()</literal>"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:594
-#, no-c-format
-msgid "batch.max_merge_docs"
-msgstr ""
-
-#. Tag: literal
-#: Configuration.xml:604
-#, no-c-format
-msgid "batch.max_buffered_docs"
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Feedback.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Feedback.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Feedback.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,35 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Feedback.xml:7
-#, no-c-format
-msgid "Feedback"
-msgstr ""
-
-#. Tag: para
-#: Feedback.xml:8
-#, no-c-format
-msgid ""
-"If you spot a typo in this guide, or if you have thought of a way to make "
-"this manual better, we would love to hear from you! Submit a report in "
-"<ulink url=\"http://jira.jboss.com/jira/browse/JBPAPP\">JIRA</ulink> against "
-"the Product: JBoss Enterprise Application Platform, Version: "
-"<replaceable><version></replaceable>, Component: <emphasis>Doc</"
-"emphasis>. If you have a suggestion for improving the documentation, try to "
-"be as specific as possible. If you have found an error, include the section "
-"number and some of the surrounding text so we can find it easily."
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Getting_Started.pot
===================================================================
--- projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Getting_Started.pot 2009-06-18 00:52:53 UTC (rev 90363)
+++ projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Getting_Started.pot 2009-06-18 00:53:28 UTC (rev 90364)
@@ -1,607 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# FIRST AUTHOR <EMAIL at ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: http://bugs.kde.org\n"
-"POT-Creation-Date: 2009-06-18 00:50+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
-"Language-Team: LANGUAGE <kde-i18n-doc at kde.org>\n"
-"MIME-Version: 1.0\n"
-"Content-Type: application/x-xml2pot; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#. Tag: title
-#: Getting_Started.xml:6
-#, no-c-format
-msgid "Getting Started"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:9
-#, no-c-format
-msgid ""
-"Welcome to Hibernate Search! The following chapter will guide you through "
-"the initial steps required to integrate Hibernate Search into an existing "
-"Hibernate enabled application. In case you are a Hibernate first timer we "
-"recommend you start <ulink url=\"http://hibernate.org/152.html\">here</"
-"ulink>."
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:15
-#, no-c-format
-msgid "System Requirements"
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:18
-#, no-c-format
-msgid "System requirements"
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:23
-#, no-c-format
-msgid "Java Runtime"
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:25
-#, no-c-format
-msgid ""
-"A JDK or JRE version <emphasis>5</emphasis> or greater. You can download a "
-"Java Runtime for Windows/Linux/Solaris <ulink url=\"http://java.sun.com/"
-"javase/downloads/\"> here </ulink>."
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:31
-#, no-c-format
-msgid "Hibernate Search"
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:33
-#, no-c-format
-msgid ""
-"<literal>hibernate-search.jar</literal> and all dependencies from the "
-"<literal>lib</literal> directory of the Hibernate Search distribution, "
-"especially lucene."
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:39
-#, no-c-format
-msgid "Hibernate Core"
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:41
-#, no-c-format
-msgid ""
-"These instructions have been tested against Hibernate 3.2.x. Next to the "
-"main <literal>hibernate3.jar</literal> you will need all required libraries "
-"from the <literal>lib</literal> directory of the distribution. Refer to "
-"<literal>README.txt</literal> in the <literal>lib</literal> directory of the "
-"distribution to determine the minimum runtime requirements."
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:50
-#, no-c-format
-msgid "Hibernate Annotations"
-msgstr ""
-
-#. Tag: entry
-#: Getting_Started.xml:52
-#, no-c-format
-msgid ""
-"Although Hibernate Search can be used without Hibernate Annotations the "
-"following instructions use them for ease of use. The tutorial is tested "
-"against version 3.3.x of Hibernate Annotations."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:60
-#, no-c-format
-msgid ""
-"You can download all dependencies from the Hibernate <ulink url=\"http://www."
-"hibernate.org/6.html\">download site</ulink>. You can also verify the "
-"dependency versions against the <ulink url=\"http://www.hibernate.org/6."
-"html#A3\">Hibernate Compatibility Matrix</ulink>."
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:65
-#, no-c-format
-msgid "Maven"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:67
-#, no-c-format
-msgid ""
-"Instead of managing all dependencies yourself, maven users are able to use "
-"the <ulink url=\"http://repository.jboss.com/maven2\">JBoss maven "
-"repository</ulink>. Just add the JBoss repository url to the "
-"<emphasis>repositories</emphasis> section of your <filename>pom.xml</"
-"filename> or <filename>settings.xml</filename>:"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:73
-#, no-c-format
-msgid ""
-"<repository>\n"
-" <id>repository.jboss.org</id>\n"
-" <name>JBoss Maven Repository</name>\n"
-" <url>http://repository.jboss.org/maven2</"
-"url>\n"
-" <layout>default</layout>\n"
-" </repository>"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:75
-#, no-c-format
-msgid "Then add the following dependencies to your pom.xml:"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:77
-#, no-c-format
-msgid ""
-"<dependency>\n"
-" <groupId>org.hibernate</groupId>\n"
-" <artifactId>hibernate-search</"
-"artifactId>\n"
-" <version>3.0.0.ga</version>\n"
-" </dependency>\n"
-" <dependency>\n"
-" <groupId>org.hibernate</groupId>\n"
-" <artifactId>hibernate-annotations</"
-"artifactId>\n"
-" <version>3.3.0.ga</version>\n"
-" </dependency>\n"
-" <dependency>\n"
-" <groupId>org.hibernate</groupId>\n"
-" <artifactId>hibernate-entitymanager</"
-"artifactId>\n"
-" <version>3.3.1.ga</version>\n"
-" </dependency>"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:79
-#, no-c-format
-msgid ""
-"Not all three dependencies are required. <emphasis>hibernate-search</"
-"emphasis> alone contains everything needed to use Hibernate Search. "
-"<emphasis>hibernate-annotations</emphasis> is only needed if you use non-"
-"Hibernate Search annotations, which are used in the examples of this "
-"tutorial. Note that <emphasis>hibernate-entitymanager</emphasis> is only "
-"required if you use Hibernate Search in conjunction with JPA."
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:87
-#, no-c-format
-msgid "Configuration"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:89
-#, no-c-format
-msgid ""
-"Once all required dependencies have been downloaded and added to your "
-"application, you will need to add some properties to your hibernate "
-"configuration file. If you are using Hibernate directly this can be done in "
-"<literal>hibernate.properties</literal> or <literal>hibernate.cfg.xml</"
-"literal>. If you are using Hibernate via JPA you can also add the properties "
-"to <literal>persistence.xml</literal>. The default properties are suitable "
-"for the standard use."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:92
-#, no-c-format
-msgid ""
-"Apache Lucene has a notion of <literal>Directory</literal> to store the "
-"index files. Hibernate Search handles the initialization and configuration "
-"of a Lucene <literal>Directory</literal> instance via a "
-"<literal>DirectoryProvider</literal>. In this tutorial we will use a "
-"subclass of <literal>DirectoryProvider</literal> called "
-"<classname>FSDirectoryProvider</classname>. This will give us the ability to "
-"physically inspect the Lucene indexes created by Hibernate Search (e.g. via "
-"<ulink url=\"http://www.getopt.org/luke/\">Luke</ulink>). Once you have a "
-"working configuration you can start experimenting with other directory "
-"providers (see <xref linkend=\"Hibernate_Search-Configuration-Directory\"/>)."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:103
-#, no-c-format
-msgid ""
-"Lets assume that your application contains the Hibernate managed class "
-"<classname>example.Book</classname> and you now want to add free text search "
-"capabilities to your application in order to search body and summary of the "
-"books contained in your database."
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:108
-#, no-c-format
-msgid ""
-"package example.Book\n"
-" ...\n"
-" @Entity\n"
-" public class Book {\n"
-" \n"
-" @Id\n"
-" private Integer id; \n"
-" private String body; \n"
-" private String summary; \n"
-" @ManyToMany private Set<Author> authors = new "
-"HashSet<Author>();\n"
-" @ManyToOne private Author mainAuthor;\n"
-" private Date publicationDate;\n"
-" \n"
-" public Book() {\n"
-" } \n"
-" \n"
-" // standard getters/setters follow here\n"
-" ..."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:110
-#, no-c-format
-msgid ""
-"First you need to tell Hibernate Search which <classname>DirectoryProvider</"
-"classname> to use. This can be achieved by setting the <literal>hibernate."
-"search.default.directory_provider</literal> property. You also have to "
-"specify the default root directory for all indexes via <literal>hibernate."
-"search.default.indexBase</literal>."
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:116
-#, no-c-format
-msgid ""
-"...\n"
-" # the default directory provider\n"
-" hibernate.search.default.directory_provider = org."
-"hibernate.search.store.FSDirectoryProvider\n"
-" \n"
-" # the default base directory for the indecies\n"
-" hibernate.search.default.indexBase = /var/lucene/"
-"indexes \n"
-" ..."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:118
-#, no-c-format
-msgid ""
-"Now add three annotations to the <classname>Book</classname> class. The "
-"first annotation <literal>@Indexed</literal> marks <classname>Book</"
-"classname> as indexable. By design Hibernate Search needs to store an "
-"untokenized id in the index to ensure index unicity for a given entity. "
-"<literal>@DocumentId</literal> marks the property to use for this purpose. "
-"Most, if not all of the time, the property is the database primary key. "
-"Finally you will need to index the fields you wish to make searchable. In "
-"our example these fields are <literal>body</literal> and <literal>summary</"
-"literal>. Both properties get annotated with <literal>@Field</literal>. The "
-"property <literal>index=Index.TOKENIZED</literal> will ensure that the text "
-"will be tokenized using the default Lucene analyzer whereas "
-"<literal>store=Store.NO</literal> ensures that the actual data will not be "
-"stored in the index. Usually, tokenizing means chunking a sentence into "
-"individual words (and potentially excluding common words like <literal>a</"
-"literal>, <literal>the </literal>etc)."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:135
-#, no-c-format
-msgid ""
-"These settings are sufficient for an initial test. For more details on "
-"entity mapping refer to <xref linkend=\"Hibernate_Search-Mapping-Entity\"/>. "
-"In case you want to store and retrieve the indexed data in order to avoid "
-"database roundtrips, refer to projections in"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:140
-#, no-c-format
-msgid ""
-"package example.Book\n"
-" ...\n"
-" @Entity\n"
-" <emphasis role=\"bold\">@Indexed</emphasis>\n"
-" public class Book {\n"
-" \n"
-" @Id\n"
-" <emphasis role=\"bold\">@DocumentId</emphasis>\n"
-" private Integer id;\n"
-" \n"
-" <emphasis role=\"bold\">@Field(index=Index."
-"TOKENIZED, store=Store.NO)</emphasis>\n"
-" private String body;\n"
-" \n"
-" <emphasis role=\"bold\">@Field(index=Index."
-"TOKENIZED, store=Store.NO)</emphasis>\n"
-" private String summary; \n"
-" @ManyToMany private Set<Author> authors = new "
-"HashSet<Author>();\n"
-" @ManyToOne private Author mainAuthor;\n"
-" private Date publicationDate;\n"
-" \n"
-" public Book() {\n"
-" } \n"
-" \n"
-" // standard getters/setters follow here\n"
-" ..."
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:144
-#, no-c-format
-msgid "Indexing"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:146
-#, no-c-format
-msgid ""
-"Hibernate Search will index every entity persisted, updated or removed "
-"through Hibernate core transparently for the application. However, the data "
-"already present in your database needs to be indexed once to populate the "
-"Lucene index. Once you have added the above properties and annotations it is "
-"time to trigger an initial batch index of your books. You can achieve this "
-"by adding one of the following code examples to your code (see also <xref "
-"linkend=\"Hibernate_Search-Batch_Index\"/>):"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:154 Getting_Started.xml:176
-#, no-c-format
-msgid "Example using Hibernate Session:"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:156
-#, no-c-format
-msgid ""
-"FullTextSession fullTextSession = Search.createFullTextSession(session);\n"
-" Transaction tx = fullTextSession.beginTransaction"
-"();\n"
-" List books = session.createQuery(\"from Book as book"
-"\").list();\n"
-" for (Book book : books) {\n"
-" fullTextSession.index(book);\n"
-" }\n"
-" tx.commit(); //index are written at commit time"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:158 Getting_Started.xml:180
-#, no-c-format
-msgid "Example using JPA:"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:160
-#, no-c-format
-msgid ""
-"EntityManager em = entityManagerFactory.createEntityManager();\n"
-" FullTextEntityManager fullTextEntityManager = Search."
-"createFullTextEntityManager(em);\n"
-" List books = em.createQuery(\"select book from Book "
-"as book\").getResultList();\n"
-" for (Book book : books) {\n"
-" fullTextEntityManager.index(book);\n"
-" }"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:162
-#, no-c-format
-msgid ""
-"After executing the above code, you should be able to see a Lucene index "
-"under <literal>/var/lucene/indexes/example.Book</literal>. Go ahead an "
-"inspect this index. It will help you to understand how Hibernate Search "
-"works."
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:169
-#, no-c-format
-msgid "Searching"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:171
-#, no-c-format
-msgid ""
-"Now it is time to execute a first search. The following code will prepare a "
-"query against the fields <literal>summary</literal> and <literal>body</"
-"literal>, execute it and return a list of <classname>Book</classname>s:"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:178
-#, no-c-format
-msgid ""
-"FullTextSession fullTextSession = Search.createFullTextSession(session);\n"
-" \n"
-" Transaction tx = fullTextSession.beginTransaction"
-"();\n"
-" \n"
-" MultiFieldQueryParser parser = new "
-"MultiFieldQueryParser( new String[]{\"summary\", \"body\"}, \n"
-" new StandardAnalyzer());\n"
-" Query query = parser.parse( \"Java rocks!\" );\n"
-" org.hibernate.Query hibQuery = fullTextSession."
-"createFullTextQuery( query, Book.class );\n"
-" List result = hibQuery.list();\n"
-" \n"
-" tx.commit();\n"
-" session.close();"
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:182
-#, no-c-format
-msgid ""
-"EntityManager em = entityManagerFactory.createEntityManager();\n"
-" \n"
-" FullTextEntityManager fullTextEntityManager = \n"
-" org.hibernate.hibernate.search.jpa.Search."
-"createFullTextEntityManager(em);\n"
-" MultiFieldQueryParser parser = new "
-"MultiFieldQueryParser( new String[]{\"summary\", \"body\"}, \n"
-" new StandardAnalyzer());\n"
-" Query query = parser.parse( \"Java rocks!\" );\n"
-" org.hibernate.Query hibQuery = fullTextEntityManager."
-"createFullTextQuery( query, Book.class );\n"
-" List result = hibQuery.list();"
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:186
-#, no-c-format
-msgid "Analyzer"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:188
-#, no-c-format
-msgid ""
-"Assume that one of your indexed book entities contains the text \"Java rocks"
-"\" and you want to get hits for all of the following queries: \"rock\", "
-"\"rocks\", \"rocked\" and \"rocking\". In Lucene this can be achieved by "
-"choosing an analyzer class which applies word stemming during the indexing "
-"process. Hibernate Search offers several ways to configure the analyzer to "
-"use (see <xref linkend=\"Hibernate_Search-Entity-Analyzer\"/>):"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:197
-#, no-c-format
-msgid ""
-"Setting the <literal>hibernate.search.analyzer</literal> property in the "
-"configuration file. The specified class will then be the default analyzer."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:203
-#, no-c-format
-msgid "Setting the <literal>Analyzer</literal> annotation at the entity level."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:208
-#, no-c-format
-msgid "Setting the <literal>Analyzer</literal> annotation at the field level."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:213
-#, no-c-format
-msgid ""
-"The following example uses the entity level annotation to apply a English "
-"language analyzer which would help you to achieve your goal. The class "
-"<classname>EnglishAnalyzer</classname> is a custom class using the Snowball "
-"English Stemmer from the <ulink url=\"http://lucene.apache.org/java/docs/"
-"lucene-sandbox/\">Lucene Sandbox</ulink>."
-msgstr ""
-
-#. Tag: programlisting
-#: Getting_Started.xml:220
-#, no-c-format
-msgid ""
-"package example.Book\n"
-" ...\n"
-" @Entity\n"
-" @Indexed\n"
-" <emphasis role=\"bold\">@Analyzer(impl = example."
-"EnglishAnalyzer.class)</emphasis>\n"
-" public class Book {\n"
-" \n"
-" @Id\n"
-" @DocumentId\n"
-" private Integer id;\n"
-" \n"
-" @Field(index=Index.TOKENIZED, store=Store.NO)\n"
-" private String body;\n"
-" \n"
-" @Field(index=Index.TOKENIZED, store=Store.NO)\n"
-" private String summary; \n"
-" @ManyToMany private Set<Author> authors = new "
-"HashSet<Author>();\n"
-" @ManyToOne private Author mainAuthor;\n"
-" private Date publicationDate;\n"
-" \n"
-" public Book() {\n"
-" } \n"
-" \n"
-" // standard getters/setters follow here\n"
-" ... \n"
-" }\n"
-" \n"
-" public class EnglishAnalyzer extends Analyzer {\n"
-" /**\n"
-" * {@inheritDoc}\n"
-" */\n"
-" @Override\n"
-" public TokenStream tokenStream(String fieldName, "
-"Reader reader) {\n"
-" TokenStream result = new StandardTokenizer(reader);\n"
-" result = new StandardFilter(result);\n"
-" result = new LowerCaseFilter(result);\n"
-" result = new SnowballFilter(result, name);\n"
-" return result;\n"
-" }\n"
-" }"
-msgstr ""
-
-#. Tag: title
-#: Getting_Started.xml:224
-#, no-c-format
-msgid "What's next"
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:226
-#, no-c-format
-msgid ""
-"The above paragraphs hopefully helped you getting started with Hibernate "
-"Search. You should by now have a file system based index and be able to "
-"search and retrieve a list of managed objects via Hibernate Search. The next "
-"step is to get more familiar with the overall architecture (<xref linkend="
-"\"Hibernate_Search-Architecture\"/>) and explore the basic features in more "
-"detail."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:233
-#, no-c-format
-msgid ""
-"Two topics which where only briefly touched in this tutorial were analyzer "
-"configuration (<xref linkend=\"Hibernate_Search-Entity-Analyzer\"/>) and "
-"field bridges (<xref linkend=\"Hibernate_Search-Mapping-Bridge\"/>), both "
-"important features required for more fine-grained indexing."
-msgstr ""
-
-#. Tag: para
-#: Getting_Started.xml:238
-#, no-c-format
-msgid ""
-"More advanced topics cover clustering (<xref linkend=\"Hibernate_Search-"
-"Configuration-JMS_Backend\"/>) and large indexes handling (<xref linkend="
-"\"Hibernate_Search-Configuration-Index_Sharding\"/>)."
-msgstr ""
Deleted: projects/docs/enterprise/4.3.4.1/Hibernate/Hibernate_Search/pot/Hibernate_Search_Reference_Guide_CP03_FP01.pot
===================================================================
More information about the jboss-cvs-commits
mailing list