all: fix some comments (#296)

Signed-off-by: cui fliter <imcusg@gmail.com>

cmd/aefix/typecheck.go

@@ -223,7 +223,7 @@ func makeExprList(a []*ast.Ident) []ast.Expr {
 	return b
 }
 
-// Typecheck1 is the recursive form of typecheck.
+// typecheck1 is the recursive form of typecheck.
 // It is like typecheck but adds to the information in typeof
 // instead of allocating a new map.
 func typecheck1(cfg *TypeConfig, f interface{}, typeof map[interface{}]string, assign map[string][]interface{}) {

datastore/query.go

@@ -754,7 +754,7 @@ func (c Cursor) String() string {
 	return strings.TrimRight(base64.URLEncoding.EncodeToString(b), "=")
 }
 
-// Decode decodes a cursor from its base-64 string representation.
+// DecodeCursor decodes a cursor from its base-64 string representation.
 func DecodeCursor(s string) (Cursor, error) {
 	if s == "" {
 		return Cursor{&zeroCC}, nil

delay/delay.go

@@ -297,7 +297,7 @@ func (f *Function) Task(args ...interface{}) (*taskqueue.Task, error) {
 	}, nil
 }
 
-// Request returns the special task-queue HTTP request headers for the current
+// RequestHeaders returns the special task-queue HTTP request headers for the current
 // task queue handler. Returns an error if called from outside a delay.Func.
 func RequestHeaders(c context.Context) (*taskqueue.RequestHeaders, error) {
 	if ret, ok := c.Value(headersContextKey).(*taskqueue.RequestHeaders); ok {

internal/identity.go

@@ -34,7 +34,7 @@ func IsStandard() bool {
 	return appengineStandard || IsSecondGen()
 }
 
-// IsStandard is the implementation of the wrapper function of the same name in
+// IsSecondGen is the implementation of the wrapper function of the same name in
 // ../appengine.go. See that file for commentary.
 func IsSecondGen() bool {
 	// Second-gen runtimes set $GAE_ENV so we use that to check if we're on a second-gen runtime.

taskqueue/taskqueue.go

@@ -62,7 +62,7 @@ type RetryOptions struct {
 	ApplyZeroMaxDoublings bool
 }
 
-// toRetryParameter converts RetryOptions to pb.TaskQueueRetryParameters.
+// toRetryParameters converts RetryOptions to pb.TaskQueueRetryParameters.
 func (opt *RetryOptions) toRetryParameters() *pb.TaskQueueRetryParameters {
 	params := &pb.TaskQueueRetryParameters{}
 	if opt.RetryLimit > 0 {

v2/cmd/aefix/typecheck.go

@@ -223,7 +223,7 @@ func makeExprList(a []*ast.Ident) []ast.Expr {
 	return b
 }
 
-// Typecheck1 is the recursive form of typecheck.
+// typecheck1 is the recursive form of typecheck.
 // It is like typecheck but adds to the information in typeof
 // instead of allocating a new map.
 func typecheck1(cfg *TypeConfig, f interface{}, typeof map[interface{}]string, assign map[string][]interface{}) {

v2/datastore/query.go

@@ -754,7 +754,7 @@ func (c Cursor) String() string {
 	return strings.TrimRight(base64.URLEncoding.EncodeToString(b), "=")
 }
 
-// Decode decodes a cursor from its base-64 string representation.
+// DecodeCursor decodes a cursor from its base-64 string representation.
 func DecodeCursor(s string) (Cursor, error) {
 	if s == "" {
 		return Cursor{&zeroCC}, nil

v2/delay/delay.go

@@ -304,7 +304,7 @@ func (f *Function) Task(args ...interface{}) (*taskqueue.Task, error) {
 	}, nil
 }
 
-// Request returns the special task-queue HTTP request headers for the current
+// RequestHeaders returns the special task-queue HTTP request headers for the current
 // task queue handler. Returns an error if called from outside a delay.Func.
 func RequestHeaders(c context.Context) (*taskqueue.RequestHeaders, error) {
 	if ret, ok := c.Value(headersContextKey).(*taskqueue.RequestHeaders); ok {

v2/internal/identity.go

@@ -38,7 +38,7 @@ func IsStandard() bool {
 	return IsSecondGen()
 }
 
-// IsStandard is the implementation of the wrapper function of the same name in
+// IsSecondGen is the implementation of the wrapper function of the same name in
 // ../appengine.go. See that file for commentary.
 func IsSecondGen() bool {
 	// Second-gen runtimes set $GAE_ENV so we use that to check if we're on a second-gen runtime.

v2/taskqueue/taskqueue.go

@@ -62,7 +62,7 @@ type RetryOptions struct {
 	ApplyZeroMaxDoublings bool
 }
 
-// toRetryParameter converts RetryOptions to pb.TaskQueueRetryParameters.
+// toRetryParameters converts RetryOptions to pb.TaskQueueRetryParameters.
 func (opt *RetryOptions) toRetryParameters() *pb.TaskQueueRetryParameters {
 	params := &pb.TaskQueueRetryParameters{}
 	if opt.RetryLimit > 0 {