From: Tom Lane <tgl@sss.pgh.pa.us>
To: Josh Kupershmidt <schmiddy@gmail.com>
Cc: pgsql-docs@postgresql.org
Subject: Re: Documentation of underlying functions for statistics views
Date: Sun, 29 Apr 2012 17:06:09 -0400
Message-ID: <19136.1335733569@sss.pgh.pa.us> (raw)
In-Reply-To: <CAK3UJRGPwcO2FN5Ktmh=bQ75pb4Q7R39EgSmLHTVvrca08N3Hw@mail.gmail.com>
References: <4683.1335648276@sss.pgh.pa.us>
<CAK3UJRH-8xmhb4G3t=LPQed3ZCtt2Jk+XH8GZkBqO45bJX7SLw@mail.gmail.com>
<23280.1335711812@sss.pgh.pa.us>
<CAK3UJRGPwcO2FN5Ktmh=bQ75pb4Q7R39EgSmLHTVvrca08N3Hw@mail.gmail.com>
Josh Kupershmidt <schmiddy@gmail.com> writes:
> Yeah, that sounds fine. The paragraph I think you're talking about
> claims "These functions are listed in Table 27-13", but Table 27-13
> only has a few functions (e.g. pg_stat_get_db_block_time_read() is
> missing). Maybe that paragraph could clarify that it's talking
> generally about all the views/functions on that page.
It seemed to me that the only view-underlying function that needs
explicit documentation is pg_stat_get_activity(), because the fact
that you can pass it a PID isn't obvious from the view's usage.
So that's the only one I left in table 27-13. However, I realized
that the stats functions that we used in pg_stat_activity before 8.4
are not documented at all with this approach, so I made another table
27-14 to cover them. I'm not sure if we should mark them deprecated
or not; thoughts?
Anyway, this is committed and up on the devel docs website, if
you want to take a look.
regards, tom lane
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 using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, schmiddy@gmail.com
Subject: Re: Documentation of underlying functions for statistics views
In-Reply-To: <19136.1335733569@sss.pgh.pa.us>
* 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