Add and reformat comments

Add some comments that were being stripped.

Author: jmr

s2/edge_query_test.go

@@ -35,6 +35,7 @@ var (
 	// this flag allows that to happen.
 	//
 	// To set in testing add "--benchmark_edge_query_range=5" to your test command.
+	// When using blaze/bazel add "--test_arg=--benchmark_edge_query_range=5"
 	benchmarkEdgeQueryRange = flag.Int("benchmark_edge_query_range", 7,
 		"Set the upper limit on times to scale up the edge query "+
 			"edge counts in benchmark runs.")

s2/example_test.go

@@ -122,6 +122,13 @@ func ExampleEdgeQuery_FindEdges_findClosestEdges() {
 	polylines := []s2.Polyline{
 		// This is an iteration = 3 Koch snowflake centered at the
 		// center of the continental US.
+		//
+		// This was generated as:
+		//
+		// fractal := newFractal()
+		// fractal.setLevelForApproxMaxEdges(48)
+		// fractal.makeLoop(randomFrameAtPoint(
+		//	PointFromLatLng(LatLngFromDegrees(39.833, -98.55))), s1.Angle(0.15))
 		s2.Polyline{
 			s2.PointFromLatLng(s2.LatLngFromDegrees(47.5467, -103.6035)),
 			s2.PointFromLatLng(s2.LatLngFromDegrees(45.9214, -103.7320)),

s2/loop_test.go

@@ -148,7 +148,7 @@ var (
 		lineTriangle,
 		skinnyChevron,
 		loopA,
-		//snappedLoopA, // Fails TestAreaConsistentWithTurningAngle
+		// snappedLoopA, // Fails TestAreaConsistentWithTurningAngle
 		loopB,
 		aIntersectB,
 		aUnionB,

s2/metric.go

@@ -34,6 +34,9 @@ type Metric struct {
 
 // Defined metrics.
 // Of the projection methods defined in C++, Go only supports the quadratic projection.
+// See
+// https://github.com/google/s2geometry/blob/58de4ea1e2f8a294e0c072c602c22232fd1433ad/src/s2/s2coords.h#L238
+// for more details.
 
 // Each cell is bounded by four planes passing through its four edges and
 // the center of the sphere. These metrics relate to the angle between each

s2/regioncoverer_test.go

@@ -298,6 +298,9 @@ func TestRegionCovererIsCanonical(t *testing.T) {
 	}
 }
 
+// To run these benchmarks with blaze/bazel use:
+// blaze test -c opt --test_output=all --test_arg=--test.bench=BenchmarkRegion --test_arg=--test.benchmem util/geometry/go:s2_test
+
 const numCoveringBMRegions = 1000
 
 func BenchmarkRegionCovererCoveringCap(b *testing.B) {

s2/s2_test.go

@@ -28,6 +28,7 @@ import (
 
 var (
 	// To set in testing add "--benchmark_brute_force=true" to your test command.
+	// When using blaze/bazel add "--test_arg=--benchmark_brute_force=true"
 	benchmarkBruteForce = flag.Bool("benchmark_brute_force", false,
 		"When set, use brute force algorithms in benchmarking.")
 )

s2/stuv.go

@@ -32,7 +32,7 @@ import (
 // transformation is designed to make the cells at each level fairly uniform
 // in size.
 //
-////////////////////////// S2 Cell Decomposition /////////////////////////
+// /////////////////////// S2 Cell Decomposition /////////////////////////
 //
 // The following methods define the cube-to-sphere projection used by
 // the Cell decomposition.