Re: Doc patch to note which system catalogs have oids - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Doc patch to note which system catalogs have oids
Date
Msg-id 15845.1348456473@sss.pgh.pa.us
Whole thread Raw
In response to Doc patch to note which system catalogs have oids  ("Karl O. Pinc" <kop@meme.com>)
Responses Re: Doc patch to note which system catalogs have oids  ("Karl O. Pinc" <kop@meme.com>)
Re: Doc patch to note which system catalogs have oids  (Stephen Frost <sfrost@snowman.net>)
List pgsql-hackers
"Karl O. Pinc" <kop@meme.com> writes:
> The attached patch documents the oid column of those
> system catalogs having an oid.

I think this is fundamentally wrong, or at least misleading, because it
documents OID as if it were an ordinary column.  Somebody who did
"select * from pg_class" and didn't see any "oid" in the result would
think the docs were wrong.

It's possible that it's worth expending a boilerplate paragraph in each
of those pages to say "this catalog has OIDs" (or that it doesn't).
But this isn't the way.
        regards, tom lane



pgsql-hackers by date:

Previous
From: "Karl O. Pinc"
Date:
Subject: Doc patch to See Also: CREATE TABLE AS in CREATE TABLE docs
Next
From: Amit Kapila
Date:
Subject: Re: [v9.3] Extra Daemons (Re: elegant and effective way for running jobs inside a database)