Merge pull request jaywcjlove#132 from ZhuangZhu-74/master

ZhuangZhu-74 · web-flow · commit 0aaa64b8d8be · 2019-08-08T11:00:22.000+08:00
更新command文件夹
diff --git a/command/cd.md b/command/cd.md
@@ -1,36 +1,81 @@
 cd
 ===
 
-切换用户当前工作目录
+切换用户当前工作目录。
 
-## 补充说明
-
-**cd命令** 用来切换工作目录至dirname。 其中dirName表示法可为绝对路径或相对路径。若目录名称省略，则变换至使用者的home directory(也就是刚login时所在的目录)。另外，`~`也表示为home directory的意思，`.`则是表示目前所在的目录，`..`则表示目前目录位置的上一层目录。
-
-###  语法
+## 概要
 
 ```shell
-cd (选项) (参数)
+cd [-L|[-P [-e]]] [dir]
 ```
 
-###  选项
+## 主要用途
+
+- 切换工作目录至`dir`。其中`dir`的表示法可以是绝对路径或相对路径。
+- 若参数`dir`省略，则默认为使用者的shell变量`HOME`。
+- 如果`dir`指定为`~`时表示为使用者的shell变量`HOME`，`.`表示当前目录，`..`表示当前目录的上一级目录。
+- 环境变量`CDPATH`是由冒号分割的一到多个目录，你可以将常去的目录的上一级加入到`CDPATH`以便方便访问它们；如果`dir`以`/`开头那么`CDPATH`不会被使用。
+- 当`shopt`选项`cdable_vars`打开时，如果`dir`在`CDPATH`及当前目录下均不存在，那么会把它当作变量，读取它的值作为要进入的目录。
+
+## 参数
+
+dir（可选）：指定要切换到的目录。
+
+## 选项
 
 ```shell
--p 如果要切换到的目标目录是一个符号连接，直接切换到符号连接指向的目标目录
--L 如果要切换的目标目录是一个符号的连接，直接切换到字符连接名代表的目录，而非符号连接所指向的目标目录。
-- 当仅实用"-"一个选项时，当前工作目录将被切换到环境变量"OLDPWD"所表示的目录。
+-L （默认值）如果要切换到的目标目录是一个符号连接，那么切换到符号连接的目录。
+-P 如果要切换到的目标目录是一个符号连接，那么切换到它指向的物理位置目录。
+-  当前工作目录将被切换到环境变量OLDPWD所表示的目录，也就是前一个工作目录。
 ```
 
-###  实例
+## 返回值
+
+返回状态为成功除非无法进入指定的目录。
+
+## 例子
 
 ```shell
 cd    # 进入用户主目录；
+cd /  # 进入根目录
 cd ~  # 进入用户主目录；
-cd -  # 返回进入此目录之前所在的目录；
+cd -  # 显示并返回进入此目录之前所在的目录（也就是根目录）；
 cd ..  # 返回上级目录（若当前目录为“/“，则执行完后还在“/"；".."为上级目录的意思）；
 cd ../..  # 返回上两级目录；
 cd !$  # 把上个命令的参数作为cd参数使用。
 ```
 
+关于`CDPATH`
+
+```shell
+# 设置桌面文件夹作为CDPATH的值。
+CDPATH='~/Desktop'
+# 假设我们接下来要演示涉及到的路径~和~/Desktop下没有test3文件夹，现在新建它们。
+mkdir ~/test3
+mkdir ~/Desktop/test3
+# 进入~目录。
+cd ~
+# 进入test3目录。
+cd test3
+# 执行后显示~/Desktop/test3并进入该目录，而不是~目录的test3目录。
+# 如果CDPATH存在值，那么优先在CDPATH中查找并进入第一个匹配成功的，如果全部失败那么最后尝试当前目录。
+```
+
+关于`cdable_vars`
+
+```shell
+# 打开选项。
+shopt -s cdable_vars
+# 假设当前路径以及CDPATH没有名为new_var的目录。
+new_var='~/Desktop'
+# 尝试进入。
+cd new_var
+# 关闭选项。
+shopt -u cdable_vars
+```
+
+### 注意
+
+1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。
 
