= improve java.md

Author: oldratlee

bin/show-busy-java-threads

@@ -139,7 +139,7 @@ Example:
 
 Output control:
   -p, --pid <java pid(s)>   find out the highest cpu consumed threads from
-                            the specified java process. support pid list(eg: 42,99).
+                            the specified java process. support pid list(eg: 42,47).
                             default from all java process.
   -c, --count <num>         set the thread count to show, default is 5.
                             set count 0 to show all threads.

docs/java.md

@@ -27,10 +27,10 @@
 
 -------------------------------
 
-关于`Java`排错与诊断，力荐️`Arthas` ❤️
+关于`Java`排错与诊断，力荐️`Arthas`： ❤️
 
-- [alibaba/arthas: Alibaba Java诊断利器 - github.com](https://github.com/alibaba/arthas)
-- `Arthas`用户文档 https://alibaba.github.io/arthas/
+- `Arthas`用户文档： https://arthas.aliyun.com/doc/quick-start.html
+- github repo: [alibaba/arthas: Alibaba Java诊断利器](https://github.com/alibaba/arthas)
 
 `Arthas`功能异常(😜)强劲，且在阿里巴巴线上支持使用多年。我自己也常用，一定要看看用用！
 
@@ -51,9 +51,9 @@
 ----------------------
 
 用于快速排查`Java`的`CPU`性能问题(`top us`值过高)，自动查出运行的`Java`进程中消耗`CPU`多的线程，并打印出其线程栈，从而确定导致性能问题的方法调用。  
-目前只支持`Linux`。原因是`Mac`、`Windows`的`ps`命令不支持列出进程的线程`id`，更多信息参见[#33](https://github.com/oldratlee/useful-scripts/issues/33)，欢迎提供解法。
+目前只支持`Linux`。原因是`Mac`、`Windows`的`ps`命令不支持列出进程的线程`id`，更多信息参见 [#33](https://github.com/oldratlee/useful-scripts/issues/33)，欢迎提供解法。
 
-PS，如何操作可以参见[@bluedavy](http://weibo.com/bluedavy)的[《分布式Java应用》](https://book.douban.com/subject/4848587/)的【5.1.1 `CPU`消耗分析】一节，说得很详细：
+PS，如何操作可以参见[`@bluedavy`](http://weibo.com/bluedavy)的[《分布式Java应用》](https://book.douban.com/subject/4848587/)的【5.1.1 `CPU`消耗分析】一节，说得很详细：
 
 1. `top`命令找出消耗`CPU`高的`Java`进程及其线程`id`：
     1. 开启线程显示模式（`top -H`，或是打开`top`后按`H`）
@@ -65,7 +65,8 @@ PS，如何操作可以参见[@bluedavy](http://weibo.com/bluedavy)的[《分布
     1. 在`jstack`输出中查找十六进制的线程`id`（可以用`vim`的查找功能`/0x1234`，或是`grep 0x1234 -A 20`）
 1. 查看对应的线程栈，分析问题
 
-查问题时，会要多次上面的操作以分析确定问题，这个过程**太繁琐太慢了**。
+查问题时，会要多次上面的操作以分析确定问题，这个过程**太繁琐太慢了**。  
+期望整合上面的过程成一个脚本，这样一行命令就可以自动化地搞定。
 
 ### 用法
 
@@ -74,10 +75,12 @@ show-busy-java-threads
 # 从所有运行的Java进程中找出最消耗CPU的线程（缺省5个），打印出其线程栈
 
 # 缺省会自动从所有的Java进程中找出最消耗CPU的线程，这样用更方便
-# 当然你可以手动指定要分析的Java进程Id，以保证只会显示你关心的那个Java进程的信息
+# 当然你可以通过 -p 选项 手动指定要分析的Java进程Id，以保证只会显示你关心的那个Java进程的信息
 show-busy-java-threads -p <指定的Java进程Id>
+show-busy-java-threads -p 42
+show-busy-java-threads -p 42,47
 
-show-busy-java-threads -c <要显示的线程栈数>
+show-busy-java-threads -c <要展示示的线程栈个数>
 
 show-busy-java-threads <重复执行的间隔秒数> [<重复执行的次数>]
 # 多次执行；这2个参数的使用方式类似vmstat命令
@@ -97,14 +100,14 @@ sudo show-busy-java-threads
 
 show-busy-java-threads -s <指定jstack命令的全路径>
 # 对于sudo方式的运行，JAVA_HOME环境变量不能传递给root，
-# 而root用户往往没有配置JAVA_HOME且不方便配置，
-# 显式指定jstack命令的路径就反而显得更方便了
+# 而root用户往往没有配置JAVA_HOME且不方便配置，不能找到jstack命令。
+# 这时显式指定jstack命令的路径就反而显得更方便了
 
-# -m选项：执行jstack命令时加上-m选项，显示上Native的栈帧，一般应用排查不需要使用
+# -m 选项：执行jstack命令时加上 -m 选项，显示上Native的栈帧，一般应用排查不需要使用
 show-busy-java-threads -m
-# -F选项：执行jstack命令时加上 -F 选项（如果直接jstack无响应时，用于强制jstack），一般情况不需要使用
+# -F 选项：执行jstack命令时加上 -F 选项（如果直接jstack无响应时，用于强制jstack），一般情况不需要使用
 show-busy-java-threads -F
-# -l选项：执行jstack命令时加上 -l 选项，显示上更多相关锁的信息，一般情况不需要使用
+# -l 选项：执行jstack命令时加上 -l 选项，显示上更多相关锁的信息，一般情况不需要使用
 # 注意：和 -m -F 选项一起使用时，可能会大大增加jstack操作的耗时
 show-busy-java-threads -l
 
@@ -121,7 +124,7 @@ Example:
 
 Output control:
   -p, --pid <java pid(s)>   find out the highest cpu consumed threads from
-                            the specified java process. support pid list(eg: 42,99).
+                            the specified java process. support pid list(eg: 42,47).
                             default from all java process.
   -c, --count <num>         set the thread count to show, default is 5.
                             set count 0 to show all threads.