mirror
/
go
mirror of https://github.com/golang/go.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

go/analysis: document need for deterministic Fact encoding 

Change-Id: I5a1b537f5ba14405fa1e9916b6d63e4fc7e5db45
Reviewed-on: https://go-review.googlesource.com/c/tools/+/410364
Reviewed-by: Hyang-Ah Hana Kim <hyangah@gmail.com>
This commit is contained in:
Alan Donovan 2022-06-06 11:22:29 -04:00
parent af82757ce0
commit 43cce678a1
1 changed files with 3 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
go/analysis/doc.go
View File

@ -241,6 +241,9 @@ Consequently, Facts must be serializable. The API requires that drivers
use the gob encoding, an efficient, robust, self-describing binary
protocol. A fact type may implement the GobEncoder/GobDecoder interfaces
if the default encoding is unsuitable. Facts should be stateless.
Because serialized facts may appear within build outputs, the gob encoding
of a fact must be deterministic, to avoid spurious cache misses in
build systems that use content-addressable caches.
The Pass type has functions to import and export facts,
associated either with an object or with a package: