code review 5728055: doc: add command docs page, canonicalize reference paths

doc: add command docs page, canonicalize reference paths

[adg, 2012-03-03 22:57:03]

Hello golang-dev@googlegroups.com,

I'd like you to review this change to
https://code.google.com/p/go

[Kyle E. Lemons, 2012-03-03 23:14:44]

LGTM

http://codereview.appspot.com/5728055/diff/3001/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/3001/doc/reference-cmd.html#newcode70
doc/reference-cmd.html:70: This is an abridged list. See the <a
href="/cmd/">full command reference</a>
Is there any way to specify this as a list of ones (maybe with some kind of
template magic) to include instead of manually duplicating it?  If there's no
existing way to do it, it is probably more work than the relatively small number
of edits that will happen here, though.

http://codereview.appspot.com/5728055/diff/3001/doc/reference.html
File doc/reference.html (right):

http://codereview.appspot.com/5728055/diff/3001/doc/reference.html#newcode8
doc/reference.html:8: <p>Good bedroom reading.</p>
bedtime?

[adg, 2012-03-03 23:19:29]

http://codereview.appspot.com/5728055/diff/3001/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/3001/doc/reference-cmd.html#newcode70
doc/reference-cmd.html:70: This is an abridged list. See the <a
href="/cmd/">full command reference</a>
> it is probably more work than the relatively small number
> of edits that will happen here, though.

Exactly.

http://codereview.appspot.com/5728055/diff/3001/doc/reference.html
File doc/reference.html (right):

http://codereview.appspot.com/5728055/diff/3001/doc/reference.html#newcode8
doc/reference.html:8: <p>Good bedroom reading.</p>
On 2012/03/03 23:14:44, Kyle E. Lemons wrote:
> bedtime?

Done.

[r, 2012-03-04 23:36:51]

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html#newcode28
doc/reference-cmd.html:28: <td style="width: auto">Fix finds Go programs that
use old APIs and rewrites them to use newer ones.</td>
can we avoid API?
old features of the language and libraries

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html#newcode64
doc/reference-cmd.html:64: <td style="width: auto">Yacc is a version of yacc for
Go.</td>
probably need to give a usage line: go, go fix, go tool yacc, etc.

[adg, 2012-03-05 00:04:32]

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html#newcode28
doc/reference-cmd.html:28: <td style="width: auto">Fix finds Go programs that
use old APIs and rewrites them to use newer ones.</td>
On 2012/03/04 23:36:51, r wrote:
> can we avoid API?
> old features of the language and libraries

Done.

http://codereview.appspot.com/5728055/diff/6001/doc/reference-cmd.html#newcode64
doc/reference-cmd.html:64: <td style="width: auto">Yacc is a version of yacc for
Go.</td>
On 2012/03/04 23:36:51, r wrote:
> probably need to give a usage line: go, go fix, go tool yacc, etc.

Done.

[adg, 2012-03-05 03:27:11]

PTAL

[r, 2012-03-05 03:31:07]

https://codereview.appspot.com/5728055/diff/1026/doc/reference-cmd.html
File doc/reference-cmd.html (right):

https://codereview.appspot.com/5728055/diff/1026/doc/reference-cmd.html#newco...
doc/reference-cmd.html:39: <td>Go is a tool for managing Go source code.</td>
maybe put this first, and say how all the others can be run from it. start
*here*

[adg, 2012-03-05 04:04:29]

https://codereview.appspot.com/5728055/diff/1026/doc/reference-cmd.html
File doc/reference-cmd.html (right):

https://codereview.appspot.com/5728055/diff/1026/doc/reference-cmd.html#newco...
doc/reference-cmd.html:39: <td>Go is a tool for managing Go source code.</td>
On 2012/03/05 03:31:07, r wrote:
> maybe put this first, and say how all the others can be run from it. start
> *here*

Done.

[adg, 2012-03-05 04:04:47]

Hello golang-dev@googlegroups.com, kyle@kylelemons.net, r@golang.org (cc:
golang-dev@googlegroups.com),

Please take another look.

[r, 2012-03-05 04:16:47]

LGTM

http://codereview.appspot.com/5728055/diff/5010/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/5010/doc/reference-cmd.html#newcode23
doc/reference-cmd.html:23: It may be used to invoke the other commands listed
below.
Besides compiling and running Go programs, the go command is also used to
invoke....

[adg, 2012-03-05 04:30:32]

*** Submitted as http://code.google.com/p/go/source/detail?r=9f5294988ba7 ***

doc: add command docs page, canonicalize reference paths

R=golang-dev, kyle, r
CC=golang-dev
http://codereview.appspot.com/5728055

http://codereview.appspot.com/5728055/diff/5010/doc/reference-cmd.html
File doc/reference-cmd.html (right):

http://codereview.appspot.com/5728055/diff/5010/doc/reference-cmd.html#newcode23
doc/reference-cmd.html:23: It may be used to invoke the other commands listed
below.
On 2012/03/05 04:16:48, r wrote:
> Besides compiling and running Go programs, the go command is also used to
> invoke....

Done.