From 00ae8a464ae040ddf551bc2cd87466cf9bcd6760 Mon Sep 17 00:00:00 2001
From: Rob Pike
Date: Tue, 12 Aug 2014 15:28:45 -0700
Subject: syscall: freeze the package Add a clause to the doc comment for the
package and a paragraph in the compatibility document explaining the
situation.
LGTM=bradfitz, adg, rsc
R=golang-codereviews, adg, bradfitz, minux, rsc
CC=golang-codereviews
https://codereview.appspot.com/129820043
---
doc/go1compat.html | 14 ++++++++++++++
1 file changed, 14 insertions(+)
(limited to 'doc')
diff --git a/doc/go1compat.html b/doc/go1compat.html
index d10b9af29..2c8d21484 100644
--- a/doc/go1compat.html
+++ b/doc/go1compat.html
@@ -152,6 +152,20 @@ will be tagged as appropriate to identify versions that are compatible
with the Go 1 point releases.
+Operating systems
+
+
+It is impossible to guarantee long-term compatibility with operating
+system interfaces, which are changed by outside parties.
+The syscall
package
+is therefore outside the purview of the guarantees made here.
+As of Go version 1.4, the syscall
package is frozen.
+Any evolution of the system call interface must be supported elsewhere,
+such as in the go.sys
subrepository.
+For details and background, see
+this document.
+
+
--
cgit v1.2.1