pgsql: Doc: document POSIX-style time zone specifications in full.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)lists(dot)postgresql(dot)org
Subject: pgsql: Doc: document POSIX-style time zone specifications in full.
Date: 2020-06-18 20:27:54
Message-ID: E1jm18c-00064U-TU@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers

Doc: document POSIX-style time zone specifications in full.

We'd glossed over most of this complexity for years, but it's hard
to avoid writing it all down now, so that we can explain what happens
when there's no "posixrules" file in the IANA time zone database.
That was at best a tiny minority situation till now, but it's likely
to become quite common in the future, so we'd better explain it.

Nonetheless, we don't really encourage people to use POSIX zone specs;
picking a named zone is almost always what you really want, unless
perhaps you're stuck with an out-of-date zone database. Therefore,
let's shove all this detail into an appendix.

Patch by me; thanks to Robert Haas for help with some awkward wording.

Discussion: https://postgr.es/m/1390.1562258309@sss.pgh.pa.us

Branch
------
REL_11_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/070f49005350131a62399b9b29bff61f8adaefff

Modified Files
--------------
doc/src/sgml/datatype.sgml | 38 ++------
doc/src/sgml/datetime.sgml | 212 +++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 217 insertions(+), 33 deletions(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Andres Freund 2020-06-18 21:36:10 pgsql: Add basic spinlock tests to regression tests.
Previous Message Michael Paquier 2020-06-18 07:36:29 pgsql: Fix oldest xmin and LSN computation across repslots after advanc