Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

cmd/vet: Docs missing headings #18758

Closed
akshayjshah opened this issue Jan 23, 2017 · 1 comment
Closed

cmd/vet: Docs missing headings #18758

akshayjshah opened this issue Jan 23, 2017 · 1 comment

Comments

@akshayjshah
Copy link
Contributor

What version of Go are you using (go version)?

go version go1.7.4 darwin/amd64

What operating system and processor architecture are you using (go env)?

GOARCH="amd64"
GOBIN=""
GOEXE=""
GOHOSTARCH="amd64"
GOHOSTOS="darwin"
GOOS="darwin"
GOPATH="/Users/ashah"
GORACE=""
GOROOT="/usr/local/Cellar/go/1.7.4_2/libexec"
GOTOOLDIR="/usr/local/Cellar/go/1.7.4_2/libexec/pkg/tool/darwin_amd64"
CC="clang"
GOGCCFLAGS="-fPIC -m64 -pthread -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/3m/040fyqk55px9hk_9hqqy0jn80000gn/T/go-build911511586=/tmp/go-build -gno-record-gcc-switches -fno-common"
CXX="clang++"
CGO_ENABLED="1"

What did you do?

I checked the documentation for cmd/vet, by both running go doc cmd/vet and visiting https://golang.org/cmd/vet/.

What did you expect to see?

I expected to see a heading and an accompanying table of contents entry for each of the options listed in go tool vet -h.

What did you see instead?

In both my local docs output and the online docs, there appear to be a number of missing headings. This makes both the table of contents and the document body rather confusing.

For example, there's no heading for the -tests flag; the docs are included under the section on copying locks, which doesn't make much sense.

Even more confusing, the section on struct tags doesn't contain any information about struct tags at all. Instead, it contains the documentation for -rangeloops.

If this is indeed a bug (and not just an organizational scheme I'm not grokking), I'm happy to open a CL to fix it.

@vcabbage
Copy link
Member

Fixed for 1.8 by https://golang.org/cl/29340/ and https://golang.org/cl/31319/. You can view the pre-release docs here: https://beta.golang.org/cmd/vet/.

I'm going to go ahead an close this, feel free to reopen if there are any additional formatting errors not addressed.

@golang golang locked and limited conversation to collaborators Jan 23, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

3 participants