Bug 508716 - Better document Lucene changes
Change-Id: I4eb5d2371d1cd1850fcdefabb49613b5ad5e187a
Signed-off-by: Sopot Cela <scela@redhat.com>
diff --git a/bundles/org.eclipse.platform.doc.isv/porting/4.7/faq.html b/bundles/org.eclipse.platform.doc.isv/porting/4.7/faq.html
index dbb8630..7dd7824 100644
--- a/bundles/org.eclipse.platform.doc.isv/porting/4.7/faq.html
+++ b/bundles/org.eclipse.platform.doc.isv/porting/4.7/faq.html
@@ -13,16 +13,27 @@
<h1>Eclipse Oxygen (4.7) Plug-in Migration FAQ</h1>
<ol>
- <li>No entries.</li>
+ <li><a href="#lucene">Apache Lucene bundle changes</a></li>
</ol>
<hr>
<!-- ############################################## -->
-<!-- <h2><a name="item">Item Title</a></h2>
-<p>
+<h2><a name="lucene">1. Apache Lucene bundle changes</a></h2>
+<p> As part of the migration to Lucene 6.1, the third-party Lucene bundles were updated from version 3.5 to 6.1.
+<ol>
+ <li>Bundle <code>org.apache.lucene.core</code> was bumped in version so consumers should not see any difference except the changes of Lucene itself (see link below).
+ However some of the new classes were moved by the Lucene project to the <code>org.apache.lucene.misc</code> by making use of split-packages.</li>
+
+ <li>Bundle <code>org.apache.lucene.analysis</code> was removed and it's functionality was split in two new bundles: <code>org.apache.lucene.analysis-common</code> and <code>org.apache.lucene.analysis-smartcn</code>.
+ Consumers should be able to make use of <code>org.apache.lucene.analysis-common</code> for everything they did in the older <code>org.apache.lucene.analysis</code> bundle except the Chinese analyzer which was moved
+ in the above-mentioned 'smartcn' bundle.
+ </li>
+</ol>
+
+See <a href="https://lucene.apache.org/core/old_versioned_docs/versions/6_1_0/changes/Changes.html">
+Lucene Change Log</a> for details on how the Apache Lucene changed between these versoins.
</p>
--->
<!-- ############################################## -->