Re: [PATCHES] Fix misleading references to columns in GRANT/REVOKE summaries

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-patches(at)postgresql(dot)org, Russell Smith <mr-russ(at)pws(dot)com(dot)au>, David Fetter <david(at)fetter(dot)org>, PostgreSQL Docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: [PATCHES] Fix misleading references to columns in GRANT/REVOKE summaries
Date: 2007-04-09 02:28:23
Message-ID: 13703.1176085703@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-patches

Bruce Momjian <bruce(at)momjian(dot)us> writes:
> Peter Eisentraut wrote:
>> That doesn't mean this one isn't useful. Please revert this.

> Well, Tom and I thought it caused confusion, as did the person reporting
> the confusion. You saying to revert it isn't enough.

A possible compromise is to describe or show the syntax in some informal
form, so that it didn't look like one of the <synopsis> sections we use
for supported syntax. I'm not sure what that would look like exactly,
but I do see merit in both sides of this discussion...

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2007-04-09 02:52:30 Re: [PATCHES] Fix misleading references to columns in GRANT/REVOKE summaries
Previous Message Bruce Momjian 2007-04-09 01:46:21 Re: [PATCHES] Fix misleading references to columns in GRANT/REVOKE summaries

Browse pgsql-patches by date

  From Date Subject
Next Message ITAGAKI Takahiro 2007-04-09 02:48:44 Re: UTF8MatchText
Previous Message Tom Lane 2007-04-09 02:24:23 Re: [HACKERS] Arrays of Complex Types