os: document FileInfo.Size as system-dependent for irregular files

R=rsc, r
CC=golang-dev
https://golang.org/cl/5795059

diff --git a/src/pkg/os/types.go b/src/pkg/os/types.go
index c7c5199be1c04365815e838e5a83335356d13074..01dddf50de0428fa8c46c9814f79b255960aeffc 100644 (file)
--- a/src/pkg/os/types.go
+++ b/src/pkg/os/types.go
@@ -15,7 +15,7 @@ func Getpagesize() int { return syscall.Getpagesize() }
 // A FileInfo describes a file and is returned by Stat and Lstat
 type FileInfo interface {
        Name() string       // base name of the file
-       Size() int64        // length in bytes
+       Size() int64        // length in bytes for regular files; system-dependent for others
        Mode() FileMode     // file mode bits
        ModTime() time.Time // modification time
        IsDir() bool        // abbreviation for Mode().IsDir()