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.

@@ -18,10 +49,9 @@ Click on the links for more documentation and usage messages. @@ -76,7 +106,7 @@ calls whose arguments do not align with the format string. - +
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.

yacc     Yacc is a version of yacc for Go.Yacc is a version of yacc that generates parsers implemented in Go.