From: Rob Pike <r@golang.org>
Date: Tue, 16 Aug 2011 05:24:00 +0000 (+1000)
Subject: builtin: tweak a couple of descriptions.
X-Git-Tag: weekly.2011-08-17~40
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=43d6389397651948cd5f1bb94426d2fc3c14aece;p=gostls13.git

builtin: tweak a couple of descriptions.

R=golang-dev, adg, dsymonds
CC=golang-dev
https://golang.org/cl/4875050
---

diff --git a/src/pkg/builtin/builtin.go b/src/pkg/builtin/builtin.go
index 636aae6934..f835580de8 100644
--- a/src/pkg/builtin/builtin.go
+++ b/src/pkg/builtin/builtin.go
@@ -45,18 +45,20 @@ func copy(dst, src []Type) int
 
 // The len built-in function returns the length of v, according to its type:
 //	Array: the number of elements in v.
-//	Pointer to array: the number of elements in *v.
-//	Slice, or map: the number of elements in v. If v is nil, len(v) is zero.
+//	Pointer to array: the number of elements in *v (even if v is nil).
+//	Slice, or map: the number of elements in v; if v is nil, len(v) is zero.
 //	String: the number of bytes in v.
-//	Channel: the number of elements queued (unread) in the channel buffer.
-//	If v is nil, len(v) is zero.
+//	Channel: the number of elements queued (unread) in the channel buffer;
+//	if v is nil, len(v) is zero.
 func len(v Type) int
 
 // The cap built-in function returns the capacity of v, according to its type:
 //	Array: the number of elements in v (same as len(v)).
 //	Pointer to array: the number of elements in *v (same as len(v)).
-//	Slice: the maximum length the slice can reach when resliced.
-//	Channel: the maximum channel buffer capacity, in units of elements.
+//	Slice: the maximum length the slice can reach when resliced;
+//	if v is nil, cap(v) is zero.
+//	Channel: the channel buffer capacity, in units of elements;
+//	if v is nil, cap(v) is zero.
 func cap(v Type) int
 
 // The make built-in function allocates and initializes an object of type