Browse Source

精校:9.6-9.7

Unknwon 10 years ago
parent
commit
ad2719141f
4 changed files with 16 additions and 16 deletions
  1. 1 1
      README_gc.md
  2. 3 1
      TOC.md
  3. 4 4
      eBook/09.6.md
  4. 8 10
      eBook/09.7.md

+ 1 - 1
README_gc.md

@@ -19,4 +19,4 @@ Golang 编程:245386165
 
 |更新日期    |更新内容
 |----------|------------------
-|2015-08-07|9.5 自定义包和可见性
+|2015-08-08|9.7 使用 go install 安装自定义包

+ 3 - 1
TOC.md

@@ -72,4 +72,6 @@
 		- 9.2 [regexp 包](eBook/09.2.md)
 		- 9.3 [锁和 sync 包](eBook/09.3.md)
 		- 9.4 [精密计算和 big 包](eBook/09.4.md)
-		- 9.5 [自定义包和可见性](eBook/09.5.md)
+		- 9.5 [自定义包和可见性](eBook/09.5.md)
+		- 9.6 [为自定义包使用 godoc](eBook/09.6.md)
+		- 9.7 [使用 go install 安装自定义包](eBook/09.7.md)

+ 4 - 4
eBook/09.6.md

@@ -1,6 +1,6 @@
 # 9.6 为自定义包使用 godoc
 
-godoc工具(第 3.6 节)在显示自定义包中的注释也有很好的效果:注释必须以 // 开始并无空行放在声明(包,类型,函数)前。godoc 会为每个文件生成一系列的网页。
+godoc工具(第 3.6 节)在显示自定义包中的注释也有很好的效果:注释必须以 `//`` 开始并无空行放在声明(包,类型,函数)前。godoc 会为每个文件生成一系列的网页。
 
 例如:
 
@@ -9,7 +9,7 @@ godoc工具(第 3.6 节)在显示自定义包中的注释也有很好的效
 
 	godoc -http =:6060 -paht="."
 
-(`.` 是指当前目录,-path 参数可以是 /path/to/my/package1 这样的形式指出 package1 在你源码中的位置或接受用冒号形式分隔的路径,无根目录的路径为相对于当前目录的相对路径)
+(`.` 是指当前目录,-path 参数可以是 `/path/to/my/package1` 这样的形式指出 package1 在你源码中的位置或接受用冒号形式分隔的路径,无根目录的路径为相对于当前目录的相对路径)
 
 - 在浏览器打开地址:http://localhost:6060
 
@@ -56,7 +56,7 @@ func (StringArray) Swap
 
 func (Float64Array) Swap
 
-Other packages
+// Other packages
 import "doc_example" 
 ```
 
@@ -83,7 +83,7 @@ Convenience wrappers for common cases: type IntArray[Top]
 Convenience types for common cases: IntArray type IntArray []int  
 ```
 
-如果你在一个团队中工作,并在源代码树被存储在网络硬盘上,就可以使用 godoc 给所有团队成员连续文档的支持。通过设置 sync_minutes=n,你甚至可以让它每 n 分钟自动更新您的文档!
+如果你在一个团队中工作,并在源代码树被存储在网络硬盘上,就可以使用 godoc 给所有团队成员连续文档的支持。通过设置 `sync_minutes=n`,你甚至可以让它每 n 分钟自动更新您的文档!
 
 ## 链接
 

+ 8 - 10
eBook/09.7.md

@@ -1,26 +1,24 @@
 # 9.7 使用 go install 安装自定义包
 
-go install 是 Go 中自动包安装工具:如需要将包安装到本地它会从远端仓库下载包:检出,编译,安装一气呵成。
+go install 是 Go 中自动包安装工具:如需要将包安装到本地它会从远端仓库下载包:检出、编译和安装一气呵成。
 
 在包安装前的先决条件是要自动处理包自身依赖关系的安装。被依赖的包也会安装到子目录下,但是没有文档和示例:可以到网上浏览。
 
-被安装包的列表可以在 $GOROOT/goinstall.log 找到。
-
 go install 使用了 GOPATH 变量(详见第 2.2 节)。
 
 远端包(详见第 9.5 节):
 
-假设我们要安装一个有趣的包 tideland(它包含了许多帮助示例,参见:http://code.google.com/p/tideland-cgl)。
+假设我们要安装一个有趣的包 tideland(它包含了许多帮助示例,参见 [项目主页](http://code.google.com/p/tideland-cgl))。
 
 因为我们需要创建目录在 Go 安装目录下,所以我们需要使用 root 或者 su 的身份执行命令。
 
-确保 Go 环境变量已经设置在 root 用户下的 ./bashrc 文件中。
+确保 Go 环境变量已经设置在 root 用户下的 `./bashrc` 文件中。
 
-使用命令安装:`go install tideland-cgl.googlecode.com/hg`
+使用命令安装:`go install tideland-cgl.googlecode.com/hg`
 
-可执行文件 hg.a 将被放到 $GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com 目录下,源码文件被放置在 $GOROOT/src/tideland-cgl.googlecode.com/hg 目录下,同样有个 hg.a 放置在 _obj 的子目录下。
+可执行文件 `hg.a` 将被放到 `$GOROOT/pkg/linux_amd64/tideland-cgl.googlecode.com` 目录下,源码文件被放置在 `$GOROOT/src/tideland-cgl.googlecode.com/hg` 目录下,同样有个 `hg.a` 放置在 `_obj` 的子目录下。
 
-现在就可以在 go 代码中使用这个包中的功能了,例如使用名 cgl 导入:
+现在就可以在 go 代码中使用这个包中的功能了,例如使用名 cgl 导入:
 
 ```go
 import cgl "tideland-cgl.googlecode.com/hg"
@@ -30,13 +28,13 @@ import cgl "tideland-cgl.googlecode.com/hg"
 
 升级到新的版本:
 
-更新到新版本的 Go 之后本地安装包的二进制文件将全被删除。当调用 install -a 工具将通过读取 $GOROOT/goinstall.log 重新安装以前的安装包。如果你想更新,重编译,重安装所有的go安装包可以使用:`go install -a -u -clean` 或者 `go install -a -u -nuke`。
+更新到新版本的 Go 之后本地安装包的二进制文件将全被删除。如果你想更新,重编译、重安装所有的go安装包可以使用:`go install -a`。
 
 go 的版本发布的很频繁,所以需要注意发布版本和包的兼容性。go1 之后都是自己编译自己了。
 
 go install 同样可以使用 go install 编译链接并安装本地自己的包(详见第 9.8.2 节)。
 
-更多信息可以在 http://golang.org/cmd/go 和 http://golang.org/cmd/goinstall 找到。
+更多信息可以在 [官方网站](http://golang.org/cmd/go/) 找到。
 
 ## 链接