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
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<S2Polyline> Coder;