public inbox for [email protected]  
help / color / mirror / Atom feed
Clarification of DateStyle
4+ messages / 2 participants
[nested] [flat]

* Clarification of DateStyle
@ 2004-04-15 04:47  Bruce Momjian <[email protected]>
  0 siblings, 1 reply; 4+ messages in thread

From: Bruce Momjian @ 2004-04-15 04:47 UTC (permalink / raw)
  To: pgsql-docs

I have applied the following patch to clarify the meaning of the second
DateStyle field.

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  [email protected]               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

Index: runtime.sgml
===================================================================
RCS file: /cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.258
diff -c -c -r1.258 runtime.sgml
*** runtime.sgml	7 Apr 2004 05:05:49 -0000	1.258
--- runtime.sgml	15 Apr 2004 04:45:46 -0000
***************
*** 2433,2449 ****
        <indexterm><primary>date style</></>
        <listitem>
         <para>
!         Sets the display format for date and time values, as well as
!         the rules for interpreting ambiguous date input values.
!         For historical reasons, this variable contains two independent
          components: the output format specification (<literal>ISO</>,
!         <literal>Postgres</>, <literal>SQL</>, or <literal>German</>) and
!         the date field order specification (<literal>DMY</>, <literal>MDY</>,
!         or <literal>YMD</>).  These can be set separately or together.
!         The keywords <literal>Euro</> and <literal>European</> are synonyms
!         for <literal>DMY</>; the keywords <literal>US</>, <literal>NonEuro</>,
!         and <literal>NonEuropean</> are synonyms for <literal>MDY</>.
!         See <xref linkend="datatype-datetime"> for more information.  The
          default is <literal>ISO, MDY</>.
         </para>
        </listitem>
--- 2433,2450 ----
        <indexterm><primary>date style</></>
        <listitem>
         <para>
!         Sets the display format for date and time values, as well as the
!         rules for interpreting ambiguous date input values. For
!         historical reasons, this variable contains two independent
          components: the output format specification (<literal>ISO</>,
!         <literal>Postgres</>, <literal>SQL</>, or <literal>German</>)
!         and the input/output specification for year/month/day ordering
!         (<literal>DMY</>, <literal>MDY</>, or <literal>YMD</>). These
!         can be set separately or together. The keywords <literal>Euro</>
!         and <literal>European</> are synonyms for <literal>DMY</>; the
!         keywords <literal>US</>, <literal>NonEuro</>, and
!         <literal>NonEuropean</> are synonyms for <literal>MDY</>. See
!         <xref linkend="datatype-datetime"> for more information. The
          default is <literal>ISO, MDY</>.
         </para>
        </listitem>


Attachments:

  [text/plain] /bjm/diff (2.3K, 2-%2Fbjm%2Fdiff)
  download | inline:
Index: runtime.sgml
===================================================================
RCS file: /cvsroot/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.258
diff -c -c -r1.258 runtime.sgml
*** runtime.sgml	7 Apr 2004 05:05:49 -0000	1.258
--- runtime.sgml	15 Apr 2004 04:45:46 -0000
***************
*** 2433,2449 ****
        <indexterm><primary>date style</></>
        <listitem>
         <para>
!         Sets the display format for date and time values, as well as
!         the rules for interpreting ambiguous date input values.
!         For historical reasons, this variable contains two independent
          components: the output format specification (<literal>ISO</>,
!         <literal>Postgres</>, <literal>SQL</>, or <literal>German</>) and
!         the date field order specification (<literal>DMY</>, <literal>MDY</>,
!         or <literal>YMD</>).  These can be set separately or together.
!         The keywords <literal>Euro</> and <literal>European</> are synonyms
!         for <literal>DMY</>; the keywords <literal>US</>, <literal>NonEuro</>,
!         and <literal>NonEuropean</> are synonyms for <literal>MDY</>.
!         See <xref linkend="datatype-datetime"> for more information.  The
          default is <literal>ISO, MDY</>.
         </para>
        </listitem>
--- 2433,2450 ----
        <indexterm><primary>date style</></>
        <listitem>
         <para>
!         Sets the display format for date and time values, as well as the
!         rules for interpreting ambiguous date input values. For
!         historical reasons, this variable contains two independent
          components: the output format specification (<literal>ISO</>,
!         <literal>Postgres</>, <literal>SQL</>, or <literal>German</>)
!         and the input/output specification for year/month/day ordering
!         (<literal>DMY</>, <literal>MDY</>, or <literal>YMD</>). These
!         can be set separately or together. The keywords <literal>Euro</>
!         and <literal>European</> are synonyms for <literal>DMY</>; the
!         keywords <literal>US</>, <literal>NonEuro</>, and
!         <literal>NonEuropean</> are synonyms for <literal>MDY</>. See
!         <xref linkend="datatype-datetime"> for more information. The
          default is <literal>ISO, MDY</>.
         </para>
        </listitem>

^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Clarification of DateStyle
@ 2004-04-15 05:27  Tom Lane <[email protected]>
  parent: Bruce Momjian <[email protected]>
  0 siblings, 1 reply; 4+ messages in thread

From: Tom Lane @ 2004-04-15 05:27 UTC (permalink / raw)
  To: Bruce Momjian <[email protected]>; +Cc: pgsql-docs

Bruce Momjian <[email protected]> writes:
> I have applied the following patch to clarify the meaning of the second
> DateStyle field.

Am I seeing correctly that this is actually just a one-word insertion?
You do your readers no favor by providing patches for comment that
consist largely of content-free rearrangement of line breaks.

			regards, tom lane



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Clarification of DateStyle
@ 2004-04-15 05:33  Bruce Momjian <[email protected]>
  parent: Tom Lane <[email protected]>
  0 siblings, 1 reply; 4+ messages in thread

From: Bruce Momjian @ 2004-04-15 05:33 UTC (permalink / raw)
  To: Tom Lane <[email protected]>; +Cc: pgsql-docs

Tom Lane wrote:
> Bruce Momjian <[email protected]> writes:
> > I have applied the following patch to clarify the meaning of the second
> > DateStyle field.
> 
> Am I seeing correctly that this is actually just a one-word insertion?
> You do your readers no favor by providing patches for comment that
> consist largely of content-free rearrangement of line breaks.

Yea, confusing.  The change was from:

	and the date field order specification 

to:

        and the input/output specification for year/month/day ordering

When I am in there, I take the opportunity to clean up the arrangement. 
If I don't my new text pushes everything out of alignment.

I guess I could make the changes, do a diff, then reformat before
applying to CVS.  Would that help?

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  [email protected]               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: Clarification of DateStyle
@ 2004-04-15 12:28  Tom Lane <[email protected]>
  parent: Bruce Momjian <[email protected]>
  0 siblings, 0 replies; 4+ messages in thread

From: Tom Lane @ 2004-04-15 12:28 UTC (permalink / raw)
  To: Bruce Momjian <[email protected]>; +Cc: pgsql-docs

Bruce Momjian <[email protected]> writes:
> I guess I could make the changes, do a diff, then reformat before
> applying to CVS.  Would that help?

Yeah, it'd make it easier to see the forest for the trees...

			regards, tom lane




^ permalink  raw  reply  [nested|flat] 4+ messages in thread


end of thread, other threads:[~2004-04-15 12:28 UTC | newest]

Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2004-04-15 04:47 Clarification of DateStyle Bruce Momjian <[email protected]>
2004-04-15 05:27 ` Tom Lane <[email protected]>
2004-04-15 05:33   ` Bruce Momjian <[email protected]>
2004-04-15 12:28     ` Tom Lane <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox