docs: edit expansion

Author: ruanyf

chapters.yml

@@ -1,8 +1,8 @@
 - intro.md: Bash 简介
 - grammar.md: Bash 的基本语法
+- expansion.md: Bash 的模式扩展
 - quotation.md: 引号和转义
 - string.md: 字符串操作
-- expansion.md: Bash 的模式扩展
 - arithmetic.md: Bash 的算术运算
 - variable.md: Bash 变量
 - script.md: Bash 脚本简介

docs/expansion.md

@@ -6,7 +6,22 @@ Shell 接收到用户输入的命令以后，会根据空格将用户的输入
 
 这种特殊字符的扩展，称为通配符扩展（wildcard expansion）或者模式扩展（globbing）。Bash 一共提供八种扩展，先进行扩展，然后再执行命令。
 
-早期的 Unix 系统有一个`/etc/glob`文件，保存扩展的模板。后来 Bash 内置了这个功能，但是这个名字保留了下来。特殊字符的扩展早于正则表达式出现，可以看作是原始的正则表达式。它的功能没有正则那么强大灵活，但是优点是简单和方便。
+- 波浪线扩展
+- `?` 字符扩展
+- `*` 字符扩展
+- 方括号扩展
+- 大括号扩展
+- 变量扩展
+- 子命令扩展
+- 算术扩展
+
+本章介绍这八种扩展。
+
+Bash 是先进行扩展，再执行命令。因此，扩展的结果与所要执行的命令无关，是由 Bash 负责的。命令本身并不存在参数扩展，收到什么参数就原样执行。这一点务必需要记住。
+
+`globbing`这个词，来自于早期的 Unix 系统有一个`/etc/glob`文件，保存扩展的模板。后来 Bash 内置了这个功能，但是这个名字就保留了下来。
+
+模式扩展与正则表达式的关系是，模式扩展早于正则表达式出现，可以看作是原始的正则表达式。它的功能没有正则那么强大灵活，但是优点是简单和方便。
 
 Bash 允许用户关闭通配符扩展。
 
@@ -33,14 +48,14 @@ $ echo ~
 /home/me
 ```
 
-如果要进入主目录的某个子目录，通常会把子目录放在波浪号后面。
+`~/dir`表示扩展成主目录的某个子目录，`dir`是主目录里面的一个子目录名。
 
 ```bash
 # 进入 /home/me/foo 目录
 $ cd ~/foo
 ```
 
-如果`~`后面是已经存在的用户名，则会返回该用户的主目录。
+`~user`表示扩展成用户`user`的主目录。
 
 ```bash
 $ echo ~foo
@@ -52,14 +67,14 @@ $ echo ~root
 
 上面例子中，Bash 会根据波浪号后面的用户名，返回该用户的主目录。
 
-如果是不存在的用户名，则波浪号扩展不起作用。
+如果`~user`的`user`是不存在的用户名，则波浪号扩展不起作用。
 
 ```bash
 $ echo ~nonExistedUser
 ~nonExistedUser
 ```
 
-此外，`~+`会返回当前所在的目录，等同于`pwd`命令。
+`~+`会扩展成当前所在的目录，等同于`pwd`命令。
 
 ```bash
 $ cd ~/foo
@@ -69,7 +84,7 @@ $ echo ~+
 
 ## `?` 字符扩展
 
-`?`字符代表文件路径里面的任意单个字符，不包括空字符。比如，`Data???`匹配所有`Data`开头后面跟着三个字符的文件名。
+`?`字符代表文件路径里面的任意单个字符，不包括空字符。比如，`Data???`匹配所有`Data`后面跟着三个字符的文件名。
 
 ```bash
 # 存在文件 a.txt 和 b.txt
@@ -89,7 +104,7 @@ ab.txt
 
 上面命令中，`??`匹配了两个字符。
 
-注意，Bash 是先进行扩展，再执行命令。因此，扩展的结果决定了命令执行的结果，各种扩展只是 Bash 的功能，命令本身并不存在参数扩展，收到什么参数就原样执行。
+`?` 字符扩展属于文件名扩展，只有文件确实存在的前提下，才会发生扩展。如果文件不存在，扩展就不会发生。
 
 ```bash
 # 当前目录有 a.txt 文件
@@ -105,7 +120,7 @@ $ echo ?.txt
 
 ## `*` 字符扩展
 
-`*`字符代表文件路径里面的任意数量字符，包括零个字符。
+`*`字符代表文件路径里面的任意数量的字符，包括零个字符。
 
 ```bash
 # 存在文件 a.txt、b.txt 和 ab.txt
