Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xEWSA-000000018wv-484C for pgsql-docs@arkaria.postgresql.org; Wed, 07 Oct 2026 18:33:22 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1xEWS9-000000084m2-31fz for pgsql-docs@arkaria.postgresql.org; Wed, 07 Oct 2026 18:33:21 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xEPkr-00000006EBQ-1HDe for pgsql-docs@lists.postgresql.org; Wed, 07 Oct 2026 11:24:13 +0000 Received: from mahout.postgresql.org ([2001:4800:3e1:1::227]) by makus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xEPkp-00000000oPK-2log for pgsql-docs@lists.postgresql.org; Wed, 07 Oct 2026 11:24:12 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=postgresql.org; s=20171124; h=Message-ID:Date:Reply-To:Cc:From:To:Subject: Content-Transfer-Encoding:MIME-Version:Content-Type:Sender:Content-ID: Content-Description:In-Reply-To:References; bh=eeNWeIeI2kvP6MFqb+/8CtuvV2W3UIYdN7kBWUb5I3w=; b=Eo9M6Esdttliy4ebIHjY5UZEtA NM952JCCMg0Ijgt5E8zjwapwEQaL53zw/coQwkg2MwGukd1u6fMDnVFm3SOJGXlCCs2Ds0yx7NfTh WXuagLwg4FcA2x1Z9z2zoF+j5aQL3Of/+S3v5W2hQGRMAKIq8qO0kBt5BJcUVjDyuPYbEIj3cX1g3 F+TlOkjJL1FF2GzW6eX12Ws44wACk9X08Sbq1idUSib3gV2FKLyCLqErFIFVL52jVVe2Ml6pZzwbb UNp1KqNvXfVoU7X4TWDCQzE+xRtN9iDdiT+JEtyUKB0Haabep5vO1etzoRYRp2OL9xzK7263sB88L ZXu+3ODA==; Received: from wrigleys.postgresql.org ([2a02:16a8:dc51::60]) by mahout.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.98.2) (envelope-from ) id 1xEPkj-00000002TGz-0Sqh for pgsql-docs@lists.postgresql.org; Wed, 07 Oct 2026 11:24:11 +0000 Received: from localhost ([127.0.0.1] helo=wrigleys.postgresql.org) by wrigleys.postgresql.org with esmtp (Exim 4.98.2) (envelope-from ) id 1xEPkh-00000007A2H-2cWC for pgsql-docs@lists.postgresql.org; Wed, 07 Oct 2026 11:24:03 +0000 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Subject: documentation on comment To: pgsql-docs@lists.postgresql.org From: PG Doc comments form Cc: michal.palenik@oma.sk Reply-To: michal.palenik@oma.sk, pgsql-docs@lists.postgresql.org Date: Wed, 07 Oct 2026 11:23:50 +0000 Message-ID: <179137223040.1061050.427125467499257106@wrigleys.postgresql.org> X-Auto-Response-Suppress: All Auto-Submitted: auto-generated List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk 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