all: fix some comments

Change-Id: Ic2005390185150566bbd791ccc5661d216a648ee
Reviewed-on: https://go-review.googlesource.com/c/text/+/713440
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
Auto-Submit: Dmitri Shuralyov <dmitshur@golang.org>
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@google.com>
LUCI-TryBot-Result: golang-scoped@luci-project-accounts.iam.gserviceaccount.com <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
diff --git a/cases/context.go b/cases/context.go
index e9aa9e1..a28f45d 100644
--- a/cases/context.go
+++ b/cases/context.go
@@ -249,7 +249,7 @@
 	return c.copy()
 }
 
-// isUpper writes the isUppercase version of the current rune to dst.
+// isUpper reports whether the current rune is in upper case.
 func isUpper(c *context) bool {
 	ct := c.caseType()
 	if c.info&hasMappingMask == 0 || ct == cUpper {
diff --git a/cases/map.go b/cases/map.go
index 0f7c6a1..51a6830 100644
--- a/cases/map.go
+++ b/cases/map.go
@@ -774,7 +774,7 @@
 	// From CLDR:
 	// # Special titlecasing for Dutch initial "ij".
 	// ::Any-Title();
-	// # Fix up Ij at the beginning of a "word" (per Any-Title, notUAX #29)
+	// # Fix up Ij at the beginning of a "word" (per Any-Title, not UAX #29)
 	// [:^WB=ALetter:] [:WB=Extend:]* [[:WB=MidLetter:][:WB=MidNumLet:]]? { Ij } → IJ ;
 	if c.src[c.pSrc] != 'I' && c.src[c.pSrc] != 'i' {
 		return title(c)
@@ -794,7 +794,7 @@
 	// From CLDR:
 	// # Special titlecasing for Dutch initial "ij".
 	// ::Any-Title();
-	// # Fix up Ij at the beginning of a "word" (per Any-Title, notUAX #29)
+	// # Fix up Ij at the beginning of a "word" (per Any-Title, not UAX #29)
 	// [:^WB=ALetter:] [:WB=Extend:]* [[:WB=MidLetter:][:WB=MidNumLet:]]? { Ij } → IJ ;
 	if c.src[c.pSrc] != 'I' {
 		return isTitle(c)
diff --git a/collate/collate.go b/collate/collate.go
index 449c73c..ee1ccce 100644
--- a/collate/collate.go
+++ b/collate/collate.go
@@ -200,8 +200,8 @@
 
 // KeyFromString returns the collation key for str.
 // Passing the buffer buf may avoid memory allocations.
-// The returned slice will point to an allocation in Buffer and will retain
-// valid until the next call to buf.ResetKeys().
+// The returned slice will point to an allocation in Buffer and will remain
+// valid until the next call to buf.Reset().
 func (c *Collator) KeyFromString(buf *Buffer, str string) []byte {
 	// See https://www.unicode.org/reports/tr10/#Main_Algorithm for more details.
 	buf.init()
diff --git a/message/fmt_test.go b/message/fmt_test.go
index a8fde6f..a8192d7 100644
--- a/message/fmt_test.go
+++ b/message/fmt_test.go
@@ -1432,7 +1432,7 @@
 		t.Skip("skipping malloc count in short mode")
 	case runtime.GOMAXPROCS(0) > 1:
 		t.Skip("skipping; GOMAXPROCS>1")
-		// TODO: detect race detecter enabled.
+		// TODO: detect race detector enabled.
 		// case race.Enabled:
 		// 	t.Skip("skipping malloc count under race detector")
 	}