[Documentation][copy]Update_documentation_about_alias_and_executable_on_copy (#1969)

* Update documentation

* Add fragment

* Update plugins/modules/zos_copy.py

Co-authored-by: Fernando Flores <[email protected]>

* Update zos_copy.py

---------

Co-authored-by: Fernando Flores <[email protected]>

Author: AndreMarcel99

changelogs/fragments/1969-Update_documentation_about_alias_and_executable_on_copy.yml

@@ -0,0 +1,3 @@
+trivial:
+  - zos_copy - Update documentation on zos_copy option C(executable) do not copy aliases.
+     (https://github.com/ansible-collections/ibm_zos_core/pull/1969).

plugins/modules/zos_copy.py

@@ -229,14 +229,12 @@
   executable:
     description:
       - If set to C(true), indicates that the file or library to be copied is an executable.
-      - If the C(src) executable has an alias, the alias information is also copied. If the
-        C(dest) is Unix, the alias is not visible in Unix, even though the information is there and
-        will be visible if copied to a library.
       - If I(executable=true), and C(dest) is a data set, it must be a PDS or PDSE (library).
       - If C(dest) is a nonexistent data set, the library attributes assigned will be
         Undefined (U) record format with a record length of 0, block size of 32760 and the
         remaining attributes will be computed.
       - If C(dest) is a file, execute permission for the user will be added to the file (``u+x``).
+      - If the C(src) executable has an alias, the alias will not be copied unless C(aliases=true).
     type: bool
     default: false
     required: false
@@ -247,6 +245,8 @@
       - Aliases are implicitly preserved when libraries are copied over to USS destinations.
         That is, when C(executable=True) and C(dest) is a USS file or directory, this option will be ignored.
       - Copying of aliases for text-based data sets from USS sources or to USS destinations is not currently supported.
+      - If the C(dest) is Unix, the alias is not visible in Unix, even though the information is there and
+        will be visible if copied to a library.
     type: bool
     default: false
     required: false