Re: Use or not record count on examples

From: David Rowley <dgrowleyml(at)gmail(dot)com>
To: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Use or not record count on examples
Date: 2024-11-24 21:54:38
Message-ID: CAApHDvodoUQGbVZE7mFzk16u8Tj8giT8C9LUv=Q5e8aSFPxesg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Sun, 24 Nov 2024 at 01:30, Marcos Pegoraro <marcos(at)f10(dot)com(dot)br> wrote:
> There is no rule of when the number of records at the end of the lists should be shown or not
> Sometimes we show that line "(4 rows)", but sometimes not.
> Should we have a standard for it ? Should we add them all or remove them all ?

It looks like we have a few ways to try to trim down the query result
output to save space on the page. In [1] we do:

> SELECT format('|%10s|', 'foo');
> Result: | foo|

I'm ok with the documentation being terse like this. If we were to
standardise on something, that would likely force those examples to be
much more verbose than they need to be. I don't think that verbosity
would add any additional value.

David

[1] https://www.postgresql.org/docs/current/functions-string.html

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tatsuo Ishii 2024-11-24 23:31:55 Re: Fix for Extra Parenthesis in pgbench progress message
Previous Message Kirill Reshke 2024-11-24 18:04:38 Re: Parallel CREATE INDEX for GIN indexes