From ad2719141f994b4e60702ad9ee4c3ec2b4482829 Mon Sep 17 00:00:00 2001 From: Unknwon Date: Sat, 8 Aug 2015 00:01:26 +0800 Subject: [PATCH] =?UTF-8?q?=E7=B2=BE=E6=A0=A1=EF=BC=9A9.6-9.7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README_gc.md | 2 +- TOC.md | 4 +++- eBook/09.6.md | 8 ++++---- eBook/09.7.md | 18 ++++++++---------- 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/README_gc.md b/README_gc.md index 9a28d88..9bd9fa8 100644 --- a/README_gc.md +++ b/README_gc.md @@ -19,4 +19,4 @@ Golang 编程：245386165 |更新日期 |更新内容 |----------|------------------ -|2015-08-07|9.5 自定义包和可见性 \ No newline at end of file +|2015-08-08|9.7 使用 go install 安装自定义包 \ No newline at end of file diff --git a/TOC.md b/TOC.md index 2b8268d..bb7e6a3 100644 --- a/TOC.md +++ b/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) \ No newline at end of file + - 9.5 [自定义包和可见性](eBook/09.5.md) + - 9.6 [为自定义包使用 godoc](eBook/09.6.md) + - 9.7 [使用 go install 安装自定义包](eBook/09.7.md) \ No newline at end of file diff --git a/eBook/09.6.md b/eBook/09.6.md index 0cb3090..1107d24 100644 --- a/eBook/09.6.md +++ b/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 分钟自动更新您的文档！ ## 链接 diff --git a/eBook/09.7.md b/eBook/09.7.md index ceb08d9..ac36c53 100644 --- a/eBook/09.7.md +++ b/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/) 找到。 ## 链接