]> Cypherpunks repositories - gostls13.git/commitdiff
runtime/pprof: restore articles in type doc comments
authorRuss Cox <rsc@golang.org>
Fri, 31 Aug 2012 17:49:57 +0000 (13:49 -0400)
committerRuss Cox <rsc@golang.org>
Fri, 31 Aug 2012 17:49:57 +0000 (13:49 -0400)
Reverts part of CL 6460082.

If a doc comment describes a type by explaining the
meaning of one instance of the type, a leading article
is fine and makes the text less awkward.

Compare:
// A dog is a kind of animal.
// Dog is a kind of animal.

R=golang-dev, dsymonds, dvyukov, r
CC=golang-dev
https://golang.org/cl/6494066

src/pkg/runtime/pprof/pprof.go

index 5a07b9421b2ccb557b2c37038641d241c5da3b4f..189500adbbf7a41255656565f8a26a5f83073482 100644 (file)
@@ -23,7 +23,7 @@ import (
 // BUG(rsc): A bug in the OS X Snow Leopard 64-bit kernel prevents
 // CPU profiling from giving accurate results on that system.
 
-// Profile is a collection of stack traces showing the call sequences
+// Profile is a collection of stack traces showing the call sequences
 // that led to instances of a particular event, such as allocation.
 // Packages can create and maintain their own profiles; the most common
 // use is for tracking resources that must be explicitly closed, such as files
@@ -250,7 +250,7 @@ func (x stackProfile) Less(i, j int) bool {
        return len(t) < len(u)
 }
 
-// countProfile is a set of stack traces to be printed as counts
+// countProfile is a set of stack traces to be printed as counts
 // grouped by stack trace.  There are multiple implementations:
 // all that matters is that we can find out how many traces there are
 // and obtain each trace in turn.