From 4632e3d5ee6d9a6171da9bdbc237c385ebcfbc25 Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Date: Tue, 16 Dec 2025 10:16:55 +1300
Subject: [PATCH] aix_*: docs adjustments (#11291)

---
 plugins/modules/aix_filesystem.py |  2 +-
 plugins/modules/aix_inittab.py    | 15 +++++----------
 plugins/modules/aix_lvol.py       |  4 ++--
 3 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/plugins/modules/aix_filesystem.py b/plugins/modules/aix_filesystem.py
index a29ba9542e..777732c9bd 100644
--- a/plugins/modules/aix_filesystem.py
+++ b/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"""
diff --git a/plugins/modules/aix_inittab.py b/plugins/modules/aix_inittab.py
index 31897d2948..f8dae12862 100644
--- a/plugins/modules/aix_inittab.py
+++ b/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,
diff --git a/plugins/modules/aix_lvol.py b/plugins/modules/aix_lvol.py
index 09a12ae2db..718ec66e00 100644
--- a/plugins/modules/aix_lvol.py
+++ b/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: []