[PR #6671/6fc1df9b backport][stable-7] Use semantic markup (modules a-c) (#6701)

Use semantic markup (modules a-c) (#6671)

* Use semantic markup.

* E() now works better.

(cherry picked from commit 6fc1df9b83)

Co-authored-by: Felix Fontein <felix@fontein.de>

plugins/modules/cloudflare_dns.py

@@ -31,7 +31,7 @@ options:
     - API token.
     - Required for api token authentication.
     - "You can obtain your API token from the bottom of the Cloudflare 'My Account' page, found here: U(https://dash.cloudflare.com/)."
-    - Can be specified in C(CLOUDFLARE_TOKEN) environment variable since community.general 2.0.0.
+    - Can be specified in E(CLOUDFLARE_TOKEN) environment variable since community.general 2.0.0.
     type: str
     required: false
     version_added: '0.2.0'
@@ -51,39 +51,39 @@ options:
   algorithm:
     description:
     - Algorithm number.
-    - Required for I(type=DS) and I(type=SSHFP) when I(state=present).
+    - Required for O(type=DS) and O(type=SSHFP) when O(state=present).
     type: int
   cert_usage:
     description:
     - Certificate usage number.
-    - Required for I(type=TLSA) when I(state=present).
+    - Required for O(type=TLSA) when O(state=present).
     type: int
     choices: [ 0, 1, 2, 3 ]
   hash_type:
     description:
     - Hash type number.
-    - Required for I(type=DS), I(type=SSHFP) and I(type=TLSA) when I(state=present).
+    - Required for O(type=DS), O(type=SSHFP) and O(type=TLSA) when O(state=present).
     type: int
     choices: [ 1, 2 ]
   key_tag:
     description:
     - DNSSEC key tag.
-    - Needed for I(type=DS) when I(state=present).
+    - Needed for O(type=DS) when O(state=present).
     type: int
   port:
     description:
     - Service port.
-    - Required for I(type=SRV) and I(type=TLSA).
+    - Required for O(type=SRV) and O(type=TLSA).
     type: int
   priority:
     description:
     - Record priority.
-    - Required for I(type=MX) and I(type=SRV)
+    - Required for O(type=MX) and O(type=SRV)
     default: 1
     type: int
   proto:
     description:
-    - Service protocol. Required for I(type=SRV) and I(type=TLSA).
+    - Service protocol. Required for O(type=SRV) and O(type=TLSA).
     - Common values are TCP and UDP.
     - Before Ansible 2.6 only TCP and UDP were available.
     type: str
@@ -95,26 +95,26 @@ options:
   record:
     description:
     - Record to add.
-    - Required if I(state=present).
-    - Default is C(@) (e.g. the zone name).
+    - Required if O(state=present).
+    - Default is V(@) (that is, the zone name).
     type: str
     default: '@'
     aliases: [ name ]
   selector:
     description:
     - Selector number.
-    - Required for I(type=TLSA) when I(state=present).
+    - Required for O(type=TLSA) when O(state=present).
     choices: [ 0, 1 ]
     type: int
   service:
     description:
     - Record service.
-    - Required for I(type=SRV).
+    - Required for O(type=SRV).
     type: str
   solo:
     description:
     - Whether the record should be the only one for that record type and record name.
-    - Only use with I(state=present).
+    - Only use with O(state=present).
     - This will delete all other records with the same record name and type.
     type: bool
   state:
@@ -136,20 +136,20 @@ options:
     default: 1
   type:
     description:
-      - The type of DNS record to create. Required if I(state=present).
-      - I(type=DS), I(type=SSHFP) and I(type=TLSA) added in Ansible 2.7.
+      - The type of DNS record to create. Required if O(state=present).
+      - O(type=DS), O(type=SSHFP), and O(type=TLSA) were added in Ansible 2.7.
     type: str
     choices: [ A, AAAA, CNAME, DS, MX, NS, SPF, SRV, SSHFP, TLSA, TXT ]
   value:
     description:
     - The record value.
-    - Required for I(state=present).
+    - Required for O(state=present).
     type: str
     aliases: [ content ]
   weight:
     description:
     - Service weight.
-    - Required for I(type=SRV).
+    - Required for O(type=SRV).
     type: int
     default: 1
   zone: