testing: examples should run in source order

[rsc]

Example tests should run in the same order they appear in the source file, just as with
ordinary tests.
It appears that non-method examples are run before method examples.

[rsc]

Comment 1:

Also method examples are run in order sorted by method name, not source order.

[gopherbot]

Comment 2 by osaingre:

> Also method examples are run in order sorted by method name, not source order.
Hi, do you deem acceptable to remove the sort done in go.doc.Examples() ?
After all, the order is not specified in the documentation.

[rsc]

Comment 3:

Sorted by name is probably correct most of the time. However, it's not in this case. I
would suggest adding a new field 
Order int // original source order
to the Example struct and let cmd/go sort by that.

[gopherbot]

Comment 4 by vegacom:

since the sorting is done in example.go and not in test.go, I think removing the sort
import and related code does the trick. https://golang.org/cl/7127064
unless I'm missing something...

[rsc]

Comment 5:

The sorting is done in package example. That can be used for things besides generating
tests. I don't want to remove the "sorted order" guarantee that it currently makes. I
just want to make it possible to reconstruct the original order.

[gopherbot]

Comment 6 by osaingre:

Alright. I get it.

[gopherbot]

Comment 7 by vegacom:

got it, dropped CL.

[rsc]

Comment 8:

This issue was closed by revision 18178fd.

Status changed to Fixed.