You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
garble/testdata/scripts
Daniel Martí fceb19f6da
deprecate using GOPRIVATE in favor of GOGARBLE (#427)
Piggybacking off of GOPRIVATE is great for a number of reasons:

* People tend to obfuscate private code, whose package paths will
  generally be in GOPRIVATE already

* Its meaning and syntax are well understood

* It allows all the flexibility we need without adding our own env var
  or config option

However, using GOPRIVATE directly has one main drawback.
It's fairly common to also want to obfuscate public dependencies,
to make the code in private packages even harder to follow.
However, using "GOPRIVATE=*" will result in two main downsides:

* GONOPROXY defaults to GOPRIVATE, so the proxy would be entirely disabled.
  Downloading modules, such as when adding or updating dependencies,
  or when the local cache is cold, can be less reliable.

* GONOSUMDB defaults to GOPRIVATE, so the sumdb would be entirely disabled.
  Adding entries to go.sum, such as when adding or updating dependencies,
  can be less secure.

We will continue to consume GOPRIVATE as a fallback,
but we now expect users to set GOGARBLE instead.
The new logic is documented in the README.

While here, rewrite some uses of "private" with "to obfuscate",
to make the code easier to follow and harder to misunderstand.

Fixes #276.
4 years ago
..
asm.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
basic.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
cgo.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
crossbuild.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
debugdir.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
embed.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
gogarble.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
goversion.txt drop support for Go 1.16.x 4 years ago
help.txt always require one argument for "reverse" 4 years ago
implement.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
imports.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
init.txt drop support for Go 1.16.x 4 years ago
ldflags.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
linkname.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
literals.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
modinfo.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
plugin.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
position.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
reflect.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
reverse.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
runtime-related.txt Obfuscate more packages of the standard library (#312) 4 years ago
seed.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
syntax.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago
test.txt drop support for Go 1.16.x 4 years ago
tiny.txt deprecate using GOPRIVATE in favor of GOGARBLE (#427) 4 years ago