foo to bar

bar.go

// Package bar provides thneeds (things everyone needs).
//
// Those switching from "example.com/pkg/foo" to bar will have to run the
// following commands (which are intended to be idempotent).
//
//     go fmt -r 'a.ChopTruffulaTree(b) -> a.ChopTruffulaTrees(b, b, b, b, b)'
//
// Of course, if you're using sufficiently smart tools, your code may already
// be updated.
//
package bar

foo.go

// Package foo does nothing anymore, it has been suprseded by bar.
//
// Except that it includes some gofmt commands intended to help foo-using
// packages become bar-using ones:
//
//     gofmt -r '"example.com/pkg/foo" -> "example.com/pkg/bar"'
//
// Of course, if you're using sufficiently smart tools, your code may already
// be updated.
//
package foo