Re: WIP: document the hook system - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: WIP: document the hook system
Date
Msg-id CABUevEzjS73s17aTdt53rPr5OHjfmhEm9vTuUTAyq3mjUv5mNA@mail.gmail.com
Whole thread Raw
In response to Re: WIP: document the hook system  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Responses Re: WIP: document the hook system
List pgsql-hackers
On Fri, Jan 15, 2021 at 8:28 AM Peter Eisentraut
<peter.eisentraut@enterprisedb.com> wrote:
>
> On 2020-12-31 04:28, David Fetter wrote:
> > This could probably use a lot of filling in, but having it in the
> > actual documentation beats needing to know folklore even to know
> > that the capability is there.
>
> This patch seems quite short of a state where one could begin to
> evaluate it.  Documenting the hooks better seems a worthwhile goal.   I
> think the question is whether we can develop documentation that is
> genuinely useful by itself without studying the relevant source code.
> This submission does not address that question.

Even just having a list of available hooks would be a nice improvement though :)

But maybe it's something that belongs better in a README file instead,
since as you say it's unlikely to be properly useful without looking
at the source anyway. But just a list of hooks and a *very* high
overview of where each of them hooks in would definitely be useful to
have somewhere, I think. Having to find with "grep" whether there may
or may not exist a hook for approximately what it is you're looking
for is definitely a process to improve on.

-- 
 Magnus Hagander
 Me: https://www.hagander.net/
 Work: https://www.redpill-linpro.com/



pgsql-hackers by date:

Previous
From: Magnus Hagander
Date:
Subject: cgit view availabel
Next
From: Tomas Vondra
Date:
Subject: Re: list of extended statistics on psql