From 426aac5cd2194015a3c1ac8e84fecb58db59ecd9 Mon Sep 17 00:00:00 2001
From: Abhisek Phago limbu <112129568+AbhisekLimbu@users.noreply.github.com>
Date: Tue, 24 Jun 2025 08:02:23 -0500
Subject: [PATCH] mp3info, zbd, sfill: add mnemonic hints and option
 placeholders (#16919)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
---
 pages/common/mp3info.md | 10 +++++-----
 pages/common/zdb.md     |  4 ++--
 pages/linux/sfill.md    |  8 ++++----
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/pages/common/mp3info.md b/pages/common/mp3info.md
index 600c988c7c..72dcfdd1c0 100644
--- a/pages/common/mp3info.md
+++ b/pages/common/mp3info.md
@@ -7,22 +7,22 @@
 
 `mp3info {{path/to/file.mp3}}`
 
-- Edit ID3v1 tags interactively:
+- Edit ID3v1 tags [i]nteractively:
 
 `mp3info -i {{path/to/file.mp3}}`
 
-- Set values for ID3v1 tags in a specific MP3 file:
+- Set values for ID3v1 tags in a specific MP3 file ([a]rtist, [t]itle, a[l]bum, [y]ear, and [c]omment):
 
 `mp3info -a "{{artist_name}}" -t "{{song_title}}" -l "{{album_title}}" -y {{year}} -c "{{comment_text}}" {{path/to/file.mp3}}`
 
-- Set the number of the track in the album for a specific MP3 file:
+- Set the [n]umber of the track in the album for a specific MP3 file:
 
 `mp3info -n {{track_number}} {{path/to/file.mp3}}`
 
-- Print a list of valid genres and their numeric codes:
+- [G]et a list of valid genres and their numeric codes:
 
 `mp3info -G`
 
-- Set the music genre for a specific MP3 file:
+- Set the music [g]enre for a specific MP3 file:
 
 `mp3info -g {{genre_number}} {{path/to/file.mp3}}`
diff --git a/pages/common/zdb.md b/pages/common/zdb.md
index 163f7e9468..94ca630130 100644
--- a/pages/common/zdb.md
+++ b/pages/common/zdb.md
@@ -9,8 +9,8 @@
 
 - Show detailed configuration for a specific ZFS pool:
 
-`zdb -C {{poolname}}`
+`zdb {{[-C|--config]}} {{poolname}}`
 
 - Show statistics about number, size and deduplication of blocks:
 
-`zdb -b {{poolname}}`
+`zdb {{[-b|--block-stats]}} {{poolname}}`
diff --git a/pages/linux/sfill.md b/pages/linux/sfill.md
index e25e00adb7..c6b8cab1d5 100644
--- a/pages/linux/sfill.md
+++ b/pages/linux/sfill.md
@@ -7,18 +7,18 @@
 
 `sfill {{/path/to/mounted_disk_directory}}`
 
-- Overwrite free space and inodes of a disk with 6 writes (fast but less secure) and show status:
+- Overwrite free space and inodes of a disk with 6 writes (fast but [l]ess secure) and show status ([v]erbose):
 
 `sfill -l -v {{/path/to/mounted_disk_directory}}`
 
-- Overwrite free space and inodes of a disk with 1 write (very fast but insecure) and show status:
+- Overwrite free space and inodes of a disk with 1 write (very fast but [l]ess secure [v]erbose) and show status:
 
 `sfill -ll -v {{/path/to/mounted_disk_directory}}`
 
-- Overwrite only free space of a disk:
+- Overwrite only free space of a d[I]sk:
 
 `sfill -I {{/path/to/mounted_disk_directory}}`
 
-- Overwrite only free inodes of a disk:
+- Overwrite only free [i]nodes of a disk:
 
 `sfill -i {{/path/to/mounted_disk_directory}}`