example.com/cmd contains main packages.

-- .info --
{"Version":"v1.0.0-replace"}
-- .mod --
module example.com/cmd

go 1.16

replace rsc.io/quote => rsc.io/quote v1.5.2
-- go.mod --
module example.com/cmd

go 1.16

replace rsc.io/quote => rsc.io/quote v1.5.2
-- a/a.go --
package main

func main() {}
-- b/b.go --
package main

func main() {}
-- err/err.go --
package err

Module example.com/retract/rename is renamed in this version.

This happens frequently when a repository is renamed or when a go.mod file
is added for the first time with a custom module path.
-- .info --
{"Version":"v1.9.0-new"}
-- .mod --
module example.com/retract/newname

go 1.16

// bad
retract v1.0.0-bad
-- go.mod --
module example.com/retract/newname

go 1.16

// bad
retract v1.0.0-bad
-- newname.go --

syntax = "proto2";

package k8s.io.apiserver.pkg.apis.example2.v1;

import "k8s.io/apimachinery/pkg/apis/meta/v1/generated.proto";
import "k8s.io/apimachinery/pkg/runtime/generated.proto";
import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";

// Package-wide variables from generator "generated".
option go_package = "k8s.io/apiserver/pkg/apis/example2/v1";

	}
	// Output:
	// err1
	// err2
	// err is err1
	// err is err2
}

func ExampleIs() {
	if _, err := os.Open("non-existing"); err != nil {
		if errors.Is(err, fs.ErrNotExist) {
			fmt.Println("file does not exist")
		} else {
			fmt.Println(err)
		}
	}

	// Output:
	// file does not exist
}

func ExampleAs() {
	if _, err := os.Open("non-existing"); err != nil {
		var pathError *fs.PathError

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.

The v1.0.0 release of example.com/retract/incompatible retracts
v2.0.0+incompatible.

-- .mod --
module example.com/retract/incompatible
-- .info --
{"Version":"v2.0.0+incompatible"}
-- incompatible.go --

example.com/pseudoupgrade v0.0.0-20190429073000-30950c05d534
written by hand

-- .mod --
module example.com/pseudoupgrade

-- .info --
{"Version":"v0.0.0-20190430073000-30950c05d534","Name":"v0.0.0-20190430073000-30950c05d534","Short":"30950c05d534","Time":"2019-04-30T07:30:00Z"}

-- pseudoupgrade.go --
package pseudoupgrade

This module's path ends with ".go".
Based on github.com/nats-io/nats.go.
Used in regression tests for golang.org/issue/32483.

-- .mod --
module example.com/dotgo.go

go 1.13
-- .info --
{"Version":"v1.0.0"}
-- go.mod --
module example.com/dotgo.go

go 1.13
-- dotgo.go --

}

// Example constructs an declarative configuration of the Example type for use with
// apply.
func Example(name, namespace string) *ExampleApplyConfiguration {
	b := &ExampleApplyConfiguration{}
	b.WithName(name)
	b.WithNamespace(namespace)
	b.WithKind("Example")
	b.WithAPIVersion("cr.example.apiextensions.k8s.io/v1")
	return b
}

Module example.com/retract/self/prerelease is a module that retracts its own
latest version and all other release version.

A pre-release version higher than the highest release version is still
available, and that should be matched by @latest.

-- .mod --
module example.com/retract/self/prerelease

go 1.15

-- .info --
{"Version":"v1.9.1-pre"}

-- p.go --