Announce 1.2

* New diff implementation (courtesy of Randy Watler)
* Mark old diff implementation as deprecated

Francis Galiegue (26):
      Announce version 1.1
      Merge pull request #1 from rwatler/factorizing-diff
      Update copyrights
      Changes to pom.xml: add contributors
      JsonFactorizingDiff: modify a little
      JsonFactorizingDiff: modify more code
      JsonFactorizingDiff: more modifications
      JsonFactorizingDiff: replace Integer.MAX_VALUE with -1 for "not array index"
      JsonFactorizingDiff: more changes
      JsonFactorizingDiff: more changes
      JsonFactorizingDiff: refactor DiffOperation
      Add comments in DiffOperation
      JsonFactorizingDiff: implement .toString() on Diff{,Operation}
      JsonDiff: some code simplification
      JsonFactorizingDiff: take advantage of ArrayNode's properties
      JsonFactorizingDiff: refactor getLCSDiffs a little
      Update README
      Update README again
      Merge pull request #2 from rwatler/master
      Merge pull request #3 from rwatler/master
      JsonFactorizingDiff: add comments
      Move JsonFactorizingDiff into its own package
      Add javadoc to new JsonDiff implementation; obsolete old one.
      Schedule old JSON diff removal for 1.3, not 1.4
      pom.xml: remove unused javadoc link
      1.2

Randy Watler (3):
      Add proposed Factorizing JSON Diff implementation
      Revise factorizing implementation and test cases to cover multiple overlapping add/remove diff array index adjustments
      Add factorizing support for converting duplicate add to copy operations

Author: fge

README.markdown

@@ -15,7 +15,7 @@ below for more information.
 
 ## Versions
 
-The current version is **1.1**.
+The current version is **1.2**.
 
 ## Maven artifact
 
@@ -31,43 +31,24 @@ Replace _your-version-here_ with the appropriate version:
 
 ## JSON "diff": the two implementations
 
-The first implementation, available in 1.1, is fully functional but is quite naive.
+### New implementation (versions 1.2 and above)
 
-It is functional in the sense that given two JSON values, it will always generate the correct JSON
-Patch (as a `JsonNode`). It is however quite naive in the sense that it does not try and factorize
-any operations. That is, given the two following JSON values:
-
-```json
-{ "a": 1 }
-```
+The new implementation (`com.github.fge.jsonpatch.diff.JsonDiff`) is able, unlike the old one, to
+factorize add and remove operations into both moves and copies.
 
-and:
+This implementation is courtesy of [Randy Watler](https://github.com/rwatler) and should now be used
+in preference to the old one.
 
-```json
-{ "b": 1 }
-```
+### Old implementation (versions 1.1 and below)
 
-this naive implementation 
-([link](https://github.com/fge/json-patch/blob/master/src/main/java/com/github/fge/jsonpatch/JsonDiff.java))
-will generate the following:
+The old implementation (`com.github.fge.jsonpatch.JsonDiff`), available since version 1.1, is fully
+functional but is quite naive.
 
-```json
-[
-    { "op": "add", "path": "/b", "value": 1 },
-    { "op": "remove", "path": "/a" }
-]
-```
-
-There is, however, a second implementation
-([link](https://github.com/fge/json-patch/blob/master/src/main/java/com/github/fge/jsonpatch/JsonFactorizingDiff.java)),
-courtesy of [Randy Watler](https://github.com/rwatler), which is able to generate a "factorized"
-form like this:
-
-```json
-[ { "op": "move", "from": "/a", "path": "/b" } ]
-```
+It is functional in the sense that given two JSON values, it will always generate the correct JSON
+Patch (as a `JsonNode`). It is however quite naive in the sense that it does not try and factorize
+any operations.
 
-This code will make it in 1.2 and will eventually become the default.
+Since 1.2, it is marked as obsolete, and you should consider using the newer one.
 
 ## Sample usage: JSON Patch
 

pom.xml

@@ -19,7 +19,7 @@
     <groupId>com.github.fge</groupId>
     <artifactId>json-patch</artifactId>
     <name>json-patch</name>
-    <version>1.2</version>
+    <version>1.3-SNAPSHOT</version>
     <packaging>jar</packaging>
     <description>JSON Patch implementation in Java</description>
     <url>https://github.com/fge/json-patch</url>