add docs dir

Author: oldratlee

README.md

@@ -12,42 +12,42 @@
 source <(curl -fsSL https://raw.githubusercontent.com/oldratlee/useful-scripts/master/test-cases/self-installer.sh)
 ```
 
-更多下载&使用方式，参见[下载使用](install.md)。
+更多下载&使用方式，参见[下载使用](docs/install.md)。
 
 :books: 脚本文档
 ----------------------
 
-### [`Java`相关脚本](java.md)
+### [`Java`相关脚本](docs/java.md)
 
-1. [show-busy-java-threads.sh](java.md#beer-show-busy-java-threadssh)  
-    打印出在运行的`Java`进程中，消耗`CPU`最多的线程栈。用于`Java`的性能问题。
-1. [show-duplicate-java-classes](java.md#beer-show-duplicate-java-classes)  
-    找出`jar`文件和`class`目录中的重复类。用于`Java`类冲突问题。
-1. [find-in-jars.sh](java.md#beer-find-in-jarssh)  
+1. [show-busy-java-threads.sh](docs/java.md#beer-show-busy-java-threadssh)  
+    打印出在运行的`Java`进程中，消耗`CPU`最多的线程栈。用于快速排查`Java`的性能问题。
+1. [show-duplicate-java-classes](docs/java.md#beer-show-duplicate-java-classes)  
+    找出`jar`文件和`class`目录中的重复类。用于排查`Java`类冲突问题。
+1. [find-in-jars.sh](docs/java.md#beer-find-in-jarssh)  
     在目录下所有`jar`文件里，查找类或资源文件。
 
-### [`VCS`相关脚本](vcs.md)
+### [`VCS`相关脚本](docs/vcs.md)
 
-1. [swtrunk.sh](vcs.md#beer-swtrunksh)  
+1. [swtrunk.sh](docs/vcs.md#beer-swtrunksh)  
     自动`svn`工作目录从分支（`branches`）切换到主干（`trunk`）。
-1. [svn-merge-stop-on-copy.sh](vcs.md#beer-svn-merge-stop-on-copysh)    
+1. [svn-merge-stop-on-copy.sh](docs/vcs.md#beer-svn-merge-stop-on-copysh)    
     把指定的远程分支从刚新建分支以来的修改合并到本地`svn`目录或是另一个远程分支。
-1. [cp-svn-url.sh](vcs.md#beer-cp-svn-urlsh)  
+1. [cp-svn-url.sh](docs/vcs.md#beer-cp-svn-urlsh)  
     拷贝当前`svn`目录对应的远程分支到系统的粘贴板，省去`CTRL+C`操作。
 
-### [`Shell`相关脚本](shell.md)
+### [`Shell`相关脚本](docs/shell.md)
 
 包含`Shell`使用或命令加强的脚本。
 
-1. [console-text-color-themes.sh](shell.md#beer-console-text-color-themessh)  
+1. [console-text-color-themes.sh](docs/shell.md#beer-console-text-color-themessh)  
     显示`Terminator`的全部文字彩色组合的效果及其打印方式。
-1. [colorful-lines](shell.md#beer-colorful-lines)  
+1. [colorful-lines](docs/shell.md#beer-colorful-lines)  
     彩色`cat`出文件行，方便人眼区分不同的行。
-1. [echo-args.sh](shell.md#beer-echo-argssh)    
+1. [echo-args.sh](docs/shell.md#beer-echo-argssh)    
     输出脚本收到的参数，在控制台运行时，把参数值括起的括号显示成 **红色**，方便人眼查看。用于调试脚本参数输入。
-1. [tcp-connection-state-counter.sh](shell.md#beer-tcp-connection-state-countersh)：    
+1. [tcp-connection-state-counter.sh](docs/shell.md#beer-tcp-connection-state-countersh)   
     统计各个`TCP`连接状态的个数。用于方便排查系统连接负荷问题。
-1. [parseOpts.sh](shell.md#beer-parseoptssh)   
+1. [parseOpts.sh](docs/shell.md#beer-parseoptssh)   
     提供命令行选项解析函数`parseOpts`，支持选项的值有多个值（即数组）。
-1. [xpl and xpf](shell.md#beer-xpl-and-xpf)    
+1. [xpl and xpf](docs/shell.md#beer-xpl-and-xpf)    
     在文件浏览器中 打开/选中 指定的文件或文件夹。

docs/console-colorful-text.png

@@ -1,7 +1,7 @@
 :snail: `Java`相关脚本
 ====================================
 
-:beer: [show-busy-java-threads.sh](show-busy-java-threads.sh)
+:beer: [show-busy-java-threads.sh](../show-busy-java-threads.sh)
 ----------------------
 
 在排查`Java`的`CPU`性能问题时(`top us`值过高)，要找出`Java`进程中消耗`CPU`多的线程，并查看它的线程栈，从而找出导致性能问题的方法调用。
@@ -67,7 +67,7 @@ The stack of busy(26.1%) thread(24018/0x5dd2) of java process(23269) of user(adm
 
 [silentforce](https://github.com/silentforce)改进此脚本，增加对环境变量`JAVA_HOME`的判断。
 
-:beer: [show-duplicate-java-classes](show-duplicate-java-classes)
+:beer: [show-duplicate-java-classes](../show-duplicate-java-classes)
 ----------------------
 
 找出`java`库（即`jar`文件）或`class`目录中的重复类。
@@ -82,21 +82,32 @@ The stack of busy(26.1%) thread(24018/0x5dd2) of java process(23269) of user(adm
 # 查找当前目录下所有Jar中的重复类
 show-duplicate-java-classes
 
-# 查找指定目录下所有Jar中的重复类
-show-duplicate-java-classes path/to/lib/dir
+# 查找多个指定目录下所有Jar中的重复类
+show-duplicate-java-classes path/to/lib_dir1 /path/to/lib_dir2
 
-# 查找多个指定Class目录下的重复类
-show-duplicate-java-classes path/to/lib/dir1 /path/to/lib/dir2
+# 查找多个指定Class目录下的重复类。 Class目录 通过 -c 选项指定
+show-duplicate-java-classes -c path/to/class_dir1 -c /path/to/class_dir2
 
 # 查找指定Class目录和指定目录下所有Jar中的重复类的jar
-show-duplicate-java-classes -c path/to/classes/dir1 -c path/to/classes/dir2 path/to/lib/dir1 /path/to/lib/dir2
+show-duplicate-java-classes path/to/lib_dir1 /path/to/lib_dir2 -c path/to/class_dir1 -c path/to/class_dir2
 ```
 
 ### 示例
 
 ```bash
 $ show-duplicate-java-classes WEB-INF/lib
-$ show-duplicate-java-classes -c WEB-INF/classes WEB-INF/libFound duplicate classes in below class path:
+COOL! No duplicate classes found!
+
+================================================================================
+class paths to find:
+================================================================================
+1  : WEB-INF/lib/sourceforge.spring.modules.context-2.5.6.SEC02.jar
+2  : WEB-INF/lib/misc.htmlparser-0.0.0.jar
+3  : WEB-INF/lib/normandy.client-1.0.2.jar
+...
+
+$ show-duplicate-java-classes -c WEB-INF/classes WEB-INF/lib
+Found duplicate classes in below class path:
 1  (293@2): WEB-INF/lib/sourceforge.spring-2.5.6.SEC02.jar WEB-INF/lib/sourceforge.spring.modules.orm-2.5.6.SEC02.jar
 2  (2@3): WEB-INF/lib/servlet-api-3.0-alpha-1.jar WEB-INF/lib/jsp-api-2.1-rev-1.jar WEB-INF/lib/jstl-api-1.2-rev-1.jar
 3  (104@2): WEB-INF/lib/commons-io-2.2.jar WEB-INF/lib/jakarta.commons.io-2.0.jar
@@ -126,19 +137,6 @@ Duplicate classes detail info:
     ...
 ...
 
-================================================================================
-class paths to find:
-================================================================================
-1  : WEB-INF/lib/sourceforge.spring.modules.context-2.5.6.SEC02.jar
-2  : WEB-INF/lib/misc.htmlparser-0.0.0.jar
-3  : WEB-INF/lib/normandy.client-1.0.2.jar
-4  : WEB-INF/lib/xml.xmlgraphics__batik-css-1.7.jar-1.7.jar
-5  : WEB-INF/lib/jakarta.ecs-1.4.2.jar
-...
-
-$ show-duplicate-java-classes WEB-INF/lib
-COOL! No duplicate classes found!
-
 ================================================================================
 class paths to find:
 ================================================================================
@@ -154,7 +152,7 @@ class paths to find:
 
 [tgic](https://github.com/tg123)提供此脚本。友情贡献者的链接[commandlinefu.cn](http://commandlinefu.cn/)|[微博linux命令行精选](http://weibo.com/u/2674868673)
 
-:beer: [find-in-jars.sh](find-in-jars.sh)
+:beer: [find-in-jars.sh](../find-in-jars.sh)
 ----------------------
 
 在当前目录下所有`jar`文件里，查找类或资源文件。

install.md renamed to docs/install.md

@@ -3,7 +3,7 @@
 
 包含`Shell`使用或命令加强的脚本。
 
-:beer: [console-text-color-themes.sh](console-text-color-themes.sh)
+:beer: [console-text-color-themes.sh](../console-text-color-themes.sh)
 ----------------------
 
 显示`Terminator`的全部文字彩色组合的效果及其打印方式。
@@ -23,7 +23,7 @@ colorEchoWithoutNewLine "4;33;40" "Hello world!" "Hello Hell!"
 ```
 
 `console-text-color-themes.sh`的运行效果图如下：   
-![console-text-color-themes.sh的运行效果图](https://raw.github.com/wiki/oldratlee/useful-scripts/console-colorful-text.png)
+![console-text-color-themes.sh的运行效果图](console-colorful-text.png)
 
 ### 贡献者
 
@@ -33,7 +33,7 @@ colorEchoWithoutNewLine "4;33;40" "Hello world!" "Hello Hell!"
 
 - [utensil](https://github.com/utensil)的[在Bash下输出彩色的文本](http://utensil.github.io/tech/2007/09/10/colorful-bash.html)，这是篇很有信息量很钻研的文章！
 
-:beer: [colorful-lines](colorful-lines)
+:beer: [colorful-lines](../colorful-lines)
 ----------------------
 
 彩色`cat`出文件行，方便人眼区分不同的行。
@@ -60,7 +60,7 @@ file2 line2
 
 注：上面显示中，没有彩色，在控制台上运行可以看出彩色效果。
 
-:beer: [echo-args.sh](echo-args.sh)
+:beer: [echo-args.sh](../echo-args.sh)
 ----------------------
 
 在编写脚本时，常常要确认输入参数是否是期望的：参数个数，参数值（可能包含有人眼不容易发现的空格问题）。
@@ -86,7 +86,7 @@ $ ./echo-args.sh 1 "  2 foo  " "3        3"
 
 这样可以不改其它的程序，查看到输入参数的信息。
 
-:beer: [tcp-connection-state-counter.sh](tcp-connection-state-counter.sh)
+:beer: [tcp-connection-state-counter.sh](../tcp-connection-state-counter.sh)
 ----------------------
 
 统计各个`TCP`连接状态的个数。
@@ -107,12 +107,12 @@ tcp-connection-state-counter.sh
 
 ```bash
 $ tcp-connection-state-counter.sh
-ESTABLISHED    290
+ESTABLISHED  290
 TIME_WAIT    212
-SYN_SENT    17
+SYN_SENT     17
 ```
 
-:beer: [parseOpts.sh](parseOpts.sh)
+:beer: [parseOpts.sh](../parseOpts.sh)
 ----------------------
 
 提供命令行选项解析函数`parseOpts`，支持选项的值有多个值（即数组）。  
@@ -211,7 +211,7 @@ parseOpts "a,a-long|b,b-long:|c,c-long+" -a -b bv -- --c-long c.sh -p pv -q qv a
 
 [Khotyn Huang](https://github.com/khotyn)指出`bash` `3.0`下使用有问题，并提供`bash` `3.0`的测试机器。
 
-:beer: [xpl](xpl) and [xpf](xpf)
+:beer: [xpl](../xpl) and [xpf](../xpf)
 ----------------------
 
 * `xpl`：在文件浏览器中打开指定的文件或文件夹。  

java.md renamed to docs/java.md

@@ -1,7 +1,7 @@
 :snail: `VCS`相关脚本
 ====================================
 
-:beer: [swtrunk.sh](swtrunk.sh)
+:beer: [swtrunk.sh](../swtrunk.sh)
 ----------------------
 
 `svn`工作目录从分支（`branches`）切换到主干（`trunk`）。
@@ -38,7 +38,7 @@ svn work dir /path/to/svn/work/dir1 switch from http://www.foo.com/project1/bran
 svn work dir /path/to/svn/work/dir2 switch from http://www.foo.com/project2/branches/feature1 to http://www.foo.com/project2/trunk !
 ```
 
-:beer: [svn-merge-stop-on-copy.sh](svn-merge-stop-on-copy.sh)
+:beer: [svn-merge-stop-on-copy.sh](../svn-merge-stop-on-copy.sh)
 ----------------------
 
 把指定的远程分支从刚新建分支以来的修改合并到本地`svn`目录或是另一个远程分支。
@@ -63,7 +63,7 @@ svn-merge-stop-on-copy.sh http://www.foo.com/project1/branches/feature1 http://w
 
 [姜太公](https://github.com/jiangjizhong)提供此脚本。
 
-:beer: [cp-svn-url.sh](cp-svn-url.sh)
+:beer: [cp-svn-url.sh](../cp-svn-url.sh)
 ----------------------
 
 拷贝当前`svn`目录对应的远程分支到系统的粘贴板，省去`CTRL+C`操作。