From 66eed80f712645abc2bdc10cb0cd0e09a6f41283 Mon Sep 17 00:00:00 2001
From: Brian Coca <bcoca@users.noreply.github.com>
Date: Wed, 14 Feb 2018 20:26:10 -0500
Subject: [PATCH] better sudo/su deprecation on config entries (#36074)

* better sudo/su deprecation on config entries

fixes #32130

* typo fixes

* Copy edit

* Fixed more instances

(cherry picked from commit 9066b17d5d122d7fd3f053cd6f2c49bd9c62f4d0)
---
 lib/ansible/config/base.yml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/lib/ansible/config/base.yml b/lib/ansible/config/base.yml
index b5fe5c2cd5c..7a70f03d2b0 100644
--- a/lib/ansible/config/base.yml
+++ b/lib/ansible/config/base.yml
@@ -360,7 +360,7 @@ DEFAULT_ASK_SUDO_PASS:
   name: Ask for the sudo password
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_ask_pass.
     version: "2.8"
     alternatives: become
   description:
@@ -373,7 +373,7 @@ DEFAULT_ASK_SU_PASS:
   name: Ask for the su password
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_ask_pass.
     version: "2.8"
     alternatives: become
   description:
@@ -988,7 +988,7 @@ DEFAULT_SU:
 DEFAULT_SUDO:
   default: False
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework
     version: "2.8"
     alternatives: become
   description: 'Toggle the use of "sudo" for tasks.'
@@ -1000,7 +1000,7 @@ DEFAULT_SUDO_EXE:
   name: sudo executable
   default: sudo
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_exe.
     version: "2.8"
     alternatives: become
   description: 'specify an "sudo" executable, otherwise it relies on PATH.'
@@ -1011,7 +1011,7 @@ DEFAULT_SUDO_FLAGS:
   name: sudo flags
   default: '-H -S -n'
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_flags.
     version: "2.8"
     alternatives: become
   description: 'Flags to pass to "sudo"'
@@ -1022,7 +1022,7 @@ DEFAULT_SUDO_USER:
   name: sudo user
   default:
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_user.
     version: "2.8"
     alternatives: become
   description: 'User you become when using "sudo", leaving it blank will use the default configured on the target (normally root)'
@@ -1033,7 +1033,7 @@ DEFAULT_SU_EXE:
   name: su executable
   default: su
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_exe.
     version: "2.8"
     alternatives: become
   description: 'specify an "su" executable, otherwise it relies on PATH.'
@@ -1044,7 +1044,7 @@ DEFAULT_SU_FLAGS:
   name: su flags
   default: ''
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_flags.
     version: "2.8"
     alternatives: become
   description: 'Flags to pass to su'
@@ -1059,7 +1059,7 @@ DEFAULT_SU_USER:
   ini:
   - {key: su_user, section: defaults}
   deprecated:
-    why: In favor of become which is a generic framework
+    why: In favor of Ansible Become, which is a generic framework. See become_user.
     version: "2.8"
     alternatives: become
 DEFAULT_SYSLOG_FACILITY: