Docs: improve descriptions of ISO week-numbering date features.
authorTom Lane <tgl@sss.pgh.pa.us>
Wed, 31 Dec 2014 21:42:48 +0000 (16:42 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Wed, 31 Dec 2014 21:42:48 +0000 (16:42 -0500)
commit453151a0615f4782618c412fe89a7898b2c6277a
tree214f49080aa6f530756fb8a26bf9fadf94266895
parent7582cce56616c991e62e1122873ce8c694e6f8a0
Docs: improve descriptions of ISO week-numbering date features.

Use the phraseology "ISO 8601 week-numbering year" in place of just
"ISO year", and make related adjustments to other terminology.

The point of this change is that it seems some people see "ISO year"
and think "standard year", whereupon they're surprised when constructs
like to_char(..., "IYYY-MM-DD") produce nonsensical results.  Perhaps
hanging a few more adjectives on it will discourage them from jumping
to false conclusions.  I put in an explicit warning against that
specific usage, too, though the main point is to discourage people
who haven't read this far down the page.

In passing fix some nearby markup and terminology inconsistencies.
doc/src/sgml/func.sgml