go/types: mention FakeImportC in Package.Import doc comment

Change-Id: If4a82893f855d86de3311247424b1a3740c1f212
Reviewed-on: https://go-review.googlesource.com/c/go/+/443615
Reviewed-by: Robert Griesemer <gri@google.com>
Run-TryBot: Alan Donovan <adonovan@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>

diff --git a/src/cmd/compile/internal/types2/package.go b/src/cmd/compile/internal/types2/package.go
index 26f10645d28be6eeba0ad5b1df4d1265e397a28f..61670f67181ec71fdccb6f94a45ffa01028bd257 100644 (file)
--- a/src/cmd/compile/internal/types2/package.go
+++ b/src/cmd/compile/internal/types2/package.go
@@ -59,6 +59,9 @@ func (pkg *Package) MarkComplete() { pkg.complete = true }
 // If pkg was loaded from export data, Imports includes packages that
 // provide package-level objects referenced by pkg. This may be more or
 // less than the set of packages directly imported by pkg's source code.
+//
+// If pkg uses cgo and the FakeImportC configuration option
+// was enabled, the imports list may contain a fake "C" package.
 func (pkg *Package) Imports() []*Package { return pkg.imports }
 
 // SetImports sets the list of explicitly imported packages to list.

diff --git a/src/go/types/package.go b/src/go/types/package.go
index 26385dc39b95fbe41b382f1477cb8f00af5f807c..2b72ff15092ece316a9dd39da8200cec81a5aa1b 100644 (file)
--- a/src/go/types/package.go
+++ b/src/go/types/package.go
@@ -60,6 +60,9 @@ func (pkg *Package) MarkComplete() { pkg.complete = true }
 // If pkg was loaded from export data, Imports includes packages that
 // provide package-level objects referenced by pkg. This may be more or
 // less than the set of packages directly imported by pkg's source code.
+//
+// If pkg uses cgo and the FakeImportC configuration option
+// was enabled, the imports list may contain a fake "C" package.
 func (pkg *Package) Imports() []*Package { return pkg.imports }
 
 // SetImports sets the list of explicitly imported packages to list.