Update version numbers for commons text release 1.2
Project: http://git-wip-us.apache.org/repos/asf/commons-text/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-text/commit/5e132f8e Tree: http://git-wip-us.apache.org/repos/asf/commons-text/tree/5e132f8e Diff: http://git-wip-us.apache.org/repos/asf/commons-text/diff/5e132f8e Branch: refs/heads/master Commit: 5e132f8e07b4aa1419de93bcd80190a8767def08 Parents: dc0e92b Author: Rob Tompkins <chtom...@apache.org> Authored: Fri Dec 8 20:46:46 2017 -0500 Committer: Rob Tompkins <chtom...@apache.org> Committed: Fri Dec 8 20:46:46 2017 -0500 ---------------------------------------------------------------------- README.md | 2 +- RELEASE-NOTES.txt | 45 +++- pom.xml | 15 +- .../release-notes/RELEASE-NOTES-1.2.txt | 222 +++++++++++++++++++ src/site/xdoc/download_text.xml | 26 +-- src/site/xdoc/index.xml | 8 +- src/site/xdoc/release-history.xml | 3 + 7 files changed, 300 insertions(+), 21 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index cd91e30..9676b5e 100644 --- a/README.md +++ b/README.md @@ -66,7 +66,7 @@ Alternatively you can pull it from the central Maven repositories: <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-text</artifactId> - <version>1.1</version> + <version>1.2</version> </dependency> ``` http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/RELEASE-NOTES.txt ---------------------------------------------------------------------- diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 06f7369..6564a21 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,12 +1,12 @@ Apache Commons Text - Version 1.1 + Version 1.2 Release Notes INTRODUCTION ============ -This document contains the release notes for the 1.1 version of Apache Commons +This document contains the release notes for the 1.2 version of Apache Commons Text. Commons Text is a set of utility functions and reusable components for the purpose of processing and manipulating text that should be of use in a Java environment. @@ -18,6 +18,47 @@ JAVA 9 SUPPORT ============== At our time of release of 1.1, our build succeeds with Java 9-ea build 159, +and we believe all of our features to be Java 9 compatible. However, when we +run "mvn clean site" we have failures. + +NEW FEATURES +============= + +o TEXT-74: StrSubstitutor: Ability to turn off substitution in values. Thanks to Ioannis Sermetziadis. +o TEXT-97: RandomStringGenerator able to pass multiple ranges to .withinRange(). Thanks to Amey Jadiye. +o TEXT-89: WordUtils.initials support for UTF-16 surrogate pairs. Thanks to Arun Vinud S S. +o TEXT-90: Add CharacterPredicates for ASCII letters (uppercase/lowercase) and arabic numerals. +o TEXT-85: Added CaseUtils class with camel case conversion support. Thanks to Arun Vinud S S. +o TEXT-91: RandomStringGenerator should be able to generate a String with a random length. +o TEXT-102: Add StrLookup.resourceBundleLookup(ResourceBundle). + +FIXED BUGS +========== + +o TEXT-106: Exception thrown in ExtendedMessageFormat using quotes with custom registry. Thanks to Benoit Moreau. +o TEXT-100: StringEscapeUtils#UnEscapeJson doesn't recognize escape signs correctly. Thanks to Don Jeba. +o TEXT-105: Typo in LongestCommonSubsequence#logestCommonSubsequence. Thanks to Abrasha. + +CHANGES +======= + +o TEXT-107: Upversion commons-lang to 3.7. +o TEXT-98: Deprecate isDelimiter and use HashSets for delimiter checks. Thanks to Arun Vinud S S. +o TEXT-88: WordUtils should treat an empty delimiter array as no delimiters. Thanks to Amey Jadiye. +o TEXT-93: Update RandomStringGenerator to accept a list of valid characters. Thanks to Amey Jadiye. +o TEXT-92: Update commons-lang dependency to version 3.6. +o TEXT-83: Document that commons-csv should be used in preference to CsvTranslators. Thanks to Amey Jadiye. +o TEXT-67: NumericEntityUnescaper.options - fix TODO. +o TEXT-84: RandomStringGenerator claims to be immutable, but isn't. + + + Release Notes for version 1.1 + + +JAVA 9 SUPPORT +============== + +At our time of release of 1.1, our build succeeds with Java 9-ea build 159, and we believe all of our features to be Java 9 compatible. However, when we run "mvn clean site" we have failures. http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/pom.xml ---------------------------------------------------------------------- diff --git a/pom.xml b/pom.xml index 9410e6c..cbe808c 100644 --- a/pom.xml +++ b/pom.xml @@ -23,7 +23,7 @@ <version>42</version> </parent> <artifactId>commons-text</artifactId> - <version>1.2-SNAPSHOT</version> + <version>1.2</version> <name>Apache Commons Text</name> <description>Apache Commons Text is a library focused on algorithms working on strings.</description> @@ -37,6 +37,7 @@ <commons.module.name>org.apache.commons.text</commons.module.name> <commons.release.version>1.2</commons.release.version> + <commons.rc.version>RC1</commons.rc.version> <commons.release.desc>(Java 7+)</commons.release.desc> <commons.jira.id>TEXT</commons.jira.id> @@ -404,5 +405,17 @@ <coveralls.skip>true</coveralls.skip> </properties> </profile> + <profile> + <!-- Temporary hack to suppress Javadoc 8 errors --> + <!-- to re-enable the checks, build with -P-javadoc_8 --> + <id>javadoc_8</id> + <activation> + <jdk>[1.8,)</jdk> + </activation> + <properties> + <!-- Disable Xdoclint, until JavaDoc issues are fixed --> + <additionalparam>-Xdoclint:none</additionalparam> + </properties> + </profile> </profiles> </project> http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/src/site/resources/release-notes/RELEASE-NOTES-1.2.txt ---------------------------------------------------------------------- diff --git a/src/site/resources/release-notes/RELEASE-NOTES-1.2.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.2.txt new file mode 100644 index 0000000..6564a21 --- /dev/null +++ b/src/site/resources/release-notes/RELEASE-NOTES-1.2.txt @@ -0,0 +1,222 @@ + Apache Commons Text + Version 1.2 + Release Notes + + +INTRODUCTION +============ + +This document contains the release notes for the 1.2 version of Apache Commons +Text. Commons Text is a set of utility functions and reusable components for +the purpose of processing and manipulating text that should be of use in a Java +environment. + +Apache Commons Text is a library focused on algorithms working on strings. + + +JAVA 9 SUPPORT +============== + +At our time of release of 1.1, our build succeeds with Java 9-ea build 159, +and we believe all of our features to be Java 9 compatible. However, when we +run "mvn clean site" we have failures. + +NEW FEATURES +============= + +o TEXT-74: StrSubstitutor: Ability to turn off substitution in values. Thanks to Ioannis Sermetziadis. +o TEXT-97: RandomStringGenerator able to pass multiple ranges to .withinRange(). Thanks to Amey Jadiye. +o TEXT-89: WordUtils.initials support for UTF-16 surrogate pairs. Thanks to Arun Vinud S S. +o TEXT-90: Add CharacterPredicates for ASCII letters (uppercase/lowercase) and arabic numerals. +o TEXT-85: Added CaseUtils class with camel case conversion support. Thanks to Arun Vinud S S. +o TEXT-91: RandomStringGenerator should be able to generate a String with a random length. +o TEXT-102: Add StrLookup.resourceBundleLookup(ResourceBundle). + +FIXED BUGS +========== + +o TEXT-106: Exception thrown in ExtendedMessageFormat using quotes with custom registry. Thanks to Benoit Moreau. +o TEXT-100: StringEscapeUtils#UnEscapeJson doesn't recognize escape signs correctly. Thanks to Don Jeba. +o TEXT-105: Typo in LongestCommonSubsequence#logestCommonSubsequence. Thanks to Abrasha. + +CHANGES +======= + +o TEXT-107: Upversion commons-lang to 3.7. +o TEXT-98: Deprecate isDelimiter and use HashSets for delimiter checks. Thanks to Arun Vinud S S. +o TEXT-88: WordUtils should treat an empty delimiter array as no delimiters. Thanks to Amey Jadiye. +o TEXT-93: Update RandomStringGenerator to accept a list of valid characters. Thanks to Amey Jadiye. +o TEXT-92: Update commons-lang dependency to version 3.6. +o TEXT-83: Document that commons-csv should be used in preference to CsvTranslators. Thanks to Amey Jadiye. +o TEXT-67: NumericEntityUnescaper.options - fix TODO. +o TEXT-84: RandomStringGenerator claims to be immutable, but isn't. + + + Release Notes for version 1.1 + + +JAVA 9 SUPPORT +============== + +At our time of release of 1.1, our build succeeds with Java 9-ea build 159, +and we believe all of our features to be Java 9 compatible. However, when we +run "mvn clean site" we have failures. + +NEW FEATURES +============ + +o TEXT-41: WordUtils.abbreviate support Thanks to Amey Jadiye. +o TEXT-82: Putting WordUtils back in to the codebase Thanks to Amey Jadiye. +o TEXT-81: Add RandomStringGenerator Thanks to djones. +o TEXT-36: RandomStringGenerator: allow users to provide source of randomness + Thanks to Raymond DeCampo. + +FIXED BUGS +========== + +o TEXT-76: Correct round issue in Jaro Winkler implementation +o TEXT-72: Similar to LANG-1025, clirr fails site build. + +CHANGES +======= + +o TEXT-39: WordUtils should use toXxxxCase(int) rather than toXxxxCase(char) + Thanks to Amey Jadiye. + + + Release Notes for version 1.0 + + +INCOMPATIBLE CHANGES +==================== + +All package names changed from org.apache.commons.text.beta in 1.0-beta-1 to +org.apache.commons.text in 1.0. + +Methods StringEscapeUtils#escapeHtml3Once and StringEscapeUtils#escapeHtml4Once +have been removed; see TEXT-40 + +JAVA 9 SUPPORT +============== + +At our time of release of 1.0, our build succeeds with Java 9-ea build 158, +and we believe all of our features to be Java 9 compatible. However, when we run +"mvn clean site" we have failures. + +FIXED BUGS +========== + +o TEXT-64: Investigate locale issue in ExtendedMessageFormatTest. Thanks to + chtompki. +o TEXT-69: Resolve PMD/CMD Violations +o TEXT-65: Fixing the 200 checkstyle errors present in 1.0-beta-1. +o TEXT-63: Mutable fields should be private. + +REMOVED +======= + +o TEXT-40: Escape HTML characters only once: revert. + + + + Release Notes for version 1.0-beta-1 + + +A NOTE ON THE HISTORY OF THE CODE +================================= + +The codebase began in the fall of 2014 as a location for housing algorithms for +operating on Strings that seemed to have a more complex nature than those which +would be considered a needed extension to java.lang. Thus, a new component, +different from Apache Commons Lang was warranted. As the project evolved, it was +noticed that Commons Lang had considerable more text manipulation tools than +the average Java application developer would need or even want. So, we have +decided to move the more esoteric String processing algorithms out of Commons +Lang into Commons Text. + +JAVA 9 SUPPORT +============== + +At our time of release of 1.0-beta-1, our build succeeds with Java 9-ea build 153, +and we believe all of our features to be Java 9 compatible. + +NEW FEATURES +============ + +o TEXT-56: Move CvsTranslators out of StringEscapeUtils and make them DRY + Thanks to Jarek Strzeleck. +o TEXT-40: Escape HTML characters only once Thanks to Sampanna Kahu. +o TEXT-32: Add LCS similarity and distance +o TEXT-34: Add class to generate random strings +o TEXT-29: Add a builder to StringEscapeUtils +o TEXT-28: Add shell/XSI escape/unescape support +o TEXT-2: Add Jaccard Index and Jaccard Distance Thanks to Don Jeba. +o TEXT-27: Move org.apache.commons.lang3.StringEscapeUtils.java into text +o TEXT-23: Moving from commons-lang, the package org.apache.commons.lang3.text +o TEXT-10: A more complex Levenshtein distance Thanks to Don Jeba. +o TEXT-24: Add coveralls and Travis.ci integration +o TEXT-19: Add alphabet converter Thanks to Eyal Allweil. +o TEXT-13: Create Commons Text logo +o TEXT-7: Write user guide +o TEXT-15: Human name parser +o TEXT-3: Add Cosine Similarity and Cosine Distance +o TEXT-4: Port Myers algorithm from [collections] +o TEXT-1: Add Hamming distance +o TEXT-9: Incorporate String algorithms from Commons Lang Thanks to britter. + +FIXED BUGS +========== + +Note. We recognize the curiosity of a new component having "fixed bugs," but a +considerable number of files were migrated over from Commons Lang, some of which +needed fixes. + +o TEXT-62: Incorporate suggestions from RC2 into 1.0 release. +o TEXT-60: Upgrading Jacoco for Java 9-ea compatibility. Thanks to Lee Adcock. +o TEXT-52: Possible attacks through StringEscapeUtils.escapeEcmaScrip better + javadoc +o TEXT-37: Global vs local source of randomness +o TEXT-38: Fluent API in "RandomStringBuilder" +o TEXT-26: Fix JaroWinklerDistance in the manner of LUCENE-1297 +o TEXT-35: Unfinished class Javadoc for CosineDistance +o TEXT-22: LevenshteinDistance reduce memory consumption +o TEXT-5: IP clearance for the names package +o TEXT-11: Work on the string metric, distance, and similarity definitions for + the project +o TEXT-12: Create StringDistanceFrom class that contains a StringMetric and + the "left" side string. This would have a method that accepts the + "right" side string to test. Thanks to Jonathan baker. +o TEXT-8: Change (R) StringMetric.compare(CS left, CS right) to "apply" so + that it is consistent with BiFunction. Thanks to Jonathan Baker. +o TEXT-6: Allow extra information (e.g. Levenshtein threshold) to be stored + as (final) fields in the StringMetric instance. Thanks to Jonathan + Baker. + +CHANGES +======= + +o TEXT-61: Naming packages org.apache.commons.text.beta Thanks to Lee Adcock. +o TEXT-58: Refactor EntityArrays to have unmodifiableMaps in leu of String[][] +o TEXT-53: Prepare site for 1.0 release +o TEXT-50: Upgrade from commons-parent version 41 to version 42 +o TEXT-33: Consolidating since tags at 1.0, removing deprecated methods +o TEXT-16: Improve HumanNameParser + +REMOVED +======= + +o TEXT-55: Remove WordUtils to be added back in an upcoming 1.X release +o TEXT-51: Remove RandomStringGenerator to be added back in the 1.1 release +o TEXT-31: Remove org.apache.commons.text.names, for later release than 1.0 + + +Historical list of changes: http://commons.apache.org/text/changes-report.html + +For complete information on Apache Commons Text, including instructions on how +to submit bug reports, patches, or suggestions for improvement, see the Apache +Apache Commons Text website: + +http://commons.apache.org/text/ + +Have fun! +-Apache Commons Text team \ No newline at end of file http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/src/site/xdoc/download_text.xml ---------------------------------------------------------------------- diff --git a/src/site/xdoc/download_text.xml b/src/site/xdoc/download_text.xml index 6db9f86..d71e436 100644 --- a/src/site/xdoc/download_text.xml +++ b/src/site/xdoc/download_text.xml @@ -111,32 +111,32 @@ limitations under the License. </p> </subsection> </section> - <section name="Apache Commons Text 1.1 (Java 7+)"> + <section name="Apache Commons Text 1.2 (Java 7+)"> <subsection name="Binaries"> <table> <tr> - <td><a href="[preferred]/commons/text/binaries/commons-text-1.1-bin.tar.gz">commons-text-1.1-bin.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.1-bin.tar.gz.md5">md5</a></td> - <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.1-bin.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/text/binaries/commons-text-1.2-bin.tar.gz">commons-text-1.2-bin.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.2-bin.tar.gz.md5">md5</a></td> + <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.2-bin.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/text/binaries/commons-text-1.1-bin.zip">commons-text-1.1-bin.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.1-bin.zip.md5">md5</a></td> - <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.1-bin.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/text/binaries/commons-text-1.2-bin.zip">commons-text-1.2-bin.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.2-bin.zip.md5">md5</a></td> + <td><a href="https://www.apache.org/dist/commons/text/binaries/commons-text-1.2-bin.zip.asc">pgp</a></td> </tr> </table> </subsection> <subsection name="Source"> <table> <tr> - <td><a href="[preferred]/commons/text/source/commons-text-1.1-src.tar.gz">commons-text-1.1-src.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.1-src.tar.gz.md5">md5</a></td> - <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.1-src.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/text/source/commons-text-1.2-src.tar.gz">commons-text-1.2-src.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.2-src.tar.gz.md5">md5</a></td> + <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.2-src.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/text/source/commons-text-1.1-src.zip">commons-text-1.1-src.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.1-src.zip.md5">md5</a></td> - <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.1-src.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/text/source/commons-text-1.2-src.zip">commons-text-1.2-src.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.2-src.zip.md5">md5</a></td> + <td><a href="https://www.apache.org/dist/commons/text/source/commons-text-1.2-src.zip.asc">pgp</a></td> </tr> </table> </subsection> http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/src/site/xdoc/index.xml ---------------------------------------------------------------------- diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml index a49c41c..f0f826f 100644 --- a/src/site/xdoc/index.xml +++ b/src/site/xdoc/index.xml @@ -42,10 +42,10 @@ The <a href="source-repository.html">Git repository</a> can be </section> <!-- ================================================== --> <section name="Release Information"> -<p>The latest stable release of Text is 1.1. You may: </p> +<p>The latest stable release of Text is 1.2. You may: </p> <ul> -<li>Download <a href="http://commons.apache.org/proper/commons-text/download_text.cgi">1.1</a></li> -<li>Read the <a href="release-notes/RELEASE-NOTES-1.1.txt">1.1 release notes</a></li> +<li>Download <a href="http://commons.apache.org/proper/commons-text/download_text.cgi">1.2</a></li> +<li>Read the <a href="release-notes/RELEASE-NOTES-1.2.txt">1.2 release notes</a></li> </ul> <p> Alternatively you can pull it from the central Maven repositories: @@ -53,7 +53,7 @@ Alternatively you can pull it from the central Maven repositories: <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-text</artifactId> - <version>1.1</version> + <version>1.2</version> </dependency> </pre> </p> http://git-wip-us.apache.org/repos/asf/commons-text/blob/5e132f8e/src/site/xdoc/release-history.xml ---------------------------------------------------------------------- diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml index 27580e4..cacbd43 100644 --- a/src/site/xdoc/release-history.xml +++ b/src/site/xdoc/release-history.xml @@ -27,6 +27,9 @@ limitations under the License. <table> <tr><th>Version</th><th>Release date</th><th>Required Java Version</th><th>Javadoc</th><th>Release notes</th></tr> <tr> + <td>1.2</td><td>12-8-2017</td><td>7.0</td><td><a href="javadocs/api-1.2/">api-1.2</a></td><td><a href="release-notes/RELEASE-NOTES-1.2.txt">release notes for 1.2</a></td> +</tr> +<tr> <td>1.1</td><td>5-23-2017</td><td>7.0</td><td><a href="javadocs/api-1.1/">api-1.1</a></td><td><a href="release-notes/RELEASE-NOTES-1.1.txt">release notes for 1.1</a></td> </tr> <tr>