1
0
mirror of https://github.com/golang/go synced 2024-11-05 16:46:10 -07:00

tools/cmd/vet: Incorporate comments from r@.

This commit fixes a few defects from a25a8d567b:

(1.) Making the top-level vars in main consistent w.r.t. documentation
     formatting, and the-like.

(2.) Removing of one-use top-level is-test predicate.

(3.) Including documentation of what the validation does and when.

Change-Id: I19b34d25836bb2af865219d18600e1add78c3fd7
Reviewed-on: https://go-review.googlesource.com/14557
Reviewed-by: Rob Pike <r@golang.org>
This commit is contained in:
Matt T. Proud 2015-09-15 16:56:48 +02:00 committed by Rob Pike
parent a25a8d567b
commit 871b75fbfc
3 changed files with 14 additions and 7 deletions

View File

@ -165,6 +165,13 @@ Flag: -shift
Shifts equal to or longer than the variable's length. Shifts equal to or longer than the variable's length.
Documentation examples
Flag: -example
Mistakes involving example tests, including examples with incorrect names or
function signatures, or that document identifiers not in the package.
Other flags Other flags
These flags configure the behavior of vet: These flags configure the behavior of vet:

View File

@ -24,7 +24,7 @@ func isExampleSuffix(s string) bool { return strings.ToLower(s) == s }
// mistakes of misnamed functions, failure to map functions to existing // mistakes of misnamed functions, failure to map functions to existing
// identifiers, etc. // identifiers, etc.
func checkExample(f *File, node ast.Node) { func checkExample(f *File, node ast.Node) {
if !f.IsTest() { if !strings.HasSuffix(f.name, "_test.go") {
return return
} }
var ( var (

View File

@ -53,11 +53,13 @@ var experimental = map[string]bool{}
// setTrueCount record how many flags are explicitly set to true. // setTrueCount record how many flags are explicitly set to true.
var setTrueCount int var setTrueCount int
var ( // dirsRun and filesRun indicate whether the vet is applied to directory or
dirsRun, filesRun bool // file targets. The distinction affects which checks are run.
var dirsRun, filesRun bool
includesNonTest bool // includesNonTest indicates whether the vet is applied to non-test targets.
) // Certain checks are relevant only if they touch both test and non-test files.
var includesNonTest bool
// A triState is a boolean that knows whether it has been set to either true or false. // A triState is a boolean that knows whether it has been set to either true or false.
// It is used to identify if a flag appears; the standard boolean flag cannot // It is used to identify if a flag appears; the standard boolean flag cannot
@ -193,8 +195,6 @@ type File struct {
checkers map[ast.Node][]func(*File, ast.Node) checkers map[ast.Node][]func(*File, ast.Node)
} }
func (f *File) IsTest() bool { return strings.HasSuffix(f.name, "_test.go") }
func main() { func main() {
flag.Usage = Usage flag.Usage = Usage
flag.Parse() flag.Parse()