Re: DOCS - "\d mytable" also shows any publications that publish mytable - Mailing list pgsql-hackers

From Fujii Masao
Subject Re: DOCS - "\d mytable" also shows any publications that publish mytable
Date
Msg-id CAHGQGwFhkhdK79fTeYEnxxfgmzjjshfXuBBnfwoD7GneEdBokQ@mail.gmail.com
Whole thread Raw
In response to Re: DOCS - "\d mytable" also shows any publications that publish mytable  (Peter Smith <smithpb2250@gmail.com>)
Responses Re: DOCS - "\d mytable" also shows any publications that publish mytable
Re: DOCS - "\d mytable" also shows any publications that publish mytable
List pgsql-hackers
On Thu, Jan 22, 2026 at 3:15 PM Peter Smith <smithpb2250@gmail.com> wrote:
> > Regarding whole patch, I'm not clear about whether this patch is worthwhile
> > if it only adds phrasing like "such as" or "for example". That said, if some
> > users currently interpret the list as exhaustive, this change could help
> > clarify the intent...
> >
>
> Yes. The patch is not doing much now, but OTOH the reason for this
> patch adding the "missing" publication entry in the first place was
> precisely because I thought the docs page was was documenting
> exhaustive lists; so there might be some merit to clear up that
> illusion.

OK, let's commit the patch as a documentation improvement to
reduce user confusion.

> PSA v4.

Thanks for updating the patch! I've applied a few small tweaks and
attached an updated version.

+        Associated objects, such as indexes, constraints, rules, publications,
+        triggers, and so on, are also shown. For foreign tables, the

I removed "and so on" because using both "such as" and "and so on"
in the same sentence felt redundant.

+        more information is displayed, such as: any comments associated with

I removed "such as" and instead added "for example" before "any comments",
which felt more natural here at least for me.

-         identity</link> setting and the
+         identity</link> settings and the

I'm not sure this change is necessary, so I restored the original wording.

I also updated the commit message.

Regards,

--
Fujii Masao

Attachment

pgsql-hackers by date:

Previous
From: Ashutosh Bapat
Date:
Subject: Re: Remove PG_MMAP_FLAGS
Next
From: Chao Li
Date:
Subject: Re: Refactor recovery conflict signaling a little