-<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
+<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
diff --git a/command/exit.md b/command/exit.md
@@ -1,23 +1,27 @@
 exit
 ===
 
-退出当前的shell
+退出当前的shell。
 
-## 补充说明
-
-**exit命令** 同于退出shell，并返回给定值。在shell脚本中可以终止当前脚本执行。执行exit可使shell以指定的状态值退出。若不设置状态值参数，则shell以预设值退出。状态值0代表执行成功，其他值代表执行失败。
-
-###  语法
+## 概要
 
 ```shell
-exit(参数)
+exit [n]
 ```
 
-###  参数
+## 主要用途
+
+- 执行exit可使shell以指定的状态值退出。若不设置参数，则以最后一条命令的返回值作为exit的返回值退出。
+
+## 参数
+
+n（可选）：指定的shell返回值（整数）。
+
+## 返回值
 
-返回值：指定shell返回值。
+返回值为你指定的参数n的值，如果你指定的参数大于255或小于0，那么会通过加或减256的方式使得返回值总是处于0到255之间。
 
-###  实例
+## 例子
 
 退出当前shell：
 
@@ -26,6 +30,15 @@ exit(参数)
 logout
 ```
 
+也可以使用`ctrl+d`退出当前终端，下面列出了打开或关闭该功能的方法：
+
+```shell
+# 打开ctrl+d退出终端
+set -o ignoreeof
+# 关闭ctrl+d退出终端
+set +o ignoreeof
+```
+
 在脚本中，进入脚本所在目录，否则退出：
 
 ```shell
@@ -57,5 +70,8 @@ if [ "$EXCODE" == "0" ]; then
 fi
 ```
 
+### 注意
+
+1.	该命令是bash内建命令，相关的帮助信息请查看`help`命令。
 
-<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
+<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
diff --git a/command/return.md b/command/return.md
@@ -0,0 +1,45 @@
+return
+===
+
+从函数中退出并返回数值。
+
+## 概要
+
+```shell
+return [n]
+```
+
+## 主要用途
+
+- 使得shell函数退出并返回数值，如果没有指定n的值，则默认为函数最后一条命令执行的返回状态。
+
+## 参数
+
+n（可选）：整数。
+
+## 返回值
+
+返回值为你指定的参数n的值，如果你指定的参数大于255或小于0，那么会通过加或减256的方式使得返回值总是处于0到255之间。
+
+在函数外执行return语句会返回失败。
+
+## 例子
+
+```shell
+#!/usr/bin/env bash
+# 定义一个返回值大于255的函数
+example() {
+  return 259
+}
+# 执行函数
+example
+# 显示3
+echo $?
+```
+
+### 注意
+
+1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。
+
+
+<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
diff --git a/command/shift.md b/command/shift.md
@@ -0,0 +1,55 @@
+shift
+===
+
+移动位置参数。
+
+## 概要
+
+```shell
+shift [n]
+```
+
+## 主要用途
+
+- 将位置参数`$n, $n+1...`重命名为`$1, $2...`。
+
+## 参数
+
+n（可选）：大于等于1且小于等于参数个数的整数，默认为1。
+
+## 返回值
+
+返回成功除非n大于参数个数或n小于1以及其他非法值。
+
+## 例子
+
+假设我们的脚本文件（test.sh）如下：
+
+```shell
+#!/usr/bin/env bash
+# 显示前三个位置参数。
+echo "$1 $2 $3"
+# 移除前两个位置参数，并将$3重命名为$1，之后的以此类推。
+shift 2
+echo "$1 $2 $3"
+```
+
+在终端执行该脚本：
+
+```shell
+sh test.sh q w e r t
+```
+
+返回信息如下：
+
+```shell
+q w e
+e r t
+```
+
+### 注意
+
+1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。
+
+
+<!-- Linux命令行搜索引擎：https://jaywcjlove.github.io/linux-command/ -->
