From c56eca65eb28a57fac551c5139d8b5d3c6eb5ed3 Mon Sep 17 00:00:00 2001
From: HonkingGoose <34918129+HonkingGoose@users.noreply.github.com>
Date: Wed, 12 Jan 2022 11:04:14 +0100
Subject: [PATCH] docs: deprecate deepExtract (#13487)

---
 docs/usage/configuration-options.md | 2 ++
 docs/usage/java.md                  | 1 +
 lib/manager/gradle/readme.md        | 2 ++
 3 files changed, 5 insertions(+)

diff --git a/docs/usage/configuration-options.md b/docs/usage/configuration-options.md
index e4490753b1..13de938582 100644
--- a/docs/usage/configuration-options.md
+++ b/docs/usage/configuration-options.md
@@ -431,6 +431,8 @@ Note: make sure not to mix this up with the term `compatibility`, which Renovate
 
 ## deepExtract
 
+Note: the `deepExtract` configuration option is deprecated, and will be removed in a future Renovate release.
+
 If configured to `true`, then dependency extraction will be done using the relevant package manager instead of JavaScript-based parsing.
 
 This option applies only to the `gradle` manager.
diff --git a/docs/usage/java.md b/docs/usage/java.md
index b132562589..c0c58ea5e6 100644
--- a/docs/usage/java.md
+++ b/docs/usage/java.md
@@ -80,6 +80,7 @@ Renovate will search repositories for all `pom.xml` files and processes them ind
 ## Custom registry support, and authentication
 
 Unless using `deepExtract`, Renovate does not make use of authentication credentials available to Gradle.
+Note: the `deepExtract` configuration option is deprecated, and will be removed in a future Renovate release.
 
 The manager for Gradle makes use of the `maven` datasource.
 Renovate can be configured to access additional repositories and access repositories authenticated.
diff --git a/lib/manager/gradle/readme.md b/lib/manager/gradle/readme.md
index 4e449618b4..b7261fb42e 100644
--- a/lib/manager/gradle/readme.md
+++ b/lib/manager/gradle/readme.md
@@ -1,5 +1,7 @@
 The `gradle` manager's default behavior uses a custom parser written in JavaScript, similar to many others managers.
 It was initially known as `gradle-lite` but is now integrated into the `gradle` manager and used as default.
 
+Note: the `deepExtract` configuration option is deprecated, and will be removed in a future Renovate release.
+
 If `deepExtract` is configured to `true`, Renovate instead extracts Gradle dependencies by calling a custom Gradle script.
 The `gradle` binary is then used to extract Maven-type dependencies.
-- 
GitLab