@@ -133,11 +148,22 @@ b.txt ab.txt
 # 显示所有隐藏文件
 $ echo .*
 
+# 与方括号扩展结合使用，
 # 只显示正常的隐藏文件，不显示 . 和 .. 这两个特殊文件
 $ echo .[!.]*
 ```
 
-## 方括号模式
+`*`字符扩展也属于文件名扩展，只有文件确实存在的前提下才会扩展。如果文件不存在，就会原样输出。
+
+```bash
+# 当前目录不存在 c 开头的文件
+$ echo c*.txt
+c*.txt
+```
+
+上面例子中，当前目录里面没有`c`开头的文件，导致`c*.txt`会原样输出。
+
+## 方括号扩展
 
 方括号模式是`[...]`，可以匹配方括号之中的任意一个字符，比如`[aeiou]`可以匹配五个元音字母中的任意一个。该模式属于文件名匹配，即匹配后的结果必须符合现有的文件路径，如果不存在匹配，就会保持原样，不进行扩展。
 
@@ -168,7 +194,7 @@ aba bbb
 
 注意，如果需要匹配`[`字符，可以放在方括号内，比如`[[aeiou]`。如果需要匹配连字号`-`，只能放在方括号内部的开头或结尾，比如`[-aeiou]`或`[aeiou-]`。
 
-## [start-end] 模式
+## [start-end] 扩展
 
 方括号模式`[start-end]`可以表示一个连续的范围。
 

docs/quotation.md

@@ -50,6 +50,8 @@ $ echo -e "a\tb"
 a        b
 ```
 
+上面例子中，命令行直接输出不可打印字符，Bash 不能正确解释。必须把它们放在引号之中，然后使用`echo`命令的`-e`参数。
+
 由于反斜杠可以对换行符转义，使得 Bash 认为换行符是一个普通字符，从而可以将一行命令写成多行。
 
 ```bash
@@ -61,11 +63,13 @@ $ mv \
 $ mv /path/to/foo /path/to/bar
 ```
 
-上面例子中，如果一条命令过长，就可以在行尾使用反斜杠，将其改写成多行。
+上面例子中，如果一条命令过长，就可以在行尾使用反斜杠，将其改写成多行。这是常见的多行命令的写法。
 
 ## 单引号
 
-单引号用于保留字符的字面含义，各种特殊字符都能在单引号里面变为普通字符，包括星号（`*`）、美元符号（`$`）、反斜杠（`\`）等。也就是说，单引号之中所有字符都会变成普通字符。
+Bash 允许字符串放在单引号或双引号之中，加以引用。
+
+单引号用于保留字符的字面含义，各种特殊字符在单引号里面，都会变为普通字符，比如星号（`*`）、美元符号（`$`）、反斜杠（`\`）等。
 
 ```bash
 $ echo '*'
@@ -81,9 +85,9 @@ $ echo '$(echo foo)'
 $(echo foo)
 ```
 
-上面命令中，单引号使得 Bash 扩展、变量引用、算术运算和子命令，都失效了。
+上面命令中，单引号使得 Bash 扩展、变量引用、算术运算和子命令，都失效了。如果不使用单引号，它们都会被 Bash 自动扩展。
 
-由于反斜杠在单引号里面会变成普通字符，所以如果单引号之中，还要使用单引号，不能使用转义，需要在外层的单引号前面加上一个美元符号（`$`），然后再对里层的单引号转义。
+由于反斜杠在单引号里面变成了普通字符，所以如果单引号之中，还要使用单引号，不能使用转义，需要在外层的单引号前面加上一个美元符号（`$`），然后再对里层的单引号转义。
 
 ```bash
 # 不正确
@@ -105,14 +109,14 @@ it's
 
 ## 双引号
 
-双引号可以保留大部分特殊字符的本来含义（比如`*`），但是三个符号除外：美元符号`$`、反引号和反斜杠（`\`）。
+双引号比单引号宽松，可以保留大部分特殊字符的本来含义，但是三个字符除外：美元符号`$`、反引号和反斜杠（`\`）。也就是说，这三个字符在双引号之中，会被 Bash 自动扩展。
 
 ```bash
 $ echo "*"
 *
 ```
 
-上面例子中，通配符`*`放在双引号之中，就变成了普通字符，会原样输出。
+上面例子中，通配符`*`放在双引号之中，就变成了普通字符，会原样输出。这一点需要特别留意，双引号里面不会进行文件名扩展。
 
 ```bash
 $ echo "$SHELL"
@@ -132,7 +136,7 @@ $ echo "\\"
 \
 ```
 
-上面例子中，反斜杠在双引号之中保持特殊含义，用来转义。可以使用反斜杠，在双引号之中插入双引号，以及插入反斜杠本身。
+上面例子中，反斜杠在双引号之中保持特殊含义，用来转义。所以，可以使用反斜杠，在双引号之中插入双引号，或者插入反斜杠本身。
 
 由于双引号将换行符解释为普通字符，所以可以利用双引号，在命令行输入多行文本。
 
@@ -145,23 +149,14 @@ world
 
 上面命令中，Bash 正常情况下会将换行符解释为命令结束，但是换行符在双引号之中就是普通字符，所以可以输入多行。`echo`命令会将换行符原样输出，显示的时候正常解释为换行。
 
-如果文件名包含空格，就可以把它放在双引号之中。
+双引号的另一个常见的使用场合是，文件名包含空格。这时就必须使用双引号，将文件名放在里面。
 
 ```bash
 $ ls "two words.txt"
 ```
 
 上面命令中，`two words.txt`是一个包含空格的文件名，否则就会被 Bash 当作两个文件。
 
-注意，双引号之中，不会进行文件名扩展。
-
-```bash
-$ echo "*"
-*
-```
-
-上面例子中，双引号之中的星号不会扩展成文件名。
-
 双引号会原样保存多余的空格。
 
 ```bash
@@ -187,7 +182,7 @@ $ echo "$(cal)"
 26 27 28 29 30 31
 ```
 
-上面命令中，如果`$(cal)`不放在双引号之中，`echo`就会将所有结果以单行输出，丢弃了所有原始的格式。
+上面例子中，如果`$(cal)`不放在双引号之中，`echo`就会将所有结果以单行输出，丢弃了所有原始的格式。
 
 ## Here 文档
 
@@ -253,7 +248,21 @@ $foo
 
 上面例子中，Here 文档的开始标记（`_example_`）放在单引号之中，导致变量替换失效了。
 
-Here 文档的本质是重定向，它将字符串重定向输出给某个命令，相当于包含了`echo`命令。所以，Here 字符串只适合那些可以接受标准输入作为参数的命令，对于其他命令无效，比如`echo`命令就不能用 Here 文档。
+Here 文档的本质是重定向，它将字符串重定向输出给某个命令，相当于包含了`echo`命令。
+
+```bash
+$ command << token
+  string
+token
+
+# 等同于
+
+$ echo string | command
+```
+
+上面代码中，Here 文档相当于`echo`命令的重定向。
+
+所以，Here 字符串只适合那些可以接受标准输入作为参数的命令，对于其他命令无效，比如`echo`命令就不能用 Here 文档作为参数。
 
 ```bash
 $ echo << _example_
@@ -275,12 +284,6 @@ Here 文档还有一个变体，叫做 Here 字符串（Here string），使用
 
 它的作用是将字符串通过标准输入，传递给命令。
 
-```bash
-$ md5sum <<< 'ddd'
-# 等同于
-$ echo 'ddd' | md5sum
-```
-
 有些命令直接接受给定的参数，与通过标准输入接受参数，结果是不一样的。所以才有了这个语法，使得将字符串通过标准输入传递给命令更方便，比如`cat`命令只接受标准输入传入的字符串。
 
 ```bash
@@ -291,3 +294,11 @@ $ echo 'hi there' | cat
 
 上面的第一种语法使用了 Here 字符串，要比第二种语法看上去语义更好，也更简洁。
 
+```bash
+$ md5sum <<< 'ddd'
+# 等同于
+$ echo 'ddd' | md5sum
+```
+
+上面例子中，`md5sum`命令只能接受标准输入作为参数，不能直接将字符串放在命令后面，会被当作文件名，即`md5sum ddd`里面的`ddd`会被解释成文件名。这时就可以用 Here 字符串，将字符串传给`md5sum`命令。
+