Re: Use or not record count on examples - Mailing list pgsql-hackers

From David Rowley
Subject Re: Use or not record count on examples
Date
Msg-id CAApHDvodoUQGbVZE7mFzk16u8Tj8giT8C9LUv=Q5e8aSFPxesg@mail.gmail.com
Whole thread Raw
In response to Use or not record count on examples  (Marcos Pegoraro <marcos@f10.com.br>)
Responses Re: Use or not record count on examples
List pgsql-hackers
On Sun, 24 Nov 2024 at 01:30, Marcos Pegoraro <marcos@f10.com.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



pgsql-hackers by date:

Previous
From: Kirill Reshke
Date:
Subject: Re: Parallel CREATE INDEX for GIN indexes
Next
From: Tatsuo Ishii
Date:
Subject: Re: Fix for Extra Parenthesis in pgbench progress message