pages*: remove mnemonics when highlighting both long and short options (#12936)

pages/common/azurite.md

@@ -3,7 +3,7 @@
 > Azure Storage API compatible server (emulator) in local environment.
 > More information: <https://www.npmjs.com/package/azurite>.
 
-- Use an existing [l]ocation as workspace path:
+- Use an existing location as workspace path:
 
 `azurite {{-l|--location}} {{path/to/directory}}`
 
@@ -11,7 +11,7 @@
 
 `azurite {{-s|--silent}}`
 
-- Enable [d]ebug log by providing a file path as log destination:
+- Enable debug log by providing a file path as log destination:
 
 `azurite {{-d|--debug}} {{path/to/debug.log}}`
 

pages/common/diff.md

@@ -7,7 +7,7 @@
 
 `diff {{old_file}} {{new_file}}`
 
-- Compare files, ignoring [w]hite spaces:
+- Compare files, ignoring white spaces:
 
 `diff {{-w|--ignore-all-space}} {{old_file}} {{new_file}}`
 
@@ -15,11 +15,11 @@
 
 `diff {{-y|--side-by-side}} {{old_file}} {{new_file}}`
 
-- Compare files, showing the differences in [u]nified format (as used by `git diff`):
+- Compare files, showing the differences in unified format (as used by `git diff`):
 
 `diff {{-u|--unified}} {{old_file}} {{new_file}}`
 
-- Compare directories [r]ecursively (shows names for differing files/directories as well as changes made to files):
+- Compare directories recursively (shows names for differing files/directories as well as changes made to files):
 
 `diff {{-r|--recursive}} {{old_directory}} {{new_directory}}`
 

pages/common/git-archive.md

@@ -7,11 +7,11 @@
 
 `git archive --verbose HEAD`
 
-- Use the Zip format and report progress [v]erbosely:
+- Use the Zip format and report progress verbosely:
 
 `git archive {{-v|--verbose}} --format zip HEAD`
 
-- [o]utput the Zip archive to a specific file:
+- Output the Zip archive to a specific file:
 
 `git archive -v {{-o|--output}} {{path/to/file.zip}} HEAD`
 

pages/common/pydocstyle.md

@@ -7,11 +7,11 @@
 
 `pydocstyle {{file.py|path/to/directory}}`
 
-- Show an [e]xplanation of each error:
+- Show an explanation of each error:
 
 `pydocstyle {{-e|--explain}} {{file.py|path/to/directory}}`
 
-- Show [d]ebug information:
+- Show debug information:
 
 `pydocstyle {{-d|--debug}} {{file.py|path/to/directory}}`
 

pages/linux/agetty.md

@@ -9,7 +9,7 @@
 
 `agetty {{tty}} {{115200}}`
 
-- Assume `stdin` is already connected to a `tty` and set a [t]imeout for the login:
+- Assume `stdin` is already connected to a `tty` and set a timeout for the login:
 
 `agetty {{-t|--timeout}} {{timeout_in_seconds}} -`
 
@@ -17,14 +17,14 @@
 
 `agetty -8 - {{term_var}}`
 
-- Skip the login ([n]o login) and invoke, as root, another [l]ogin program instead of `/bin/login`:
+- Skip the login (no login) and invoke, as root, another login program instead of `/bin/login`:
 
 `agetty {{-n|--skip-login}} {{-l|--login-program}} {{login_program}} {{tty}}`
 
-- Do not display the pre-login ([i]ssue) file (`/etc/issue` by default) before writing the login prompt:
+- Do not display the pre-login (issue) file (`/etc/issue` by default) before writing the login prompt:
 
 `agetty {{-i|--noissue}} -`
 
-- Change the [r]oot directory and write a specific fake [H]ost into the `utmp` file:
+- Change the root directory and write a specific fake host into the `utmp` file:
 
 `agetty {{-r|--chroot}} {{/path/to/root_directory}} {{-H|--host}} {{fake_host}} -`

pages/linux/blkpr.md

@@ -3,22 +3,22 @@
 > Register, reserve, release, preempt, and clear persistent reservations on a block device that supports Persistent Reservations.
 > More information: <https://manned.org/blkpr>.
 
-- Register ([c]ommand) a new reservation with a given [k]ey on a given device:
+- Register (command) a new reservation with a given key on a given device:
 
-`blkpr {{-c|--command}} register --key {{reservation_key}} {{path/to/device}}`
+`blkpr {{-c|--command}} register {{-k|--key}} {{reservation_key}} {{path/to/device}}`
 
-- Set the [t]ype of an existing reservation to exclusive access:
+- Set the type of an existing reservation to exclusive access:
 
-`blkpr -c reserve -k {{reservation_key}} {{-t|--type}} exclusive-access {{path/to/device}}`
+`blkpr -c reserve {{-k|--key}} {{reservation_key}} {{-t|--type}} exclusive-access {{path/to/device}}`
 
-- Preempt the existing reservation with a given [K]ey and replace it with a new reservation:
+- Preempt the existing reservation with a given key and replace it with a new reservation:
 
-`blkpr -c preempt {{-K|--oldkey}} {{old_key}} --key {{new_key}} -t write-exclusive {{path/to/device}}`
+`blkpr -c preempt {{-K|--oldkey}} {{old_key}} {{-k|--key}} {{new_key}} {{-t|--type}} write-exclusive {{path/to/device}}`
 
-- Release a reservation with a given [k]ey and [t]ype on a given device:
+- Release a reservation with a given key and type on a given device:
 
-`blkpr -c release --key {{reservation_key}} -t {{reservation_type}} {{path/to/device}}`
+`blkpr -c release {{-k|--key}} {{reservation_key}} {{-t|--type}} {{reservation_type}} {{path/to/device}}`
 
 - Clear all reservations from a given device:
 
-`blkpr -c clear -k {{key}} {{path/to/device}}`
+`blkpr -c clear {{-k|--key}} {{key}} {{path/to/device}}`

pages/linux/pw-dot.md

@@ -12,7 +12,7 @@
 
 `pw-dot {{-j|--json}} {{path/to/file.json}}`
 
-- Specify an [o]utput file, showing [a]ll object types:
+- Specify an [o]utput file, showing all object types:
 
 `pw-dot --output {{path/to/file.dot}} {{-a|--all}}`
 
@@ -24,7 +24,7 @@
 
 `pw-dot --remote {{remote_name}} {{-s|--smart}}`
 
-- Lay the graph from [l]eft to [r]ight, instead of dot's default top to bottom:
+- Lay the graph from left to right, instead of dot's default top to bottom:
 
 `pw-dot {{-L|--lr}}`
 

pages/linux/showkey.md

@@ -7,15 +7,15 @@
 
 `sudo showkey`
 
-- Display [s]cancodes in hexadecimal:
+- Display scancodes in hexadecimal:
 
 `sudo showkey {{-s|--scancodes}}`
 
-- Display [k]eycodes in decimal (default):
+- Display keycodes in decimal (default):
 
 `sudo showkey {{-k|--keycodes}}`
 
-- Display keycodes in [a]SCII, decimal, and hexadecimal:
+- Display keycodes in ASCII, decimal, and hexadecimal:
 
 `sudo showkey {{-a|--ascii}}`