st*: style adjustments (#9516)

* st*: style adjustments

* lien lenght adjustments
This commit is contained in:
Alexei Znamensky 2025-01-04 08:00:45 +13:00 committed by GitHub
parent d7da0ae7f6
commit 695b1abc8d
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
28 changed files with 310 additions and 290 deletions

View file

@ -12,14 +12,14 @@ DOCUMENTATION = r"""
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(ansible.builtin.service) module.
- 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(ansible.builtin.service) module.
- It is recommended to restart C(crond) after changing the timezone, otherwise the jobs may run at the wrong time.
- 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) and C(hwclock). On SmartOS, C(sm-set-timezone), for macOS, C(systemsetup), for BSD, C(/etc/localtime) is modified. On
AIX, C(chtz) is used.
- Make sure that the zoneinfo files are installed with the appropriate OS package, like C(tzdata) (usually always installed, when not using
a minimal installation like Alpine Linux).
- 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) and C(hwclock). On SmartOS, C(sm-set-timezone), for macOS, C(systemsetup),
for BSD, C(/etc/localtime) is modified. On AIX, C(chtz) is used.
- Make sure that the zoneinfo files are installed with the appropriate OS package, like C(tzdata) (usually always installed,
when not using a minimal installation like Alpine Linux).
- Windows and HPUX are not supported, please let us know if you find any other OS/distro in which this fails.
extends_documentation_fragment:
- community.general.attributes
@ -39,7 +39,8 @@ options:
description:
- Whether the hardware clock is in UTC or in local timezone.
- Default is to keep current setting.
- Note that this option is recommended not to change and may fail to configure, especially on virtual environments such as AWS.
- Note that this option is recommended not to change and may fail to configure, especially on virtual environments such
as AWS.
- B(At least one) of O(name) and O(hwclock) are required.
- I(Only used on Linux).
type: str
@ -48,8 +49,8 @@ options:
notes:
- On Ubuntu 24.04 the C(util-linux-extra) package is required to provide the C(hwclock) command.
- On SmartOS the C(sm-set-timezone) utility (part of the smtools package) is required to set the zone timezone.
- On AIX only Olson/tz database timezones are usable (POSIX is not supported). An OS reboot is also required on AIX for the new timezone setting
to take effect. Note that AIX 6.1+ is needed (OS level 61 or newer).
- On AIX only Olson/tz database timezones are usable (POSIX is not supported). An OS reboot is also required on AIX for
the new timezone setting to take effect. Note that AIX 6.1+ is needed (OS level 61 or newer).
author:
- Shinichi TAMURA (@tmshn)
- Jasper Lievisse Adriaanse (@jasperla)