From 14e526110a8786320ee0961a601b104c17fa70b1 Mon Sep 17 00:00:00 2001 From: Jiahong Luo Date: Sun, 9 Nov 2025 17:58:17 +0800 Subject: [PATCH 1/3] Update ch05: explain shell website --- docs/Ch06/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/Ch06/index.md b/docs/Ch06/index.md index 24c5b504..2dee85e0 100644 --- a/docs/Ch06/index.md +++ b/docs/Ch06/index.md @@ -969,6 +969,8 @@ Bash shell 本身提供了调试方法： 除了 Bash shell 内置的选项，还有 [BASH Debugger](http://bashdb.sourceforge.net/)、[shellcheck](https://github.com/koalaman/shellcheck) 等第三方脚本分析工具。 +对于单行的命令，可以使用 [Explain Shell](https://explainshell.com/) 解释命令和参数的含义、作用。 + ## 思考题 {#thinking-questions} !!! question "I/O 重定向的小细节" From f48b03bdf974d0fb07539739b8575d9ecb916457 Mon Sep 17 00:00:00 2001 From: Jiahong Luo Date: Sun, 9 Nov 2025 11:20:11 +0000 Subject: [PATCH 2/3] Move Explain Shell to Ch03 man pages --- docs/Ch03/index.md | 4 ++++ docs/Ch06/index.md | 2 -- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/Ch03/index.md b/docs/Ch03/index.md index 35306b29..f9f1a682 100644 --- a/docs/Ch03/index.md +++ b/docs/Ch03/index.md @@ -1127,6 +1127,10 @@ DESCRIPTION (Output omitted) ``` +!!! tip "提示" + + 对于单行的命令，可以使用 [Explain Shell](https://explainshell.com/) 解释命令和参数的含义、作用。 + ### tldr 软件 {#tldr} 通常，软件手册中的内容十分繁多，如果只是希望能够快速了解软件的常用用法，可以使用 `tldr` 软件。 diff --git a/docs/Ch06/index.md b/docs/Ch06/index.md index 2dee85e0..24c5b504 100644 --- a/docs/Ch06/index.md +++ b/docs/Ch06/index.md @@ -969,8 +969,6 @@ Bash shell 本身提供了调试方法： 除了 Bash shell 内置的选项，还有 [BASH Debugger](http://bashdb.sourceforge.net/)、[shellcheck](https://github.com/koalaman/shellcheck) 等第三方脚本分析工具。 -对于单行的命令，可以使用 [Explain Shell](https://explainshell.com/) 解释命令和参数的含义、作用。 - ## 思考题 {#thinking-questions} !!! question "I/O 重定向的小细节" From 82fe16f48bf9083e96eb0f385483cadd738b4679 Mon Sep 17 00:00:00 2001 From: Jiahong Luo Date: Sun, 9 Nov 2025 21:12:11 +0800 Subject: [PATCH 3/3] Update index.md Co-authored-by: taoky --- docs/Ch03/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/Ch03/index.md b/docs/Ch03/index.md index f9f1a682..2e1db8b4 100644 --- a/docs/Ch03/index.md +++ b/docs/Ch03/index.md @@ -1129,7 +1129,7 @@ DESCRIPTION !!! tip "提示" - 对于单行的命令，可以使用 [Explain Shell](https://explainshell.com/) 解释命令和参数的含义、作用。 + 对于单行的命令，可以使用 [Explain Shell](https://explainshell.com/) 解释命令和参数的含义、作用。Explain Shell 通过预先解析 Ubuntu 的 man 文档实现了相关功能。 ### tldr 软件 {#tldr}