From: Rob Pike <r@golang.org>
Date: Fri, 13 Nov 2009 21:15:18 +0000 (-0800)
Subject: Explain why
X-Git-Tag: weekly.2009-11-17~78
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=f9919ba323417aabd56b33403fe4568669ba62b3;p=gostls13.git

Explain why
	-flag true
does not work although
	-flag=true
does.

Fixes #139.

R=iant
CC=golang-dev
https://golang.org/cl/154118
---

diff --git a/src/pkg/flag/flag.go b/src/pkg/flag/flag.go
index ff72c08e24..0471d126c0 100644
--- a/src/pkg/flag/flag.go
+++ b/src/pkg/flag/flag.go
@@ -31,8 +31,13 @@
 	Command line flag syntax:
 		-flag
 		-flag=x
-		-flag x
+		-flag x  // non-boolean flags only
 	One or two minus signs may be used; they are equivalent.
+	The last form is not permitted for boolean flags because the
+	meaning of the command
+		cmd -x *
+	will change if there is a file called 0, false, etc.  You must
+	use the -flag=false form to turn off a boolean flag.
 
 	Flag parsing stops just before the first non-flag argument
 	("-" is a non-flag argument) or after the terminator "--".