diff --git a/README.md b/README.md index f6c3619ebaa9..260bcbc08a70 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,7 @@ comprehensive documentation, visit: - Nightly: - Build System Documentation: [help/](./help/) - Developer Documentation: [dev-docs/](./dev-docs/) +- Migration Guide: [lucene/MIGRATE.md](./lucene/MIGRATE.md) ## Building with Gradle diff --git a/lucene/MIGRATE.md b/lucene/MIGRATE.md index 345e1919aa8d..aa0d011e8df0 100644 --- a/lucene/MIGRATE.md +++ b/lucene/MIGRATE.md @@ -17,6 +17,24 @@ # Apache Lucene Migration Guide +## Rename of binary artifacts from '**-analyzers-**' to '**-analysis-**' (LUCENE-9562) + +All binary analysis packages (and corresponding Maven artifacts) have been renamed and are +now consistent with repository module 'analysis'. You will need to adjust build dependencies +to the new coordinates: + +| Old Artifact Coordinates | New Artifact Coordinates | +|---------------------------------------------|--------------------------------------------| +|org.apache.lucene:lucene-analyzers-common |org.apache.lucene:lucene-analysis-common | +|org.apache.lucene:lucene-analyzers-icu |org.apache.lucene:lucene-analysis-icu | +|org.apache.lucene:lucene-analyzers-kuromoji |org.apache.lucene:lucene-analysis-kuromoji | +|org.apache.lucene:lucene-analyzers-morfologik|org.apache.lucene:lucene-analysis-morfologik| +|org.apache.lucene:lucene-analyzers-nori |org.apache.lucene:lucene-analysis-nori | +|org.apache.lucene:lucene-analyzers-opennlp |org.apache.lucene:lucene-analysis-opennlp | +|org.apache.lucene:lucene-analyzers-phonetic |org.apache.lucene:lucene-analysis-phonetic | +|org.apache.lucene:lucene-analyzers-smartcn |org.apache.lucene:lucene-analysis-smartcn | +|org.apache.lucene:lucene-analyzers-stempel |org.apache.lucene:lucene-analysis-stempel | + ## Minor syntactical changes in StandardQueryParser (Lucene 9.1) LUCENE-10223 adds interval functions and min-should-match support to StandardQueryParser. This @@ -82,11 +100,6 @@ the default stop tags returned by `JapaneseAnalyzer.getDefaultStopTags()` (i.e. o.a.l.collation.ICUCollationAnalyzer is renamed to o.a.l.a.icu.ICUCollationKeyAnalyzer. Also, its dependant classes are renamed in the same way. -## Rename of binary artifacts from '**-analyzers-**' to '**-analysis-**' (LUCENE-9562) - -All binary analysis packages (and corresponding Maven artifacts) have been renamed and are -now consistent with repository module 'analysis'. - ## Base and concrete analysis factories are moved / package renamed (LUCENE-9317) 1. Base analysis factories are moved to `lucene-core`, also their package names are renamed.