pgsql: Docs: improve descriptions of ISO week-numbering date features.

Поиск
Список
Период
Сортировка
От Tom Lane
Тема pgsql: Docs: improve descriptions of ISO week-numbering date features.
Дата
Msg-id E1Y6R2s-0002Pz-1Z@gemulon.postgresql.org
обсуждение исходный текст
Список pgsql-committers
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.

Branch
------
REL9_0_STABLE

Details
-------
http://git.postgresql.org/pg/commitdiff/5f8fe02a56ec689c9811c67c3e548c754b577c63

Modified Files
--------------
doc/src/sgml/func.sgml |   89 ++++++++++++++++++++++++++++--------------------
1 file changed, 53 insertions(+), 36 deletions(-)


В списке pgsql-committers по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: pgsql: Docs: improve descriptions of ISO week-numbering date features.
Следующее
От: Tom Lane
Дата:
Сообщение: pgsql: Docs: improve descriptions of ISO week-numbering date features.