精校:9.6-9.7

This commit is contained in:
Unknwon
2015-08-08 00:01:26 +08:00
parent a9e5e2aff9
commit ad2719141f
4 changed files with 16 additions and 16 deletions

View File

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

2
TOC.md
View File

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

View File

@@ -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 分钟自动更新您的文档!
## 链接

View File

@@ -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/) 找到。
## 链接