Re: doc examples for pghandler - Mailing list pgsql-hackers

From Tom Lane
Subject Re: doc examples for pghandler
Date
Msg-id 776992.1591989020@sss.pgh.pa.us
Whole thread Raw
In response to doc examples for pghandler  (Mark Wong <mark@2ndquadrant.com>)
Responses Re: doc examples for pghandler  (Mark Wong <mark@2ndquadrant.com>)
List pgsql-hackers
Mark Wong <mark@2ndquadrant.com> writes:
> Would some additional procedure language handler code examples in the
> documentation be good to add?  I've put some together in the attached
> patch, and can log it to a future commitfest if people think it would
> be a good addition.

Hmm.  The existing doc examples are really pretty laughable, because
there's such a large gap between the offered skeleton and a workable
handler.  So I agree it'd be nice to do better, but I'm suspicious of
having large chunks of sample code in the docs --- that's a maintenance
problem, if only because we likely won't notice when we break it.
Also, if somebody is hoping to copy-and-paste such code, it isn't
that nice to work from if it's embedded in SGML.

I wonder if it'd be possible to adapt what you have here into some
tiny contrib module that doesn't do very much useful, but can at
least be tested to see that it compiles; moreover it could be
copied verbatim to serve as a starting point for a new PL.

            regards, tom lane



pgsql-hackers by date:

Previous
From: Dmitry Igrishin
Date:
Subject: Re: Building PostgreSQL extensions on Windows
Next
From: Bruce Momjian
Date:
Subject: Re: what can go in root.crt ?