diff --git a/doc/functions.sgm b/doc/functions.sgm index 3bd109d..ce795ad 100644 --- a/doc/functions.sgm +++ b/doc/functions.sgm @@ -149,9 +149,9 @@ - + - Point distance function + Point-within-distance function The function @@ -166,8 +166,9 @@ returns if points p1 and p2 - lie within distance radius of each other. - On PostgreSQL 12 and later, the function has GIST + lie within distance radius of each other, i.e. + it computes the boolean expression p1 <-> p2 <= radius. + On PostgreSQL 12 and later, the function has GiST support and the PostgreSQL optimizer will transform it to either p1 <@ scircle(p2, radius) or p2 <@ scircle(p1, radius) where appropriate.