Go Concepts - Documentation
Jump to navigation
Jump to search
Internal
Overview
Go generates in-line documentation for symbols in packages, via the go doc command.
Reading Documentation
To read the package summary:
go doc <package-name>
Example:
go doc fmt
To get the documentation for a package identifier (function name, type, etc):
go doc <package-name> <identifier>
Example:
go doc fmt Println
Writing Documentation
Package-Level Documentation
Package Identifier Documentation
Add a "//" comment before the exported identifier (function, type, etc).
Example:
// This function pains all its arguments blue fun Blue(s string) string { ... }
go doc will work as follows:
go doc blue Blue func Blue(s string) string This function paints all its arguments blue