pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedDocumenting timezone setting in initdb
5+ messages / 3 participants
[nested] [flat]
* Documenting timezone setting in initdb
@ 2014-11-16 00:19 Daniel Gustafsson <daniel@yesql.se>
0 siblings, 2 replies; 5+ messages in thread
From: Daniel Gustafsson @ 2014-11-16 00:19 UTC (permalink / raw)
To: pgsql-docs
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.patch (application/octet-stream, 553B) download
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index 228edf7..807bec4 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -413,6 +413,17 @@ PostgreSQL documentation
</para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><envar>TZ</envar></term>
+
+ <listitem>
+ <para>
+ Specifies the time zone, using full time zone names, which the created
+ database cluster should use.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
<para>
* Re: Documenting timezone setting in initdb
@ 2014-11-16 14:53 Magnus Hagander <magnus@hagander.net>
parent: Daniel Gustafsson <daniel@yesql.se>
1 sibling, 0 replies; 5+ messages in thread
From: Magnus Hagander @ 2014-11-16 14:53 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; +Cc: pgsql-docs
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
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Documenting timezone setting in initdb
@ 2014-12-12 04:16 Peter Eisentraut <peter_e@gmx.net>
parent: Daniel Gustafsson <daniel@yesql.se>
1 sibling, 1 reply; 5+ messages in thread
From: Peter Eisentraut @ 2014-12-12 04:16 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; pgsql-docs
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
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Documenting timezone setting in initdb
@ 2014-12-12 11:37 Daniel Gustafsson <daniel@yesql.se>
parent: Peter Eisentraut <peter_e@gmx.net>
0 siblings, 1 reply; 5+ messages in thread
From: Daniel Gustafsson @ 2014-12-12 11:37 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
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
Attachments:
signature.asc (application/pgp-signature, 841B) download
^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Documenting timezone setting in initdb
@ 2014-12-15 01:08 Peter Eisentraut <peter_e@gmx.net>
parent: Daniel Gustafsson <daniel@yesql.se>
0 siblings, 0 replies; 5+ messages in thread
From: Peter Eisentraut @ 2014-12-15 01:08 UTC (permalink / raw)
To: Daniel Gustafsson <daniel@yesql.se>; +Cc: pgsql-docs
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
^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2014-12-15 01:08 UTC | newest]
Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2014-11-16 00:19 Documenting timezone setting in initdb Daniel Gustafsson <daniel@yesql.se>
2014-11-16 14:53 ` Magnus Hagander <magnus@hagander.net>
2014-12-12 04:16 ` Peter Eisentraut <peter_e@gmx.net>
2014-12-12 11:37 ` Daniel Gustafsson <daniel@yesql.se>
2014-12-15 01:08 ` Peter Eisentraut <peter_e@gmx.net>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox