Re: Couple document fixes

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Alvaro Herrera <alvherre(at)commandprompt(dot)com>
Cc: Kevin Grittner <kevin(dot)grittner(at)wicourts(dot)gov>, Thom Brown <thom(at)linux(dot)com>, PostgreSQL-development <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Couple document fixes
Date: 2011-09-05 18:21:46
Message-ID: 201109051821.p85ILkQ01814@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

Alvaro Herrera wrote:
> Removing CC to pg-docs so that Robert reads it.
>
> Excerpts from Bruce Momjian's message of vie mar 11 08:13:20 -0300 2011:
> > Kevin Grittner wrote:
>
> > > relpersistence should be <type>"char"</type>, not <type>char</type>.
> > > Oddly enough, there is a difference.
> >
> > I am unsure on that one. We have many 'char' mentions in catalog.sgml,
> > and I don't see any of them shown as '"char"'. (Wow, we should have
> > just called this type char1, but I think that name came from Berkeley!)
> > The big problem is that the pg_type name is really "char" _without_
> > quotes.
>
> One idea is to rename the type to something else. We could keep "char"
> as an alias for backwards compatibility, but use the new name in system
> catalogs, and document it as the main name of the type.
>
> Discussed the idea a bit on IM with Bruce, but couldn't find any really
> good alternative. Idea floated so far:
>
> * byte (seems pretty decent to me)
> * octet (though maybe people would expect it'd output as a number)
> * char1 (looks ugly, but then we have int4 and so on)
> * achar (this one is just plain weird)
>
> None seems great. Thoughts?

Any new ideas on how to document our "char" data type?

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2011-09-05 18:36:21 Re: Couple document fixes
Previous Message Bruce Momjian 2011-09-05 16:50:24 Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd

Browse pgsql-hackers by date

  From Date Subject
Next Message Andy Colson 2011-09-05 18:29:55 Re: remove useless ccache searching
Previous Message Andy Colson 2011-09-05 18:19:21 remove useless ccache searching