docs: edit grammar

ruanyf · ruanyf · commit e4ca0868c337 · 2020-01-13T17:38:30.000+08:00
diff --git a/docs/grammar.md b/docs/grammar.md
@@ -1,5 +1,13 @@
 # Bash 的基本语法
 
+## 分号
+
+分号`;`是命令的结束符，使得一行可以放置多个命令，上一个命令执行结束后，再执行第二个命令。
+
+```bash
+$ clear; ls
+```
+
 ## 命令的分组和合并
 
 Shell 允许将多个命令分组和合并执行。
@@ -32,7 +40,19 @@ $ mkdir foo || mkdir bar
 
 ## if 结构
 
-`if`结构用于条件判断。
+`if`结构用于条件判断，符合条件时，才会执行指定的命令。它的语法如下。
+
+```bash
+if commands; then
+commands
+[elif commands; then
+commands...]
+[else
+commands]
+fi
+```
+
+这个命令分成三个部分：`if`、`elif`和`else`。其中，后两个部分是可选的。`if`后面是判断的条件，如果不成立，并且存在`elif`部分，就会进行`elif`判断；如果还不成立，并且存在`else`部分，则会执行`else`代码块。
 
 ```bash
 if test $USER = "foo"; then
@@ -42,7 +62,52 @@ else
 fi
 ```
 
-`if test -e filename`判断文件是否存在。
+上面的例子中，`if test`判断环境变量`$USER`是否等于`foo`，如果等于就输出`Hello foo.`，否则输出其他内容。
+
+`if`结构可以写在一行内。
+
+```bash
+$ if true; then echo "It's true."; fi
+It's true.
+
+$ if false; then echo "It's true."; fi
+```
+
+上面的例子中，`true`和`false`是两个特殊命令，前者代表操作成功，后者代表操作失败。
+
+`if`结构写成下面两种形式，也是可以的。
+
+```bash
+# 形式一
+if [ -f .bash_profile ]
+then
+  echo ".bash_profile 文件存在"
+else
+  echo ".bash_profile 文件不存在"
+fi
+
+# 形式二
+if [ -f .bash_profile ]
+then echo ".bash_profile 文件存在"
+else echo ".bash_profile 文件不存在"
+fi
+```
+
+## test 命令
+
+`if`结构往往与`test`命令一起使用，有两种形式。
+
+```bash
+# 第一种形式
+test 表达式
+
+# 第二种形式
+[ 表达式 ]
+```
+
+注意，第二种形式之中，`[`和`]`与内部的表达式之间都必须有空格。
+
+`if test -e filename`判断一个文件是否存在。
 
 ```bash
 if test -e /tmp/foo.txt ; then
@@ -58,6 +123,22 @@ if [ -e /tmp/foo.txt ] ; then
 fi
 ```
 
+`test`命令的参数如下。
+
+- `-d file`：如果`file`为目录，返回`true`。
+- `-e file`：如果`file`文件存在，返回`true`。
+- `-f file`：如果`file`文件存在，并且为一个常规文件，返回`true`。
+- `-L file`：如果`file`是一个符号链接，返回`true`。
+- `-r file`：如果`file`是一个文件，且用户有读权限，返回`true`。
+- `-w file`：如果`file`是一个文件，且用户有写权限，返回`true`。
+- `-x file`：如果`file`是一个文件，且用户有执行权限，返回`true`。
+- `file1 -nt file2`：如果`file1`比`file2`更新（根据修改时间），返回`true`。
+- `file1 -ot file2`：如果`file1`比`file2`更旧（根据修改时间），返回`true`。
+- `-z string`：如果`string`是一个空字符串，返回`true`。
+- `-n string`：如果`string`是一个非空字符串，返回`true`。
+- `string1 = string2`：如果`string1`与`string2`相等，返回`true`。
+- `string1 != string2`：如果`string1`与`string2`不相等，返回`true`。
+
 ## for 循环
 
 foo 循环用于命令的重复执行。
diff --git a/docs/script.md b/docs/script.md
@@ -208,11 +208,26 @@ $ exit
 `exit`命令后面可以跟参数，该参数就是退出状态。
 
 ```bash
+# 退出值为0（成功）
+$ exit 0
+
+# 退出值为1（失败）
 $ exit 1
 ```
 
 退出时，脚本会返回一个退出值。脚本的退出值，`0`表示正常，`1`表示发生错误，`2`表示用法不对，`126`表示不是可执行脚本，`127`表示命令没有发现。如果脚本被信号`N`终止，则退出值为`128 + N`。简单来说，只要退出值非0，就认为执行出错。
 
+下面是一个例子。
+
+```bash
+if [ $(id -u) != "0" ]; then
+  echo "根用户才能执行当前脚本"
+  exit 1
+fi
+```
+
+上面的例子中，`id -u`命令返回用户的 ID，一旦用户的 ID 不等于`0`（根用户的 ID），脚本就会退出，并且退出码为`1`，表示运行失败。
+
 上一条命令的退出值，可以用系统变量`$?`查询。使用这个命令，可以知道上一条命令是否执行成功。
 
 `exit`与`return`命令的差别是，`return`命令是函数的退出，并返回一个值给调用者，脚本依然执行。`exit`是整个脚本的退出，如果在函数之中调用`exit`，则退出函数，并终止脚本执行。
diff --git a/docs/set.md b/docs/set.md
@@ -95,6 +95,24 @@ bar
 set -o xtrace
 ```
 
+脚本当中如果要关闭命令输出，可以使用`set +x`。
+
+```bash
+#!/bin/bash
+
+number=1
+
+set -x
+if [ $number = "1" ]; then
+  echo "Number equals 1"
+else
+  echo "Number does not equal 1"
+fi
+set +x
+```
+
+上面的例子中，只对特定的代码段打开命令输出。
+
 ## Bash 的错误处理
 
 如果脚本里面有运行失败的命令（返回值非0），Bash 默认会继续执行后面的命令。
diff --git a/docs/variable.md b/docs/variable.md
@@ -30,7 +30,9 @@ $ printenv
 - `TERM`：终端类型名，即终端仿真器所用的协议。
 - `USER`：当前用户的用户名。
 
-Bash 还提供一些特殊变量。
+这些环境变量很少发生变化，一般可以视为常量。由于它们的变量名全部都是大写，所以传统上，如果用户要自己定义一个常量，也会使用全部大写的变量名。
+
+Bash 还提供一些特殊的环境变量。
 
 - `$` 进程的ID
 - `?` 上一个命令的退出码
