update the go commands

zh/01.3.md

@@ -12,9 +12,9 @@
 
 ## go build
 
-  这个命令主要用于测试编译。在包的编译过程中，若有必要，会同时编译与之相关联的包。
+  这个命令主要用于编译代码。在包的编译过程中，若有必要，会同时编译与之相关联的包。
 
-  - 如果是普通包，就像我们在1.2节中编写的`mymath`包那样，当你执行`go build`之后，它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件，那就得执行`go install`了。
+  - 如果是普通包，就像我们在1.2节中编写的`mymath`包那样，当你执行`go build`之后，它不会产生任何文件。如果你需要在`$GOPATH/pkg`下生成相应的文件，那就得执行`go install`。
 
   - 如果是`main`包，当你执行`go build`之后，它就会在当前目录下生成一个可执行文件。如果你需要在`$GOPATH/bin`下生成相应的文件，需要执行`go install`，或者使用`go build -o 路径/a.exe`。
 
@@ -35,9 +35,28 @@
 
   `go build`的时候会选择性地编译以系统名结尾的文件（Linux、Darwin、Windows、Freebsd）。例如Linux系统下面编译只会选择array_linux.go文件，其它系统命名后缀文件全部忽略。
 
+参数的介绍
+
+- `-o` 指定输出的文件名，可以带上路径，例如 `go build -o a/b/c`
+- `-i` 安装相应的包，编译+`go install`
+- `-a` 更新全部已经是最新的包的，但是对标准包不适用
+- `-n` 把需要执行的编译命令打印出来，但是不执行，这样就可以很容易的知道底层是如何运行的
+- `-p n` 指定可以并行可运行的编译数目，默认是CPU数目
+- `-race` 开启编译的时候自动检测数据竞争的情况，目前只支持64位的机器
+- `-v` 打印出来我们正在编译的包名
+- `-work` 打印出来编译时候的临时文件夹名称，并且如果已经存在的话就不要删除
+- `-x` 打印出来执行的命令，其实就是和`-n`的结果类似，只是这个会执行
+- `-ccflags 'arg list'` 传递参数给5c, 6c, 8c 调用
+- `-compiler name` 指定相应的编译器，gccgo还是gc
+- `-gccgoflags 'arg list'` 传递参数给gccgo编译连接调用
+- `-gcflags 'arg list'` 传递参数给5g, 6g, 8g 调用
+- `-installsuffix suffix` 为了和默认的安装包区别开来，采用这个前缀来重新安装那些依赖的包，`-race`的时候默认已经是`-installsuffix race`,大家可以通过`-n`命令来验证
+- `-ldflags 'flag list'` 传递参数给5l, 6l, 8l 调用
+- `-tags 'tag list'` 设置在编译的时候可以适配的那些tag，详细的tag限制参考里面的 [Build Constraints](http://golang.org/pkg/go/build/)
+ 
 ## go clean
 
-  这个命令是用来移除当前源码包里面编译生成的文件。这些文件包括
+  这个命令是用来移除当前源码包和关联源码包里面编译生成的文件。这些文件包括
 
 	_obj/            旧的object目录，由Makefiles遗留
 	_test/           旧的test目录，由Makefiles遗留
@@ -49,14 +68,39 @@
 	DIR(.exe)        由go build产生
 	DIR.test(.exe)   由go test -c产生
 	MAINFILE(.exe)   由go build MAINFILE.go产生
+	*.so             由 SWIG 产生
 
   我一般都是利用这个命令清除编译文件，然后github递交源码，在本机测试的时候这些编译文件都是和系统相关的，但是对于源码管理来说没必要。
 
+	$ go clean -i -n
+	cd /Users/astaxie/develop/gopath/src/mathapp
+	rm -f mathapp mathapp.exe mathapp.test mathapp.test.exe app app.exe
+	rm -f /Users/astaxie/develop/gopath/bin/mathapp
+
+参数介绍
+
+- `-i` 清除关联的安装的包和可运行文件，也就是通过go install安装的文件
+- `-n` 把需要执行的清除命令打印出来，但是不执行，这样就可以很容易的知道底层是如何运行的
+- `-r` 循环的清除在import中引入的包
+- `-x` 打印出来执行的详细命令，其实就是`-n`打印的执行版本
+
 ## go fmt
 
   有过C/C++经验的读者会知道,一些人经常为代码采取K&R风格还是ANSI风格而争论不休。在go中，代码则有标准的风格。由于之前已经有的一些习惯或其它的原因我们常将代码写成ANSI风格或者其它更合适自己的格式，这将为人们在阅读别人的代码时添加不必要的负担，所以go强制了代码格式（比如左大括号必须放在行尾），不按照此格式的代码将不能编译通过，为了减少浪费在排版上的时间，go工具集中提供了一个`go fmt`命令 它可以帮你格式化你写好的代码文件，使你写代码的时候不需要关心格式，你只需要在写完之后执行`go fmt <文件名>.go`，你的代码就被修改成了标准格式，但是我平常很少用到这个命令，因为开发工具里面一般都带了保存时候自动格式化功能，这个功能其实在底层就是调用了`go fmt`。接下来的一节我将讲述两个工具，这两个工具都自带了保存文件时自动化`go fmt`功能。
 
->使用go fmt命令，更多时候是用gofmt，而且需要参数-w，否则格式化结果不会写入文件。gofmt -w src，可以格式化整个项目。
+使用go fmt命令，其实是调用了gofmt，而且需要参数-w，否则格式化结果不会写入文件。gofmt -w -l src，可以格式化整个项目。
+
+所以go fmt是gofmt的上层一个包装的命令，我们想要更多的个性化的格式化可以参考 [gofmt](http://golang.org/cmd/gofmt/)
+
+gofmt的参数介绍
+
+- `-l` 显示那些需要格式化的文件
+- `-w` 把改写后的内容直接写入到文件中，而不是作为结果打印到标准输出。
+- `-r` 添加形如“a[b:len(a)] -> a[b:]”的重写规则，方便我们做批量替换
+- `-s` 简化文件中的代码
+- `-d` 显示格式化前后的diff而不是写入文件，默认是false
+- `-e` 打印所有的语法错误到标准输出。如果不使用此标记，则只会打印不同行的前10个错误。
+- `-cpuprofile` 支持调试模式，写入相应的cpufile到指定的文件
 
 ## go get
 
@@ -69,10 +113,21 @@
 
   所以为了`go get` 能正常工作，你必须确保安装了合适的源码管理工具，并同时把这些命令加入你的PATH中。其实`go get`支持自定义域名的功能，具体参见`go help remote`。
 
+参数介绍：
+
+- `-d` 只下载不安装
+- `-f` 只有在你包含了`-u`参数的时候才有效，不让`-u`去验证import中的每一个都已经获取了，这对于本地fork的包特别有用
+- `-fix` 在获取源码之后先运行fix，然后再去做其他的事情
+- `-t` 同时也下载需要为运行测试所需要的包
+- `-u` 强制使用网络去更新包和它的依赖包
+- `-v` 显示执行的命令
+
 ## go install
 
   这个命令在内部实际上分成了两步操作：第一步是生成结果文件(可执行文件或者.a包)，第二步会把编译好的结果移到`$GOPATH/pkg`或者`$GOPATH/bin`。
 
+参数支持`go build`的编译参数。大家只要记住一个参数`-v`就好了，这个随时随地的可以查看底层的执行信息。
+
 ## go test
 
   执行这个命令，会自动读取源码目录下面名为`*_test.go`的文件，生成并运行测试用的可执行文件。输出的信息类似
@@ -84,14 +139,48 @@
 
   默认的情况下，不需要任何的参数，它会自动把你源码包下面所有test文件测试完毕，当然你也可以带上参数，详情请参考`go help testflag`
 
-## go doc
+这里我介绍几个我们常用的参数：
+
+- `-bench regexp` 执行相应的benchmarks，例如 `-bench=.`
+- `-cover` 开启测试覆盖率
+- `-run regexp` 只运行regexp匹配的函数，例如 `-run=Array` 那么就执行包含有Array开头的函数
+- `-v` 显示测试的详细命令
+
+## go tool
+`go tool`下面下载聚集了很多命令，这里我们只介绍两个，fix和vet
+
+- `go tool fix .` 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1,例如API的变化
+- `go tool vet directory|files` 用来分析当前目录的代码是否都是正确的代码,例如是不是调用fmt.Printf里面的参数不正确，例如函数里面提前return了然后出现了无用代码之类的。
+
+## go generate
+这个命令是从Go1.4开始才设计的，用于在编译前自动化生成某类代码。`go generate`和`go build`是完全不一样的命令，通过分析源码中特殊的注释，然后执行相应的命令。这些命令都是很明确的，没有任何的依赖在里面。而且大家在用这个之前心里面一定要有一个理念，这个`go generate`是给你用的，不是给使用你这个包的人用的，是方便你来生成一些代码的。
+
+这里我们来举一个简单的例子，例如我们经常会使用`yacc`来生成代码，那么我们常用这样的命令：
+
+	go tool yacc -o gopher.go -p parser gopher.y
+	
+-o 指定了输出的文件名， -p指定了package的名称，这是一个单独的命令，如果我们想让`go generate`来触发这个命令，那么就可以在当然目录的任意一个`xxx.go`文件里面的任意位置增加一行如下的注释：
+
+	//go:generate go tool yacc -o gopher.go -p parser gopher.y
+
+这里我们注意了，`//go:generate`是没有任何空格的，这其实就是一个固定的格式，在扫描源码文件的时候就是根据这个来判断的。
+
+所以我们可以通过如下的命令来生成，编译，测试。如果`gopher.y`文件有修改，那么就重新执行`go generate`重新生成文件就好。
+
+	$ go generate
+	$ go build
+	$ go test
+
+
+## godoc
   
-  (1.2rc1 以後沒有 go doc 指令, 只留下 godoc 指令)
+在Go1.2版本之前还支持`go doc`命令，但是之后全部已到了godoc这个命令下，需要这样安装`go get golang.org/x/tools/cmd/godoc`
+
   很多人说go不需要任何的第三方文档，例如chm手册之类的（其实我已经做了一个了，[chm手册](https://github.com/astaxie/godoc)），因为它内部就有一个很强大的文档工具。
 
   如何查看相应package的文档呢？
-  例如builtin包，那么执行`go doc builtin`
-  如果是http包，那么执行`go doc net/http`
+  例如builtin包，那么执行`godoc builtin`
+  如果是http包，那么执行`godoc net/http`
   查看某一个包里面的函数，那么执行`godoc fmt Printf`
   也可以查看相应的代码，执行`godoc -src fmt Printf`
 
@@ -101,7 +190,6 @@
 
   go还提供了其它很多的工具，例如下面的这些工具
 
-	go fix 用来修复以前老版本的代码到新版本，例如go1之前老版本的代码转化到go1
 	go version 查看go当前的版本
 	go env 查看当前go的环境变量
 	go list 列出当前全部安装的package