docs: add stack

ruanyf · ruanyf · commit 1300534f7597 · 2020-02-28T16:48:59.000+08:00
diff --git a/docs/expansion.md b/docs/expansion.md
@@ -382,7 +382,7 @@ baz
 
 ## 子命令扩展
 
-`$(...)`可以扩展成另一个命令的运行结果。
+`$(...)`可以扩展成另一个命令的运行结果，内部命令的所有输出都会作为返回值。
 
 ```bash
 $ echo $(date)
@@ -398,6 +398,8 @@ $ echo `date`
 Tue Jan 28 00:01:13 CST 2020
 ```
 
+`$(...)`还可以嵌套，比如`$(ls $(pwd))`。
+
 ## 算术扩展
 
 `$((...))`可以扩展成整数运算的结果。
diff --git a/docs/stack.md b/docs/stack.md
@@ -0,0 +1,56 @@
+# 目录堆栈
+
+## cd -
+
+Bash 可以记忆用户进入过的目录。默认情况下，只记忆前一次所在的目录，`cd -`命令可以返回前一次的目录。
+
+```bash
+# 当前目录是 /path/to/foo
+$ cd bar
+
+# 重新回到 /path/to/foo
+$ cd -
+```
+
+上面例子中，用户原来所在的目录是`/path/to/foo`，进入子目录`bar`以后，使用`cd -`可以回到原来的目录。
+
+## pushd，popd
+
+如果希望记忆多重目录，可以使用`pushd`命令和`popd`命令。
+
+`pushd`命令的用法类似`cd`命令，可以进入指定的目录。
+
+```bash
+$ pushd dirname
+```
+
+第一次使用`pushd`命令时，会将当前目录先放入堆栈，然后将所要进入的目录也放入堆栈，位置在前一个记录的上方。以后每次使用`pushd`命令，都会将所要进入的目录，放在堆栈的顶部。
+
+使用`popd`命令，会移除堆栈的顶部记录，并进入后一条目录所指向的目录（即原来的第二条目录）。
+
+下面是一个例子。
+
+```bash
+# 当前处在主目录，堆栈为空
+$ pwd
+/home/me
+
+# 进入 /home/me/foo
+# 当前堆栈为 /home/me/foo /home/me
+$ pushd ~/foo
+
+# 进入 /etc
+# 当前堆栈为 /etc /home/me/foo /home/me
+$ pushd /etc
+
+# 进入 /home/me/foo
+# 当前堆栈为 /home/me/foo /home/me
+$ popd
+
+# 进入 /home/me
+# 当前堆栈为 /home/me
+$ popd
+
+# 目录不变，当前堆栈为空
+$ popd
+```
diff --git a/docs/string.md b/docs/string.md
@@ -44,6 +44,18 @@ footman
 
 上面例子是返回变量`count`从4号位置一直到结尾的子字符串。
 
+如果`offset`为负值，表示从字符串的末尾开始算起。注意，负数前面必须有一个空格， 以防止与`${variable:-word}`的变量设置默认值的形式混淆。这时，如果还指定`length`，则`length`不能小于零。
+
+```bash
+$ foo="This string is long."
+$ echo ${foo: -5}
+long.
+$ echo ${foo: -5:2}
+lo
+```
+
+上面例子中，`offset`为`-5`，表示从倒数第5个字符开始截取，所以返回`long.`。如果指定长度为`2`，则返回`lo`。
+
 ## 字符串的处理
 
 Bash 提供字符串处理的多种方法。
@@ -189,112 +201,17 @@ $ echo ${path/.*/}
 
 上面例子中，第二个斜杠后面的`string`部分省略了，所以模式`.*`匹配的部分`.name`被删除后返回。
 
-## 返回变量名的展开
-
-`${!prefix*}`和`${!prefix@}`，会返回以 prefix 开头的已有变量名，它们的执行结果相同。
-
-```bash
-$ echo ${!BASH*}
-BASH BASH_ARGC BASH_ARGV BASH_COMMAND BASH_COMPLETION
-BASH_COMPLETION_DIR BASH_LINENO BASH_SOURCE BASH_SUBSHELL
-BASH_VERSINFO BASH_VERSION
-```
-
-## 字符串的展开
-
-字符串长度
-
-```bash
-${#parameter}
-```
-
-`${#parameter}`展开成由 parameter 所包含的字符串的长度。通常，parameter 是一个字符串；然而，如果 parameter 是`@`或者是`*` 的话， 则展开结果是位置参数的个数。
-
-```bash
-$ foo="This string is long."
-$ echo "'$foo' is ${#foo} characters long."
-'This string is long.' is 20 characters long.
-```
-
-截取子字符串。
-
-```bash
-${parameter:offset}
-
-${parameter:offset:length}
-```
-
-这些展开用来从 parameter 所包含的字符串中提取一部分字符。提取的字符始于 第 offset 个字符（从字符串开头算起）直到字符串的末尾，除非指定提取的长度。
-
-```bash
-$ foo="This string is long."
-$ echo ${foo:5}
-string is long.
-$ echo ${foo:5:6}
-string
-```
-
-若 offset 的值为负数，则认为 offset 值是从字符串的末尾开始算起，而不是从开头。注意负数前面必须有一个空格， 为防止与 ${parameter:-word} 展开形式混淆。length，若出现，则必须不能小于零。
+这个语法还有两种扩展形式。
 
 ```bash
-$ foo="This string is long."
-$ echo ${foo: -5}
-long.
-$ echo ${foo: -5:2}
-lo
-```
-
-如果 parameter 是 @，展开结果是 length 个位置参数，从第 offset 个位置参数开始。
+# 模式必须出现在字符串的开头
+${variable/#pattern/string}
 
-清除匹配的模式
-
-```bash
-${parameter#pattern}
-
-${parameter##pattern}
-```
-
-这些展开会从 paramter 所包含的字符串中清除开头一部分文本，这些字符要匹配定义的 patten。pattern 是 通配符模式，就如那些用在路径名展开中的模式。这两种形式的差异之处是该 # 形式清除最短的匹配结果， 而该 ## 模式清除最长的匹配结果。
-
-```bash
-$ foo=file.txt.zip
-$ echo ${foo#*.}
-txt.zip
-$ echo ${foo##*.}
-zip
+# 模式必须出现在字符串的结尾
+${variable/%pattern/string}
 ```
 
-清除匹配的模式（从尾部开始）
-
-```bash
-${parameter%pattern}
-
-${parameter%%pattern}
-```
-
-这些展开和上面的 # 和 ## 展开一样，除了它们清除的文本从 parameter 所包含字符串的末尾开始，而不是开头。
-
-```bash
-$ foo=file.txt.zip
-$ echo ${foo%.*}
-file.txt
-$ echo ${foo%%.*}
-file
-```
-
-查找和替换
-
-```bash
-${parameter/pattern/string}
-
-${parameter//pattern/string}
-
-${parameter/#pattern/string}
-
-${parameter/%pattern/string}
-```
-
-这种形式的展开对 parameter 的内容执行查找和替换操作。如果找到了匹配通配符 pattern 的文本， 则用 string 的内容替换它。在正常形式下，只有第一个匹配项会被替换掉。在该 // 形式下，所有的匹配项都会被替换掉。 该 /# 要求匹配项出现在字符串的开头，而 /% 要求匹配项出现在字符串的末尾。/string 可能会省略掉，这样会 导致删除匹配的文本。
+下面是一个例子。
 
 ```bash
 $ foo=JPG.JPG
