On 25 March 2016 at 06:17, Robert Haas <robertmhaas@gmail.com> wrote:
> On Mon, Mar 21, 2016 at 2:18 PM, David Rowley
> <david.rowley@2ndquadrant.com> wrote:
>> I've attached 2 of the patches which are affected by the changes.
>
> I think the documentation for 0001 needs some work yet. The
> additional paragraph that you've added...
>
> (1) doesn't seem to appear at a very logical place in the
> documentation - I think it should be much further down, as it's a
> minor detail. Maybe document this the same way as the documentation
> patch you just sent for the combine-function stuff does it; and
Thanks. I also realised this when writing the combine documents fix.
> (2) isn't indented consistently with the surrounding paragraphs; and
>
> (3) is missing a closing </para> tag
>
> Also, I'd just cut this:
>
> + This is required due to
> + the process model being unable to pass references to <literal>INTERNAL
> + </literal> types between different <productname>PostgreSQL</productname>
> + processes.
>
> Instead, I'd change the earlier sentence in the paragraph, which
> currently reads:
>
> + These
> + functions are required in order to allow parallel aggregation for aggregates
> + with an <replaceable class="PARAMETER">stype</replaceable> of <literal>
> + INTERNAL</>.
>
> I'd replace the period at end with a comma and add "since
> <literal>INTERNAL</> values represent arbitrary in-memory data
> structures which can't be passed between processes". I think that's a
> bit smoother.
>
In my rewrite I've incorporated these words.
Thanks for checking over this. A patch will follow in my response to
the next email.
-- David Rowley http://www.2ndQuadrant.com/PostgreSQL Development, 24x7 Support, Training & Services