[lucene-solr] 02/02: Merging with master. Add deps help links.

[dw...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

dweiss pushed a commit to branch gradle-master
in repository https://gitbox.apache.org/repos/asf/lucene-solr.git

commit eea3c1e472baa4a5f5d1872c1a2b4519a74cd885
Author: Dawid Weiss <dw...@apache.org>
AuthorDate: Mon Dec 9 11:02:13 2019 +0100

    Merging with master. Add deps help links.
---
 help/dependencies.txt | 28 +++++++++++++++++++++++-----
 versions.lock         |  8 ++++----
 versions.props        |  2 +-
 3 files changed, 28 insertions(+), 10 deletions(-)

diff --git a/help/dependencies.txt b/help/dependencies.txt
index b68750c..4490d73 100644
--- a/help/dependencies.txt
+++ b/help/dependencies.txt
@@ -9,7 +9,9 @@ adds standard configurations such as "api", "implementation",
 "testImplementation" and others. These configurations can also inherit
 from each other; more about this typic can be found here:
 
-[TODO: add conigurations link, java plugin configs]
+https://docs.gradle.org/current/userguide/dependency_management_for_java_projects.html#dependency_management_for_java_projects
+https://docs.gradle.org/current/userguide/java_library_plugin.html#sec:java_library_separation
+https://docs.gradle.org/current/userguide/java_plugin.html#sec:java_plugin_and_dependency_management
 
 For the needs of Lucene and Solr we will typically focus on three
 configurations and attach project dependencies to them:
@@ -21,8 +23,7 @@ implementation - makes a dependency available for main classes, tests
   but will *not* export the dependency for other modules (so their
   compilation classpath won't contain it).
 
-testImplementation - makes a dependency only available for test
-  classes.
+testImplementation - makes a dependency only available for test  classes.
 
 
 Adding a library dependency
@@ -59,7 +60,24 @@ gradlew --write-locks
 
 IMPORTANT: The versions.lock file will contain the actual version
 of the dependency picked based on other project dependencies and
-their transitive dependencies.
+their transitive dependencies. This selected version may be
+different from what each of these actually requires (the highest
+version number will be typically selected). To see which dependencies
+require which version of the library use:
+
+gradlew why --hash=...
+
+where the hash code comes from versions.lock file. For example, at
+the time of writing, jackson-databind has the following entry:
+
+com.fasterxml.jackson.core:jackson-databind:2.10.0 (3 constraints: 931a7796)
+
+and gradlew why --hash=931a7796 prints:
+
+com.fasterxml.jackson.core:jackson-databind:2.10.0
+        projects -> 2.10.0
+        net.thisptr:jackson-jq -> 2.7.0
+        org.carrot2:carrot2-mini -> 2.9.9.3
 
 Once the dependency is added it always makes sense to see the
 tree of all module dependencies and maybe exclude transitive
@@ -103,4 +121,4 @@ dependencies {
 }
 
 Note the brackets - they are important and prevent accidental
-mistakes of applying the exclusion to the wrong scope.
\ No newline at end of file
+mistakes of applying the exclusion to the wrong scope.
diff --git a/versions.lock b/versions.lock
index d02ff02..be4c5eb 100644
--- a/versions.lock
+++ b/versions.lock
@@ -7,10 +7,10 @@ com.carrotsearch.thirdparty:simple-xml-safe:2.7.1 (1 constraints: a60a82ca)
 com.cybozu.labs:langdetect:1.1-20120112 (1 constraints: 5c066d5e)
 com.drewnoakes:metadata-extractor:2.11.0 (1 constraints: 3605323b)
 com.epam:parso:2.0.9 (1 constraints: 0d05fe35)
-com.fasterxml.jackson.core:jackson-annotations:2.9.9 (2 constraints: 0a1d1637)
-com.fasterxml.jackson.core:jackson-core:2.9.9 (3 constraints: 23350c6a)
-com.fasterxml.jackson.core:jackson-databind:2.9.9.3 (3 constraints: 741a6389)
-com.fasterxml.jackson.dataformat:jackson-dataformat-smile:2.9.9 (1 constraints: 16051936)
+com.fasterxml.jackson.core:jackson-annotations:2.10.0 (2 constraints: 321dab4e)
+com.fasterxml.jackson.core:jackson-core:2.10.0 (3 constraints: 6135ffb6)
+com.fasterxml.jackson.core:jackson-databind:2.10.0 (3 constraints: 931a7796)
+com.fasterxml.jackson.dataformat:jackson-dataformat-smile:2.10.0 (1 constraints: 35052f3b)
 com.github.ben-manes.caffeine:caffeine:2.8.0 (1 constraints: 0c050d36)
 com.github.jnr:jffi:1.2.18 (1 constraints: b20902ab)
 com.github.jnr:jnr-constants:0.9.12 (4 constraints: ed2c9d5d)
diff --git a/versions.props b/versions.props
index bbca163..94f74db 100644
--- a/versions.props
+++ b/versions.props
@@ -4,7 +4,7 @@ com.carrotsearch:hppc=0.8.1
 com.cybozu.labs:langdetect=1.1-20120112
 com.drewnoakes:metadata-extractor=2.11.0
 com.epam:parso=2.0.9
-com.fasterxml.jackson*:*=2.9.9
+com.fasterxml.jackson*:*=2.10.0
 com.fasterxml.woodstox:*=4.4.1
 com.github.ben-manes.caffeine:caffeine=2.8.0
 com.github.virtuald:curvesapi=1.04