From 4b6ee5fb873dbd9210d5e0db7bdb0ee4f501aeaf Mon Sep 17 00:00:00 2001 From: Michael Matloob Date: Fri, 12 Oct 2018 16:29:09 -0400 Subject: [PATCH] go/packages: remove scary warning on documentation Add a guarantee for breaking changes. Change-Id: I7c176eb0c3a309ad187e3a33a645996e397d09be Reviewed-on: https://go-review.googlesource.com/c/141684 Reviewed-by: Alan Donovan --- go/packages/doc.go | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/go/packages/doc.go b/go/packages/doc.go index 61933de8def..f9dd1b02379 100644 --- a/go/packages/doc.go +++ b/go/packages/doc.go @@ -5,11 +5,10 @@ /* Package packages loads Go packages for inspection and analysis. -NOTE: THIS PACKAGE IS NOT YET READY FOR WIDESPREAD USE: - - The interface is still being revised and minor changes are likely. - - The implementation depends on the Go 1.11 go command; - support for earlier versions will be added soon. - - We intend to finalize the API before Go 1.11 is released. +Note: Though this package is ready for widespread use, we may make minor +breaking changes if absolutely necessary. Any such change will be +announced on golang-tools@ at least one week before it is committed. No +more breaking changes will be made after December 1, 2018. The Load function takes as input a list of patterns and return a list of Package structs describing individual packages matched by those patterns.