add docs for ap/rp

Author: oldratlee

README.md

@@ -36,6 +36,8 @@ source <(curl -fsSL https://raw.githubusercontent.com/oldratlee/useful-scripts/m
     彩色`cat`出文件行，方便人眼区分不同的行。
 1. [a2l](docs/shell.md#beer-a2l)  
     按行彩色输出参数，方便人眼查看。
+1. [ap and rp](docs/shell.md#beer-ap-and-rp)  
+    批量转换文件路径为绝对路径/相对路径，会自动跟踪链接并规范化路径。
 1. [xpl and xpf](docs/shell.md#beer-xpl-and-xpf)  
     在命令行中快速完成 在文件浏览器中 打开/选中 指定的文件或文件夹的操作。
 1. [tcp-connection-state-counter.sh](docs/shell.md#beer-tcp-connection-state-countersh)  

ap

@@ -1,9 +1,11 @@
 #!/bin/bash
 # @Function
-# convert to absolute path.
+# convert to Absolute Path.
 #
 # @Usage
+#   # print Absolute Path of current directory.
 #   $ ./ap
+#   # print Absolute Path of arguments.
 #   $ ./ap a.txt ../dir1/b.txt
 #
 # @author Jerry Lee

docs/shell.md

@@ -95,6 +95,37 @@ test-cases/self-installer.sh
 
 注：上面显示中，没有彩色，在控制台上运行可以看出彩色效果。
 
+:beer: [ap](../ap) and [rp](../rp)
+----------------------
+
+批量转换文件路径为绝对路径/相对路径，会自动跟踪链接并规范化路径。
+
+命令名`ap`意思是`Absolute Path`，`rp`是`Relative Path`。
+
+### 示例
+
+```bash
+# ap缺省打印当前路径的绝对路径
+$ ap
+/home/admin/useful-scripts/test
+$ ap ..
+/home/admin/useful-scripts
+# 支持多个参数
+$ ap .. ../.. /etc /etc/../etc
+/home/admin/useful-scripts
+/home/admin
+/etc
+/etc
+
+# rp当一个参数时，打印相对于当前路径的相对路径
+$ rp /home
+../..
+# 多于一个参数时，打印相对于最后一个参数的相对路径
+$ rp /home /etc/../etc /home/admin
+..
+../../etc
+```
+
 :beer: [xpl](../xpl) and [xpf](../xpf)
 ----------------------
 

rp

@@ -1,4 +1,15 @@
 #!/bin/bash
+# @Function
+# convert to Relative Path.
+#
+# @Usage
+#   # if 1 argument, print relative path to current dir.
+#   $ ./rp /etc/apache2/httpd.conf
+#   # if more than 1 argument, print relative path to last argument.
+#   $ ./rp a.txt ../b.txt /etc/passwd /etc/apache2
+#
+# @author Jerry Lee
+
 [ $# -eq 0 ] && {
     echo "ERROR: NO argument!"
     exit 1