Merge branch 'main' into contributing-guides

.github/workflows/monthly-check.yml

@@ -41,7 +41,7 @@ jobs:
         GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
 
     - name: Find the last report issue open
-      uses: micalevisk/last-issue-action@044e1cb7e9a4dde20e22969cb67818bfca0797be # v2.3.0
+      uses: micalevisk/last-issue-action@0d40124cc99ac8601c2516007f0c98ef3d27537b # v2.3.0
       id: last-issue
       with:
         state: open

MAINTAINERS.md

@@ -90,8 +90,6 @@ If you are an owner of the organization, you can see an automated list [here](ht
   [24 August 2020](https://github.com/tldr-pages/tldr/issues/4291) — [5 October 2020](https://github.com/tldr-pages/tldr/issues/4504), [14 November 2024](https://github.com/tldr-pages/tldr/issues/14541) — present
 - **witt ([@witt-bit](https://github.com/witt-bit))**:
   [14 January 2025](https://github.com/tldr-pages/tldr/issues/15514) — present
-- **Machiavelli ([@MachiavelliII](https://github.com/MachiavelliII))**:
-  [21 January 2025](https://github.com/tldr-pages/tldr/issues/15564) — present
 - Owen Voke ([@owenvoke](https://github.com/owenvoke))
   [11 January 2018](https://github.com/tldr-pages/tldr/issues/1885) — [26 August 2018](https://github.com/tldr-pages/tldr/issues/2258)
 - Marco Bonelli ([@mebeim](https://github.com/mebeim)):
@@ -148,6 +146,8 @@ If you are an owner of the organization, you can see an automated list [here](ht
   [4 September 2023](https://github.com/tldr-pages/tldr/issues/10611) — [3 October 2024](https://github.com/tldr-pages/tldr/issues/13956)
 - Renie ([@renie](https://github.com/renie)):
   [03 October 2024](https://github.com/tldr-pages/tldr/issues/13946) — [23 October 2024](https://github.com/tldr-pages/tldr/issues/14343)
+- Machiavelli ([@MachiavelliII](https://github.com/MachiavelliII)):
+  [21 January 2025](https://github.com/tldr-pages/tldr/issues/15564) — [27 Mar 2025](https://github.com/tldr-pages/tldr/issues/16036)
 
 ## Organization members
 
@@ -180,6 +180,8 @@ An automated list can be found [here](https://github.com/orgs/tldr-pages/people)
   [3 October 2024](https://github.com/tldr-pages/tldr/issues/13956) — present
 - **Renie ([@renie](https://github.com/renie))**:
   [23 October 2024](https://github.com/tldr-pages/tldr/issues/14343) — present
+- **Machiavelli ([@MachiavelliII](https://github.com/MachiavelliII))**:
+  [27 Mar 2025](https://github.com/tldr-pages/tldr/issues/16036) — present
 - Owen Voke ([@owenvoke](https://github.com/owenvoke))
   [26 August 2018](https://github.com/tldr-pages/tldr/issues/2258) — [8 May 2019](https://github.com/tldr-pages/tldr/issues/2989)
 - Marco Bonelli ([@mebeim](https://github.com/mebeim)):

contributing-guides/style-guide.md

@@ -495,7 +495,7 @@ To mark keypresses for TUI or GUI programs, use angle brackets `<` and `>`.
 - Special keys can be translated if they have culturally relevant translations.
 - When a program takes in uppercase character literals mark them as `<A>` instead of marking it with shift. Otherwise always mark characters in lowercase.
 - Mark simultaneous keypresses inside the same angle brackets separated by a single space:  `<Ctrl c>`, `<Alt F4>`, `<Ctrl Shift k>`, `<Super Shift PrtSc>`.
-- When writing simultaneous keypresses, keep the following order: `<Ctrl>` -> `<Super>` / `<Windows>` -> `<Alt>` -> `<AltGr>` -> `<Shift>` -> everything else.
+- When writing simultaneous keypresses, keep the following order: `<Ctrl Super Windows Alt AltGr Shift everything_else>`.
 - Consecutive keypresses need to be contained in their own angle brackets with no space in between: `<Esc><u>`, `<Ctrl k><Ctrl s>`, `<Enter><~><.>`, `<d><o>`.
 - Keys that are typed into a prompt do not need to be marked as keypresses: `<:>help<Enter>`. Note that the context switching keypress is marked in angle brackets despite printing on the prompt.
 

pages.ar/common/w.md

@@ -0,0 +1,20 @@
+# w
+
+> اداة لعرض المستخدمين المتصلين حالياً و العمليات التي يتم تنفيذها.
+> لمزيد من التفاصيل: <https://manned.org/w>.
+
+- عرض معلومات عن جميع المستخدمين المتصلين حاليا:
+
+`w`
+
+- عرض معلومات عن مستخدم محدد:
+
+`w {{اسم_المستخدم}}`
+
+- عرض معلومات المستخدمين المتصلين بدون الترويسة:
+
+`w {{[-h|--no-header]}}`
+
+- عرض المعلومات بدون تضمين أعمدة تسجيل الدخول و JCPU و PCPU:
+
+`w {{[-s|--short]}}`

pages.ar/linux/fprintd.md

@@ -0,0 +1,8 @@
+# fprintd
+
+> خدمة إدارة بصمات الأصابع.
+> لمزيد من التفاصيل: <https://fprint.freedesktop.org/>.
+
+- عرض صفحة المساعدة لـ `fprintd`:
+
+`man fprintd`

pages.es/common/gitlab-ctl.md

@@ -0,0 +1,36 @@
+# gitlab-ctl
+
+> Gestiona el ómnibus de GitLab.
+> Más información: <https://docs.gitlab.com/omnibus/maintenance/>.
+
+- Muestra el estado de cada servicio:
+
+`sudo gitlab-ctl status`
+
+- Muestra el estado de un servicio específico:
+
+`sudo gitlab-ctl status {{nginx}}`
+
+- Reinicia todos los servicios:
+
+`sudo gitlab-ctl restart`
+
+- Reinicia un servicio específico:
+
+`sudo gitlab-ctl restart {{nginx}}`
+
+- Muestra los registros de cada servicio y sigue leyendo hasta que se pulse `<Ctrl c>`:
+
+`sudo gitlab-ctl tail`
+
+- Muestra los registros de un servicio específico:
+
+`sudo gitlab-ctl tail {{nginx}}`
+
+- Envia la señal SIGKILL a un servicio específico:
+
+`sudo gitlab-ctl kill {{nginx}}`
+
+- Reconfigura la aplicación:
+
+`sudo gitlab-ctl reconfigure`

pages.es/common/ng.md

@@ -0,0 +1,36 @@
+# ng
+
+> Crea y maneja applicaciones de Angular.
+> Más información: <https://angular.io/cli>.
+
+- Crea una aplicación de Angular dentro de un directorio:
+
+`ng new {{nombre_del_proyecto}}`
+
+- Añade un componente nuevo a tu aplicación:
+
+`ng generate component {{nombre_del_componente}}`
+
+- Añade una clase nueva a tu aplicación:
+
+`ng generate class {{nombre_de_la_clase}}`
+
+- Añade un directivo nuevo a tu aplicación:
+
+`ng generate directive {{nombre_del_directivo}}`
+
+- Corre la applicación con el siguiente comando en el directorio raíz:
+
+`ng serve`
+
+- Compila la aplicación:
+
+`ng build`
+
+- Ejecuta las pruebas unitarias:
+
+`ng test`
+
+- Muestra la version actual de tu instalación de Angular:
+
+`ng version`

pages.es/common/task.md

@@ -0,0 +1,36 @@
+# task
+
+> Organizador de tareas en la línea de comandos.
+> Más información: <https://taskwarrior.org/docs/>.
+
+- Añade una tarea la cual se vence mañana:
+
+`task add {{descripción}} due:{{tomorrow}}`
+
+- Actualiza la prioridad de una tarea:
+
+`task {{id_de_la_tarea}} modify priority:{{H|M|L}}`
+
+- Completa una tarea:
+
+`task {{id_de_la_tarea}} done`
+
+- Elimina una tarea:
+
+`task {{id_de_la_tarea}} delete`
+
+- Lista todas las tareas pendientes:
+
+`task list`
+
+- Lista tareas pendientes que se vencen antes del fin de semana:
+
+`task list due.before:{{eow}}`
+
+- Muestra una gráfica de progreso de tareas, por día:
+
+`task burndown.daily`
+
+- Lista todos los reportes:
+
+`task reports`

pages.es/linux/cdrdao.md

@@ -1,7 +1,7 @@
 # cdrdao
 
 > Lee y graba CDs en modo disc-at-once.
-> Más información: <https://manned.org/man/cdrdao>.
+> Más información: <https://manned.org/cdrdao>.
 
 - Lee un CD y escribe su contenido en un archivo:
 

pages.es/linux/dnf-group.md

@@ -1,7 +1,7 @@
 # dnf group
 
 > Gestiona colecciones virtuales de paquetes en sistemas basados en Fedora.
-> Más información: <https://manned.org/man/dnf-group>.
+> Más información: <https://manned.org/dnf-group>.
 
 - Lista los grupos DNF, mostrando el estado de instalado o no en una tabla:
 

pages.ko/common/ntpctl.md

@@ -5,16 +5,16 @@
 
 - 모든 데이터 표시:
 
-`ntpctl -s {{a|all}}`
+`ntpctl -s {{[a|all]}}`
 
 - 각 피어에 대한 정보 표시:
 
-`ntpctl -s {{p|peers}}`
+`ntpctl -s {{[p|peers]}}`
 
 - 피어와 센서의 상태 및 시스템 시계 동기화 여부 표시:
 
-`ntpctl -s {{s|status}}`
+`ntpctl -s {{[s|status]}}`
 
 - 각 센서에 대한 정보 표시:
 
-`ntpctl -s {{S|Sensors}}`
+`ntpctl -s {{[S|Sensors]}}`

pages.ko/linux/init.md

@@ -2,7 +2,7 @@
 
 > Linux 런레벨 관리자.
 > systemd를 사용하는 경우 SYSVINIT 컴파일 시 옵션이 활성화되어야 합니다.
-> 더 많은 정보: <https://manned.org/man/init.8>.
+> 더 많은 정보: <https://manned.org/init.8>.
 
 - 시스템을 그래픽 환경으로 설정:
 

pages.nl/linux/dnf-group.md

@@ -1,7 +1,7 @@
 # dnf group
 
 > Beheer virtuele collecties van pakketten op Fedora gebaseerde systemen.
-> Meer informatie: <https://manned.org/man/dnf-group>.
+> Meer informatie: <https://manned.org/dnf-group>.
 
 - Maak een lijst van DNF-groepen, met geïnstalleerde en verwijderde status in een tabel:
 

pages.zh/common/$.md

@@ -22,3 +22,11 @@
 - 运行 `命令` 并展开它的输出。与将 `命令` 括在反引号中相同：
 
 `$({{命令}})`
+
+- 列出当前上下文有多少个参数：
+
+`echo $#`
+
+- 打印 Bash 数组：
+
+`echo ${array[@]}`

pages.zh/common/ani-cli.md

@@ -7,22 +7,30 @@
 
 `ani-cli "{{动漫名称}}"`
 
-- 下载动漫剧集：
+- 下载（[d]ownload）剧集：
 
 `ani-cli -d "{{动漫名称}}"`
 
-- 使用 VLC 播放器播放：
+- 下载（[d]ownload）一个范围（[r]ange）的剧集：
+
+`ani-cli -d -r "{{1 6}}" "{{动漫名称}}"`
+
+- 下载（[d]ownload）整部动漫（所有剧集的范围）：
+
+`ani-cli -d -r "1 -1" "{{动漫名称}}"`
+
+- 使用 [v]LC 播放器播放：
 
 `ani-cli -v "{{动漫名称}}"`
 
-- 指定要观看的剧集：
+- 观看特定（[e]pisode）剧集：
 
 `ani-cli -e {{剧集序号}} "{{动漫名称}}"`
 
-- 从历史记录中继续观看动漫：
+- 从历史记录中（[c]ontinue）继续观看动漫：
 
 `ani-cli -c`
 
-- 更新 `ani-cli`：
+- 更新（[U]pdate）`ani-cli`：
 
 `ani-cli -U`

pages.zh/common/btop.md

@@ -23,3 +23,11 @@
 - 设置更新速率为 500 毫秒：
 
 `btop --update 500`
+
+- 退出 `btop`：
+
+`<q>`
+
+- 显示帮助信息：
+
+`btop {{[-h|--help]}}`

pages.zh/common/nano.md

@@ -30,3 +30,7 @@
 - 打开文件并在保存时创建备份文件（如 `路径/到/文件~`）：
 
 `nano {{[-B|--backup]}} {{路径/到/文件}}`
+
+- 退出 nano：
+
+`<Ctrl x>`

pages.zh/common/netstat.md

@@ -1,24 +1,33 @@
 # netstat
 
 > 显示与网络相关的信息，如打开的连接、打开的套接字端口等。
+> 另见：`ss`。
 > 更多信息：<https://manned.org/netstat>.
 
 - 列出所有端口：
 
-`netstat -a`
+`netstat --all`
 
-- 列出所有被侦听端口：
+- 列出所有被监听端口：
 
-`netstat -l`
+`netstat --listening`
 
-- 列出侦听的 TCP 端口：
+- 列出监听的 TCP 端口：
 
-`netstat -t`
+`netstat --tcp`
 
-- 显示监听给定协议监听的 PID 和程序名：
+- 显示 PID 和程序名：
 
-`netstat -p {{协议}}`
+`netstat --program`
 
-- 打印路由表：
+- 持续列出信息：
 
-`netstat -nr`
+`netstat --continuous`
+
+- 列出路由并且不解析 IP 到主机名：
+
+`netstat --route --numeric`
+
+- 列出正在监听的 TCP 和 UDP 端口（如果你是 root 用户，还会显示用户和进程）：
+
+`netstat --listening --program --numeric --tcp --udp --extend`

pages.zh/common/nmap.md

@@ -1,29 +1,37 @@
 # nmap
 
 > 网络探索工具和安全/端口扫描程序。
-> 仅当以特权运行 Nmap 时，某些功能才激活。
+> 某些功能（如 SYN 扫描）仅当以 root 权限运行 `nmap` 时才能激活。
 > 更多信息：<https://nmap.org/book/man.html>.
 
-- 检查 IP 地址是否可用，并猜测远程主机的操作系统：
+- 使用不同的详细（[v]erbosity）级别扫描远程主机的前 1000 个端口：
 
-`nmap -O {{IP 或者 主机名}}`
+`nmap -v{{1|2|3}} {{ip或主机名}}`
 
-- 尝试确定指定的主机是否启动以及它们的名称是什么：
+- 对整个子网或单个主机进行非常激进的 ping 扫描：
 
-`sudo nmap -sn {{IP 或者 主机名}} {{可选的其它地址}}`
+`nmap -T5 -sn {{192.168.0.0/24|ip或主机名1,ip或主机名2,...}}`
 
-- 像上面一样，如果主机启动了，还可以运行默认的 1000 端口 TCP 扫描：
+- 对来自文件的主机启用操作系统检测、版本检测、脚本扫描和路由跟踪：
 
-`nmap {{IP 或者 主机名}} {{可选的其它地址}}`
+`sudo nmap -A -iL {{路径/到/文件.txt}}`
 
-- 也可以启用脚本，服务检测，操作系统指纹识别和跟踪路由：
+- 扫描特定的端口列表（使用 `-p-` 扫描从 1 到 65535 的所有端口）：
 
-`nmap -A {{一个地址 或者 多个地址}}`
+`nmap -p {{端口1,端口2,...}} {{ip或主机名1,ip或主机名2,...}}`
 
-- 扫描端口的特定列表（使用 `-p` 参数覆盖所有端口，如 `-p 1-65535`，也可以明确指定几个端口，如 `-p 3306,3307,3308`）：
+- 使用默认 NSE 脚本执行前 1000 个端口的服务和版本检测，将结果（`-oA`）写入输出文件：
 
-`nmap -p {{端口1, 端口2, ..., 端口N}} {{一个地址 或者 多个地址}}`
+`nmap -sC -sV -oA {{top-1000-ports}} {{ip或主机名1,ip或主机名2,...}}`
 
-- 使用默认 NSE 脚本执行针对该主机地址的完整端口、服务、版本检测扫描，以确定弱点和信息：
+- 使用 `default and safe` NSE 脚本谨慎地扫描目标：
 
-`nmap -sC -sV {{一个地址 或者 多个地址}}`
+`nmap --script "default and safe" {{ip或主机名1,ip或主机名2,...}}`
+
+- 使用所有可用的 `http-*` NSE 脚本扫描在标准端口 80 和 443 上运行的 Web 服务器：
+
+`nmap --script "http-*" {{ip或主机名1,ip或主机名2,...}} -p 80,443`
+
+- 尝试通过使用极慢扫描（`-T0`）、诱饵源地址（`-D`）、分段（[f]ragmented）数据包、随机数据和其他方法来规避 IDS/IPS 检测：
+
+`sudo nmap -T0 -D {{诱饵ip1,诱饵ip2,...}} --source-port {{53}} -f --data-length {{16}} -Pn {{ip或主机名}}`

pages.zh/common/node.md

@@ -5,20 +5,24 @@
 
 - 运行一个 JavaScript 文件：
 
-`node {{文件名}}`
+`node {{路径/到/文件}}`
 
 - 开始一个 REPL 交互式解释器：
 
 `node`
 
+- 执行指定的文件，当导入的文件发生变化时重启进程（需要 Node.js 18.11+ 版本）：
+
+`node --watch {{路径/到/文件}}`
+
 - 执行输入的 JavaScript 代码：
 
 `node -e "{{代码}}"`
 
-- 执行输入的 JavaScript 代码并显示结果：
+- 执行输入的 JavaScript 代码并显示结果，用于打印 node 的依赖版本：
 
-`node -p "{{代码}}"`
+`node -p "process.versions"`
 
 - 启动检查器并在程序源码解析完成后等待调试器连接：
 
-`node --no-lazy --inspect-brk {{文件名}}`
+`node --no-lazy --inspect-brk {{路径/到/文件}}`

pages.zh/common/picocom.md

@@ -3,10 +3,22 @@
 > 模拟串行端口的极简程序。
 > 更多信息：<https://manned.org/picocom>.
 
-- 以指定波特率连接到串行端口：
+- 使用默认波特率 9600 连接到串行控制台：
 
-`picocom {{/dev/ttyXYZ}} {{[-b|--baud]}} {{波特率}}`
+`sudo picocom {{/dev/ttyXYZ}}`
 
-- 映射特殊字符（例如：将 LF 映射为 CRLF）：
+- 以指定波特率连接到串行控制台：
 
-`picocom {{/dev/ttyXYZ}} --imap {{lfcrlf}}`
+`sudo picocom {{/dev/ttyXYZ}} {{[-b|--baud]}} {{波特率}}`
+
+- 映射特殊字符（例如：将 `LF` 映射为 `CRLF`）：
+
+`sudo picocom {{/dev/ttyXYZ}} --imap {{lfcrlf}}`
+
+- 退出 picocom：
+
+`<Ctrl a><Ctrl x>`
+
+- 显示帮助信息：
+
+`picocom {{[-h|--help]}}`

pages.zh/common/popd.md

@@ -1,16 +1,21 @@
 # popd
 
 > 通过 pushd shell 内置程序删除目录堆栈中的目录。
-> 更多信息：<https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html>.
+> 另见 `pushd` 将目录放入堆栈和 `dirs` 显示目录堆栈内容。
+> 更多信息：<https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html#index-popd>.
 
 - 从堆栈中删除顶部目录，并用 `cd` 跳转到该目录：
 
 `popd`
 
-- 删除第 n 个目录（从零开始，以用 `dirs` 打印的列表左侧开始）：
+- 删除第 N 个目录（从零开始，以用 `dirs` 打印的列表左侧开始）：
 
 `popd +N`
 
-- 删除第 n 个目录（从零开始，以用 `dirs` 打印的列表右侧开始）：
+- 删除第 N 个目录（从零开始，以用 `dirs` 打印的列表右侧开始）：
 
 `popd -N`
+
+- 删除第 1 个目录（从零开始，以用 `dirs` 打印的列表左侧开始）：
+
+`popd -n`

pages.zh/common/powershell.md

@@ -1,32 +1,13 @@
 # powershell
 
-> 专为系统管理而设计的命令行 shell 和脚本语言。
+> 此命令可能会被误认为是 PowerShell 的跨平台版本（以前称为 PowerShell Core），后者使用 `pwsh` 而不是 `powershell`。
+> Windows 中原始的 `powershell` 命令仍然可用于使用传统的 Windows PowerShell 版本（5.1 及以下版本）。
 > 更多信息：<https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_pwsh>.
 
-- 在命令提示符窗口中启动 Windows PowerShell 会话：
+- 查看最新的跨平台版本 PowerShell（版本 6 及以上）的命令文档：
 
-`powershell`
+`tldr pwsh`
 
-- 加载一个特定的 PowerShell 控制台文件：
+- 查看传统 Windows PowerShell（版本 5.1 及以下）的命令文档：
 
-`powershell -PSConsoleFile {{路径/file}}`
-
-- 用指定版本的 PowerShell 启动会话：
-
-`powershell -Version {{版本}}`
-
-- 防止运行启动命令后 shell 退出：
-
-`powershell -NoExit`
-
-- 描述发送到 PowerShell 的数据格式：
-
-`powershell -InputFormat {{Text|XML}}`
-
-- 设定 PowerShell 输出的格式：
-
-`powershell -OutputFormat {{Text|XML}}`
-
-- 显示帮助：
-
-`powershell -Help`
+`tldr powershell -p windows`

pages.zh/common/protoc.md

@@ -14,3 +14,15 @@
 - 生成多种语言的代码：
 
 `protoc --csharp_out={{路径/到/c#_输出目录}} --js_out={{路径/到/js_输出目录}} {{输入文件.proto}}`
+
+- 从 `.proto` 文件将文本格式消息编码为协议消息：
+
+`protoc --encode={{类型名称}} {{输入文件.proto}} < {{消息.txt}}`
+
+- 从 `.proto` 文件将协议消息解码为文本格式：
+
+`protoc --decode={{类型名称}} {{输入文件.proto}} < {{消息.bin}}`
+
+- 将协议消息解码为原始标签/值对：
+
+`protoc --decode_raw < {{消息.bin}}`

pages.zh/common/pushd.md

@@ -1,12 +1,12 @@
 # pushd
 
 > 将目录放在堆栈上，以便以后访问。
-> 另请参阅 `popd` 命令说明，以切换回原始目录。
+> 另见 `popd` 切换回原始目录和 `dirs` 显示目录堆栈内容。
 > 更多信息：<https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html>.
 
 - 切换到目录并将其添加到堆栈上：
 
-`pushd {{directory}}`
+`pushd {{路径/到/目录}}`
 
 - 切换堆栈上的第一个和第二个目录：
 
@@ -15,3 +15,7 @@
 - 通过使第 5 个元素成为堆栈的顶部来旋转堆栈：
 
 `pushd +4`
+
+- 将堆栈向左旋转 4 次（当前目录通过替换第 5 个元素保持在顶部）：
+
+`pushd -n +4`

pages.zh/common/rm.md

@@ -1,20 +1,29 @@
 # rm
 
 > 删除文件或目录。
+> 另见：`rmdir`。
 > 更多信息：<https://www.gnu.org/software/coreutils/manual/html_node/rm-invocation.html>.
 
-- 从任意位置删除文件：
+- 删除指定文件：
 
-`rm {{路径/到/文件 路径/到/另一个/文件 ...}}`
+`rm {{路径/到/文件1 路径/到/文件2 ...}}`
+
+- 删除指定文件，忽略不存在的文件：
+
+`rm {{[-f|--force]}} {{路径/到/文件1 路径/到/文件2 ...}}`
 
 - 交互式地删除多个文件，每次删除前都会有提示：
 
-`rm -i {{文件（们）}}`
+`rm {{[-i|--interactive]}} {{路径/到/文件1 路径/到/文件2 ...}}`
 
-- 以粗略模式删除文件，为每个被删除的文件打印一条信息：
+- 删除文件并打印删除信息：
 
-`rm -v {{路径/到/目录/*}}`
+`rm {{[-v|--verbose]}} {{路径/到/文件1 路径/到/文件2 ...}}`
 
-- 递归删除一个目录及其所有子目录：
+- 递归删除指定文件和目录：
 
-`rm -r {{路径/到/目录}}`
+`rm {{[-r|--recursive]}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
+
+- 删除空目录（这被认为是安全的方法）：
+
+`rm {{[-d|--dir]}} {{路径/到/目录}}`

pages.zh/common/shasum.md

@@ -3,22 +3,34 @@
 > 计算或检查加密 SHA 校验值。
 > 更多信息：<https://manned.org/shasum>.
 
-- 计算文件的 SHA1 校验值：
+- 计算一个或多个文件的 SHA1 校验值：
 
-`shasum {{文件名}}`
+`shasum {{路径/到/文件1 路径/到/文件2 ...}}`
 
-- 计算文件的 SHA256 校验值：
+- 使用指定算法计算一个或多个文件的 SHA 校验值：
 
-`shasum --algorithm 256 {{文件名}}`
-
-- 计算多个文件的 SHA512 校验值：
-
-`shasum --algorithm 512 {{文件名 1}} {{文件名 2}}`
-
-- 计算一个文件内列出的所有的目录文件的相对应的总数：
-
-`shasum --check {{列表文件}}`
+`shasum --algorithm {{1|224|256|384|512|512224|512256}} {{路径/到/文件1 路径/到/文件2 ...}}`
 
 - 从标准输入中获取并计算 SHA1 校验值：
 
-`{{其他命令}} | shasum`
+`{{命令}} | shasum`
+
+- 计算并保存 SHA256 校验值列表到文件：
+
+`shasum --algorithm 256 {{路径/到/文件1 路径/到/文件2 ...}} > {{路径/到/文件.sha256}}`
+
+- 读取包含 SHA 校验值和文件名的文件，并验证所有文件是否具有匹配的校验值（算法将被自动检测）：
+
+`shasum {{[-c|--check]}} {{路径/到/文件}}`
+
+- 仅显示缺失文件或验证失败的消息：
+
+`shasum {{[-c|--check]}} --quiet {{路径/到/文件}}`
+
+- 仅显示验证失败的消息，忽略缺失的文件：
+
+`shasum --ignore-missing {{[-c|--check]}} --quiet {{路径/到/文件}}`
+
+- 检查文件的已知 SHA 校验值：
+
+`echo {{文件的已知 sha 校验值}} {{路径/到/文件}} | shasum {{[-c|--check]}}`

pages.zh/common/sshuttle.md

@@ -1,17 +1,21 @@
 # sshuttle
 
 > 通过 SSH 连接传输流量的透明代理服务器。
-> 不需要管理员或远程 SSH 服务器上的任何特殊设置。
+> 不需要在远程 SSH 服务器上进行任何特殊设置，但会提示在本地机器上获取 root 访问权限。
 > 更多信息：<https://manned.org/sshuttle>.
 
 - 通过远程 SSH 服务器转发所有 IPv4 TCP 流量：
 
 `sshuttle --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}}`
 
-- 转发所有 IPv4 TCP 和 DNS 流量：
+- 同时将所有 DNS 流量转发到服务器的默认 DNS 解析器：
 
 `sshuttle --dns --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}}`
 
+- 转发所有流量，除了发往特定子网的流量：
+
+`sshuttle --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}} --exclude {{192.168.0.1/24}}`
+
 - 使用 tproxy 方法转发所有 IPv4 和 IPv6 流量：
 
-`sudo sshuttle --method=tproxy --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}} {{::/0}} --exclude={{你本地 IP 地址}} --exclude={{SSH 服务器的 IP 地址}}`
+`sshuttle --method=tproxy --remote={{用户名}}@{{服务器名}} {{0.0.0.0/0}} {{::/0}} --exclude={{你本地 IP 地址}} --exclude={{SSH 服务器的 IP 地址}}`

pages.zh/common/stty.md

@@ -5,16 +5,28 @@
 
 - 显示当前终端的所有设置：
 
-`stty --all`
+`stty {{[-a|--all]}}`
 
 - 设置行数或列数：
 
-`stty {{行数|列数}} {{数量}}`
+`stty {{rows|cols}} {{数量}}`
 
 - 获取设备的实际传输速度：
 
-`stty --file {{路径/到/驱动设备文件}} speed`
+`stty {{[-F|--file]}} {{路径/到/设备文件}} speed`
 
 - 重置所有模式为当前终端的合理默认值：
 
 `stty sane`
+
+- 在原始模式和普通模式之间切换：
+
+`stty {{raw|cooked}}`
+
+- 关闭或开启字符回显：
+
+`stty {{-echo|echo}}`
+
+- 显示帮助信息：
+
+`stty --help`

pages.zh/common/tldr.md

@@ -31,3 +31,7 @@
 - 列出某个命令的所有可用子命令页面：
 
 `tldr {{[-l|--list]}} | grep {{命令}} | column`
+
+- 打印随机命令的 tldr 页面：
+
+`tldr {{[-l|--list]}} | shuf {{[-n|--head-count]}} 1 | xargs tldr`

pages.zh/common/trap.md

@@ -1,21 +1,17 @@
 # trap
 
-> 在进程或操作系统接收到信号后自动执行命令。
+> 在接收到事件时执行命令。
 > 可用于对用户中断或其他操作执行清理。
 > 更多信息：<https://manned.org/trap.1posix>.
 
-- 列出设置 trap 的可用信号：
+- 列出命令和预期事件的名称：
 
-`trap -l`
+`trap`
 
-- 列出当前 shell 程序的活动 trap 程序：
+- 在接收到信号时执行命令：
 
-`trap -p`
+`trap 'echo "捕获到信号 {{SIGHUP}}"' {{HUP}}`
 
-- 设置 trap 以在检测到一个或多个信号时执行命令：
+- 移除命令：
 
-`trap 'echo "检测到信号 {{SIGHUP}}"' {{SIGHUP}}`
-
-- 移除活动 trap：
-
-`trap - {{SIGHUP}} {{SIGINT}}`
+`trap - {{HUP}} {{INT}}`

pages.zh/common/tree.md

@@ -11,9 +11,9 @@
 
 `tree -d`
 
-- 同时显示隐藏文件：
+- 同时显示隐藏文件并开启彩色输出：
 
-`tree -a`
+`tree -a -C`
 
 - 打印没有缩进行的树，显示完整路径（使用`-N`不转义空格和特殊字符）：
 
@@ -30,3 +30,7 @@
 - 在树层次结构中查找目录，删除不属于所需目录的目录：
 
 `tree -P {{文件夹名}} --matchdirs --prune`
+
+- 忽略指定目录显示树：
+
+`tree -I '{{目录名1|目录名2}}'`

pages.zh/common/uname.md

@@ -1,21 +1,37 @@
 # uname
 
 > 输出关于当前机器和运行在该机器上的操作系统的详细信息。
-> 注意：如需了解操作系统的其他信息，请尝试使用 `lsb_release` 命令。
+> 另见 `lsb_release`。
 > 更多信息：<https://www.gnu.org/software/coreutils/manual/html_node/uname-invocation.html>.
 
-- 打印硬件相关信息：机器和处理器：
+- 打印内核名称：
 
-`uname -mp`
+`uname`
 
-- 打印软件相关信息：操作系统、发行号和版本：
+- 打印所有可用的系统信息：
 
-`uname -srv`
+`uname {{[-a|--all]}}`
 
-- 打印系统的名称（主机名）：
+- 打印系统架构和处理器信息：
 
-`uname -n`
+`uname {{[-mp|--machine --processor]}}`
 
-- 打印所有可用的系统信息（硬件、软件、名称）：
+- 打印内核名称、内核版本号和内核版本：
 
-`uname -a`
+`uname {{[-srv|--kernel-name --kernel-release --kernel-version]}}`
+
+- 打印系统主机名：
+
+`uname {{[-n|--nodename]}}`
+
+- 打印当前操作系统名称：
+
+`uname {{[-o|--operating-system]}}`
+
+- 打印当前网络节点主机名：
+
+`uname {{[-n|--nodename]}}`
+
+- 显示帮助信息：
+
+`uname --help`

pages.zh/common/units.md

@@ -7,6 +7,10 @@
 
 `units`
 
+- 在交互模式下列出包含特定字符串的所有单位：
+
+`search {{字符串}}`
+
 - 显示两个简单单位之间的转换：
 
 `units {{quarts(夸脱)}} {{tablespoons(大汤匙)}}`
@@ -17,11 +21,11 @@
 
 - 显示两个复合单位之间的转换：
 
-`units "{{meters(米) / second(秒)}}" "{{inches(英尺) / hour(小时)}}"`
+`units "{{meters(米) / second(秒)}}" "{{inches(英寸) / hour(小时)}}"`
 
 - 显示具有不同维度的单位之间的转换：
 
-`units "{{acres(英亩)}}" "{{ft(英尺)^2(平方)}}"`
+`units "{{acres(英亩)}}" "{{ft^2(平方英尺)}}"`
 
 - 显示字节乘数的转换：
 

pages.zh/common/wc.md

@@ -5,20 +5,24 @@
 
 - 计数文件中的行数：
 
-`wc {{[-l|--lines]}} {{文件}}`
+`wc {{[-l|--lines]}} {{路径/到/文件}}`
 
 - 计数文件中的单词数：
 
-`wc {{[-w|--words]}} {{文件}}`
+`wc {{[-w|--words]}} {{路径/到/文件}}`
 
-- 计数文件中的字符（字节）：
+- 计数文件中的字节数：
 
-`wc {{[-c|--bytes]}} {{文件}}`
+`wc {{[-c|--bytes]}} {{路径/到/文件}}`
 
 - 计数文件中的字符数（考虑所有多字节的字符）：
 
-`wc {{[-m|--chars]}} {{文件}}`
+`wc {{[-m|--chars]}} {{路径/到/文件}}`
 
-- 使用标准输入，按顺序计数行、单词和字符（字节）：
+- 使用 `stdin`，按顺序计数行、单词和字节：
 
 `{{find .}} | wc`
+
+- 计算最长行的长度（字符数）：
+
+`wc {{[-L|--max-line-length]}} {{路径/到/文件}}`

pages.zh/common/whereis.md

@@ -1,6 +1,6 @@
 # whereis
 
-> 找到命令的二进制，源文件和手册文件。
+> 找到命令的二进制文件、源文件和手册文件。
 > 更多信息：<https://manned.org/whereis>.
 
 - 找到 SSH 命令的二进制、源文件和手册页：
@@ -11,10 +11,18 @@
 
 `whereis -bm {{ls}}`
 
-- 找到 `gc` 的源文件和 `git` 的手册页：
+- 找到 `gcc` 的源文件和 `git` 的手册页：
 
 `whereis -s {{gcc}} -m {{git}}`
 
 - 仅在 /usr/bin/ 目录中查找 `gcc` 的二进制文件：
 
 `whereis -b -B {{/usr/bin/}} -f {{gcc}}`
+
+- 查找不寻常的二进制文件（系统上有多个或少于一个二进制文件的二进制文件）：
+
+`whereis -u *`
+
+- 查找有不寻常手册条目的二进制文件（安装了多个或少于一个手册的二进制文件）：
+
+`whereis -u -m *`

pages.zh/common/z.md

@@ -23,6 +23,10 @@
 
 `z -l {{foo}}`
 
-- 将当前文件夹从 `z`的数据库中移除：
+- 将当前文件夹从 `z` 的数据库中移除：
 
-`z -x .`
+`z -x`
+
+- 限制匹配结果为当前目录的子目录：
+
+`z -c {{foo}}`

pages.zh/common/zip.md

@@ -1,36 +1,33 @@
 # zip
 
 > 将文件打包并压缩（存档）为 zip 文件。
+> 另见：`unzip`。
 > 更多信息：<https://manned.org/zip>.
 
-- 递归地打包和压缩文件和目录：
+- 将文件/目录添加到指定存档中：
 
-`zip -r {{压缩文件.zip}} {{路径/到/文件}} {{路径/到/目录1}} {{路径/到/目录2}}`
+`zip {{[-r|--recurse-paths]}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
 
-- 添加到压缩档案中并排除不需要的文件：
+- 从指定存档中删除文件/目录：
 
-`zip -r {{压缩文件.zip}} {{路径/到/目录}} -x {{路径/到/不需要的文件}}`
+`zip {{[-d|--delete]}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
 
-- 使用最高压缩级别 9 压缩目录和内容：
+- 存档文件/目录，排除指定的文件/目录：
 
-`zip -r -{{9}} {{压缩文件.zip}} {{路径/到/目录}}`
+`zip {{[-r|--recurse-paths]}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}} {{-x|--exclude}} {{路径/到/排除的文件或目录}}`
 
-- 创建一个加密压缩档案（将会提示输入密码）：
+- 以指定的压缩级别存档文件/目录（`0` - 最低，`9` - 最高）：
 
-`zip -e -r {{压缩文件.zip}} {{路径/到/目录}}`
+`zip {{[-r|--recurse-paths]}} -{{0..9}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
 
-- 将文件添加到现有的 zip 文件：
+- 创建一个加密的存档：
 
-`zip {{压缩文件.zip}} {{路径/到/文件}}`
+`zip {{[-r|--recurse-paths]}} {{[-e|--encrypt]}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
 
-- 从现有 zip 文件中删除文件：
+- 将文件/目录存档为多段分割的 zip 存档（例如每部分 3 GB）：
 
-`zip -d {{压缩文件.zip}} "{{foo/*.tmp}}"`
+`zip {{[-r|--recurse-paths]}} {{[-s|--split-size]}} {{3g}} {{路径/到/压缩文件.zip}} {{路径/到/文件或目录1 路径/到/文件或目录2 ...}}`
 
-- 将指定目录及其内容打包并拆分为多个 zip 文件（例如：若干个 3 GB 的 zip 包）：
+- 打印指定存档的内容：
 
-`zip -r -s {{3g}} {{压缩文件.zip}} {{路径/到/目录}}`
-
-- 列出指定压缩档案中的文件（不提取文件）：
-
-`zip -sf {{压缩文件.zip}}`
+`zip {{[-sf|--split-size --freshen]}} {{路径/到/压缩文件.zip}}`

pages/common/%.md

@@ -11,9 +11,9 @@
 
 `%-`
 
-- Bring a job numbered `N` to front:
+- Bring the job number `n` to front:
 
-`%{{N}}`
+`%{{n}}`
 
 - Bring a job whose command starts with `string` to front:
 

pages/common/abduco.md

@@ -1,7 +1,7 @@
 # abduco
 
 > Terminal session manager.
-> More information: <https://www.brain-dump.org/projects/abduco/>.
+> More information: <https://manned.org/abduco>.
 
 - List sessions:
 

pages/common/ac.md

@@ -1,7 +1,7 @@
 # ac
 
 > Print statistics on how long users have been connected.
-> More information: <https://man.openbsd.org/ac>.
+> More information: <https://manned.org/ac.8>.
 
 - Print how long the current user has been connected in hours:
 

pages/common/act.md

@@ -1,11 +1,11 @@
 # act
 
 > Execute GitHub Actions locally using Docker.
-> More information: <https://github.com/nektos/act>.
+> More information: <https://manned.org/act>.
 
-- [l]ist the available jobs:
+- List the available jobs:
 
-`act -l`
+`act {{[-l|--list]}}`
 
 - Run the default event:
 
@@ -15,18 +15,18 @@
 
 `act {{event_type}}`
 
-- Run a specific [j]ob:
+- Run a specific job:
 
-`act -j {{job_id}}`
+`act {{[-j|--job]}} {{job_id}}`
 
 - Do [n]ot actually run the actions (i.e. a dry run):
 
-`act -n`
+`act {{[-n|--dryrun]}}`
 
-- Show [v]erbose logs:
+- Show verbose logs:
 
-`act -v`
+`act {{[-v|--verbose]}}`
 
-- Run a specific [W]orkflow with the push event:
+- Run a specific workflow with the push event:
 
-`act push -W {{path/to/workflow}}`
+`act push {{[-W|--workflows]}} {{path/to/workflow}}`

pages/common/ag.md

@@ -1,7 +1,7 @@
 # ag
 
 > The Silver Searcher. Like `ack`, but aims to be faster.
-> More information: <https://github.com/ggreer/the_silver_searcher>.
+> More information: <https://manned.org/ag>.
 
 - Find files containing "foo", and print the line matches in context:
 
@@ -11,17 +11,17 @@
 
 `ag {{foo}} {{path/to/directory}}`
 
-- Find files containing "foo", but only [l]ist the filenames:
+- Find files containing "foo", but only list the filenames:
 
-`ag -l {{foo}}`
+`ag {{[-l|--files-with-matches]}} {{foo}}`
 
-- Find files containing "FOO" case-[i]nsensitively, and print [o]nly the match, rather than the whole line:
+- Find files containing "FOO" case-insensitively, and print only the match, rather than the whole line:
 
-`ag -i -o {{FOO}}`
+`ag {{[-i|--ignore-case]}} {{[-o|--only-matching]}} {{FOO}}`
 
 - Find "foo" in files with a name matching "bar":
 
-`ag {{foo}} -G {{bar}}`
+`ag {{foo}} {{[-G|--file-search-regex]}} {{bar}}`
 
 - Find files whose contents match a regular expression:
 
@@ -29,4 +29,4 @@
 
 - Find files with a name matching "foo":
 
-`ag -g {{foo}}`
+`ag {{[-g|--filename-pattern]}} {{foo}}`

pages/common/age-keygen.md

@@ -6,7 +6,7 @@
 
 - Generate a key pair, save it to an unencrypted file, and print the public key to `stdout`:
 
-`age-keygen --output {{path/to/file}}`
+`age-keygen {{[-o|--output]}} {{path/to/file}}`
 
 - Convert an identit[y] to a recipient and print the public key to `stdout`:
 

pages/common/alacritty.md

@@ -1,7 +1,7 @@
 # alacritty
 
 > Cross-platform, GPU-accelerated terminal emulator.
-> More information: <https://github.com/alacritty/alacritty>.
+> More information: <https://manned.org/alacritty>.
 
 - Start a new Alacritty process and create a window:
 
@@ -21,7 +21,7 @@
 
 - [e]xecute a command in a new Alacritty window (also works with `alacritty msg create-window`):
 
-`alacritty -e {{command}}`
+`alacritty {{[-e|--command]}} {{command}}`
 
 - Use an alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.toml`):
 

pages/common/ani-cli.md

@@ -1,36 +1,36 @@
 # ani-cli
 
 > A cli to browse and watch anime.
-> More information: <https://github.com/pystardust/ani-cli>.
+> More information: <https://manned.org/ani-cli>.
 
 - Search anime by name:
 
 `ani-cli "{{anime_name}}"`
 
-- [d]ownload episode:
+- Download episode:
 
-`ani-cli -d "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} "{{anime_name}}"`
 
-- [d]ownload a [r]ange of episodes:
+- Download a range of episodes:
 
-`ani-cli -d -r "{{1 6}}" "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} {{[-r|--range]}} "{{1 6}}" "{{anime_name}}"`
 
-- [d]ownload the entire series (a range of all episodes):
+- Download the entire series (a range of all episodes):
 
-`ani-cli -d -r "1 -1" "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} {{[-r|--range]}} "1 -1" "{{anime_name}}"`
 
-- Use [v]LC as the media player:
+- Use VLC as the media player:
 
-`ani-cli -v "{{anime_name}}"`
+`ani-cli {{[-v|-vlc]}} "{{anime_name}}"`
 
-- Watch a specific [e]pisode:
+- Watch a specific episode:
 
-`ani-cli -e {{episode_number}} "{{anime_name}}"`
+`ani-cli {{[-e|--episode]}} {{episode_number}} "{{anime_name}}"`
 
-- [c]ontinue watching anime from history:
+- Continue watching anime from history:
 
-`ani-cli -c`
+`ani-cli {{[-c|--continue]}}`
 
-- [U]pdate `ani-cli`:
+- Update `ani-cli`:
 
-`ani-cli -U`
+`ani-cli {{[-U|--update]}}`

pages/common/ansible-playbook.md

@@ -7,21 +7,21 @@
 
 `ansible-playbook {{playbook}}`
 
-- Run tasks in playbook with custom host [i]nventory:
+- Run tasks in playbook with custom host inventory:
 
-`ansible-playbook {{playbook}} -i {{inventory_file}}`
+`ansible-playbook {{playbook}} {{[-i|--inventory]}} {{inventory_file}}`
 
-- Run tasks in playbook with [e]xtra variables defined via the command-line:
+- Run tasks in playbook with extra variables defined via the command-line:
 
-`ansible-playbook {{playbook}} -e "{{variable1}}={{value1}} {{variable2}}={{value2}}"`
+`ansible-playbook {{playbook}} {{[-e|--extra-vars]}} "{{variable1}}={{value1}} {{variable2}}={{value2}}"`
 
-- Run tasks in playbook with [e]xtra variables defined in a JSON file:
+- Run tasks in playbook with extra variables defined in a JSON file:
 
-`ansible-playbook {{playbook}} -e "@{{variables.json}}"`
+`ansible-playbook {{playbook}} {{[-e|--extra-vars]}} "@{{variables.json}}"`
 
 - Run tasks in playbook for the given tags:
 
-`ansible-playbook {{playbook}} --tags {{tag1,tag2}}`
+`ansible-playbook {{playbook}} {{[-t|--tags]}} {{tag1,tag2}}`
 
 - Run tasks in a playbook starting at a specific task:
 
@@ -29,4 +29,4 @@
 
 - Run tasks in a playbook without making any changes (dry-run):
 
-`ansible-playbook {{playbook}} --check --diff`
+`ansible-playbook {{playbook}} {{[-C|--check]}} {{[-D|--diff]}}`

pages/common/ansible.md

@@ -2,32 +2,32 @@
 
 > Manage groups of computers remotely over SSH. (use the `/etc/ansible/hosts` file to add new groups/hosts).
 > Some subcommands such as `galaxy` have their own usage documentation.
-> More information: <https://www.ansible.com/>.
+> More information: <https://docs.ansible.com/ansible/latest/cli/ansible.html>.
 
 - List hosts belonging to a group:
 
 `ansible {{group}} --list-hosts`
 
-- Ping a group of hosts by invoking the ping [m]odule:
+- Ping a group of hosts by invoking the ping module:
 
-`ansible {{group}} -m ping`
+`ansible {{group}} {{[-m|--module-name]}} ping`
 
 - Display facts about a group of hosts by invoking the setup [m]odule:
 
-`ansible {{group}} -m setup`
+`ansible {{group}} {{[-m|--module-name]}} setup`
 
 - Execute a command on a group of hosts by invoking command module with arguments:
 
-`ansible {{group}} -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - Execute a command with administrative privileges:
 
-`ansible {{group}} --become --ask-become-pass -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-b|--become]}} --ask-become-pass {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - Execute a command using a custom inventory file:
 
-`ansible {{group}} -i {{inventory_file}} -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-i|--inventory]}} {{inventory_file}} {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - List the groups in an inventory:
 
-`ansible localhost -m debug -a '{{var=groups.keys()}}'`
+`ansible localhost {{[-m|--module-name]}} debug {{[-a|--args]}} '{{var=groups.keys()}}'`

pages/common/ant.md

@@ -1,24 +1,24 @@
 # ant
 
 > Apache Ant: build and manage Java-based projects.
-> More information: <https://ant.apache.org>.
+> More information: <https://ant.apache.org/manual/index.html>.
 
 - Build a project with default build file `build.xml`:
 
 `ant`
 
-- Build a project using build [f]ile other than `build.xml`:
+- Build a project using build file other than `build.xml`:
 
-`ant -f {{buildfile.xml}}`
+`ant {{[-f|-buildfile]}} {{buildfile.xml}}`
 
 - Print information on possible targets for this project:
 
-`ant -p`
+`ant {{[-p|-projecthelp]}}`
 
 - Print debugging information:
 
-`ant -d`
+`ant {{[-d|-debug]}}`
 
 - Execute all targets that do not depend on fail target(s):
 
-`ant -k`
+`ant {{[-k|-keep-going]}}`

pages/common/apkleaks.md

@@ -4,14 +4,14 @@
 > Note: APKLeaks utilizes the `jadx` disassembler to decompile APK files.
 > More information: <https://github.com/dwisiswant0/apkleaks>.
 
-- Scan an APK [f]ile for URIs, endpoints, and secrets:
+- Scan an APK file for URIs, endpoints, and secrets:
 
-`apkleaks --file {{path/to/file.apk}}`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}}`
 
-- Scan and save the [o]utput to a specific file:
+- Scan and save the output to a specific file:
 
-`apkleaks --file {{path/to/file.apk}} --output {{path/to/output.txt}}`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}} {{[-o|--output]}} {{path/to/output.txt}}`
 
-- Pass `jadx` disassembler [a]rguments:
+- Pass `jadx` disassembler arguments:
 
-`apkleaks --file {{path/to/file.apk}} --args "{{--threads-count 5 --deobf}}"`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}} {{[-a|--args]}} "{{--threads-count 5 --deobf}}"`

pages/common/apropos.md

@@ -9,8 +9,8 @@
 
 - Search without restricting the output to the terminal width ([l]ong output):
 
-`apropos -l {{regular_expression}}`
+`apropos {{[-l|--long]}} {{regular_expression}}`
 
-- Search for pages that match [a]ll the expressions given:
+- Search for pages that match all the expressions given:
 
-`apropos {{regular_expression_1}} -a {{regular_expression_2}} -a {{regular_expression_3}}`
+`apropos {{regular_expression_1}} {{[-a|--and]}} {{regular_expression_2}} {{[-a|--and]}} {{regular_expression_3}}`

pages/common/arp.md

@@ -1,7 +1,7 @@
 # arp
 
 > Show and manipulate your system's ARP cache.
-> More information: <https://manned.org/arp>.
+> More information: <https://manned.org/arp.8>.
 
 - Show the current ARP table:
 

pages/common/arping.md

@@ -2,7 +2,7 @@
 
 > Discover and probe hosts in a network using the ARP protocol.
 > Useful for MAC address discovery.
-> More information: <https://github.com/ThomasHabets/arping>.
+> More information: <https://manned.org/arping>.
 
 - Ping a host by ARP request packets:
 

pages/common/asciinema.md

@@ -8,9 +8,9 @@
 
 `asciinema auth`
 
-- Make a new recording (finish it with `<Ctrl d>` or type `exit`, and then choose to upload it or save it locally):
+- Make a new recording (finish it with `<Ctrl d>` or type `exit`):
 
-`asciinema rec`
+`asciinema rec {{path/to/file.cast}}`
 
 - Make a new recording and save it to a local file:
 

pages/common/atoum.md

@@ -1,7 +1,7 @@
 # atoum
 
 > A simple, modern and intuitive unit testing framework for PHP.
-> More information: <https://atoum.org>.
+> More information: <https://atoum.readthedocs.io/en/latest/option_cli.html>.
 
 - Initialize a configuration file:
 
@@ -11,26 +11,26 @@
 
 `atoum`
 
-- Run tests using the specified [c]onfiguration file:
+- Run tests using the specified configuration file:
 
-`atoum -c {{path/to/file}}`
+`atoum {{[-c|--configuration]}} {{path/to/file}}`
 
-- Run a specific test [f]ile:
+- Run a specific test file:
 
-`atoum -f {{path/to/file}}`
+`atoum {{[-f|--files]}} {{path/to/file}}`
 
-- Run a specific [d]irectory of tests:
+- Run a specific directory of tests:
 
-`atoum -d {{path/to/directory}}`
+`atoum {{[-d|--directories]}} {{path/to/directory}}`
 
-- Run all tests under a specific name[s]pace:
+- Run all tests under a specific namespace:
 
-`atoum -ns {{namespace}}`
+`atoum {{[-ns|--namespaces]}} {{namespace}}`
 
-- Run all tests with a specific [t]ag:
+- Run all tests with a specific tag:
 
-`atoum -t {{tag}}`
+`atoum {{[-t|--tags]}} {{tag}}`
 
 - Load a custom bootstrap file before running tests:
 
-`atoum --bootstrap-file {{path/to/file}}`
+`atoum {{[-bf|--bootstrap-file]}} {{path/to/file}}`

pages/common/autossh.md

@@ -2,7 +2,7 @@
 
 > Run, monitor and restart SSH connections.
 > Auto-reconnects to keep port forwarding tunnels up. Accepts all SSH flags.
-> More information: <https://www.harding.motd.ca/autossh>.
+> More information: <https://manned.org/autossh>.
 
 - Start an SSH session, restarting when the [M]onitoring port fails to return data:
 

pages/common/avrdude.md

@@ -1,7 +1,7 @@
 # avrdude
 
 > Driver program for Atmel AVR microcontrollers programming.
-> More information: <https://www.nongnu.org/avrdude/>.
+> More information: <https://www.nongnu.org/avrdude/user-manual/avrdude_3.html#Option-Descriptions>.
 
 - [r]ead the flash ROM of a AVR microcontroller with a specific [p]art ID:
 

pages/common/aws-google-auth.md

@@ -3,18 +3,18 @@
 > Acquire AWS temporary (STS) credentials using Google Apps as a federated (Single Sign-On) provider.
 > More information: <https://github.com/cevoaustralia/aws-google-auth>.
 
-- Log in with Google SSO using the specified [u]sername [I]DP and [S]P identifiers and set the credentials [d]uration to one hour:
+- Log in with Google SSO using the specified username IDP and SP identifiers and set the credentials duration to one hour:
 
-`aws-google-auth -u {{example@example.com}} -I {{$GOOGLE_IDP_ID}} -S {{$GOOGLE_SP_ID}} -d {{3600}}`
+`aws-google-auth {{[-u|--username]}} {{example@example.com}} {{[-I|--idp-id]}} {{$GOOGLE_IDP_ID}} {{[-S|--sp-id]}} {{$GOOGLE_SP_ID}} {{[-d|--duration]}} {{3600}}`
 
-- Log in [a]sking which role to use (in case of several available SAML roles):
+- Log in asking which role to use (in case of several available SAML roles):
 
-`aws-google-auth -u {{example@example.com}} -I {{$GOOGLE_IDP_ID}} -S {{$GOOGLE_SP_ID}} -d {{3600}} -a`
+`aws-google-auth {{[-u|--username]}} {{example@example.com}} {{[-I|--idp-id]}} {{$GOOGLE_IDP_ID}} {{[-S|--sp-id]}} {{$GOOGLE_SP_ID}} {{[-d|--duration]}} {{3600}} {{[-a|--ask-role]}}`
 
 - Resolve aliases for AWS accounts:
 
-`aws-google-auth -u {{example@example.com}} -I {{$GOOGLE_IDP_ID}} -S {{$GOOGLE_SP_ID}} -d {{3600}} -a --resolve-aliases`
+`aws-google-auth {{[-u|--username]}} {{example@example.com}} {{[-I|--idp-id]}} {{$GOOGLE_IDP_ID}} {{[-S|--sp-id]}} {{$GOOGLE_SP_ID}} {{[-d|--duration]}} {{3600}} {{[-a|--ask-role]}} --resolve-aliases`
 
 - Display help:
 
-`aws-google-auth -h`
+`aws-google-auth {{[-h|--help]}}`

pages/common/axel.md

@@ -2,24 +2,24 @@
 
 > Download accelerator.
 > Supports HTTP, HTTPS, and FTP.
-> More information: <https://github.com/axel-download-accelerator/axel>.
+> More information: <https://manned.org/axel>.
 
 - Download a URL to a file:
 
 `axel {{url}}`
 
-- Download and specify an [o]utput file:
+- Download and specify an output file:
 
-`axel {{url}} -o {{path/to/file}}`
+`axel {{url}} {{[-o|--output]}} {{path/to/file}}`
 
-- Download with a specific [n]umber connections:
+- Download with a specific number connections:
 
-`axel -n {{connections_num}} {{url}}`
+`axel {{[-n|--num-connections]}} {{connections_num}} {{url}}`
 
-- [S]earch for mirrors:
+- Search for mirrors:
 
-`axel -S {{mirrors_num}} {{url}}`
+`axel {{[-S|--search]}} {{mirrors_num}} {{url}}`
 
-- Limit download [s]peed (bytes per second):
+- Limit download speed (bytes per second):
 
-`axel -s {{speed}} {{url}}`
+`axel {{[-s|--max-speed]}} {{speed}} {{url}}`

pages/common/az-lock.md

@@ -6,19 +6,19 @@
 
 - Create a read-only subscription level lock:
 
-`az lock create --name {{lock_name}} --lock-type ReadOnly`
+`az lock create {{[-n|--name]}} {{lock_name}} {{[-t|--lock-type]}} ReadOnly`
 
 - Create a read-only resource group level lock:
 
-`az lock create --name {{lock_name}} --resource-group {{group_name}} --lock-type ReadOnly`
+`az lock create {{[-n|--name]}} {{lock_name}} {{[-g|--resource-group]}} {{group_name}} {{[-t|--lock-type]}} ReadOnly`
 
 - Delete a subscription level lock:
 
-`az lock delete --name {{lock_name}}`
+`az lock delete {{[-n|--name]}} {{lock_name}}`
 
 - Delete a resource group level lock:
 
-`az lock delete --name {{lock_name}} --resource-group {{group_name}}`
+`az lock delete {{[-n|--name]}} {{lock_name}} {{[-g|--resource-group]}} {{group_name}}`
 
 - List out all locks on the subscription level:
 
@@ -26,4 +26,4 @@
 
 - Show a subscription level lock with a specific [n]ame:
 
-`az lock show -n {{lock_name}}`
+`az lock show {{[-n|--name]}} {{lock_name}}`

pages/common/az-storage-blob.md

@@ -4,22 +4,22 @@
 > Part of `azure-cli` (also known as `az`).
 > More information: <https://learn.microsoft.com/cli/azure/storage/blob>.
 
-- Download a blob to a [f]ile path specifying a [s]ource container:
+- Download a blob to a file path specifying a source container:
 
-`az storage blob download --account-name {{storage_account_name}} --account-key {{storage_account_key}} -c {{container_name}} -n {{path/to/blob}} -f {{path/to/local_file}}`
+`az storage blob download --account-name {{storage_account_name}} --account-key {{storage_account_key}} {{[-c|--container-name]}} {{container_name}} {{[-n|--name]}} {{path/to/blob}} {{[-f|--file]}} {{path/to/local_file}}`
 
 - [d]ownload blobs from a blob container recursively:
 
-`az storage blob download-batch --account-name {{storage_account_name}} --account-key {{storage_account_key}} -s {{container_name}} -d {{path/to/remote}} --pattern {{filename_regex}} --destination {{path/to/destination}}`
+`az storage blob download-batch --account-name {{storage_account_name}} --account-key {{storage_account_key}} {{[-s|--source]}} {{container_name}} {{[-d|--destination]}} {{path/to/remote}} --pattern {{filename_regex}} {{[-d|--destination]}} {{path/to/destination}}`
 
 - Upload a local file to blob storage:
 
-`az storage blob upload --account-name {{storage_account_name}} --account-key {{storage_account_key}} -c {{container_name}} -n {{path/to/blob}} -f {{path/to/local_file}}`
+`az storage blob upload --account-name {{storage_account_name}} --account-key {{storage_account_key}} {{[-c|--container-name]}} {{container_name}} {{[-n|--name]}} {{path/to/blob}} {{[-f|--file]}} {{path/to/local_file}}`
 
 - Delete a blob object:
 
-`az storage blob delete --account-name {{storage_account_name}} --account-key {{storage_account_key}} -c {{container_name}} -n {{path/to/blob}}`
+`az storage blob delete --account-name {{storage_account_name}} --account-key {{storage_account_key}} {{[-c|--container-name]}} {{container_name}} {{[-n|--name]}} {{path/to/blob}}`
 
 - Generate a shared access signature for a blob:
 
-`az storage blob generate-sas --account-name {{storage_account_name}} --account-key {{storage_account_key}} -c {{container_name}} -n {{path/to/blob}} --permissions {{permission_set}} --expiry {{Y-m-d'T'H:M'Z'}} --https-only`
+`az storage blob generate-sas --account-name {{storage_account_name}} --account-key {{storage_account_key}} {{[-c|--container-name]}} {{container_name}} {{[-n|--name]}} {{path/to/blob}} --permissions {{permission_set}} --expiry {{Y-m-d'T'H:M'Z'}} --https-only`

pages/common/az-storage.md

@@ -4,22 +4,22 @@
 > Part of `azure-cli` (also known as `az`).
 > More information: <https://learn.microsoft.com/cli/azure/storage>.
 
-- Create a storage account specifying a [l]ocation:
+- Create a storage account specifying a location:
 
-`az storage account create --resource-group {{group_name}} --name {{account_name}} -l {{location}} --sku {{account_sku}}`
+`az storage account create {{[-g|--resource-group]}} {{group_name}} {{[-n|--name]}} {{account_name}} {{[-l|--location]}} {{location}} --sku {{account_sku}}`
 
 - List all storage accounts in a resource group:
 
-`az storage account list --resource-group {{group_name}}`
+`az storage account list {{[-g|--resource-group]}} {{group_name}}`
 
 - List the access keys for a storage account:
 
-`az storage account keys list --resource-group {{group_name}} --name {{account_name}}`
+`az storage account keys list {{[-g|--resource-group]}} {{group_name}} {{[-n|--name]}} {{account_name}}`
 
 - Delete a storage account:
 
-`az storage account delete --resource-group {{group_name}} --name {{account_name}}`
+`az storage account delete {{[-g|--resource-group]}} {{group_name}} {{[-n|--name]}} {{account_name}}`
 
 - Update the minimum tls version setting for a storage account:
 
-`az storage account update --min-tls-version {{TLS1_0|TLS1_1|TLS1_2}} --resource-group {{group_name}} --name {{account_name}}`
+`az storage account update --min-tls-version {{TLS1_0|TLS1_1|TLS1_2}} {{[-g|--resource-group]}} {{group_name}} {{[-n|--name]}} {{account_name}}`

pages/common/banner.md

@@ -7,9 +7,9 @@
 
 `banner "{{Hello World}}"`
 
-- Use a banner [w]idth of 50 characters:
+- Use a banner width of 50 characters:
 
-`banner -w 50 "{{Hello World}}"`
+`banner {{[-w|--width]}} 50 "{{Hello World}}"`
 
 - Read text from `stdin`:
 

pages/common/bash.md

@@ -2,7 +2,7 @@
 
 > Bourne-Again SHell, an `sh`-compatible command-line interpreter.
 > See also: `zsh`, `histexpand` (history expansion).
-> More information: <https://www.gnu.org/software/bash/>.
+> More information: <https://www.gnu.org/software/bash/manual/html_node/Invoking-Bash.html>.
 
 - Start an interactive shell session:
 

pages/common/bats.md

@@ -3,26 +3,26 @@
 > Bash Automated Testing System: a TAP (<https://testanything.org/>) compliant testing framework for Bash.
 > More information: <https://bats-core.readthedocs.io/en/stable/usage.html>.
 
-- Run a BATS test script and output results in the [t]AP (Test Anything Protocol) format:
+- Run a BATS test script and output results in the TAP (Test Anything Protocol) format:
 
-`bats --tap {{path/to/test.bats}}`
+`bats {{[-t|--tap]}} {{path/to/test.bats}}`
 
-- [c]ount test cases of a test script without running any tests:
+- Count test cases of a test script without running any tests:
 
-`bats --count {{path/to/test.bats}}`
+`bats {{[-c|--count]}} {{path/to/test.bats}}`
 
-- Run BATS test cases [r]ecursively (files with a `.bats` extension):
+- Run BATS test cases recursively (files with a `.bats` extension):
 
-`bats --recursive {{path/to/directory}}`
+`bats {{[-r|--recursive]}} {{path/to/directory}}`
 
-- Output results in a specific [F]ormat:
+- Output results in a specific format:
 
-`bats --formatter {{pretty|tap|tap13|junit}} {{path/to/test.bats}}`
+`bats {{[-F|--formatter]}} {{pretty|tap|tap13|junit}} {{path/to/test.bats}}`
 
-- Add [T]iming information to tests:
+- Add timing information to tests:
 
-`bats --timing {{path/to/test.bats}}`
+`bats {{[-T|--timing]}} {{path/to/test.bats}}`
 
-- Run specific number of [j]obs in parallel (requires GNU `parallel` to be installed):
+- Run specific number of jobs in parallel (requires GNU `parallel` to be installed):
 
-`bats --jobs {{number}} {{path/to/test.bats}}`
+`bats {{[-j|--jobs]}} {{number}} {{path/to/test.bats}}`

pages/common/bb.md

@@ -3,13 +3,13 @@
 > Native Clojure interpreter for scripting.
 > More information: <https://book.babashka.org/#usage>.
 
-- [e]valuate an expression:
+- Evaluate an expression:
 
-`bb -e "(+ 1 2 3)"`
+`bb {{[-e|--eval]}} "(+ 1 2 3)"`
 
-- Evaluate a script [f]ile:
+- Evaluate a script file:
 
-`bb -f {{path/to/script.clj}}`
+`bb {{[-f|--file]}} {{path/to/script.clj}}`
 
 - Bind [i]nput to a sequence of lines from `stdin`:
 

pages/common/bc.md

@@ -8,9 +8,9 @@
 
 `bc`
 
-- Start an [i]nteractive session with the standard math [l]ibrary enabled:
+- Start an interactive session with the standard math library enabled:
 
-`bc --interactive --mathlib`
+`bc {{[-i|--interactive]}} {{[-l|--mathlib]}}`
 
 - Calculate an expression:
 
@@ -26,7 +26,7 @@
 
 - Calculate a sine/cosine/arctangent/natural logarithm/exponential function using `mathlib`:
 
-`echo '{{s|c|a|l|e}}({{1}})' | bc --mathlib`
+`echo '{{s|c|a|l|e}}({{1}})' | bc {{[-l|--mathlib]}}`
 
 - Execute an inline factorial script:
 

pages/common/bdfr.md

@@ -3,26 +3,26 @@
 > Bulk downloader for Reddit.
 > More information: <https://github.com/Serene-Arc/bulk-downloader-for-reddit>.
 
-- Download videos/images from the specified [l]inks to URL or ID's of posts:
+- Download videos/images from the specified links to URL or ID's of posts:
 
-`bdfr download {{path/to/output_directory}} -l {{post_url}}`
+`bdfr download {{path/to/output_directory}} {{[-l|--link]}} {{post_url}}`
 
-- Download the maximum possible number (roughly 1000) of videos/images from a specified [u]ser:
+- Download the maximum possible number (roughly 1000) of videos/images from a specified user:
 
-`bdfr download {{path/to/output_directory}} -u {{reddit_user}} --submitted`
+`bdfr download {{path/to/output_directory}} {{[-u|--user]}} {{reddit_user}} --submitted`
 
-- Download submission data (text, upvotes, comments, etc.) [L]imited to 10 submissions for each [s]ubreddit (30 total):
+- Download submission data (text, upvotes, comments, etc.) limited to 10 submissions for each subreddit (30 total):
 
-`bdfr archive {{path/to/output_directory}} -s '{{Python, all, mindustry}}' -L 10`
+`bdfr archive {{path/to/output_directory}} {{[-s|--subreddit]}} '{{Python, all, mindustry}}' {{[-L|--limit]}} 10`
 
-- Download videos/images from the [s]ubreddit r/Python [S]orted by top (default is hot) using [t]ime filter all, [L]imited to 10 submissions:
+- Download videos/images from the subreddit r/Python sorted by top (default is hot) using time filter all, limited to 10 submissions:
 
-`bdfr download {{path/to/output_directory}} -s Python -S top -t all -L 10`
+`bdfr download {{path/to/output_directory}} {{[-s|--subreddit]}} Python {{[-S|--sort]}} top {{[-t|--time]}} all {{[-L|--limit]}} 10`
 
-- Download the maximum possible number of both submission data and videos/images from [s]ubreddit r/Python skipping over submissions with mp4 or gif file extensions and creating hard links for duplicate files:
+- Download the maximum possible number of both submission data and videos/images from subreddit r/Python skipping over submissions with mp4 or gif file extensions and creating hard links for duplicate files:
 
-`bdfr clone {{path/to/output_directory}} -s Python --skip mp4 --skip gif --make-hard-links`
+`bdfr clone {{path/to/output_directory}} {{[-s|--subreddit]}} Python --skip mp4 --skip gif --make-hard-links`
 
 - Download saved posts of the authenticated user, naming each file according to a specified format. Avoid downloading duplicates and posts already present in the output directory:
 
-`bdfr download {{path/to/output_directory}} --user me --saved --authenticate --file-scheme '{{ {POSTID}_{TITLE}_{UPVOTES} }}' --no-dupes --search-existing`
+`bdfr download {{path/to/output_directory}} {{[-u|--user]}} me --saved --authenticate --file-scheme '{{ {POSTID}_{TITLE}_{UPVOTES} }}' --no-dupes --search-existing`

pages/common/beanstalkd.md

@@ -1,7 +1,7 @@
 # beanstalkd
 
 > A simple and generic work-queue server.
-> More information: <https://beanstalkd.github.io/>.
+> More information: <https://manned.org/beanstalkd>.
 
 - Start the server, listening on port 11300:
 

pages/common/bedtools.md

@@ -2,7 +2,7 @@
 
 > A swiss-army knife of tools for genomic-analysis tasks.
 > Used to intersect, group, convert and count data in BAM, BED, GFF/GTF, VCF format.
-> More information: <https://bedtools.readthedocs.io>.
+> More information: <https://bedtools.readthedocs.io/en/latest/content/overview.html#summary-of-available-tools>.
 
 - Intersect file [a] and file(s) [b] regarding the sequences' [s]trand and save the result to a specific file:
 

pages/common/black.md

@@ -7,9 +7,9 @@
 
 `black {{path/to/file_or_directory}}`
 
-- Format the [c]ode passed in as a string:
+- Format the code passed in as a string:
 
-`black -c "{{code}}"`
+`black {{[-c|--code]}} "{{code}}"`
 
 - Show whether a file or a directory would have changes made to them if they were to be formatted:
 
@@ -21,8 +21,8 @@
 
 - Auto-format a file or directory, emitting exclusively error messages to `stderr`:
 
-`black --quiet {{path/to/file_or_directory}}`
+`black {{[-q|--quiet]}} {{path/to/file_or_directory}}`
 
 - Auto-format a file or directory without replacing single quotes with double quotes (adoption helper, avoid using this for new projects):
 
-`black --skip-string-normalization {{path/to/file_or_directory}}`
+`black {{[-S|--skip-string-normalization]}} {{path/to/file_or_directory}}`

pages/common/blender.md

@@ -6,28 +6,28 @@
 
 - Render all frames of an animation in the background, without loading the UI (output is saved to `/tmp`):
 
-`blender --background {{path/to/file.blend}} --render-anim`
+`blender {{[-b|--background]}} {{path/to/file.blend}} {{[-a|--render-anim]}}`
 
 - Render an animation using a specific image naming pattern, in a path relative (`//`) to the .blend file:
 
-`blender --background {{path/to/file.blend}} --render-output //{{render/frame_###.png}} --render-anim`
+`blender {{[-b|--background]}} {{path/to/file.blend}} {{[-o|--render-output]}} //{{render/frame_###.png}} {{[-a|--render-anim]}}`
 
 - Render the 10th frame of an animation as a single image, saved to an existing directory (absolute path):
 
-`blender --background {{path/to/file.blend}} --render-output {{/path/to/output_directory}} --render-frame {{10}}`
+`blender {{[-b|--background]}} {{path/to/file.blend}} {{[-o|--render-output]}} {{/path/to/output_directory}} {{[-f|--render-frame]}} {{10}}`
 
 - Render the second last frame in an animation as a JPEG image, saved to an existing directory (relative path):
 
-`blender --background {{path/to/file.blend}} --render-output //{{output_directory}} --render-frame {{JPEG}} --render-frame {{-2}}`
+`blender {{[-b|--background]}} {{path/to/file.blend}} {{[-o|--render-output]}} //{{output_directory}} {{[-f|--render-frame]}} {{JPEG}} {{[-f|--render-frame]}} {{-2}}`
 
 - Render the animation of a specific scene, starting at frame 10 and ending at frame 500:
 
-`blender --background {{path/to/file.blend}} --scene {{scene_name}} --frame-start {{10}} --frame-end {{500}} --render-anim`
+`blender {{[-b|--background]}} {{path/to/file.blend}} {{[-S|--scene]}} {{scene_name}} {{[-s|--frame-start]}} {{10}} {{[-e|--frame-end]}} {{500}} {{[-a|--render-anim]}}`
 
 - Render an animation at a specific resolution, by passing a Python expression:
 
-`blender --background {{path/to/file.blend}} --python-expr '{{import bpy; bpy.data.scenes[0].render.resolution_percentage = 25}}' --render-anim`
+`blender {{[-b|--background]}} {{path/to/file.blend}} --python-expr '{{import bpy; bpy.data.scenes[0].render.resolution_percentage = 25}}' {{[-a|--render-anim]}}`
 
 - Start an interactive Blender session in the terminal with a Python console (do `import bpy` after starting):
 
-`blender --background --python-console`
+`blender {{[-b|--background]}} --python-console`

pages/common/bmaptool.md

@@ -1,11 +1,11 @@
 # bmaptool
 
 > Create or copy block maps intelligently (designed to be faster than `cp` or `dd`).
-> More information: <https://source.tizen.org/documentation/reference/bmaptool>.
+> More information: <https://manned.org/bmaptool>.
 
-- [o]utput a blockmap file from image file:
+- Output a blockmap file from image file:
 
-`bmaptool create -o {{blockmap.bmap}} {{source.img}}`
+`bmaptool create {{[-o|--output]}} {{blockmap.bmap}} {{source.img}}`
 
 - Copy an image file into sdb:
 

pages/common/bosh.md

@@ -3,9 +3,9 @@
 > Deploy and manage the BOSH director.
 > More information: <https://bosh.io/docs/cli-v2/>.
 
-- Create local alias for director in a specific [e]nvironment:
+- Create local alias for director in a specific environment:
 
-`bosh alias-env {{environment_name}} -e {{ip_address|URL}} --ca-cert {{ca_certificate}}`
+`bosh alias-env {{environment_name}} {{[-e|--environment]}} {{ip_address|URL}} --ca-cert {{ca_certificate}}`
 
 - List environments:
 
@@ -13,24 +13,24 @@
 
 - Log in to the director:
 
-`bosh login -e {{environment}}`
+`bosh login {{[-e|--environment]}} {{environment}}`
 
 - List deployments:
 
-`bosh -e {{environment}} deployments`
+`bosh {{[-e|--environment]}} {{environment}} deployments`
 
-- List environment virtual machines in a [d]eployment:
+- List environment virtual machines in a deployment:
 
-`bosh -e {{environment}} vms -d {{deployment}}`
+`bosh {{[-e|--environment]}} {{environment}} vms {{[-d|--deployment]}} {{deployment}}`
 
 - SSH into virtual machine:
 
-`bosh -e {{environment}} ssh {{virtual_machine}} -d {{deployment}}`
+`bosh {{[-e|--environment]}} {{environment}} ssh {{virtual_machine}} {{[-d|--deployment]}} {{deployment}}`
 
 - Upload stemcell:
 
-`bosh -e {{environment}} upload-stemcell {{stemcell_file|url}}`
+`bosh {{[-e|--environment]}} {{environment}} upload-stemcell {{stemcell_file|url}}`
 
 - Show current cloud config:
 
-`bosh -e {{environment}} cloud-config`
+`bosh {{[-e|--environment]}} {{environment}} cloud-config`

pages/common/boxes.md

@@ -7,26 +7,26 @@
 
 `echo "{{string}}" | boxes`
 
-- [r]emove a box from a string:
+- Remove a box from a string:
 
-`echo "{{string}}" | boxes -r`
+`echo "{{string}}" | boxes {{[-r|--remove]}}`
 
-- Specify the box [d]esign:
+- Specify the box design:
 
-`echo "{{string}}" | boxes -d {{parchment}}`
+`echo "{{string}}" | boxes {{[-d|--design]}} {{parchment}}`
 
-- Specify the box [s]ize (in columns by lines):
+- Specify the box size (in columns by lines):
 
-`echo "{{string}}" | boxes -s {{10}}x{{5}}`
+`echo "{{string}}" | boxes {{[-s|--size]}} {{10}}x{{5}}`
 
-- [a]lign the box text [h]orizonally (at [l]eft, [c]enter or [r]ight):
+- Align the box text [h]orizonally (at [l]eft, [c]enter or [r]ight):
 
-`echo "{{string}}" | boxes -a h{{l|c|r}}`
+`echo "{{string}}" | boxes {{[-a|--align]}} h{{l|c|r}}`
 
-- [a]lign the box text [v]ertically (at [t]op, [c]enter or [b]ottom):
+- Align the box text [v]ertically (at [t]op, [c]enter or [b]ottom):
 
-`echo "{{string}}" | boxes -a v{{t|c|b}}`
+`echo "{{string}}" | boxes {{[-a|--align]}} v{{t|c|b}}`
 
 - [j]ustify the box text (at [l]eft, [c]enter or [r]ight):
 
-`echo "{{string}}" | boxes -a j{{l|c|r}}{{vt}}`
+`echo "{{string}}" | boxes {{[-a|--align]}} j{{l|c|r}}{{vt}}`

pages/common/bpython.md

@@ -14,8 +14,8 @@
 
 - Execute a specific Python file and start a REPL:
 
-`bpython --interactive {{path/to/file.py}}`
+`bpython {{[-i|--interactive]}} {{path/to/file.py}}`
 
-- Use the specified [c]onfig file instead of the default config:
+- Use the specified config file instead of the default config:
 
 `bpython --config {{path/to/file.conf}}`

pages/common/brotli.md

@@ -1,24 +1,24 @@
 # brotli
 
 > Compress/uncompress files with Brotli compression.
-> More information: <https://github.com/google/brotli>.
+> More information: <https://manned.org/brotli>.
 
 - Compress a file, creating a compressed version next to the file:
 
 `brotli {{path/to/file}}`
 
-- [d]ecompress a file, creating an uncompressed version next to the file:
+- Decompress a file, creating an uncompressed version next to the file:
 
-`brotli -d {{path/to/file.br}}`
+`brotli {{[-d|--decompress]}} {{path/to/file.br}}`
 
-- Compress a file specifying the [o]utput filename:
+- Compress a file specifying the output filename:
 
-`brotli {{path/to/file}} -o {{path/to/compressed_output_file.br}}`
+`brotli {{path/to/file}} {{[-o|--output]}} {{path/to/compressed_output_file.br}}`
 
-- [d]ecompress a Brotli file specifying the [o]utput filename:
+- Decompress a Brotli file specifying the output filename:
 
-`brotli -d {{path/to/compressed_file.br}} -o {{path/to/output_file}}`
+`brotli {{[-d|--decompress]}} {{path/to/compressed_file.br}} {{[-o|--output]}} {{path/to/output_file}}`
 
 - Specify the compression quality (1=fastest (worst), 11=slowest (best)):
 
-`brotli -q {{11}} {{path/to/file}} -o {{path/to/compressed_output_file.br}}`
+`brotli {{[-q|--quality]}} {{11}} {{path/to/file}} {{[-o|--output]}} {{path/to/compressed_output_file.br}}`

pages/common/bup.md

@@ -1,24 +1,24 @@
 # bup
 
 > Backup system based on the Git packfile format, providing incremental saves and global deduplication.
-> More information: <https://github.com/bup/bup>.
+> More information: <https://manned.org/bup>.
 
-- Initialize a backup repository in a given local [d]irectory:
+- Initialize a backup repository in a given local directory:
 
-`bup -d {{path/to/repository}} init`
+`bup {{[-d|--bup-dir]}} {{path/to/repository}} init`
 
-- Prepare a given [d]irectory before taking a backup:
+- Prepare a given directory before taking a backup:
 
-`bup -d {{path/to/repository}} index {{path/to/directory}}`
+`bup {{[-d|--bup-dir]}} {{path/to/repository}} index {{path/to/directory}}`
 
-- Backup a [d]irectory to the repository specifying its [n]ame:
+- Backup a directory to the repository specifying its name:
 
-`bup -d {{path/to/repository}} save -n {{backup_name}} {{path/to/directory}}`
+`bup {{[-d|--bup-dir]}} {{path/to/repository}} save {{[-n|--name]}} {{backup_name}} {{path/to/directory}}`
 
 - Show the backup snapshots currently stored in the repository:
 
-`bup -d {{path/to/repository}} ls`
+`bup {{[-d|--bup-dir]}} {{path/to/repository}} ls`
 
-- Restore a specific backup snapshot to a target dire[C]tory:
+- Restore a specific backup snapshot to a target directory:
 
-`bup -d {{path/to/repository}} restore -C {{path/to/target_directory}} {{backup_name}}`
+`bup {{[-d|--bup-dir]}} {{path/to/repository}} restore {{[-C|--outdir]}} {{path/to/target_directory}} {{backup_name}}`

pages/common/bzip2.md

@@ -7,26 +7,26 @@
 
 `bzip2 {{path/to/file_to_compress}}`
 
-- [d]ecompress a file:
+- Decompress a file:
 
-`bzip2 -d {{path/to/compressed_file.bz2}}`
+`bzip2 {{[-d|--decompress]}} {{path/to/compressed_file.bz2}}`
 
-- [d]ecompress a file to `stdout`:
+- Decompress a file to `stdout`:
 
-`bzip2 -dc {{path/to/compressed_file.bz2}}`
+`bzip2 {{[-dc|--decompress --stdout]}} {{path/to/compressed_file.bz2}}`
 
 - Test the integrity of each file inside the archive file:
 
-`bzip2 --test {{path/to/compressed_file.bz2}}`
+`bzip2 {{[-t|--test]}} {{path/to/compressed_file.bz2}}`
 
 - Show the compression ratio for each file processed with detailed information:
 
-`bzip2 --verbose {{path/to/compressed_files.bz2}}`
+`bzip2 {{[-v|--verbose]}} {{path/to/compressed_files.bz2}}`
 
 - Decompress a file overwriting existing files:
 
-`bzip2 --force {{path/to/compressed_file.bz2}}`
+`bzip2 {{[-f|--force]}} {{path/to/compressed_file.bz2}}`
 
 - Display help:
 
-`bzip2 -h`
+`bzip2 {{[-h|--help]}}`

pages/common/bzip3.md

@@ -1,32 +1,32 @@
 # bzip3
 
 > An efficient statistical file compressor.
-> More information: <https://github.com/kspalaiologos/bzip3>.
+> More information: <https://manned.org/bzip3>.
 
 - Compress a file:
 
 `bzip3 {{path/to/file_to_compress}}`
 
-- [d]ecompress a file:
+- Decompress a file:
 
-`bzip3 -d {{path/to/compressed_file.bz3}}`
+`bzip3 {{[-d|--decode]}} {{path/to/compressed_file.bz3}}`
 
 - Decompress a file to `stdout` ([c]):
 
-`bzip3 -dc {{path/to/compressed_file.bz3}}`
+`bzip3 {{[-dc|--decode --stdout]}} {{path/to/compressed_file.bz3}}`
 
 - Test the integrity of each file inside the archive file:
 
-`bzip3 --test {{path/to/compressed_file.bz3}}`
+`bzip3 {{[-t|--test]}} {{path/to/compressed_file.bz3}}`
 
 - Show the compression ratio for each file processed with detailed information:
 
-`bzip3 --verbose {{path/to/compressed_files.bz3}}`
+`bzip3 {{[-v|--verbose]}} {{path/to/compressed_files.bz3}}`
 
 - Decompress a file overwriting existing files:
 
-`bzip3 -d --force {{path/to/compressed_file.bz3}}`
+`bzip3 {{[-d|--decode]}} {{[-f--force]}} {{path/to/compressed_file.bz3}}`
 
 - Display help:
 
-`bzip3 -h`
+`bzip3 {{[-h|--help]}}`

pages/common/calc.md

@@ -1,7 +1,7 @@
 # calc
 
 > An interactive arbitrary-precision calculator in the terminal.
-> More information: <https://github.com/lcn2/calc>.
+> More information: <https://manned.org/calc>.
 
 - Start `calc` in interactive mode:
 

pages/common/carbon-now.md

@@ -15,21 +15,21 @@
 
 `{{input}} | carbon-now --to-clipboard`
 
-- Create images [i]nteractively for custom settings and optionally save a preset:
+- Create images interactively for custom settings and optionally save a preset:
 
-`carbon-now -i {{path/to/file}}`
+`carbon-now {{[-i|--interactive]}} {{path/to/file}}`
 
-- Create images from a previously saved [p]reset:
+- Create images from a previously saved preset:
 
-`carbon-now -p {{preset}} {{path/to/file}}`
+`carbon-now {{[-p|--preset]}} {{preset}} {{path/to/file}}`
 
-- [s]tart at a specified line of text:
+- Start at a specified line of text:
 
-`carbon-now -s {{line}} {{path/to/file}}`
+`carbon-now {{[-s|--start]}} {{line}} {{path/to/file}}`
 
-- [e]nd at a specific line of text:
+- End at a specific line of text:
 
-`carbon-now -e {{line}} {{path/to/file}}`
+`carbon-now {{[-e|--end]}} {{line}} {{path/to/file}}`
 
 - Open image in a browser instead of saving:
 

pages/common/cargo-rustc.md

@@ -10,11 +10,11 @@
 
 - Build artifacts in release mode, with optimizations:
 
-`cargo rustc --release`
+`cargo rustc {{[-r|--release]}}`
 
 - Compile with architecture-specific optimizations for the current CPU:
 
-`cargo rustc --release -- -C target-cpu=native`
+`cargo rustc {{[-r|--release]}} -- -C target-cpu=native`
 
 - Compile with speed optimizations:
 
@@ -30,7 +30,7 @@
 
 - Build a specific package:
 
-`cargo rustc --package {{package}}`
+`cargo rustc {{[-p|--package]}} {{package}}`
 
 - Build only the specified binary:
 

pages/common/catimg.md

@@ -2,7 +2,7 @@
 
 > Image printing in the terminal.
 > See also: `pixterm`, `chafa`.
-> More information: <https://github.com/posva/catimg>.
+> More information: <https://manned.org/catimg>.
 
 - Print a JPEG, PNG, or GIF to the terminal:
 

pages/common/ccache.md

@@ -4,17 +4,17 @@
 > Note: packages usually provide symlinks for compilers in `/usr/lib/ccache/bin`. Prepend this directory to `$PATH` to automatically use `ccache` for them.
 > More information: <https://ccache.dev/manual/latest.html>.
 
-- Show current cache [s]tatistics:
+- Show current cache statistics:
 
-`ccache --show-stats`
+`ccache {{[-s|--show-stats]}}`
 
-- [C]lear all cache:
+- Clear all cache:
 
-`ccache --clear`
+`ccache {{[-C|--clear]}}`
 
-- Reset ([z]ero) statistics (but not cache itself):
+- Reset statistics (but not cache itself):
 
-`ccache --zero-stats`
+`ccache {{[-z|--zero-stats]}}`
 
 - Compile C code and cache compiled output (to use `ccache` on all `gcc` invocations, see the note above):
 

pages/common/cdecl.md

@@ -1,7 +1,7 @@
 # cdecl
 
 > Compose and decode C and C++ type declarations.
-> More information: <https://github.com/paul-j-lucas/cdecl>.
+> More information: <https://manned.org/cdecl>.
 
 - Compose English phrase into C declaration, and create [c]ompilable output (include `;` and `{}`):
 

pages/common/cdk.md

@@ -23,9 +23,9 @@
 
 `cdk diff {{stack_name}}`
 
-- Create a new CDK project in the current directory for a specified [l]anguage:
+- Create a new CDK project in the current directory for a specified language:
 
-`cdk init -l {{language}}`
+`cdk init {{[-l|--language]}} {{language}}`
 
 - Open the CDK API reference in your browser:
 

pages/common/chafa.md

@@ -8,13 +8,13 @@
 
 `chafa {{path/to/file}}`
 
-- Render an image with 24-bit [c]olor:
+- Render an image with 24-bit color:
 
-`chafa -c full {{path/to/file}}`
+`chafa {{[-c|--colors]}} full {{path/to/file}}`
 
 - Improve image rendering with small color palettes using dithering:
 
-`chafa -c 16 --dither ordered {{path/to/file}}`
+`chafa {{[-c|--colors]}} 16 --dither ordered {{path/to/file}}`
 
 - Render an image, making it appear pixelated:
 
@@ -22,4 +22,4 @@
 
 - Render a monochrome image with only braille characters:
 
-`chafa -c none --symbols braille {{path/to/file}}`
+`chafa {{[-c|--colors]}} none --symbols braille {{path/to/file}}`

pages/common/chatgpt.md

@@ -7,17 +7,17 @@
 
 `chatgpt`
 
-- Give a [p]rompt to answer to:
+- Give a prompt to answer to:
 
-`chatgpt --prompt "{{What is the regex to match an email address?}}"`
+`chatgpt {{[-p|--prompt]}} "{{What is the regex to match an email address?}}"`
 
-- Start in chat mode using a specific [m]odel (default is `gpt-3.5-turbo`):
+- Start in chat mode using a specific model (default is `gpt-3.5-turbo`):
 
-`chatgpt --model {{gpt-4}}`
+`chatgpt {{[-m|--model]}} {{gpt-4}}`
 
-- Start in chat mode with an [i]nitial prompt:
+- Start in chat mode with an initial prompt:
 
-`chatgpt --init-prompt "{{You are Rick, from Rick and Morty. Respond to questions using his mannerism and include insulting jokes.}}"`
+`chatgpt {{[-i|--init-prompt]}} "{{You are Rick, from Rick and Morty. Respond to questions using his mannerism and include insulting jokes.}}"`
 
 - Pipe the result of a command to `chatgpt` as a prompt:
 
@@ -25,4 +25,4 @@
 
 - Generate an image using DALL-E:
 
-`chatgpt --prompt "{{image: A white cat}}"`
+`chatgpt {{[-p|--prompt]}} "{{image: A white cat}}"`

pages/common/cheatshh.md

@@ -2,32 +2,32 @@
 
 > CLI cheatsheet with customized descriptions, tldr and groups, to look into for your reference.
 > Press `<Enter>` to a command to copy it to your clipboard and exit.
-> More information: <https://github.com/AnirudhG07/cheatshh>.
+> More information: <https://github.com/AnirudhG07/cheatshh/blob/main/docs/man/cheatshh.1>.
 
-- [a]dd a new command to the cheatshheet:
+- Add a new command to the cheatshheet:
 
-`cheatshh --add`
+`cheatshh {{[-a|--add]}}`
 
-- Edit ([ec]) an existing command's description or group in the cheatshheet:
+- Edit an existing command's description or group in the cheatshheet:
 
-`cheatshh --edit-command`
+`cheatshh {{[-ec|--edit-command]}}`
 
-- Delete ([dc]) an existing command from the cheatshheet:
+- Delete an existing command from the cheatshheet:
 
-`cheatshh --delete-command`
+`cheatshh {{[-dc|--delete-command]}}`
 
-- Create a new [g]roup:
+- Create a new group:
 
-`cheatshh --group`
+`cheatshh {{[-g|--group]}}`
 
-- Edit ([eg]) an existing group's name or description in the cheatsheet:
+- Edit an existing group's name or description in the cheatsheet:
 
-`cheatshh --edit-group`
+`cheatshh {{[-eg|--edit-group]}}`
 
-- Delete ([dg]) an existing group and it's sub commands from commands.json file:
+- Delete an existing group and it's sub commands from commands.json file:
 
-`cheatshh --delete-group`
+`cheatshh {{[-dg|--delete-group]}}`
 
-- Display [m]an pages after tldr in the preview:
+- Display man pages after tldr in the preview:
 
-`cheatshh --man`
+`cheatshh {{[-m|--man]}}`

pages/common/chronic.md

@@ -1,7 +1,7 @@
 # chronic
 
 > Display `stdout` and `stderr` of a command if and only if it fails.
-> More information: <https://joeyh.name/code/moreutils/>.
+> More information: <https://manned.org/chronic>.
 
 - Display `stdout` and `stderr` of the specified command if and only if it produces a non-zero exit code or crashes:
 

pages/common/d2.md

@@ -8,9 +8,9 @@
 
 `d2 {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
 
-- [w]atch live changes made to a D2 source file in the default web browser:
+- Watch live changes made to a D2 source file in the default web browser:
 
-`d2 --watch {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
+`d2 {{[-w|--watch]}} {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
 
 - Format a D2 source file:
 
@@ -20,10 +20,10 @@
 
 `d2 themes`
 
-- Use a different [t]heme for the output file (list available themes first to get the desired `theme_id`):
+- Use a different theme for the output file (list available themes first to get the desired `theme_id`):
 
-`d2 --theme {{theme_id}} {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
+`d2 {{[-t|--theme]}} {{theme_id}} {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
 
-- Make rendered diagrams look like hand [s]ketches:
+- Make rendered diagrams look like hand sketches:
 
-`d2 --sketch true {{path/to/input_file.d2}} {{path/to/output_file.ext}}`
+`d2 {{[-s|--sketch]}} true {{path/to/input_file.d2}} {{path/to/output_file.ext}}`

pages/common/ddev.md

@@ -1,7 +1,7 @@
 # ddev
 
 > Container based local development tool for PHP environments.
-> More information: <https://ddev.readthedocs.io>.
+> More information: <https://ddev.readthedocs.io/en/stable/users/usage/cli/>.
 
 - Start up a project:
 
@@ -11,9 +11,9 @@
 
 `ddev config`
 
-- [f]ollow the log trail:
+- Follow the log trail:
 
-`ddev logs -f`
+`ddev logs {{[-f|--follow]}}`
 
 - Run composer within the container:
 
@@ -25,7 +25,7 @@
 
 - Export a database:
 
-`ddev export-db --file={{/tmp/db.sql.gz}}`
+`ddev export-db {{[-f|--file]}} {{/tmp/db.sql.gz}}`
 
 - Run a specific command within a container:
 

pages/common/ddgr.md

@@ -11,9 +11,9 @@
 
 `ddgr {{keyword}}`
 
-- Limit the number of search results to `N`:
+- Limit the number of search results to `n`:
 
-`ddgr -n {{N}} {{keyword}}`
+`ddgr -n {{n}} {{keyword}}`
 
 - Display the complete URL in search results:
 

pages/common/dirs.md

@@ -12,9 +12,9 @@
 
 `dirs -p`
 
-- Display only the nth entry in the directory stack, starting at 0:
+- Display only the `n`th entry in the directory stack, starting at 0:
 
-`dirs +{{N}}`
+`dirs +{{n}}`
 
 - Clear the directory stack:
 

pages/common/dnsx.md

@@ -7,32 +7,32 @@
 
 - Query the A record of a (sub)domain and show [re]sponse received:
 
-`echo {{example.com}} | dnsx -a -re`
+`echo {{example.com}} | dnsx -a {{[-re|-resp]}}`
 
 - Query all the DNS records (A, AAAA, CNAME, NS, TXT, SRV, PTR, MX, SOA, AXFR, CAA):
 
-`dnsx -recon -re <<< {{example.com}}`
+`dnsx -recon {{[-re|-resp]}} <<< {{example.com}}`
 
 - Query a specific type of DNS record:
 
-`echo {{example.com}} | dnsx -re -{{a|aaaa|cname|ns|txt|srv|ptr|mx|soa|any|axfr|caa}}`
+`echo {{example.com}} | dnsx {{[-re|-resp]}} -{{a|aaaa|cname|ns|txt|srv|ptr|mx|soa|any|axfr|caa}}`
 
-- Output [r]esponse [o]nly (do not show the queried domain or subdomain):
+- Output response only (do not show the queried domain or subdomain):
 
-`echo {{example.com}} | dnsx -ro`
+`echo {{example.com}} | dnsx {{[-ro|-resp-only]}}`
 
-- Display raw response of a query, specifying [r]esolvers to use and retry attempts for failures:
+- Display raw response of a query, specifying resolvers to use and retry attempts for failures:
 
-`echo {{example.com}} | dnsx -{{debug|raw}} -resolver {{1.1.1.1,8.8.8.8,...}} -retry {{number}}`
+`echo {{example.com}} | dnsx -{{debug|raw}} {{[-r|-resolver]}} {{1.1.1.1,8.8.8.8,...}} -retry {{number}}`
 
 - Brute force DNS records using a placeholder:
 
-`dnsx -domain {{FUZZ.example.com}} -wordlist {{path/to/wordlist.txt}} -re`
+`dnsx {{[-d|-domain]}} {{FUZZ.example.com}} {{[-w|-wordlist]}} {{path/to/wordlist.txt}} {{[-re|-resp]}}`
 
-- Brute force DNS records from a list of [d]omains and wordlists, appending [o]utput to a file with [n]o [c]olor codes:
+- Brute force DNS records from a list of domains and wordlists, appending output to a file with no color codes:
 
-`dnsx -domain {{path/to/domain.txt}} -wordlist {{path/to/wordlist.txt}} -re -output {{path/to/output.txt}} -no-color`
+`dnsx {{[-d|-domain]}} {{path/to/domain.txt}} {{[-w|-wordlist]}} {{path/to/wordlist.txt}} {{[-re|-resp]}} {{[-o|-output]}} {{path/to/output.txt}} {{[-nc|-no-color]}}`
 
-- Extract `CNAME` records for the given list of subdomains, with [r]ate [l]imiting DNS queries per second:
+- Extract `CNAME` records for the given list of subdomains, with rate limiting DNS queries per second:
 
-`subfinder -silent -d {{example.com}} | dnsx -cname -re -rl {{number}}`
+`subfinder -silent {{[-d|-domain]}} {{example.com}} | dnsx -cname {{[-re|-resp]}} {{[-rl|-rate-limit]}} {{number}}`

pages/common/docker-update.md

@@ -18,7 +18,7 @@
 
 - Update the memory limit in [M]egabytes for a specific container:
 
-`docker update --memory {{limit}}M {{container_name}}`
+`docker update {{[-m|--memory]}} {{limit}}M {{container_name}}`
 
 - Update the maximum number of process IDs allowed inside a specific container (use `-1` for unlimited):
 

pages/common/doggo.md

@@ -2,7 +2,7 @@
 
 > DNS client for Humans.
 > Written in Golang.
-> More information: <https://github.com/mr-karan/doggo>.
+> More information: <https://doggo.mrkaran.dev/docs/guide/reference/>.
 
 - Perform a simple DNS lookup:
 
@@ -18,8 +18,8 @@
 
 - Output in the JSON format:
 
-`doggo {{example.com}} --json | jq '{{.responses[0].answers[].address}}'`
+`doggo {{example.com}} {{[-J|--json]}} | jq '{{.responses[0].answers[].address}}'`
 
 - Perform a reverse DNS lookup:
 
-`doggo --reverse {{8.8.4.4}} --short`
+`doggo {{[-x|--reverse]}} {{8.8.4.4}} --short`

pages/common/duplicity.md

@@ -3,7 +3,7 @@
 > Create incremental, compressed, encrypted and versioned backups.
 > Can also upload the backups to a variety of backend services.
 > It is worth mentioning that depending on the version, some options may not be available (e.g. `--gio` in 2.0.0).
-> More information: <https://duplicity.gitlab.io>.
+> More information: <https://duplicity.gitlab.io/stable/duplicity.1.html#name>.
 
 - Backup a directory via FTPS to a remote machine, encrypting it with a password:
 
@@ -23,7 +23,7 @@
 
 - List the files in a backup stored on a remote machine, via SSH:
 
-`duplicity list-current-files --time {{YYYY-MM-DD}} scp://{{user@hostname}}/{{path/to/backup/dir}}`
+`duplicity list-current-files {{[-t|--time]}} {{YYYY-MM-DD}} scp://{{user@hostname}}/{{path/to/backup/dir}}`
 
 - Restore a subdirectory from a GnuPG-encrypted local backup to a given location:
 

pages/common/elvish.md

@@ -2,7 +2,7 @@
 
 > Expressive programming language and a versatile interactive shell.
 > See also: `nu`.
-> More information: <https://elv.sh>.
+> More information: <https://elv.sh/ref/command.html>.
 
 - Start an interactive shell session: