From 3bea370acc84282e4ae267e04eead3902cab97f4 Mon Sep 17 00:00:00 2001 From: Ben Guild Date: Mon, 10 Nov 2025 02:55:34 +0900 Subject: [PATCH 1/2] Mark `S2Polygon` as obsolete in documentation --- src/s2/s2polygon.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/s2/s2polygon.h b/src/s2/s2polygon.h index 748af5a44..776187f9a 100644 --- a/src/s2/s2polygon.h +++ b/src/s2/s2polygon.h @@ -58,10 +58,10 @@ class S2Loop; class S2Polyline; struct S2XYZFaceSiTi; -// An S2Polygon is an S2Region object that represents a polygon. A polygon is -// defined by zero or more loops; recall that the interior of a loop is -// defined to be its left-hand side (see S2Loop). There are two different -// conventions for creating an S2Polygon: +// Obsolete, see S2LaxPolygonShape. An S2Polygon is an S2Region object that +// represents a polygon. A polygon is defined by zero or more loops; recall +// that the interior of a loop is defined to be its left-hand side (see S2Loop). +// There are two different conventions for creating an S2Polygon: // // - InitNested() expects the input loops to be nested hierarchically. The // polygon interior then consists of the set of points contained by an odd From 4e1ba303e3866366ad6d394b4142a4f9518ea343 Mon Sep 17 00:00:00 2001 From: Ben Guild Date: Mon, 10 Nov 2025 02:58:48 +0900 Subject: [PATCH 2/2] Mark `S2Polyline` as obsolete --- src/s2/s2polyline.h | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/s2/s2polyline.h b/src/s2/s2polyline.h index d914bc14f..9812fcff3 100644 --- a/src/s2/s2polyline.h +++ b/src/s2/s2polyline.h @@ -50,9 +50,10 @@ class S2LatLng; class S2PolylineCoder; struct S2XYZFaceSiTi; -// An S2Polyline represents a sequence of zero or more vertices connected by -// straight edges (geodesics). Edges of length 0 and 180 degrees are not -// allowed, i.e. adjacent vertices should not be identical or antipodal. +// Obsolete, see S2LaxPolylineShape. An S2Polyline represents a sequence +// of zero or more vertices connected by straight edges (geodesics). +// Edges of length 0 and 180 degrees are not allowed, i.e. adjacent +// vertices should not be identical or antipodal. class S2Polyline final : public S2Region { public: typedef s2coding::internal::S2LegacyHintCoder Coder;