Documenting timezone setting in initdb

Started by Daniel Gustafssonover 11 years ago5 messagesdocs
Jump to latest
#1Daniel Gustafsson
daniel@yesql.se

Setting the time zone of the newly created cluster from initdb via the
environment variable isn't documented in the initdb section (but very handy).
Attached is a patch adding a mention of TZ in the Environment section.

Unless objections I'll add it to the open commitfest.

cheers ./daniel

Attachments:

initdb-doc-timezone.patchapplication/octet-stream; name=initdb-doc-timezone.patchDownload+11-0
#2Magnus Hagander
magnus@hagander.net
In reply to: Daniel Gustafsson (#1)
Re: Documenting timezone setting in initdb

On Sun, Nov 16, 2014 at 1:19 AM, Daniel Gustafsson <daniel@yesql.se> wrote:

Setting the time zone of the newly created cluster from initdb via the
environment variable isn't documented in the initdb section (but very handy).
Attached is a patch adding a mention of TZ in the Environment section.

Unless objections I'll add it to the open commitfest.

Looks good to me, applied. 9.4 is still open for docs patches so I
back-patched it there, as this is clearly an omission/bug.

--
Magnus Hagander
Me: http://www.hagander.net/
Work: http://www.redpill-linpro.com/

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#3Peter Eisentraut
peter_e@gmx.net
In reply to: Daniel Gustafsson (#1)
Re: Documenting timezone setting in initdb

On 11/15/14 7:19 PM, Daniel Gustafsson wrote:

Setting the time zone of the newly created cluster from initdb via the
environment variable isn't documented in the initdb section (but very handy).
Attached is a patch adding a mention of TZ in the Environment section.

What is a "full time zone name"? Where is that term documented?

Also, I wouldn't write "should use", but "will use".

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

#4Daniel Gustafsson
daniel@yesql.se
In reply to: Peter Eisentraut (#3)
Re: Documenting timezone setting in initdb

On 12 Dec 2014, at 05:16, Peter Eisentraut <peter_e@gmx.net> wrote:

On 11/15/14 7:19 PM, Daniel Gustafsson wrote:

Setting the time zone of the newly created cluster from initdb via the
environment variable isn't documented in the initdb section (but very handy).
Attached is a patch adding a mention of TZ in the Environment section.

What is a "full time zone name"? Where is that term documented?

Full time zone name is the term used in section 8.5.3 for the America/New_York
style time zone names, perhaps linking to that section like how we link to the
locale section etc would be appropriate?

Also, I wouldn't write "should use", but "will use".

Fair enough, that does make it clearer.

I can submit a patch with these changes if you want?

cheers ./daniel

#5Peter Eisentraut
peter_e@gmx.net
In reply to: Daniel Gustafsson (#4)
Re: Documenting timezone setting in initdb

On 12/12/14 6:37 AM, Daniel Gustafsson wrote:

On 12 Dec 2014, at 05:16, Peter Eisentraut <peter_e@gmx.net> wrote:

On 11/15/14 7:19 PM, Daniel Gustafsson wrote:

Setting the time zone of the newly created cluster from initdb via the
environment variable isn't documented in the initdb section (but very handy).
Attached is a patch adding a mention of TZ in the Environment section.

What is a "full time zone name"? Where is that term documented?

Full time zone name is the term used in section 8.5.3 for the America/New_York
style time zone names, perhaps linking to that section like how we link to the
locale section etc would be appropriate?

Fixed it. Thanks for the pointer.

--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs