Re: Lack of detailed documentation

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "Strauss, Randy (ARC-AF)[SGT, INC]" <randolph(dot)a(dot)strauss(at)nasa(dot)gov>, "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Lack of detailed documentation
Date: 2020-04-23 00:18:42
Message-ID: CAKFQuwbgjJtUpWCb+jxf1bMVhm8V-W+XdkrtkuJ-fk093H7H5g@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, Apr 22, 2020 at 4:36 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:

> One thing that surprised me is that I couldn't find any well-known
> name for what the * and / operators are doing; digging around on
> the net and in some dusty old math textbooks didn't yield any exact
> matches. I ended up adding footnotes with the actual computations,
> but I'm not very happy with that approach. Surely Lockhart[1] got this
> definition from someplace, though, and didn't invent it out of thin air.
>
>
I'd move the footnote indicator to:

Available for point[a], box, path, circle.
Available for point[b], box, path, circle.

As the footnote only applies to that specific left operand type.

Or maybe:

Available for box, path, and circle. It is also defined for point [a] but
it has no related physical meaning.

David J.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2020-04-23 00:22:46 Re: Lack of detailed documentation
Previous Message Tom Lane 2020-04-22 23:36:54 Re: Lack of detailed documentation