Re: BUG #14016: Incomplete documentation of IN subquery expression

On Tuesday, April 26, 2016, Bruce Momjian <bruce(at)momjian(dot)us> wrote:

> On Tue, Apr 26, 2016 at 02:00:39PM -0700, David G. Johnston wrote:
> > On Tue, Apr 26, 2016 at 1:27 PM, Bruce Momjian <bruce(at)momjian(dot)us
> <javascript:;>> wrote:
> > > >>>Note: This form of IN is not truly a subquery expression, but
> it seems
> > best
> > > to document it in the same place as subquery IN.
> >
> > Does the attached patch improve this?
> >
> >
> > ​I'd append "scalar" to the id to distinguish in from the subquery
> version.
> > Otherwise any suggest I make seems like overkill. The main point being
> the
> > "list of scalars" is not a term we use on the referenced page, and the
> chapter
> > header indicates "Row and Array" of which this is similar but technically
> > neither.​
> >
> > ​<sect2 id="functions-comparisons-in-scalar"> [...]​
> >
> > [...] rely on the ​<link
> linkend="functions-comparison-in-scalar">array</link>
> > form of [...]​
>
> Sorry, there was already a link in that place --- I had linked to the
> wrong spot. New patch attached.
>
>
I think the spot you linked to the first time was correct. The subquery
form is the one you get when using values, the scalar version is the one
the note wants to link to.

David J.