mirror of
https://github.com/golang/go
synced 2024-10-01 05:28:33 -06:00
1c78e26233
Instead of defaulting to a one sentence synopsis for documentation on hover, allow the user to configure the amount of documentation they want to see. Right now, the options are none, some (using go/doc.Synopsis), or all. We should add a 4th, single-line, mode, which will allow clients like vim-go to stop stripping off documentation on hover. Updates golang/go#32561 Change-Id: I529242da84b794636984d5ef2918b7252886f0ef Reviewed-on: https://go-review.googlesource.com/c/tools/+/184797 Run-TryBot: Rebecca Stambler <rstambler@golang.org> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Ian Cottrell <iancottrell@google.com>
71 lines
1.6 KiB
Go
71 lines
1.6 KiB
Go
// Copyright 2019 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package lsp
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
|
|
"golang.org/x/tools/internal/lsp/protocol"
|
|
"golang.org/x/tools/internal/lsp/source"
|
|
"golang.org/x/tools/internal/span"
|
|
)
|
|
|
|
func (s *Server) hover(ctx context.Context, params *protocol.TextDocumentPositionParams) (*protocol.Hover, error) {
|
|
uri := span.NewURI(params.TextDocument.URI)
|
|
view := s.session.ViewOf(uri)
|
|
f, m, err := getGoFile(ctx, view, uri)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
spn, err := m.PointSpan(params.Position)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
identRange, err := spn.Range(m.Converter)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
ident, err := source.Identifier(ctx, view, f, identRange.Start)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
hover, err := ident.Hover(ctx, s.preferredContentFormat == protocol.Markdown, s.hoverKind)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
identSpan, err := ident.Range.Span()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
rng, err := m.Range(identSpan)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &protocol.Hover{
|
|
Contents: protocol.MarkupContent{
|
|
Kind: s.preferredContentFormat,
|
|
Value: hover,
|
|
},
|
|
Range: &rng,
|
|
}, nil
|
|
}
|
|
|
|
func markupContent(decl, doc string, kind protocol.MarkupKind) protocol.MarkupContent {
|
|
result := protocol.MarkupContent{
|
|
Kind: kind,
|
|
}
|
|
switch kind {
|
|
case protocol.PlainText:
|
|
result.Value = decl
|
|
case protocol.Markdown:
|
|
result.Value = "```go\n" + decl + "\n```"
|
|
}
|
|
if doc != "" {
|
|
result.Value = fmt.Sprintf("%s\n%s", doc, result.Value)
|
|
}
|
|
return result
|
|
}
|