go/src/cmd/8a/doc.go

// Copyright 2009 The Go Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// +build ignore

/*

8a is a version of the Plan 9 assembler.  The original is documented at

	http://plan9.bell-labs.com/magic/man2html/1/8a

Go-specific considerations are documented at

	http://golang.org/doc/asm

I
Its target architecture is the x86, referred to by these tools for historical reasons as 386.

*/
package main
document the assemblers. add details about -d and -e flags in the loaders. R=rsc CC=go-dev http://go/go-review/1018031 2009-11-03 17:29:32 -07:00			`// Copyright 2009 The Go Authors. All rights reserved.`
			`// Use of this source code is governed by a BSD-style`
			`// license that can be found in the LICENSE file.`

cmd/godoc: use go/build to determine package and example files Also: - faster code for example extraction - simplify handling of command documentation: all "main" packages are treated as commands - various minor cleanups along the way For commands written in Go, any doc.go file containing documentation must now be part of package main (rather then package documentation), otherwise the documentation won't show up in godoc (it will still build, though). For commands written in C, documentation may still be in doc.go files defining package documentation, but the recommended way is to explicitly ignore those files with a +build ignore constraint to define package main. Fixes #4806. R=adg, rsc, dave, bradfitz CC=golang-dev https://golang.org/cl/7333046 2013-02-19 12:19:58 -07:00			`// +build ignore`

document the assemblers. add details about -d and -e flags in the loaders. R=rsc CC=go-dev http://go/go-review/1018031 2009-11-03 17:29:32 -07:00			`/*`

tweak documentation of commands so that first sentence is better for cmd page. live at http://r45:3456/cmd/ R=gri, r http://go/go-review/1024034 2009-11-09 12:45:15 -07:00			`8a is a version of the Plan 9 assembler. The original is documented at`
document the assemblers. add details about -d and -e flags in the loaders. R=rsc CC=go-dev http://go/go-review/1018031 2009-11-03 17:29:32 -07:00
cmd/5a, cmd/5c, cmd/6a, cmd/6c, cmd/8a, cmd/8c, cmd/ld: update reference Reference the 80386 compiler documentation now that the documentation for the 68020 is offline. R=golang-dev, minux.ma, rsc CC=golang-dev https://golang.org/cl/7127053 2013-01-18 14:39:53 -07:00			`http://plan9.bell-labs.com/magic/man2html/1/8a`
document the assemblers. add details about -d and -e flags in the loaders. R=rsc CC=go-dev http://go/go-review/1018031 2009-11-03 17:29:32 -07:00
src/cmd/?a: link to new assembler document Blocked on 20930043, the CL the new text references. R=golang-dev, bradfitz CC=golang-dev https://golang.org/cl/18430044 2013-11-12 21:07:08 -07:00			`Go-specific considerations are documented at`

doc/asm: more about SP, ARM R11 Also rename URL to /doc/asm. R=golang-dev, minux.ma, r CC=golang-dev https://golang.org/cl/26170043 2013-11-13 19:29:34 -07:00			`http://golang.org/doc/asm`
src/cmd/?a: link to new assembler document Blocked on 20930043, the CL the new text references. R=golang-dev, bradfitz CC=golang-dev https://golang.org/cl/18430044 2013-11-12 21:07:08 -07:00
			`I`
document the assemblers. add details about -d and -e flags in the loaders. R=rsc CC=go-dev http://go/go-review/1018031 2009-11-03 17:29:32 -07:00			`Its target architecture is the x86, referred to by these tools for historical reasons as 386.`

			`*/`
cmd/godoc: use go/build to determine package and example files Also: - faster code for example extraction - simplify handling of command documentation: all "main" packages are treated as commands - various minor cleanups along the way For commands written in Go, any doc.go file containing documentation must now be part of package main (rather then package documentation), otherwise the documentation won't show up in godoc (it will still build, though). For commands written in C, documentation may still be in doc.go files defining package documentation, but the recommended way is to explicitly ignore those files with a +build ignore constraint to define package main. Fixes #4806. R=adg, rsc, dave, bradfitz CC=golang-dev https://golang.org/cl/7333046 2013-02-19 12:19:58 -07:00			`package main`