Re: EXCEPT TABLE - Case inconsistency for describe \d and \dRp+ - Mailing list pgsql-hackers

From Peter Smith
Subject Re: EXCEPT TABLE - Case inconsistency for describe \d and \dRp+
Date
Msg-id CAHut+Puyt4DTq9E+EJR8zNeKhPSAaKh6JWUOfn1U62ESv2kz_Q@mail.gmail.com
Whole thread
In response to Re: EXCEPT TABLE - Case inconsistency for describe \d and \dRp+  (Amit Kapila <amit.kapila16@gmail.com>)
List pgsql-hackers
On Fri, Apr 17, 2026 at 3:24 PM Amit Kapila <amit.kapila16@gmail.com> wrote:
>
> On Fri, Apr 17, 2026 at 4:34 AM Peter Smith <smithpb2250@gmail.com> wrote:
> >
> > On Fri, Apr 17, 2026 at 12:10 AM Álvaro Herrera <alvherre@kurilemu.de> wrote:
> > >
> > > On 2026-Apr-10, Peter Smith wrote:
> > >
> > > > # -- describe the tables
> > > > # \d t1
> > > >                 Table "public.t1"
> > > > Column | Type   | Collation | Nullable | Default
> > > > --------+---------+-----------+----------+---------
> > > > a      | integer |           |          |
> > > > Except Publications:
> > > >   "pub1"
> > >
> > > I have a hard time understanding what an "except publication" is.  I
> > > think this would be clearer if the header said "Excluded from publications:"
> > >
> >
> > I agree that your suggestion is clearer.
> >
> > If we make that change, then should the "Publications:" footer also be
> > modified similarly (to "Included in publications:") so they match?
> >
> > e.g.
> >
> > CURRENTLY
> >
> > test_pub=# \d t1
> >                  Table "public.t1"
> >  Column |  Type   | Collation | Nullable | Default
> > --------+---------+-----------+----------+---------
> >  a      | integer |           |          |
> > Publications:
> >     "pub1"
> >     "pub2"
> > Except publications:
> >     "pub3"
> >
> > ~~~
> >
> > SUGGESTION
> >
> > test_pub=# \d t1
> >                  Table "public.t1"
> >  Column |  Type   | Collation | Nullable | Default
> > --------+---------+-----------+----------+---------
> >  a      | integer |           |          |
> > Included in publications:
> >     "pub1"
> >     "pub2"
> > Excluded from publications:
> >     "pub3"
> >
> > ~~~
> >
>
> +1 for the proposal. It makes the description clear.
>

OK. Thanks.

Next question: am I only changing this for the table describe (\d)?

I am asking because I noticed the schema describe (\dn) also has a
footer called "Publications:".

----------
test_pub=# CREATE PUBLICATION pub7 FOR TABLES IN SCHEMA my_schema;
CREATE PUBLICATION
test_pub=# \dn+ my_schema
                    List of schemas
   Name    |  Owner   | Access privileges | Description
-----------+----------+-------------------+-------------
 my_schema | postgres |                   |
Publications:
    "pub7"
----------

Would you like this schema footer also changed to say "Included in
publications:"?

======
Kind Regards,
Peter Smith.
Fujitsu Australia



pgsql-hackers by date:

Previous
From: Heikki Linnakangas
Date:
Subject: Re: Add editorconfig support for Postgres spec files
Next
From: Andrei Lepikhov
Date:
Subject: A very quick observation of dangling pointers in Postgres pathlists