• Rob Pike's avatar
    cmd/doc: show documentation for interface methods when requested explicitly · 2ee82edf
    Rob Pike authored
    For historical reasons, the go/doc package does not include
    the methods within an interface as part of the documented
    methods for that type. Thus,
    
    	go doc ast.Node.Pos
    
    gives an incorrect and confusing error message:
    
    	doc: no method Node.Pos in package go/ast
    
    This CL does some dirty work to dig down to the methods
    so interface methods now present their documentation:
    
    % go doc ast.node.pos
    func Pos() token.Pos  // position of first character belonging to the node
    %
    
    It must largely sidestep the doc package to do this, which
    is a shame. Perhaps things will improve there one day.
    
    The change does not handle embeddings, and in principle the
    same approach could be done for struct fields, but that is also
    not here yet. But this CL fixes the thing that was bugging me.
    
    Change-Id: Ic10a91936da96f54ee0b2f4a4fe4a8c9b93a5b4a
    Reviewed-on: https://go-review.googlesource.com/31852Reviewed-by: 's avatarRobert Griesemer <gri@golang.org>
    2ee82edf
Name
Last commit
Last update
.github Loading commit data...
api Loading commit data...
doc Loading commit data...
lib/time Loading commit data...
misc Loading commit data...
src Loading commit data...
test Loading commit data...
.gitattributes Loading commit data...
.gitignore Loading commit data...
AUTHORS Loading commit data...
CONTRIBUTING.md Loading commit data...
CONTRIBUTORS Loading commit data...
LICENSE Loading commit data...
PATENTS Loading commit data...
README.md Loading commit data...
favicon.ico Loading commit data...
robots.txt Loading commit data...