From: PG Doc comments form <noreply@postgresql.org>
To: pgsql-docs@lists.postgresql.org
Cc: michal.palenik@oma.sk
Subject: documentation on comment
Date: Wed, 07 Oct 2026 11:23:50 +0000
Message-ID: <179137223040.1061050.427125467499257106@wrigleys.postgresql.org> (raw)
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/18/sql-altertable.html
Description:
after spending some time searching for how to do comments, maybe some
documentation could be made clearer:
links from 'create table', 'alter table' to
https://www.postgresql.org/docs/current/sql-comment.html (maybe in the 'see
also' section).
and in 'comment' part, mention that comments on columns can be seen with \d+
and comments on tables with \dt+ (\dv+ on views)
so from 'Comments can be viewed using psql's \d family of commands.' to
something like 'Comments can be viewed using psql's \d family of commands.
To see comments on columns, use \d+ table_name command, for comment on the
table itself, use \dt+ table_name command'.
thanks for wonderful work on documentation
Michal
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients from your mail client; the link fills in
the headers below: reply via email
Some clients, webmail especially, drop In-Reply-To and References from
a link, and the reply then starts a new thread: use the mbox below.
To: pgsql-docs@postgresql.org
Cc: noreply@postgresql.org, michal.palenik@oma.sk
Subject: Re: documentation on comment
In-Reply-To: <179137223040.1061050.427125467499257106@wrigleys.postgresql.org>
References: <179137223040.1061050.427125467499257106@wrigleys.postgresql.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox