From: Andrew Gerrand <adg@golang.org>
Date: Wed, 13 Nov 2013 03:35:59 +0000 (+1100)
Subject: [release-branch.go1.2] cmd/godoc: document package-level examples
X-Git-Tag: go1.2rc4~9
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=021476db3bccf19c84344b60e95bec67c21bc155;p=gostls13.git

[release-branch.go1.2] cmd/godoc: document package-level examples

««« CL 23940043 / 6ad0ec54cf2d
cmd/godoc: document package-level examples

Fixes  issue  5807 .

R=golang-dev, adg
CC=golang-dev
https://golang.org/cl/23940043

»»»

R=golang-dev
CC=golang-dev
https://golang.org/cl/25500045
---

diff --git a/src/pkg/testing/testing.go b/src/pkg/testing/testing.go
index 5019e07626..52dc166dd9 100644
--- a/src/pkg/testing/testing.go
+++ b/src/pkg/testing/testing.go
@@ -73,17 +73,19 @@
 //
 // Example functions without output comments are compiled but not executed.
 //
-// The naming convention to declare examples for a function F, a type T and
+// The naming convention to declare examples for the package, a function F, a type T and
 // method M on type T are:
 //
+//     func Example() { ... }
 //     func ExampleF() { ... }
 //     func ExampleT() { ... }
 //     func ExampleT_M() { ... }
 //
-// Multiple example functions for a type/function/method may be provided by
+// Multiple example functions for a package/type/function/method may be provided by
 // appending a distinct suffix to the name. The suffix must start with a
 // lower-case letter.
 //
+//     func Example_suffix() { ... }
 //     func ExampleF_suffix() { ... }
 //     func ExampleT_suffix() { ... }
 //     func ExampleT_M_suffix() { ... }