From: Russ Cox <rsc@golang.org>
Date: Sat, 22 Dec 2012 18:36:39 +0000 (-0500)
Subject: fmt: document width and flags a bit more
X-Git-Tag: go1.1rc2~1551
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=1cad1f8d1c605e527422b569e9daabc60c66f936;p=gostls13.git

fmt: document width and flags a bit more

Fixes #4581.

R=golang-dev, bradfitz
CC=golang-dev
https://golang.org/cl/7000052
---

diff --git a/src/pkg/fmt/doc.go b/src/pkg/fmt/doc.go
index ff947b68a7..2c925a4228 100644
--- a/src/pkg/fmt/doc.go
+++ b/src/pkg/fmt/doc.go
@@ -63,9 +63,10 @@
 	The default precision for %e and %f is 6; for %g it is the smallest
 	number of digits necessary to identify the value uniquely.
 
-	For strings, width is the minimum number of characters to output,
-	padding with spaces if necessary, and precision is the maximum
-	number of characters to output, truncating if necessary.
+	For most values, width is the minimum number of characters to output,
+	padding the formatted form with spaces if necessary.
+	For strings, precision is the maximum number of characters to output,
+	truncating if necessary.
 
 	Other flags:
 		+	always print a sign for numeric values;
@@ -77,7 +78,12 @@
 			write e.g. U+0078 'x' if the character is printable for %U (%#U).
 		' '	(space) leave a space for elided sign in numbers (% d);
 			put spaces between bytes printing strings or slices in hex (% x, % X)
-		0	pad with leading zeros rather than spaces
+		0	pad with leading zeros rather than spaces;
+			for numbers, this moves the padding after the sign
+
+	Flags are ignored by verbs that do not expect them.
+	For example there is no alternate decimal format, so %#d and %d
+	behave identically.
 
 	For each Printf-like function, there is also a Print function
 	that takes no format and is equivalent to saying %v for every