Re: Use uppercase keywords in foreign key tutorial - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Use uppercase keywords in foreign key tutorial
Date
Msg-id aQKGVwVChafkfSub@momjian.us
Whole thread Raw
In response to Re: Use uppercase keywords in foreign key tutorial  (David Rowley <dgrowleyml@gmail.com>)
Responses Re: Use uppercase keywords in foreign key tutorial
List pgsql-docs
On Thu, Oct 30, 2025 at 10:24:30AM +1300, David Rowley wrote:
> On Thu, 30 Oct 2025 at 09:48, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> >
> > Bruce Momjian <bruce@momjian.us> writes:
> > > On Tue, Oct 28, 2025 at 04:34:45PM -0500, Nathan Bossart wrote:
> > >> I noticed the patch also changes some column types to lowercase:
> > >> ...
> > >> -    category_N TEXT
> > >> +    category_N text
> > >>
> > >> FWIW I tend to use uppercase for those, too, but I'm not sure there is a
> > >> preferred style for the docs.
> >
> > > Agreed, uppercase is better for type names.
> >
> > "text" is not a keyword according to either us or the SQL standard.
> > I agree that there's some reason to capitalize things that are
> > grammar keywords, such as INTEGER or VARCHAR, but it's a big stretch
> > to go from that to capitalizing everything that is a type name.
> > Would you capitalize user-defined type names?
> 
> Going by: git grep -i "\btext\b," we're fairly consistently using
> lower case, so FWIW, when I looked, I thought Eric's change made
> sense.
> 
> How about if Eric just drops the portion of the patch that alters the
> casing of the types and leaves all the keyword uppercasing stuff in.
> Any objections to that part?

Works for me.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Do not let urgent matters crowd out time for investment in the future.



pgsql-docs by date:

Previous
From: David Rowley
Date:
Subject: Re: Use uppercase keywords in foreign key tutorial
Next
From: Nathan Bossart
Date:
Subject: Re: Use uppercase keywords in foreign key tutorial