From 8d5b324afc6be6246e702c6bec35a3791ed033ea Mon Sep 17 00:00:00 2001 From: Andrew Gerrand Date: Tue, 27 Mar 2012 13:46:16 +1100 Subject: doc: move /ref/cmd to /doc/cmd Fixes #3400. R=golang-dev, rsc CC=golang-dev https://golang.org/cl/5926043 --- doc/cmd.html | 103 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/reference-cmd.html | 103 ------------------------------------------------- doc/reference.html | 2 +- 3 files changed, 104 insertions(+), 104 deletions(-) create mode 100644 doc/cmd.html delete mode 100644 doc/reference-cmd.html diff --git a/doc/cmd.html b/doc/cmd.html new file mode 100644 index 0000000000..ac54923d43 --- /dev/null +++ b/doc/cmd.html @@ -0,0 +1,103 @@ + + +

+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 vet. +This style of invocation allows, for instance, checking a single source file +rather than an entire package: go tool vet myprogram.go as +compared to go vet mypackage. +Some of the commands, such as 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. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Name    Synopsis
go     +The go program manages Go source code and runs the other +commands listed here. +See the command docs for usage +details. +

+
cgo    Cgo enables the creation of Go packages that call C code.
fix    Fix finds Go programs that use old features of the language and libraries +and rewrites them to use newer ones.
doc    Doc extracts and generates documentation for Go packages, it is also available as +an independent godoc command with more general options.
fmt    Fmt formats Go packages, it is also available as an independent +gofmt command with more general options.
vet    Vet examines Go source code and reports suspicious constructs, such as Printf +calls whose arguments do not align with the format string.
yacc    Yacc is a version of yacc that generates parsers implemented in Go.
+ +

+This is an abridged list. See the full command reference +for documentation of the compilers and more. +

diff --git a/doc/reference-cmd.html b/doc/reference-cmd.html deleted file mode 100644 index b2cb2efa04..0000000000 --- a/doc/reference-cmd.html +++ /dev/null @@ -1,103 +0,0 @@ - - -

-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 vet. -This style of invocation allows, for instance, checking a single source file -rather than an entire package: go tool vet myprogram.go as -compared to go vet mypackage. -Some of the commands, such as 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. -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Name    Synopsis
go     -The go program manages Go source code and runs the other -commands listed here. -See the command docs for usage -details. -

-
cgo    Cgo enables the creation of Go packages that call C code.
fix    Fix finds Go programs that use old features of the language and libraries -and rewrites them to use newer ones.
doc    Doc extracts and generates documentation for Go packages, it is also available as -an independent godoc command with more general options.
fmt    Fmt formats Go packages, it is also available as an independent -gofmt command with more general options.
vet    Vet examines Go source code and reports suspicious constructs, such as Printf -calls whose arguments do not align with the format string.
yacc    Yacc is a version of yacc that generates parsers implemented in Go.
- -

-This is an abridged list. See the full command reference -for documentation of the compilers and more. -

diff --git a/doc/reference.html b/doc/reference.html index 628289f7be..beaac431d2 100644 --- a/doc/reference.html +++ b/doc/reference.html @@ -14,7 +14,7 @@ The documentation for the Go standard library.

-

Command Documentation

+

Command Documentation

The documentation for the Go tools.

-- cgit v1.3