filter: Misc fixes in docs (#82823)

* misc fixes for the filter documentation

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>

lib/ansible/plugins/filter/b64decode.yml

@@ -2,28 +2,28 @@ DOCUMENTATION:
   name: b64decode
   author: ansible core team
   version_added: 'historical'
-  short_description: Decode a base64 string
+  short_description: Decode a Base64 string
   description:
     - Base64 decoding function.
     - The return value is a string.
-    - Trying to store a binary blob in a string most likely corrupts the binary. To base64 decode a binary blob,
+    - Trying to store a binary blob in a string most likely corrupts the binary. To Base64 decode a binary blob,
-      use the ``base64`` command  and pipe the encoded data through standard input.
+      use the I(base64) command and pipe the encoded data through standard input.
-      For example, in the ansible.builtin.shell`` module, ``cmd="base64 --decode > myfile.bin" stdin="{{ encoded }}"``.
+      For example, in the M(ansible.builtin.shell) module, ``cmd="base64 --decode > myfile.bin" stdin="{{ encoded }}"``.
   positional: _input
   options:
     _input:
-      description: A base64 string to decode.
+      description: A Base64 string to decode.
       type: string
       required: true
 
 EXAMPLES: |
-  # b64 decode a string
+  # Base64 decode a string
   lola: "{{ 'bG9sYQ==' | b64decode }}"
 
-  # b64 decode the content of 'b64stuff' variable
+  # Base64 decode the content of 'b64stuff' variable
   stuff: "{{ b64stuff | b64decode }}"
 
 RETURN:
   _value:
-    description: The contents of the base64 encoded string.
+    description: The contents of the Base64 encoded string.
     type: string

lib/ansible/plugins/filter/b64encode.yml

@@ -2,7 +2,7 @@ DOCUMENTATION:
   name: b64encode
   author: ansible core team
   version_added: 'historical'
-  short_description: Encode a string as base64
+  short_description: Encode a string as Base64
   description:
     - Base64 encoding function.
   positional: _input
@@ -13,13 +13,13 @@ DOCUMENTATION:
       required: true
 
 EXAMPLES: |
-  # b64 encode a string
+  # Base64 encode a string
   b64lola: "{{ 'lola'| b64encode }}"
 
-  # b64 encode the content of 'stuff' variable
+  # Base64 encode the content of 'stuff' variable
   b64stuff: "{{ stuff | b64encode }}"
 
 RETURN:
   _value:
-    description: A base64 encoded string.
+    description: A Base64 encoded string.
     type: string

lib/ansible/plugins/filter/core.py

@@ -592,7 +592,7 @@ def commonpath(paths):
     :rtype: str
     """
     if not is_sequence(paths):
-        raise AnsibleFilterTypeError("|path_join expects sequence, got %s instead." % type(paths))
+        raise AnsibleFilterTypeError("|commonpath expects sequence, got %s instead." % type(paths))
 
     return os.path.commonpath(paths)