On Thu, Jan 22, 2026 at 3:15 PM Peter Smith <[email protected]> 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: v5-0001-doc-Clarify-that-d-and-d-output-lists-are-illustr.patch
Description: Binary data

Reply via email to