updated timezone docs to avoid repainting bikeshed

fixes #19272
fixes #20570

lib/ansible/modules/system/timezone.py

@@ -37,11 +37,13 @@ DOCUMENTATION = '''
 module: timezone
 short_description: Configure timezone setting
 description:
-  - This module configures the timezone setting, both of the system clock and of the hardware clock. If you want to set up the NTP, use M(service) module.  As of version 2.3 support was added for SmartOS and BSDs.
+  - This module configures the timezone setting, both of the system clock and of the hardware clock. If you want to set up the NTP, use M(service) module.
   - It is recommended to restart C(crond) after changing the timezone, otherwise the jobs may run at the wrong time.
-  - On Linux it uses the C(timedatectl) command if available. Otherwise, it edits C(/etc/sysconfig/clock) or C(/etc/timezone) for the system clock, and uses the C(hwclock) command for the hardware clock.
-  - On SmartOS the C(sm-set-timezone) utility is used to set the zone timezone.
-  - "On *BSD, C(/etc/localtime) is modified."
+  - Several different tools are used depending on the OS/Distribution involved.
+    For Linux it can use C(timedatectl)  or edit C(/etc/sysconfig/clock) or C(/etc/timezone) andC(hwclock).
+    On SmartOS , C(sm-set-timezone), for *BSD, C(/etc/localtime) is modified.
+  - As of version 2.3 support was added for SmartOS and BSDs.
+  - Windows, AIX and HPUX are not supported, please let us know if you find any other OS/distro in which this fails.
 version_added: "2.2"
 options:
   name: