go.tools: various comments + doc tweaks.

No functional changes.

LGTM=gri
R=gri
CC=golang-codereviews
https://golang.org/cl/74270043
diff --git a/go/pointer/gen.go b/go/pointer/gen.go
index 77cf159..fdd2370 100644
--- a/go/pointer/gen.go
+++ b/go/pointer/gen.go
@@ -1103,6 +1103,10 @@
 	r.String()      // (asserts that it doesn't crash)
 	root := a.makeCGNode(r, 0, nil)
 
+	// TODO(adonovan): make an ssa utility to construct an actual
+	// root function so we don't need to special-case site-less
+	// call edges.
+
 	// For each main package, call main.init(), main.main().
 	for _, mainPkg := range a.config.Mains {
 		main := mainPkg.Func("main")