Golang comments: Difference between revisions
From wikinotes
No edit summary |
|||
(3 intermediate revisions by the same user not shown) | |||
Line 13: | Line 13: | ||
= Doc Comments = | = Doc Comments = | ||
<blockquote> | <blockquote> | ||
Doc-comments are regular comments that preceed a top-level declaration.<br> | |||
The docs recommend that they begin with the name of the function. | |||
It is customary to have a doc-comment above every exported function. | |||
It is customary to have a doc-comment above every exported function, constant<br> | |||
and preceding a package statement (any package statement, often there is a <code>doc.go</code> for this comment). | |||
<syntaxhighlight lang="go"> | <syntaxhighlight lang="go"> | ||
// | // Words contains a collection of words to be printed. | ||
// | package words | ||
// Hello prints hello to STDOUT. | |||
// If you'd like to ... etc etc | |||
func Hello() { | func Hello() { | ||
fmt.Println("hello") | fmt.Println("hello") | ||
} | } | ||
// Doc-Comments may also preceed a group of declarations | |||
var ( | |||
one = 1 | |||
two = 2 | |||
three = 3 | |||
) | |||
</syntaxhighlight> | |||
You can search documentation by by type in your cli | |||
<syntaxhighlight lang="bash"> | |||
go doc -all regexp # print docs for all methods with regexp type in method signature (?) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</blockquote><!-- Doc Comments --> | </blockquote><!-- Doc Comments --> |
Latest revision as of 03:35, 25 May 2022
Comments
// single line comment /* Multiline * Comment */
Doc Comments
Doc-comments are regular comments that preceed a top-level declaration.
The docs recommend that they begin with the name of the function.It is customary to have a doc-comment above every exported function, constant
and preceding a package statement (any package statement, often there is adoc.go
for this comment).// Words contains a collection of words to be printed. package words // Hello prints hello to STDOUT. // If you'd like to ... etc etc func Hello() { fmt.Println("hello") } // Doc-Comments may also preceed a group of declarations var ( one = 1 two = 2 three = 3 )You can search documentation by by type in your cli
go doc -all regexp # print docs for all methods with regexp type in method signature (?)