godoc feature request '--exclude-dir'

[mz3co...@gmail.com]

Good time of day.

I use go and godoc, and have a lot of pleasure of this.

But I have some gotcha. I need an option to '-exclude some paths' from
godoc scan paths.

My $GOPATH point to $HOME/go. I write code into $HOME/go/src/local and
use 'go install'. Also I use 'go get' and receive github.com-packages
into $HOME/go/src. I consider it good. And I like to see these package's
documentation through godoc.

But my source path ($HOME/go/src) contains many examples. All of such
examples are in path $HOME/go/src/local/.
When I use 'godoc -http=:6060' all of this examples falls into godoc
scan path and clogs the output package list just by its presence.

In most cases I unset $GOPATH before godoc call in a shell script to
see only go-language documentation. But for gitub.com-package
documentation I cannot do that. And it cause that packages-page in my
browser is clogged by more than one hundred of examples.

I don't want to move examples from src-path - many of this are useful
for me.

Please, add the feature like --exclude "paths" to make this world better.

Thank you for spending your time to read this.
Sorry for my bad english - I'm only a coder, not a writer.

WBR, Marat.

[minux]

On Fri, Dec 6, 2013 at 9:25 PM, <mz3co...@gmail.com> wrote:

Good time of day.

I use go and godoc, and have a lot of pleasure of this.

But I have some gotcha. I need an option to '-exclude some paths' from
godoc scan paths.

My $GOPATH point to $HOME/go. I write code into $HOME/go/src/local and
use 'go install'. Also I use 'go get' and receive github.com-packages
into $HOME/go/src. I consider it good. And I like to see these package's
documentation through godoc.

But my source path ($HOME/go/src) contains many examples. All of such
examples are in path $HOME/go/src/local/.
When I use 'godoc -http=:6060' all of this examples falls into godoc
scan path and clogs the output package list just by its presence.

Do you know that you can set multiple directory paths in $GOPATH?

you can arrange to put your local packages in a local GOPATH, and 3rd-party packages

in another, and set

GOPATH=~/go/local:~/go/3rdparty 

for the Go command.

When you only need the documentation for 3rdparty packages, you can use

GOPATH=~/go/3rdparty godoc

And because of this, I think godoc doesn't need the -exclude path feature.

[Marat Kagarmanov]

Ok, proposed workaround is quite usable.

Thanks you, minux.