Re: Lack of detailed documentation - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Lack of detailed documentation
Date
Msg-id CAKFQuwaUAxHPRn8t0zUA+ctE0dKDYhESGg2rnRJB8r8gN_XgfA@mail.gmail.com
Whole thread Raw
In response to Lack of detailed documentation  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Lack of detailed documentation  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Fri, Feb 7, 2020 at 4:53 PM PG Doc comments form <noreply@postgresql.org> wrote:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/12/functions-geometry.html
Description:

On:  https://www.postgresql.org/docs/current/functions-geometry.html

The functions aren't defined, nor have pointers.  For instance:
*       Scaling/rotation        box '((0,0),(1,1))' * point '(2.0,0)'

I see how it can be scaling (or shearing), but how does it do rotation?
Or maybe when the points x^2+y^2 == 1, it's interpreted at rotation?

Google: "box point multiplication postgres" came up with the follow book section:

Haven't independently confirm the math but it sounds reasonable...

Each operator needs a full explanation...

Patch submissions are welcomed.

David J.

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: 9.4. String Functions and Operators page does not document thatencode adds line breaks
Next
From: Tom Lane
Date:
Subject: Re: 9.4. String Functions and Operators page does not document that encode adds line breaks