fix markup (#11147)

* fix markup for common return values

* Apply suggestion from review

plugins/modules/ansible_galaxy_install.py

@@ -81,7 +81,7 @@ options:
   force:
     description:
       - Force overwriting existing roles and/or collections.
-      - It can be used for upgrading, but the module output always reports C(changed=true).
+      - It can be used for upgrading, but the module output always reports RV(ignore:changed=true).
       - Using O(force=true) is mandatory when downgrading.
     type: bool
     default: false

plugins/modules/bitbucket_pipeline_variable.py

@@ -55,7 +55,7 @@ options:
     choices: [absent, present]
 notes:
   - Check mode is supported.
-  - For secured values return parameter C(changed) is always V(true).
+  - For secured values return parameter RV(ignore:changed) is always V(true).
 """
 
 EXAMPLES = r"""

plugins/modules/cpanm.py

@@ -69,16 +69,16 @@ options:
       - If V(false), it ensures the dependencies declared as suggests are not installed, overriding any decision made earlier
         in E(PERL_CPANM_OPT).
       - If parameter is not set, C(cpanm) uses its existing defaults.
-      - When these dependencies fail to install, cpanm continues the installation, since they are just suggestion.
+      - When these dependencies fail to install, C(cpanm) continues the installation, since they are just suggestions.
     type: bool
     version_added: 10.3.0
   version:
     description:
-      - Version specification for the perl module. When O(mode) is V(new), C(cpanm) version operators are accepted.
+      - Version specification for the perl module. When O(mode=new), C(cpanm) version operators are accepted.
     type: str
   executable:
     description:
-      - Override the path to the cpanm executable.
+      - Override the path to the C(cpanm) executable.
     type: path
   mode:
     description:

plugins/modules/filesize.py

@@ -66,7 +66,7 @@ options:
   force:
     description:
       - Whether or not to overwrite the file if it exists, in other words, to truncate it from 0. When V(true), the module
-        is not idempotent, that means it always reports C(changed=true).
+        is not idempotent, that means it always reports RV(ignore:changed=true).
       - O(force=true) and O(sparse=true) are mutually exclusive.
     type: bool
     default: false

plugins/modules/heroku_collaborator.py

@@ -54,7 +54,7 @@ options:
     default: "present"
 notes:
   - E(HEROKU_API_KEY) and E(TF_VAR_HEROKU_API_KEY) environment variables can be used instead setting O(api_key).
-  - If you use C(check_mode), you can also pass the C(-v) flag to see affected apps in C(msg), for example C(["heroku-example-app"]).
+  - If you use C(check_mode), you can also pass the C(-v) flag to see affected apps in RV(ignore:msg), for example C(["heroku-example-app"]).
 """
 
 EXAMPLES = r"""

plugins/modules/keycloak_user_execute_actions_email.py

@@ -18,7 +18,7 @@ description:
     This sends an email with one or more required actions the user must complete (for example resetting the password).
   - If no O(actions) list is provided, the default action C(UPDATE_PASSWORD) is used.
   - You must supply either the user's O(id) or O(username). Supplying only C(username) causes an extra lookup call.
-  - This module always reports C(changed=true) because sending an email is a side effect and cannot be made idempotent.
+  - This module always reports RV(ignore:changed=true) because sending an email is a side effect and cannot be made idempotent.
 attributes:
   check_mode:
     support: full

plugins/modules/lxc_container.py

@@ -174,7 +174,7 @@ notes:
     the command executed, and then the container V(stopped) again. Likewise if O(state=stopped) and the container does not
     exist it is first created, V(started), the command executed, and then V(stopped). If you use a C(|) in the variable you
     can use common script formatting within the variable itself. The O(container_command) option always execute as C(bash).
-    When using O(container_command), a log file is created in the C(/tmp/) directory which contains both C(stdout) and C(stderr)
+    When using O(container_command), a log file is created in the C(/tmp/) directory which contains both RV(ignore:stdout) and RV(ignore:stderr)
     of any command executed.
   - If O(archive=true) the system attempts to create a compressed tarball of the running container. The O(archive) option
     supports LVM backed containers and creates a snapshot of the running container when creating the archive.

plugins/modules/one_template.py

@@ -23,7 +23,7 @@ attributes:
   check_mode:
     support: partial
     details:
-      - Note that check mode always returns C(changed=true) for existing templates, even if the template would not actually
+      - Note that check mode always returns RV(ignore:changed=true) for existing templates, even if the template would not actually
         change.
   diff_mode:
     support: none

plugins/modules/one_vnet.py

@@ -20,7 +20,7 @@ attributes:
   check_mode:
     support: partial
     details:
-      - Note that check mode always returns C(changed=true) for existing networks, even if the network would not actually
+      - Note that check mode always returns RV(ignore:changed=true) for existing networks, even if the network would not actually
         change.
   diff_mode:
     support: none

plugins/modules/pacman.py

@@ -82,7 +82,7 @@ options:
       - Whether or not to refresh the master package lists.
       - This can be run as part of a package installation or as a separate step.
       - If not specified, it defaults to V(false).
-      - Please note that this option only had an influence on the module's C(changed) state if O(name) and O(upgrade) are
+      - Please note that this option only had an influence on the module's RV(ignore:changed) state if O(name) and O(upgrade) are
         not specified before community.general 5.0.0. See the examples for how to keep the old behavior.
     type: bool
 
@@ -128,7 +128,7 @@ notes:
   - 'In the tests, while using C(yay) as the O(executable) option, the module failed to install AUR packages with the error:
     C(error: target not found: <pkg>). This is caused by an incompatibility of yay with the arguments passed by this module.
     See L(yay bug #1744 report for details, https://github.com/Jguer/yay/issues/1744).'
-  - The common return values C(stdout) and C(stderr) are returned upon success, when needed, since community.general 4.1.0.
+  - The common return values RV(ignore:stdout) and RV(ignore:stderr) are returned upon success, when needed, since community.general 4.1.0.
 """
 
 RETURN = r"""

plugins/modules/pagerduty_change.py

@@ -23,7 +23,7 @@ attributes:
   check_mode:
     support: full
     details:
-      - Check mode simply does nothing except returning C(changed=true) in case the O(url) seems to be correct.
+      - Check mode simply does nothing except returning RV(ignore:changed=true) in case the O(url) seems to be correct.
   diff_mode:
     support: none
 options:

plugins/modules/puppet.py

@@ -65,7 +65,7 @@ options:
     description:
       - Where the puppet logs should go, if puppet apply is being used.
       - V(all) goes to both C(console) and C(syslog).
-      - V(stdout) is deprecated and replaced by C(console).
+      - V(stdout) is deprecated and replaced by C(console).  # TODO which/where is console?
     type: str
     choices: [all, stdout, syslog]
     default: stdout

plugins/modules/scaleway_container.py

@@ -90,7 +90,7 @@ options:
   secret_environment_variables:
     description:
       - Secret environment variables of the container namespace.
-      - Updating those values does not output a C(changed) state in Ansible.
+      - Updating those values does not output a RV(ignore:changed) state in Ansible.
       - Injected in container at runtime.
     type: dict
     default: {}

plugins/modules/scaleway_container_namespace.py

@@ -80,7 +80,7 @@ options:
   secret_environment_variables:
     description:
       - Secret environment variables of the container namespace.
-      - Updating those values does not output a C(changed) state in Ansible.
+      - Updating those values does not output a RV(ignore:changed) state in Ansible.
       - Injected in containers at runtime.
     type: dict
     default: {}

plugins/modules/scaleway_function.py

@@ -90,7 +90,7 @@ options:
   secret_environment_variables:
     description:
       - Secret environment variables of the function.
-      - Updating those values does not output a C(changed) state in Ansible.
+      - Updating those values does not output a RV(ignore:changed) state in Ansible.
       - Injected in function at runtime.
     type: dict
     default: {}

plugins/modules/scaleway_function_namespace.py

@@ -80,7 +80,7 @@ options:
   secret_environment_variables:
     description:
       - Secret environment variables of the function namespace.
-      - Updating those values does not output a C(changed) state in Ansible.
+      - Updating those values does not output a RV(ignore:changed) state in Ansible.
       - Injected in functions at runtime.
     type: dict
     default: {}

plugins/modules/snmp_facts.py

@@ -13,7 +13,7 @@ author:
   - Patrick Ogenstad (@ogenstad)
 short_description: Retrieve facts for a device using SNMP
 description:
-  - Retrieve facts for a device using SNMP, the facts are inserted to the C(ansible_facts) key.
+  - Retrieve facts for a device using SNMP, the facts are inserted to the RV(ignore:ansible_facts) key.
 requirements:
   - pysnmp
 extends_documentation_fragment: