Expand documentation of QTimeZone::M{in,ax}OffsetSecs

Also save some wanton line breaks in \value directives.

Change-Id: I16e0798d7474febb7946ece0ad57c80476f9d9e2
Reviewed-by: Thiago Macieira <thiago.macieira@intel.com>
This commit is contained in:
Edward Welbourne 2022-11-17 20:08:54 +01:00
parent e4528eb77d
commit 930f1cef78

View File

@ -204,15 +204,15 @@ Q_GLOBAL_STATIC(QTimeZoneSingleton, global_tz);
/*!
\enum QTimeZone::anonymous
This enumeration provides constants bounding the range of plausible timezone
offsets from UTC, measured in seconds.
Sane UTC offsets range from -14 to +14 hours.
No known zone > 12 hrs West of Greenwich (Baker Island, USA).
No known zone > 14 hrs East of Greenwich (Kiritimati, Christmas Island, Kiribati).
No known zone has offset > 12 hrs West of Greenwich (Baker Island, USA).
No known zone has offset > 14 hrs East of Greenwich (Kiritimati, Christmas Island, Kiribati).
Note that there are zones whose offsets differ by more than a day.
\value MinUtcOffsetSecs
-14 * 3600,
\value MaxUtcOffsetSecs
+14 * 3600
\value MinUtcOffsetSecs -14 * 3600,
\value MaxUtcOffsetSecs +14 * 3600
*/
/*!