Re: small fix for pg_overexplain docs - Mailing list pgsql-hackers

From Dean Rasheed
Subject Re: small fix for pg_overexplain docs
Date
Msg-id CAEZATCUEaasoxNPSva5mOWJ-Lu92U6ryprB2Dgdt-_9DEdCoRw@mail.gmail.com
Whole thread Raw
In response to Re: small fix for pg_overexplain docs  (Robert Treat <rob@xzilla.net>)
List pgsql-hackers
On Tue, 15 Jul 2025 at 04:17, Robert Treat <rob@xzilla.net> wrote:
>
> On Mon, Jul 14, 2025 at 3:22 PM David G. Johnston
> > The pg_overexplain extends EXPLAIN with new options that provide...
> > Suggest instead:
> > The pg_overexplain module provides EXPLAIN with new options intended to assist with debugging of and development of
theplanner. 
> > (replacing the first two sentences of the existing paragraph)
>
> +1 for consistency, though I'd argue "intended to assist with
> debugging and development of the planner" would be easier to read (in
> either one sentence or two sentence format).
>

+1. I find that easier to read.

Something else that's missing is instructions on how to load the
module, which usually follows this first paragraph.

Regards,
Dean



pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: remove WITHOUT OIDS syntax for v19
Next
From: Fujii Masao
Date:
Subject: Re: Logical replication launcher did not automatically restart when got SIGKILL