[maven-javadoc-plugin] branch master updated: [MJAVADOC-557] Deprecate parameter includeTransitiveDependencySources

[rf...@apache.org]

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

rfscholte pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-javadoc-plugin.git


The following commit(s) were added to refs/heads/master by this push:
     new 0f0f9d4  [MJAVADOC-557] Deprecate parameter includeTransitiveDependencySources
0f0f9d4 is described below

commit 0f0f9d40c88916bfb87d769f9b9d1b467351160d
Author: rfscholte <rf...@apache.org>
AuthorDate: Sat Dec 29 14:24:27 2018 +0100

    [MJAVADOC-557] Deprecate parameter includeTransitiveDependencySources
---
 .../java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java b/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
index 261b617..7ae705b 100644
--- a/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
+++ b/src/main/java/org/apache/maven/plugins/javadoc/AbstractJavadocMojo.java
@@ -1656,13 +1656,16 @@ public abstract class AbstractJavadocMojo
     private File sourceDependencyCacheDir;
 
     /**
-     * Whether to include transitive dependencies in the list of dependency -sources jars to include
-     * in this javadoc run.
+     * Whether to include transitive dependencies in the list of dependency -sources jars to include in this javadoc
+     * run.
      *
      * @see #includeDependencySources
      * @since 2.7
+     * @deprecated if these sources depend on transitive dependencies, those dependencies should be added to the pom as
+     *             direct dependencies
      */
     @Parameter( defaultValue = "false" )
+    @Deprecated
     private boolean includeTransitiveDependencySources;
 
     /**