Use M() to link to the replacement module. (#19976)

lib/ansible/modules/cloud/amazon/_ec2_ami_search.py

@@ -25,7 +25,7 @@ DOCUMENTATION = '''
 ---
 module: ec2_ami_search
 short_description: Retrieve AWS AMI information for a given operating system.
-deprecated: "in favor of the ec2_ami_find module"
+deprecated: "Use M(ec2_ami_find) instead."
 version_added: "1.6"
 description:
   - Look up the most recent AMI on AWS for a given operating system.

lib/ansible/modules/cloud/openstack/_glance_image.py

@@ -24,7 +24,7 @@ DOCUMENTATION = '''
 ---
 module: glance_image
 version_added: "1.2"
-deprecated: Deprecated in 1.10. Use os_image instead
+deprecated: Deprecated in 1.10. Use M(os_image) instead.
 short_description: Add/Delete images from glance
 description:
    - Add or Remove images from the glance repository.

lib/ansible/modules/cloud/openstack/_keystone_user.py

@@ -25,7 +25,7 @@ DOCUMENTATION = '''
 ---
 module: keystone_user
 version_added: "1.2"
-deprecated: Deprecated in 2.0. Use os_user instead
+deprecated: Deprecated in 2.0. Use M(os_user) instead.
 short_description: Manage OpenStack Identity (keystone) users, tenants and roles
 description:
    - Manage users,tenants, roles from OpenStack.

lib/ansible/modules/cloud/openstack/_nova_compute.py

@@ -38,7 +38,7 @@ DOCUMENTATION = '''
 ---
 module: nova_compute
 version_added: "1.2"
-deprecated: Deprecated in 2.0. Use os_server instead
+deprecated: Deprecated in 2.0. Use M(os_server) instead.
 short_description: Create/Delete VMs from OpenStack
 description:
    - Create or Remove virtual machines from Openstack.

lib/ansible/modules/cloud/openstack/_nova_keypair.py

@@ -36,7 +36,7 @@ version_added: "1.2"
 author:
     - "Benno Joy (@bennojoy)"
     - "Michael DeHaan"
-deprecated: Deprecated in 2.0. Use os_keypair instead
+deprecated: Deprecated in 2.0. Use M(os_keypair) instead.
 short_description: Add/Delete key pair from nova
 description:
    - Add or Remove key pair from nova .

lib/ansible/modules/cloud/openstack/_quantum_floating_ip.py

@@ -40,7 +40,7 @@ version_added: "1.2"
 author:
     - "Benno Joy (@bennojoy)"
     - "Brad P. Crochet (@bcrochet)"
-deprecated: Deprecated in 2.0. Use os_floating_ip instead
+deprecated: Deprecated in 2.0. Use M(os_floating_ip) instead.
 short_description: Add/Remove floating IP from an instance
 description:
    - Add or Remove a floating IP to an instance

lib/ansible/modules/cloud/openstack/_quantum_floating_ip_associate.py

@@ -37,7 +37,7 @@ DOCUMENTATION = '''
 module: quantum_floating_ip_associate
 version_added: "1.2"
 author: "Benno Joy (@bennojoy)"
-deprecated: Deprecated in 2.0. Use os_floating_ip instead
+deprecated: Deprecated in 2.0. Use M(os_floating_ip) instead.
 short_description: Associate or disassociate a particular floating IP with an instance
 description:
    - Associates or disassociates a specific floating IP with a particular instance

lib/ansible/modules/cloud/openstack/_quantum_network.py

@@ -34,7 +34,7 @@ DOCUMENTATION = '''
 ---
 module: quantum_network
 version_added: "1.4"
-deprecated: Deprecated in 2.0. Use os_network instead
+deprecated: Deprecated in 2.0. Use M(os_network) instead.
 short_description: Creates/Removes networks from OpenStack
 description:
    - Add or Remove network from OpenStack.

lib/ansible/modules/cloud/openstack/_quantum_router.py

@@ -35,7 +35,7 @@ DOCUMENTATION = '''
 module: quantum_router
 version_added: "1.2"
 author: "Benno Joy (@bennojoy)"
-deprecated: Deprecated in 2.0. Use os_router instead
+deprecated: Deprecated in 2.0. Use M(os_router) instead.
 short_description: Create or Remove router from openstack
 description:
    - Create or Delete routers from OpenStack

lib/ansible/modules/cloud/openstack/_quantum_router_gateway.py

@@ -35,7 +35,7 @@ DOCUMENTATION = '''
 module: quantum_router_gateway
 version_added: "1.2"
 author: "Benno Joy (@bennojoy)"
-deprecated: Deprecated in 2.0. Use os_router instead
+deprecated: Deprecated in 2.0. Use M(os_router) instead.
 short_description: set/unset a gateway interface for the router with the specified external network
 description:
    - Creates/Removes a gateway interface from the router, used to associate a external network with a router to route external traffic.

lib/ansible/modules/cloud/openstack/_quantum_router_interface.py

@@ -35,7 +35,7 @@ DOCUMENTATION = '''
 module: quantum_router_interface
 version_added: "1.2"
 author: "Benno Joy (@bennojoy)"
-deprecated: Deprecated in 2.0. Use os_router instead
+deprecated: Deprecated in 2.0. Use M(os_router) instead.
 short_description: Attach/Detach a subnet's interface to a router
 description:
    - Attach/Detach a subnet interface to a router, to provide a gateway for the subnet.

lib/ansible/modules/cloud/openstack/_quantum_subnet.py

@@ -33,7 +33,7 @@ ANSIBLE_METADATA = {'status': ['deprecated'],
 DOCUMENTATION = '''
 ---
 module: quantum_subnet
-deprecated: Deprecated in 2.0. Use os_subnet instead
+deprecated: Deprecated in 2.0. Use M(os_subnet) instead.
 version_added: "1.2"
 short_description: Add/remove subnet from a network
 description:

lib/ansible/modules/network/ios/_ios_template.py

@@ -33,7 +33,7 @@ description:
     by evaluating the current running-config and only pushing configuration
     commands that are not already configured.  The config source can
     be a set of commands or a template.
-deprecated: Deprecated in 2.2. Use ios_config instead
+deprecated: Deprecated in 2.2. Use M(ios_config) instead.
 extends_documentation_fragment: ios
 options:
   src:

lib/ansible/modules/network/iosxr/_iosxr_template.py

@@ -33,7 +33,7 @@ description:
     by evaluating the current running-config and only pushing configuration
     commands that are not already configured.  The config source can
     be a set of commands or a template.
-deprecated: Deprecated in 2.2. Use iosxr_config instead
+deprecated: Deprecated in 2.2. Use M(iosxr_config) instead.
 extends_documentation_fragment: iosxr
 options:
   src:

lib/ansible/modules/network/junos/_junos_template.py

@@ -32,7 +32,7 @@ description:
     from a template file onto a remote device running Junos.  The
     module will return the differences in configuration if the diff
     option is specified on the Ansible command line
-deprecated: Deprecated in 2.2. Use junos_config instead
+deprecated: Deprecated in 2.2. Use M(junos_config) instead.
 extends_documentation_fragment: junos
 options:
   src:

lib/ansible/modules/network/nxos/_nxos_template.py

@@ -33,7 +33,7 @@ description:
     by evaluating the current running-config and only pushing configuration
     commands that are not already configured.  The config source can
     be a set of commands or a template.
-deprecated: Deprecated in 2.2. Use nxos_config instead
+deprecated: Deprecated in 2.2. Use M(nxos_config) instead.
 extends_documentation_fragment: nxos
 options:
   src:

lib/ansible/modules/network/openswitch/_ops_template.py

@@ -33,7 +33,7 @@ description:
     against a provided candidate configuration. If there are changes, the
     candidate configuration is merged with the current configuration and
     pushed into OpenSwitch
-deprecated: Deprecated in 2.2. Use ops_config instead
+deprecated: Deprecated in 2.2. Use M(ops_config) instead.
 extends_documentation_fragment: openswitch
 options:
   src:

lib/ansible/modules/utilities/helper/_accelerate.py

@@ -26,7 +26,7 @@ DOCUMENTATION = '''
 ---
 module: accelerate
 short_description: Enable accelerated mode on remote node
-deprecated: "in favor of SSH with ControlPersist"
+deprecated: "Use SSH with ControlPersist instead."
 description:
      - This modules launches an ephemeral I(accelerate) daemon on the remote node which
        Ansible can use to communicate with nodes at high speed.