Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
x/tools/cmd/godoc: analysis mode is too hard/slow/fragile #8968
I'm watching a friend trying to use godoc -analysis mode and it's apparent that there are a few areas for improvement: -- when a package has a parse error, just skip that package. Blake has $GOPATH=$HOME and $HOME/src/** also has non-Go stuff, like Postgres. And Postgres has its own *.s files, which aren't Go-style assembly. So godoc barfs. -- analysis mode is too slow with a large GOPATH, and he has a large GOPATH. Our next attempt was to make a new GOPATH just for godoc -analysis with symlinks to the subset of packages we care about. But godoc and/or -analysis don't get along well with symlinks. So: -- perhaps godoc needs its own -analysis-filter=[pattern] flag for a regexp or comma-separated list of packages / globs (implicitly including all dependent packages thereof). e.g. --analysis-filter=foo.com/...,bar.com/baz,github.com/bradfitz/bar/... -- log progress output in verbose mode? sometimes we think it's hung. Some reassuring progress would be nice. Thanks!