package main

import "fmt"

//go:generate echo one
//go:generate printf %s\n two

func main() {
    fmt.Println(`This is a program showing how go generate is a half-assed tool.

First of all, you might include in a multi-line string (like this one. It's a string, not a comment), the text
//go:generate example of using go:generate.
But, if you were to do the above, you'd be sorely disappointed to learn that running "go generate" on the file would result in an error. 'example not found'... yup, it doesn't feel like parsing the language, it just does dumb "split into lines, line starts with".... Yeah, wow.

This program also shows another issue with go generate. On your shiny release version of go 1.4 (no, not beta. Release) run
"go generate -help". You'll notice it prints out usage for one flag... -run=""
Read that. Notice that at the beginning of this I have a "go:generate echo" and a "go:generate printf".
Just try to use go generate -run to make it print "one" but not "two". Good luck.
Don't bang your head against the above problem too much though; I'll let you in on a secret. The single documented useful flag in go-generate does not in fact work. It's not implemented. At all. They define it and then never use it. Feel free to read the source code like I did after losing a week to this.
`)
}