Re: clean up docs for v12

On 2019-Apr-22, Andres Freund wrote:

> On 2019-04-22 14:48:26 +0900, Michael Paquier wrote:

> > /*
> > - * Check if's guaranteed the all the desired attributes are available in
> > - * tuple. If so, we can start deforming. If not, need to make sure to
> > - * fetch the missing columns.
> > + * Check if all the desired attributes are available in the tuple. If so,
> > + * we can start deforming. If not, we need to make sure to fetch the
> > + * missing columns.
> > */
>
> That's imo not an improvement. The guaranteed bit is actually
> relevant. What this block is doing is eliding the check against the
> tuple header for the number of attributes, if NOT NULL attributes for
> later columns guarantee that the desired columns are present in the NULL
> bitmap. But the rephrasing makes it sound like we're actually checking
> against the tuple.
>
> I think it'd be better just to fix s/the all/that all/.

(and s/if's/if it's/)

>
> > if ((natts - 1) <= guaranteed_column_number)
> > {
> > @@ -383,7 +383,7 @@ slot_compile_deform(LLVMJitContext *context, TupleDesc desc,
> >
> > /*
> > * If this is the first attribute, slot->tts_nvalid was 0. Therefore
> > - * reset offset to 0 to, it be from a previous execution.
> > + * reset offset to 0 too, as it may be from a previous execution.
> > */
> > if (attnum == 0)
> > {
>
> That obviously makes sense.

Hmm, I think "as it *is*", not "as it *may be*", right?

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services