diff options
| author | Rob Pike <r@golang.org> | 2014-10-01 15:25:56 -0700 |
|---|---|---|
| committer | Rob Pike <r@golang.org> | 2014-10-01 15:25:56 -0700 |
| commit | dba2faf2c60bd3bf249641c7f09af2cbc984f645 (patch) | |
| tree | 34011ee3851d8b7826dae9d0c9ecc5d5a28456ed | |
| parent | 9f4084278fd0038ef4deedab78ee4d7d2bc1a636 (diff) | |
| download | go-dba2faf2c60bd3bf249641c7f09af2cbc984f645.tar.xz | |
doc/go_faq.html: explain the policy about unused imports a little better
This new text won't stop the whining but it might focus the whining a little more.
LGTM=adg
R=golang-codereviews, adg
CC=golang-codereviews
https://golang.org/cl/146680044
| -rw-r--r-- | doc/go_faq.html | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/go_faq.html b/doc/go_faq.html index 5813e1d047..ec3689aeb0 100644 --- a/doc/go_faq.html +++ b/doc/go_faq.html @@ -1661,14 +1661,17 @@ Can I stop these complaints about my unused variable/import?</h3> <p> The presence of an unused variable may indicate a bug, while -unused imports just slow down compilation. -Accumulate enough unused imports in your code tree and -things can get very slow. -For these reasons, Go allows neither. +unused imports just slow down compilation, +an effect that can become substantial as a program accumulates +code and programmers over time. +For these reasons, Go refuses to compile programs with unused +variables or imports, +trading short-term convenience for long-term build speed and +program clarity. </p> <p> -When developing code, it's common to create these situations +Still, when developing code, it's common to create these situations temporarily and it can be annoying to have to edit them out before the program will compile. </p> |
