pgsql: Improve documentation around historical calendar rules.

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: pgsql-committers(at)postgresql(dot)org
Subject: pgsql: Improve documentation around historical calendar rules.
Date: 2012-04-26 22:29:10
Message-ID: E1SNXBW-0002It-68@gemulon.postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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(-)

Browse pgsql-committers by date

  From Date Subject
Next Message Robert Haas 2012-04-27 00:03:16 pgsql: Prevent index-only scans from returning wrong answers under Hot
Previous Message Tom Lane 2012-04-26 18:18:07 pgsql: Fix oversight in recent parameterized-path patch.