diff --git a/doc/reference-cmd.html b/doc/reference-cmd.html index 7fdc9706260..8a9529d17a4 100644 --- a/doc/reference-cmd.html +++ b/doc/reference-cmd.html @@ -4,7 +4,38 @@ }-->
-Click on the links for more documentation and usage messages. +There is a suite of programs to build and process Go source code. +Instead of being run directly, programs in the suite are usually invoked +by the go program. +
+ ++The most common way to run these programs is as a subcommand of the go +program, +for instance as "go fmt". Run like this, the command operates on complete +packages of Go source code, with the go program invoking the underlying binary +with arguments appropriate to package-level processing. +
+ ++The programs can also be run as stand-alone binaries, with unmodified arguments, +using the go tool subcommand, such as "go tool fmt". +This style of invocation allows, for instance, reformatting a single source file rather than +an entire package: "go tool fmt myprogram.go" as compared to +"go fmt mypackage". +Some of the commands, such as prof and yacc, are accessible +only through the go tool subcommand. +
+ ++Finally, two of the commands, fmt and +doc, are also installed as regular binaries called +gofmt and godoc +because they are so often referenced. +
+ ++Click on the links for more documentation, invocation methods, and usage details.
go |
-Go is a tool for managing Go source code.
- -Besides compiling and running Go programs, the go command is also used to -invoke the other commands listed below. See the command docs for usage +The go program manages Go source code and runs the other
+commands listed here.
+See the command docs for usage
details.
|
@@ -76,7 +106,7 @@ calls whose arguments do not align with the format string.
||
yacc | - | Yacc is a version of yacc for Go. | +Yacc is a version of yacc that generates parsers implemented in Go. |