Re: Documentation about PL transforms

From: chap(at)anastigmatix(dot)net
To: Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Documentation about PL transforms
Date: 2022-04-08 01:22:11
Message-ID: 15aae6eba18b19579ce2568828c692bd@anastigmatix.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 2022-02-22 12:59, Chapman Flack wrote:
> It would have been painful to write documentation of get_func_trftypes
> saying its result isn't what get_transform_{from.to}sql expect, so
> patch 1 does add a get_call_trftypes that returns a List *.
>
> Patch 2 then updates the docs as discussed in this thread. It turned
> out
> plhandler.sgml was kind of a long monolith of text even before adding
> transform information, so I broke it into sections first. This patch
> adds
> the section markup without reindenting, so the changes aren't obscured.
>
> The chapter had also fallen behind the introduction of procedures, so
> I have changed many instances of 'function' to the umbrella term
> 'routine'.
>
> Patch 3 simply reindents for the new section markup and rewraps.
> Whitespace only.
>
> Patch 4 updates src/test/modules/plsample to demonstrate handling of
> transforms (and to add some more comments generally).

Here is a rebase.

Attachment Content-Type Size
v2-0001-Warmup-add-a-get_call_trftypes-function.patch text/x-diff 2.9 KB
v2-0002-Update-PL-handler-implementation-docs.patch text/x-diff 32.6 KB
v2-0003-Reindent-and-wrap-between-added-sect1-tags.patch text/x-diff 35.9 KB
v2-0004-PL-Sample-with-TRANSFORM-FOR-TYPE.patch text/x-diff 8.5 KB

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2022-04-08 01:22:57 Re: test/isolation/expected/stats_1.out broken for me
Previous Message vignesh C 2022-04-08 01:11:50 Re: Handle infinite recursion in logical replication setup