| These files are processed by example_test.go:TestExamples. | |
| A .golden file is a txtar file with two sections for each example that should be | |
| created by doc.Examples from the corresponding .go file. | |
| One section, named EXAMPLE_NAME.Output, contains the example's output, | |
| the value of the field Example.Output. | |
| The other, named EXAMPLE_NAME.Play, contains the formatted code for a playable | |
| version of the example, the value of the field Example.Play. | |
| If a section is missing, it is treated as being empty. |