Merge remote-tracking branch 'refs/remotes/rustcc/master'

Author: lkchen-x1c

1st-glance/README.md

@@ -54,6 +54,43 @@ Rust 运行在以下操作系统上：Linux, OS X, Windows, FreeBSD, Android, iO
 - [Liqueur Librazy](https://github.com/Librazy)
 - [Knight42](https://github.com/knight42)
 - [Ryan Kung](https://github.com/ryankung)
+- lambdaplus
+- doomsplayer
+- lucklove
+- veekxt
+- lk-chen
+- RyanKung
+- arrowrowe
+- marvin-min
+- ghKelo
+- wy193777
+- domty
+- xusss
+- wangyu190810
+- nextzhou
+- zhongke
+- [ryuki](https://github.com/3442853561)
+- codeworm96
+- anzhihun
+- lidashuang
+- sceext2
+- loggerhead
+- twq0076262
+- passchaos
+- yyrust
+- markgeek
+- ts25504
+- overvenus
+- Akagi201
+- theJian
+- jqs7
+- ahjdzx
+- chareice
+- chenshaobo
+- marvinguo
+- izgzhen
+- ziqin
+- peng1999
 
 等。在此，向他们的辛苦工作和无私奉献表示尊敬和感谢！
 

CONTRIBUTING.md

@@ -0,0 +1,3 @@
+我们欢迎RustPrimer的Contributor们将自己的 `[blog/github/社交帐号]`
+添加在 [1st-glance/README.md](./1st-glance/README.md)里。
+但严禁未参与者恶意添加帐号，违者将会被永久拒绝PR和issue权限。

README.md

@@ -6,16 +6,17 @@
 [build-url]: https://travis-ci.org/rustcc/RustPrimer
 
 The Rust primer for beginners.
+
 给初学者的Rust中文教程。
 
 ## 在线阅读地址
 
-[点我阅读](https://wayslog.gitbooks.io/rustprimer/content/)
+[点我阅读](https://rustcc.gitbooks.io/rustprimer/content/)
 
 也可复制以下链接：
 
 ```
-https://wayslog.gitbooks.io/rustprimer/content/
+https://rustcc.gitbooks.io/rustprimer/content/
 ```
 
 ## 社区
@@ -52,11 +53,6 @@ gitbook serve
 
 即可。
 
-
-## 成为Contributors
-
-我们欢迎RustPrimer的Contributor们将自己的 `[blog/github/社交帐号]` 添加在 [1st-glance/README.md](./1st-glance/README.md)里。但严禁未参与者恶意添加帐号，违者将会被永久拒绝PR和issue权限。
-
 ## ChangeLog
 
 1. 2016年3月31日，初稿完成。发布 v1.0 版。

SUMMARY.md

@@ -47,7 +47,7 @@
   * [trait关键字](trait/trait.md)
   * [trait对象](trait/trait-object.md)
 * [泛型](generic/generic.md)「stormgbs」
-* [可变性、所有权、租借和生命期](ownership-system/ownership_system.md)「stormgbs」
+* [可变性、所有权、租借和生命期](ownership-system/preface.md)「stormgbs」
   * [所有权](ownership-system/ownership.md)
   * [引用和借用](ownership-system/borrowing_reference.md)
   * [生命周期](ownership-system/lifetime.md)
@@ -63,8 +63,12 @@
 * [模块和包系统、Prelude](module/preface.md)「daogangtang」
   * [模块 module 和包 crate](module/module.md)
   * [Prelude](module/prelude.md)
+  * [pub restricted](module/pub-restricted.md)
 * [Option、Result与错误处理](error-handling/option-result.md)「JohnSmithX」
-* [输入与输出](io/io.md)「tennix」
+* [输入与输出](io/preface.md)
+  * [标准输入输出](io/io.md) 
+  * [print! 宏](io/output.md)
+  * [文件输入输出](io/file-io.md)「tennix」
 * [宏系统](macro/macro.md)「tennix」
 * [堆、栈与Box](heap-stack/heap-stack.md)「tennix」
 * [几种智能指针](rcarc/preface.md)「daogangtang」
@@ -100,7 +104,7 @@
   * [评测 (benchmark)](testing/bench.md)
 * [代码风格](coding-style/style.md)「tiansiyuan」
 * [Any与反射](any/any.md)「wayslog」
-* [安全（safe）](safe/safety.md)「daogangtang」
+* [安全](safe/safety.md)「daogangtang」
 * [常用数据结构实现](data-structure/preface.md)「Naupio」
   * [栈结构](data-structure/stack.md)
   * [队列](data-structure/queue.md)

TOC.md

@@ -0,0 +1,117 @@
+- [初识Rust](1st-glance/README.md)
+- [安装Rust](install/preface.md)
+  - [Linux](install/install_rust_on_linux.md)
+  - [Mac](install/install_rust_on_mac_os.md)
+  - [Windows](install/install_rust_on_windows.md)
+  - [版本管理工具: rustup](install/rustup.md)
+- [编辑器](editors/preface.md)
+  - [前期准备](editors/before.md)
+  - [vim](editors/vim.md)
+  - [emacs](editors/emacs.md)
+  - [vscode](editors/vscode.md)
+  - [atom](editors/atom.md)
+  - [sublime](editors/sublime.md)
+  - [visual studio](editors/visualstudio.md)
+  - [spacemacs](editors/spacemacs.md)
+- [Rust快速入门](quickstart/quickstart.md)
+  - [Rust旅程](quickstart/rust-travel.md)
+  - [变量绑定与原生类型](quickstart/primitive-type.md)
+  - [数组、动态数组和字符串](quickstart/vector-string.md)
+  - [结构体与枚举](quickstart/struct-enum.md)
+  - [控制流](quickstart/control-flow.md)
+  - [函数与方法](quickstart/function-method.md)
+  - [特性](quickstart/trait.md)
+  - [注释与文档](quickstart/comments-document.md)
+  - [输入输出流](quickstart/io-stream.md)
+- [Cargo项目管理器](cargo-projects-manager/cargo-projects-manager.md)
+- [基本程序结构](flow/preface.md)
+  - [注释](flow/comment.md)
+  - [条件](flow/condition.md)
+  - [循环](flow/repetition.md)
+- [类型、运算符和字符串](type/preface.md)
+  - [基础类型](type/types.md)
+  - [复合类型](type/compound-types.md)
+  - [字符串类](type/string.md)
+  - [基础运算符和字符串格式化](type/operator-and-formatting.md)
+- [函数](function/overview.md)
+  - [函数参数](function/arguement.md)
+  - [函数返回值](function/return_value.md)
+  - [语句和表达式](function/statement_expression.md)
+  - [高阶函数](function/higher_order_function.md)
+- [模式匹配](match/overview.md)
+  - [match关键字](match/match.md)
+  - [模式 pattern](match/pattern.md)
+- [特征 Trait](trait/overview.md)
+  - [trait关键字](trait/trait.md)
+  - [trait对象](trait/trait-object.md)
+- [泛型](generic/generic.md)
+- [可变性、所有权、租借和生命期](ownership-system/ownership_system.md)
+  - [所有权](ownership-system/ownership.md)
+  - [引用和借用](ownership-system/borrowing_reference.md)
+  - [生命周期](ownership-system/lifetime.md)
+- [闭包](closure/overview.md)
+  - [闭包的语法](closure/syntax.md)
+  - [闭包的实现](closure/implementation.md)
+  - [闭包作为参数和返回值](closure/as_argument_return_value.md)
+- [集合类型 Collections](collections/overview.md)
+  - [动态数组 Vec](collections/vec.md)
+  - [哈希表 HashMap](collections/hashmap.md)
+- [迭代器](iterator/overview.md)
+  - [迭代器、适配器、消费者](iterator/iterator.md)
+- [模块和包系统、Prelude](module/preface.md)
+  - [模块 module 和包 crate](module/module.md)
+  - [Prelude](module/prelude.md)
+- [Option、Result与错误处理](error-handling/option-result.md)
+- [输入与输出](io/io.md)
+- [宏系统](macro/macro.md)
+- [堆、栈与Box](heap-stack/heap-stack.md)
+- [几种智能指针](rcarc/preface.md)
+  - [Rc, Arc](rcarc/rcarc.md)
+  - [Mutex, RwLock](rcarc/mutex.md)
+  - [Cell, RefCell](rcarc/cell.md)
+- [类型系统中的几个常见 Trait](intoborrow/preface.md) 
+  - [Into/From 及其在 String 和 &str 互转上的应用](intoborrow/into.md)
+  - [AsRef, AsMut](intoborrow/asref.md)
+  - [Borrow, BorrowMut, ToOwned](intoborrow/borrow.md)
+  - [Deref 与 Deref coercions](intoborrow/deref.md)
+  - [Cow 及其在 String 和 &str 上的应用](intoborrow/cow.md)
+- [Send 和 Sync](marker/sendsync.md)
+- [并发，并行，多线程编程](concurrency-parallel-thread/preface.md)
+  - [线程](concurrency-parallel-thread/thread.md)
+  - [消息传递](concurrency-parallel-thread/message-passing.md)
+  - [共享内存](concurrency-parallel-thread/share-memory.md)
+  - [同步](concurrency-parallel-thread/synchronize.md)
+  - [并行](concurrency-parallel-thread/parallel.md)
+- [Unsafe、原始指针](unsafe-rawpointer/preface.md)
+  - [Unsafe](unsafe-rawpointer/unsafe.md)
+  - [原始指针](unsafe-rawpointer/raw-pointer.md)
+- [FFI](ffi/preface.md)
+  - [rust调用ffi函数](ffi/calling-ffi-function.md)
+  - [将rust编译成库](ffi/compiling-rust-to-lib.md)
+- [运算符重载](operator-overloading/operator.md)
+- [属性和编译器参数](attr-and-compiler-arg/preface.md)
+  - [属性](attr-and-compiler-arg/attribute.md)
+  - [编译器参数](attr-and-compiler-arg/rustc-option.md)
+- [Cargo参数配置](cargo-detailed-cfg/cargo-detailed-cfg.md)
+- [测试与评测](testing/preface.md)
+  - [测试 (testing)](testing/threearchtest.md)
+  - [评测 (benchmark)](testing/bench.md)
+- [代码风格](coding-style/style.md)
+- [Any与反射](any/any.md)
+- [安全（safe）](safe/safety.md)
+- [常用数据结构实现](data-structure/preface.md)
+  - [栈结构](data-structure/stack.md)
+  - [队列](data-structure/queue.md)
+  - [二叉树](data-structure/binary_tree.md)
+  - [优先队列](data-structure/priority_queue.md)
+  - [链表](data-structure/linked_list.md)
+  - [图结构](data-structure/graph.md)
+- [标准库介绍](std/overview.md)
+  - [系统命令:调用grep](std/process.md)
+  - [目录操作:简单grep](std/fs-and-path.md)
+  - [网络模块:W回音](std/net.md)
+- [实战篇](action/preface.md)
+  - [实战：Json处理](action/json_data/readme.md)
+  - [实战：Web 应用开发入门](action/mysite/readme.md)
+  - [实战：使用Postgresql数据库](action/db/readme.md)
+- [附录-术语表](appendix/glossary.md)

action/db/readme.md

@@ -1,16 +1,16 @@
 # rust数据库操作
 
-编程时，我们依赖数据库来存储相应的数据，很多编程语言都支持对数据库的操作（为什么不是全部，因为还有html这样的东西），所以当然
-可以使用rust操作数据库。
+编程时，我们依赖数据库来存储相应的数据，很多编程语言都支持对数据库的操作，所以当然可以使用Rust操作数据库。
 
-不过在我自己操作时，发现很多问题，主要因为我不了解rust在操作数据库时，应该注意的事情，从而浪费了很多的时间，在进行数据查询时。
+不过在我自己操作时，发现很多问题，主要因为我不了解Rust在操作数据库时，应该注意的事情，从而浪费了很多的时间，在进行数据查询时。
 具体遇到的坑，我会做一些演示，从而让大家避免这些情况。
 
-首先使用rust操作postgresql,因为postgresql是我最喜欢的数据库。
+首先使用Rust操作PostgreSQL,因为PostgreSQL是我最喜欢的数据库。
 
 首先创建新项目 `cargo new db --bin`
 
-在cargo.toml中添加,postgres:
+在cargo.toml中添加 `postgres` 如下：
+
 
 ``` rust
 [package]
@@ -142,6 +142,7 @@ pub fn query_all(conn: &Connection,query: &str){
 }
 
 ```
+
 然后在main.rs 中调用相应的函数代码如下
 1. extern db ,引入db，也就是将项目本身引入
 2. use db 使用db，中的可以被引入的函数
@@ -182,14 +183,15 @@ fn main() {
 ```
 
 自己遇到的坑
+
 - 创建连接函数时，连接必须有一个返回值，所以必须指定返回值的类型，
-对于一个写python的人而言，我觉得是痛苦的，我想按照官方的写法match
+对于一个写Python的人而言，我觉得是痛苦的，我想按照官方的写法match
 一下，发现可能产生多个返回值。在编译时直接无法通过编译，所以最终
 使用了unwrap,解决问题，不过我还是没有学会，函数多值返回时我如何
 定义返回值
 
-- 在使用`&conn.query(query,&[]).unwrap()`时，我按照文档操作，文档
-说返回的是一个可迭代的数据，那也就是说，我可以使用for循环，将数据打印，
+- 在使用`&conn.query(query,&[]).unwrap()`时，我按照文档操作，文档说
+返回的是一个可迭代的数据，那也就是说，我可以使用for循环，将数据打印，
 但是发现怎么也不能实现：
 
 ``` rust
@@ -202,7 +204,9 @@ pub fn query_all(conn: &Connection,query: &str){
 }
 
 ```
+
 报错如下：
+
 ``` rust
 vagrant@ubuntu-14:~/tmp/test/rustprimer/db$ cargo run
    Compiling db v0.1.0 (file:///home/vagrant/tmp/test/rustprimer/db)
@@ -216,13 +220,14 @@ src/lib.rs:53:37: 53:47 help: run `rustc --explain E0282` to see a detailed expl
 error: aborting due to previous error
 Could not compile `db`.
 
-``
+```
+
 然后去查看了关于postgres模块的所有函数，尝试了无数种办法，依旧没有解决。
 
-可能自己眼高手低，如果从头再把rust的相关教程看一下，可能很早就发现这个问题，
-也有可能是因为习惯了写python，导致自己使用固有的思维来看待问题和钻牛角尖，才
+可能自己眼高手低，如果从头再把Rust的相关教程看一下，可能很早就发现这个问题，
+也有可能是因为习惯了写Python，导致自己使用固有的思维来看待问题和钻牛角尖，才
 导致出现这样的问题，浪费很多的时间。
 
 - 改变思维，把自己当作一个全新的新手，既要利用已有的思想来学习新的语言，同样不要
-被自己很精通的语言，固话自己的思维。
+被自己很精通的语言，固化自己的思维。