GKPython
diff --git a/‎docs/archives/stdio.md‎ ‎docs/archives/deleted/stdio.md‎docs/archives/stdio.md renamed to docs/archives/deleted/stdio.md
Lines changed: 9 additions & 0 deletions b/‎docs/archives/stdio.md‎ ‎docs/archives/deleted/stdio.md‎docs/archives/stdio.md renamed to docs/archives/deleted/stdio.md
Lines changed: 9 additions & 0 deletions
diff --git a/‎docs/archives/option.md‎
Lines changed: 0 additions & 152 deletions b/‎docs/archives/option.md‎
Lines changed: 0 additions & 152 deletions
diff --git a/‎docs/archives/references.md‎
Lines changed: 0 additions & 3 deletions b/‎docs/archives/references.md‎
Lines changed: 0 additions & 3 deletions
diff --git a/‎docs/archives/session.md‎
Lines changed: 0 additions & 11 deletions b/‎docs/archives/session.md‎
Lines changed: 0 additions & 11 deletions
diff --git a/‎docs/grammar.md‎
Lines changed: 20 additions & 2 deletions b/‎docs/grammar.md‎
Lines changed: 20 additions & 2 deletions
diff --git a/‎docs/script.md‎
Lines changed: 52 additions & 4 deletions b/‎docs/script.md‎
Lines changed: 52 additions & 4 deletions
diff --git a/‎docs/variable.md‎
Lines changed: 2 additions & 2 deletions b/‎docs/variable.md‎
Lines changed: 2 additions & 2 deletions
@@ -38,6 +38,15 @@ echo "<HTML>
 </HTML>"
 ```
 
+echo '<HTML>
+    <HEAD>
+          <TITLE>Page Title</TITLE>
+    </HEAD>
+    <BODY>
+          Page body.
+    </BODY>
+</HTML>'
+
 ## read
 
 `read`命令被用来从标准输入读取单行数据。这个命令可以用来读取键盘输入，当使用重定向的时候，读取文件中的一行数据。
 
@@ -4,16 +4,34 @@
 
 ## echo 命令
 
-`echo`命令的作用是输出一行文本，可以将该命令的参数原样输出。
+由于后面的例子会大量用到`echo`命令，这里先介绍这个命令。
+
+`echo`命令的作用是在屏幕输出一行文本，可以将该命令的参数原样输出。
 
 ```bash
 $ echo hello world
 hello world
-$
 ```
 
+上面例子中，`echo`的参数是`hello world`，可以原样输出。
+
 默认情况下，`echo`输出的文本末尾会有一个回车符。
 
+如果引号里面的文本包括换行，`echo`命令也能原样输出。
+
+```bash
+$ echo "<HTML>
+    <HEAD>
+          <TITLE>Page Title</TITLE>
+    </HEAD>
+    <BODY>
+          Page body.
+    </BODY>
+</HTML>"
+```
+
+上面例子中，`echo`可以原样输出多行文本。
+
 （1）`-n`参数
 
 `-n`参数可以取消输出末尾的回车符，使得下一个提示符紧跟在输出内容的后面。
 
@@ -346,7 +346,15 @@ fi
 
 ## read 命令
 
-有时，脚本需要用户输入参数，这时可以使用`read`命令。它将用户的输入存入一个参数变量，方便后面的代码使用。
+有时，脚本需要用户输入参数，这时可以使用`read`命令。它将用户的输入存入一个参数变量，方便后面的代码使用。用户按下回车键，就表示输入结束。
+
+`read`命令的格式如下。
+
+```bash
+read [-options] [variable...]
+```
+
+上面语法中，`options`是参数选项，`variable`是用来保存输入数值的一个或多个变量名。如果没有提供变量名，shell 变量`REPLY`会包含用户输入的一整行数据。
 
 下面是一个例子`demo.sh`。
 
@@ -366,8 +374,6 @@ $ bash demo.sh
 你的输入：你好，世界
 ```
 
-`read`命令的参数，就是保存用户输入内容的变量名。如果省略了`read`命令的参数，用户输入的内容会保存在环境变量`REPLY`。
-
 `read`可以接受用户输入的多个值。
 
 ```bash
@@ -379,6 +385,30 @@ echo "Hi! $LN, $FN !"
 
 上面例子中，`read`根据用户的输入，同时为两个变量赋值。
 
+如果用户的输入项少于`read`命令定义的变量数目，那么额外的变量值为空。如果用户的输入项多于定义的变量，那么多余的输入项会包含到最后一个变量中。
+
+如果`read`命令之后没有定义变量名，那么环境变量`REPLY`会包含所有的输入。
+
+```bash
+#!/bin/bash
+# read-single: read multiple values into default variable
+echo -n "Enter one or more values > "
+read
+echo "REPLY = '$REPLY'"
+```
+
+上面脚本的运行结果如下。
+
+```bash
+$ read-single
+Enter one or more values > a b c d
+REPLY = 'a b c d'
+```
+
+`read`命令的参数如下。
+
+**（1）-t 参数**
+
 `read`命令的`-t`参数，设置了超时的秒数。如果超过了指定时间，用户仍然没有输入，脚本将放弃等待，继续向下执行。
 
 ```bash
@@ -394,7 +424,25 @@ fi
 
 上面例子中，输入命令会等待3秒，如果用户超过这个时间没有输入，这个命令就会执行失败。`if`根据这个返回码，转入`else`代码块，继续往下执行。
 
-`-s`参数使得用户的输入不显示在屏幕上，这常常用于输入密码或保密信息。
+**（2）-p 参数**
+
+`-p`参数指定用户输入的提示信息。
+
+```bash
+read -p "Enter one or more values > "
+echo "REPLY = '$REPLY'"
+```
+
+上面例子中，先显示`Enter one or more values >`，再接受用户的输入。
+
+**（3）其他参数**
+
+- `-a array`：把用户输入赋值到数组`array`中，从零号位置开始。
+- `-d delimiter`：定义字符串`delimiter`的第一个字符作为用户输入的结束，而不是一个换行符。
+- `-n num`：读取`num`个输入的字符，而不是读取整行。
+- `-r`：raw 模式，表示不把用户输入的反斜杠字符解释为转义字符。
+- `-s`：使得用户的输入不显示在屏幕上，这常常用于输入密码或保密信息。
+- `-u fd`：使用文件描述符`fd`作为输入。
 
 ## 命令执行结果
 
 
@@ -19,6 +19,7 @@ $ printenv
 - `EDITOR`：文本编辑器的名字。
 - `HOME`：用户的主目录。
 - `HOST`：当前主机的名称。
+- `IFS`：词与词之间的分隔符，默认为空格。
 - `LANG`：字符集以及语言编码，比如`zh_CN.UTF-8`。
 - `PATH`：由冒号分开的目录列表，当输入可执行程序名后，会搜索这个目录列表。
 - `PS1`：Shell 提示符。
@@ -41,8 +42,7 @@ $ echo $PATH
 ```
 
 注意，`printenv`命令后面的变量名，不用加前缀`$`。
-$ readonly TUX=penguinpower
-$ TUX=Mickeysoft
+
 ## 局部变量
 
 局部变量是仅在当前 Shell 可用的变量，一旦退出，就不存在了。