pgsql: Improve documentation around historical calendar rules. - Mailing list pgsql-committers

From Tom Lane
Subject pgsql: Improve documentation around historical calendar rules.
Date
Msg-id E1SNXBW-0002It-68@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
Improve documentation around historical calendar rules.

Get rid of section 8.5.6 (Date/Time Internals), which appears to confuse
people more than it helps, and anyway discussion of Postgres' internal
datetime calculation methods seems pretty out of place here.  Instead,
make datatype.sgml just say that we follow the Gregorian calendar (a bit
of specification not previously present anywhere in that chapter :-()
and link to the History of Units appendix for more info.  Do some mild
editorialization on that appendix, too, to make it clearer that we are
following proleptic Gregorian calendar rules rather than anything more
historically accurate.

Per a question from Florence Cousin and subsequent discussion in
pgsql-docs.

Branch
------
master

Details
-------
http://git.postgresql.org/pg/commitdiff/92df2203437603d40417fe711c3cb7066ac4fdf5

Modified Files
--------------
doc/src/sgml/datatype.sgml |   22 +++--------------
doc/src/sgml/datetime.sgml |   57 +++++++++++++++++++++++++++----------------
2 files changed, 40 insertions(+), 39 deletions(-)


pgsql-committers by date:

Previous
From: Tom Lane
Date:
Subject: pgsql: Fix oversight in recent parameterized-path patch.
Next
From: Robert Haas
Date:
Subject: pgsql: Prevent index-only scans from returning wrong answers under Hot