[PR #11291/4632e3d5 backport][stable-12] aix_*: docs adjustments (#11292)

aix_*: docs adjustments (#11291)

(cherry picked from commit 4632e3d5ee)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>

plugins/modules/aix_filesystem.py

@@ -103,7 +103,7 @@ options:
       - Specifies an existing volume group (VG).
     type: str
 notes:
-  - For more O(attributes), please check "crfs" AIX manual.
+  - For more O(attributes), please check C(crfs) AIX manual.
 """
 
 EXAMPLES = r"""

plugins/modules/aix_inittab.py

@@ -34,7 +34,7 @@ options:
     required: true
   action:
     description:
-      - Action what the init has to do with this entry.
+      - Action the C(init) process performs for this entry.
     type: str
     choices:
       - boot
@@ -51,25 +51,23 @@ options:
       - wait
   command:
     description:
-      - What command has to run.
+      - Command to be executed.
     type: str
     required: true
   insertafter:
     description:
-      - After which inittabline should the new entry inserted.
+      - After which C(inittab) line should the new entry inserted.
     type: str
   state:
     description:
-      - Whether the entry should be present or absent in the inittab file.
+      - Whether the entry should be present or absent in the C(inittab) file.
     type: str
     choices: [absent, present]
     default: present
 notes:
   - The changes are persistent across reboots.
-  - You need root rights to read or adjust the inittab with the C(lsitab), C(chitab), C(mkitab) or C(rmitab) commands.
+  - You need root rights to read or adjust the C(inittab) with the C(lsitab), C(chitab), C(mkitab) or C(rmitab) commands.
   - Tested on AIX 7.1.
-requirements:
-  - itertools
 """
 
 EXAMPLES = r"""
@@ -115,9 +113,6 @@ name:
 
 from ansible.module_utils.basic import AnsibleModule
 
-# end import modules
-# start defining the functions
-
 
 def check_current_entry(module):
     # Check if entry exists, if not return False in exists in return dict,

plugins/modules/aix_lvol.py

@@ -13,7 +13,7 @@ author:
 module: aix_lvol
 short_description: Configure AIX LVM logical volumes
 description:
-  - This module creates, removes or resizes AIX logical volumes. Inspired by lvol module.
+  - This module creates, removes or resizes AIX logical volumes. Inspired by M(community.general.lvol) module.
 extends_documentation_fragment:
   - community.general.attributes
 attributes:
@@ -69,7 +69,7 @@ options:
     default: ''
   pvs:
     description:
-      - A list of physical volumes, for example V(hdisk1,hdisk2).
+      - A list of physical volumes, for example V([hdisk1, hdisk2]).
     type: list
     elements: str
     default: []