]> Cypherpunks repositories - gostls13.git/commit
cmd/doc, go/doc: add basic support for generic code
authorRobert Findley <rfindley@google.com>
Fri, 29 Oct 2021 21:41:41 +0000 (17:41 -0400)
committerRobert Findley <rfindley@google.com>
Thu, 4 Nov 2021 14:54:46 +0000 (14:54 +0000)
commit00d6d2037ee1bf4b6959219120b79b7c01244b02
treedf2d5504710ef46ce7b3ddc597cf3db3ccb16e89
parent901bf291bc90819cb6dad76064475cf9ecbc9651
cmd/doc, go/doc: add basic support for generic code

Update cmd/doc and go/doc for the generics, by adding handling for type
parameters and the new embedded interface elements.

Specifically:
 - Format type parameters when summarizing type and function nodes.
 - Find the origin type name for instantiation expressions, so that
   methods are associated with generic type declarations.
 - Generalize the handling of embedding 'error' in interfaces to
   arbitrary predeclared types.
 - Keep embedded type literals.
 - Update filtering to descend into embedded type literals.

Also add "any" to the list of predeclared types.

Updates #49210

Change-Id: I6ea82869f19c3cdbc3c842f01581c8fc7e1c2ee7
Reviewed-on: https://go-review.googlesource.com/c/go/+/359778
Trust: Robert Findley <rfindley@google.com>
Run-TryBot: Robert Findley <rfindley@google.com>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Robert Griesemer <gri@golang.org>
src/cmd/doc/pkg.go
src/go/doc/exports.go
src/go/doc/filter.go
src/go/doc/reader.go
src/go/doc/testdata/generics.0.golden [new file with mode: 0644]
src/go/doc/testdata/generics.1.golden [new file with mode: 0644]
src/go/doc/testdata/generics.2.golden [new file with mode: 0644]
src/go/doc/testdata/generics.go [new file with mode: 0644]