Use or not record count on examples

From: Marcos Pegoraro <marcos(at)f10(dot)com(dot)br>
To: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Use or not record count on examples
Date: 2024-11-23 12:29:47
Message-ID: CAB-JLwYaauh-QRjnqN-DLfgZ8xFmy_uyGe545tiuejtiX0-T+Q@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

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 ?
I think they are useless. Or maybe shown when no rows are returned.

datatype.sgml
a | char_length
------+-------------
ok | 2

name | current_mood
------+--------------
Moe | happy
(1 row)

func.sgml
a | b
---+-----
1 | foo
2 |

make | model | sales
-------+-------+-------
Foo | GT | 10
Foo | Tour | 20
Bar | City | 15
Bar | Sport | 5
(4 rows)

Or maybe when not all records are shown, like in planstats.sgml
index | values | nulls | frequency | base_frequency
-------+----------+-------+-----------+----------------
0 | {0, 0} | {f,f} | 0.01 | 0.0001
1 | {1, 1} | {f,f} | 0.01 | 0.0001
...
49 | {49, 49} | {f,f} | 0.01 | 0.0001
50 | {50, 50} | {f,f} | 0.01 | 0.0001
...
97 | {97, 97} | {f,f} | 0.01 | 0.0001
98 | {98, 98} | {f,f} | 0.01 | 0.0001
99 | {99, 99} | {f,f} | 0.01 | 0.0001
(100 rows)

regards
Marcos

Browse pgsql-hackers by date

  From Date Subject
Next Message Marcos Pegoraro 2024-11-23 12:29:54 Re: Document NULL
Previous Message Andrey M. Borodin 2024-11-23 08:20:28 Re: UUID v7