Request: "gopherjs doc" command

[flimzy]

Having GopherJS-specific versions of 'go doc' and 'godoc' would be nice.

This could possibly help address the documentation issues mentioned here.

An effectively duplicate feature request already exists on godoc, to support build tag in the official godoc package. But until that's accomplished, supporting it here might be worth while.

Thoughts @neelance , @shurcooL ? If it's deemed a good idea, I may try to work on this myself.

[dmitshur]

Related issue and PR:

golang/gddo#342
golang/gddo#343

Given that's done, can you elaborate what exactly are you looking for? What problem are you trying to resolve?

[flimzy]

I guess I hadn't remembered all the details of those bugs/PRs, despite my involvement in them.

It does accomplish what I had in mind, by use of GOARCH=js godoc ....

[flimzy]

Maybe it would be worth considering making gopherjs doc run GOARCH=js go doc? I think similar proposals have been considered for other commands. I don't remember what conclusions were reached...

[dmitshur]

Maybe it would be worth considering making gopherjs doc run GOARCH=js go doc?

That's worth considering, because it's very low extra maintenance cost and doesn't deviate us further away from normal Go.

We currently do that for gopherjs get only.

[flimzy]

I'll see about throwing together a PR for that then, since it does sound quite simple.

[dmitshur]

Let's decide that we want to do this, since we're still on the "considering" stage. The implementation is indeed trivial.

@neelance What do you think about this?

[neelance]

Sure, why not. It is useful and it adds no complexity.