pgsql: Properly lowercase identifiers, uppercase keywords, in doc

Started by Bruce Momjianalmost 16 years ago4 messagescomitters
Jump to latest
#1Bruce Momjian
bruce@momjian.us

Log Message:
-----------
Properly lowercase identifiers, uppercase keywords, in doc examples

Modified Files:
--------------
pgsql/doc/src/sgml:
syntax.sgml (r1.150 -> r1.151)
(http://anoncvs.postgresql.org/cvsweb.cgi/pgsql/doc/src/sgml/syntax.sgml?r1=1.150&r2=1.151)

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#1)
Re: pgsql: Properly lowercase identifiers, uppercase keywords, in doc

momjian@postgresql.org (Bruce Momjian) writes:

Log Message:
-----------
Properly lowercase identifiers, uppercase keywords, in doc examples

Bruce, did you do that with a blind sed script? You totally destroyed
the point of these examples. Kindly revert.

regards, tom lane

#3Thom Brown
thom@linux.com
In reply to: Tom Lane (#2)
Re: pgsql: Properly lowercase identifiers, uppercase keywords, in doc

On 11 August 2010 23:04, Tom Lane <tgl@sss.pgh.pa.us> wrote:

momjian@postgresql.org (Bruce Momjian) writes:

Log Message:
-----------
Properly lowercase identifiers, uppercase keywords, in doc examples

Bruce, did you do that with a blind sed script?  You totally destroyed
the point of these examples.  Kindly revert.

Whilst that change definitely needs reverting, I noticed the following
doesn't read well:

"Additionally, comments can occur in SQL input. They are not tokens,
they are effectively equivalent to whitespace.

For example, the following is (syntactically) valid SQL input:"

You'd expect an example with comments in after reading that, but there isn't.

Maybe that "Additionally..." bit should be moved beneath the "This is
a sequence..." paragraph?

--
Thom Brown
Registered Linux user: #516935

#4Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#2)
Re: pgsql: Properly lowercase identifiers, uppercase keywords, in doc

Tom Lane wrote:

momjian@postgresql.org (Bruce Momjian) writes:

Log Message:
-----------
Properly lowercase identifiers, uppercase keywords, in doc examples

Bruce, did you do that with a blind sed script? You totally destroyed
the point of these examples. Kindly revert.

Oops, reverted. I was looking in there for something else and was
surprised that such odd casing had gotten into our docs.

--
Bruce Momjian <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ It's impossible for everything to be true. +