Commit 7df2854f authored by Rob Pike's avatar Rob Pike

doc/articles/go_command.html: mention go generate

Fix some out-of-date remarks.

Fixes #10489.

Change-Id: I8f0cce2588828052a5d013e7bac6bcfeb220579d
Reviewed-on: https://go-review.googlesource.com/9008Reviewed-by: 's avatarRuss Cox <rsc@golang.org>
parent 9c3bf097
...@@ -250,11 +250,16 @@ projects at once within a single <code>$GOPATH</code> root directory.</p> ...@@ -250,11 +250,16 @@ projects at once within a single <code>$GOPATH</code> root directory.</p>
<h2>Limitations</h2> <h2>Limitations</h2>
<p>As mentioned above, the go command is not a general-purpose build <p>As mentioned above, the go command is not a general-purpose build
tool. In particular, it does not have any facility for generating Go tool.
source files during a build. Instead, if you want to use a tool like In particular, it does not have any facility for generating Go
yacc or the protocol buffer compiler, you will need to write a source files <em>during</em> a build, although it does provide
<a href="/cmd/go/#hdr-Generate_Go_files_by_processing_source"><code>go</code>
<code>generate</code></a>,
which can automate the creation of Go files <em>before</em>
the build, such as by running <code>yacc</code>.
For more advanced build setups, you may need to write a
makefile (or a configuration file for the build tool of your choice) makefile (or a configuration file for the build tool of your choice)
to generate the Go files and then check those generated source files to run whatever tool creates the Go files and then check those generated source files
into your repository. This is more work for you, the package author, into your repository. This is more work for you, the package author,
but it is significantly less work for your users, who can use but it is significantly less work for your users, who can use
"<code>go get</code>" without needing to obtain and build "<code>go get</code>" without needing to obtain and build
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment