os: clarify that OpenFile reqires one of O_RDONLY/O_WRONLY/O_RDWR

ianlancetaylor · ianlancetaylor · commit 94d937178039 · 2017-10-31T03:23:10.000Z
Fixes #21322. Change-Id: Ia589c576be0b5cdb7cde5d35cd857ad7c93c372b Reviewed-on: https://go-review.googlesource.com/74550 Reviewed-by: Robert Griesemer <gri@golang.org>
diff --git a/src/os/file.go b/src/os/file.go
@@ -60,7 +60,8 @@ var (
 )
 
 // Flags to OpenFile wrapping those of the underlying system. Not all
-// flags may be implemented on a given system.
+// flags may be implemented on a given system. Each call to OpenFile
+// should specify exactly one of O_RDONLY, O_WRONLY, or O_RDWR.
 const (
 	O_RDONLY int = syscall.O_RDONLY // open the file read-only.
 	O_WRONLY int = syscall.O_WRONLY // open the file write-only.

Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,8 @@ var (`
`60`	`60`	`)`
`61`	`61`
`62`	`62`	`// Flags to OpenFile wrapping those of the underlying system. Not all`
`63`		`-// flags may be implemented on a given system.`
	`63`	`+// flags may be implemented on a given system. Each call to OpenFile`
	`64`	`+// should specify exactly one of O_RDONLY, O_WRONLY, or O_RDWR.`
`64`	`65`	`const (`
`65`	`66`	`O_RDONLY int = syscall.O_RDONLY // open the file read-only.`
`66`	`67`	`O_WRONLY int = syscall.O_WRONLY // open the file write-only.`