os: be explicit in the package comment that this package is for portable features...

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

diff --git a/src/pkg/os/file.go b/src/pkg/os/file.go
index dff8fa862cee8de54f93de8553513ada7ec6a16b..0e97e0bd9379418d4a0710feacc3539ad97c727f 100644 (file)
--- a/src/pkg/os/file.go
+++ b/src/pkg/os/file.go
@@ -4,6 +4,8 @@
 
 // Package os provides a platform-independent interface to operating system
 // functionality.  The design is Unix-like.
+// The os interface is intended to be uniform across all operating systems.
+// Features not generally available appear in the system-specific package syscall.
 package os
 
 import (