add multirust

02-install/02-04-multirust.md

@@ -0,0 +1,93 @@
+# Rust 版本管理工具: multirust
+
+multirust 是一个简单的 Rust 版本管理工具.
+
+项目主页是: <https://github.com/brson/multirust>
+
+## Features
+
+* 管理安装多个官方版本的 Rust 二进制程序.
+* 配置基于目录的 Rust 工具链.
+* 安装和更新来自 Rust 的发布通道: nightly, beta 和 stable.
+* 接收来自发布通道更新的通知.
+* 从官方安装历史版本的 nightly 工具链.
+* 通过指定 stable 版本来安装.
+* 安装额外的 std 用于交叉编译.
+* 安装自定义的工具链.
+* 独立每个安装的 Cargo metadata.
+* 校验下载的 hash 值.
+* 校验签名 (如果 GPG 存在).
+* 断点续传.
+* 只依赖 bash, curl 和常见 unix 工具.
+* 支持 Linux, OS X, Windows(via MSYS2).
+
+## 安装
+
+```
+curl -sf https://raw.githubusercontent.com/brson/multirust/master/blastoff.sh | sh
+```
+
+这个命令将会编译和安装 multirust, 安装过程中可能会提示你输入 sudo 的密码. 然后, 他会下载和安装 stable 版本的工具链, 当执行 rustc, rustdoc 和 cargo 时, 将会配置他为默认工具链.
+
+`*nix` 上安装后工具链会被安装到 `~/.multirust/toolchains`.
+
+## 卸载
+
+```
+curl -sf https://raw.githubusercontent.com/brson/multirust/master/blastoff.sh | sh -s -- --uninstall
+```
+
+## 用法
+
+安装后会得到一个 multirust 命令, 多使用命令自带的帮助提示, 可以快速定位你需要功能.
+
+### 帮助
+
+运行 `multirust -h` 你将会得到如下提示:
+
+```
+❯ multirust -h
+# Usage: multirust <command> [--verbose] [--version]
+#
+# Commands:
+#
+#     default          Set the default toolchain
+#     override         Set the toolchain override for the current directory tree
+#     update           Install or update a given toolchain (for example, "stable", "beta", "nightly")
+#     show-override    Show information about the current override
+#     show-default     Show information about the current default
+#     list-overrides   List all overrides
+#     list-toolchains  List all installed toolchains
+#     remove-override  Remove an override, for current directory unless specified
+#     remove-toolchain Uninstall a toolchain
+#     list-available-targets
+#                      List targets available to install
+#     add-target       Add additional compilation targets to an existing toolchain
+#     run              Run a command in an environment configured for a toolchain
+#     delete-data      Delete all user metadata, including installed toolchains
+#     upgrade-data     Upgrade the ~/.multirust directory from previous versions
+#     doc              Open the documentation for the currently active toolchain
+#     which            Report location of the currently active Rust tool.
+#     help             Show help for this command or subcommands
+#
+# Use `multirust help <command>` for detailed help.
+#
+```
+
+根据提示, 使用 `multirust help <command>` 来查看子命令的帮助, 基本看这些帮助文档就足够了.
+
+下面着重介绍几个常用的命令.
+
+`multirust default beta|stable|nightly` 配置默认的工具链.
+
+`multirust override beta|stable|nightly` 配置一个目录以及其子目录的工具链.
+
+`multirust show-default` 显示当前默认的工具链信息.
+
+`multirust show-override` 显示当前目录的 override 的工具链信息.
+
+`multirust list-toolchains` 显示所有安装的工具链.
+
+`multirust list-overrides` 显示所有的 override 的工具链.
+
+`multirust update` 更新所有的发布通道的工具链.

README.md

@@ -19,6 +19,7 @@ https://wayslog.gitbooks.io/rustprimer/content/
   1. [Linux](./02-install/02-01-install_rust_on_linux.md)
   2. [Mac](./02-install/02-02-install_rust_on_mac_os.md)
   3. [Windows](./02-install/02-03-install_rust_on_windows.md)
+  4. [版本管理工具: multirust](./02-install/02-04-multirust.md)
 3. [编辑器](./03-editors/03-00-preface.md)
   1. [前期准备](./03-editors/03-01-before.md)「wayslog」
   1. [vim](./03-editors/03-02-vim.md)「wayslog」