linux/*: switch from using mnemonics to option placeholders (#16029)

pages/linux/agetty.md

@@ -13,9 +13,9 @@
 
 `agetty {{[-t|--timeout]}} {{timeout_in_seconds}} -`
 
-- Assume the `tty` is [8]-bit, overriding the `TERM` environment variable set by `init`:
+- Assume the `tty` is 8-bit, overriding the `TERM` environment variable set by `init`:
 
-`agetty -8 - {{term_var}}`
+`agetty {{[-8|--8bits]}} - {{term_var}}`
 
 - Skip the login (no login) and invoke, as root, another login program instead of `/bin/login`:
 

pages/linux/apx-subsystems.md

@@ -2,7 +2,7 @@
 
 > Manage subsystems in `apx`.
 > Subsystems are containers that can be created based on pre-existing stacks.
-> More information: <https://github.com/Vanilla-OS/apx>.
+> More information: <https://docs.vanillaos.org/docs/en/apx-manpage#subsystems>.
 
 - Interactively create a new subsystem:
 
@@ -14,16 +14,16 @@
 
 - Reset a specific subsystem to its initial state:
 
-`apx subsystems reset --name {{string}}`
+`apx subsystems reset {{[-n|--name]}} {{string}}`
 
-- [f]orce reset a specific subsystem:
+- Force reset a specific subsystem:
 
-`apx subsystems reset --name {{string}} --force`
+`apx subsystems reset {{[-n|--name]}} {{string}} {{[-f|--force]}}`
 
 - Remove a specific subsystem:
 
-`apx subsystems rm --name {{string}}`
+`apx subsystems rm {{[-n|--name]}} {{string}}`
 
-- [f]orce remove a specific subsystem:
+- Force remove a specific subsystem:
 
-`apx subsystems rm --name {{string}} --force`
+`apx subsystems rm {{[-n|--name]}} {{string}} {{[-f|--force]}}`

pages/linux/arithmetic.md

@@ -1,7 +1,7 @@
 # arithmetic
 
 > Quiz on simple arithmetic problems.
-> More information: <https://manned.org/arithmetic.6>.
+> More information: <https://manned.org/arithmetic>.
 
 - Start an arithmetic quiz:
 

pages/linux/arpspoof.md

@@ -1,7 +1,7 @@
 # arpspoof
 
 > Forge ARP replies to intercept packets.
-> More information: <https://monkey.org/~dugsong/dsniff>.
+> More information: <https://manned.org/arpspoof>.
 
 - Poison all hosts to intercept packets on [i]nterface for the host:
 

pages/linux/asterisk.md

@@ -1,7 +1,7 @@
 # asterisk
 
 > Run and manage telephone and exchange (phone) server instances.
-> More information: <https://docs.asterisk.org>.
+> More information: <https://docs.asterisk.org/Operation/>.
 
 - [r]econnect to a running server, and turn on logging 3 levels of [v]erbosity:
 

pages/linux/autorecon.md

@@ -7,14 +7,14 @@
 
 `sudo autorecon {{host_or_ip1,host_or_ip2,...}}`
 
-- Perform reconnaissance on [t]arget(s) from a file:
+- Perform reconnaissance on target(s) from a file:
 
-`sudo autorecon --target-file {{path/to/file}}`
+`sudo autorecon {{[-t|--target-file]}} {{path/to/file}}`
 
-- [o]utput results to a different directory:
+- Output results to a different directory:
 
-`sudo autorecon --output {{path/to/results}} {{host_or_ip1,host_or_ip2,...}}`
+`sudo autorecon {{[-o|--output]}} {{path/to/results}} {{host_or_ip1,host_or_ip2,...}}`
 
-- Limit scanning to specific [p]orts and protocols (`T` for TCP, `U` for UDP, `B` for both):
+- Limit scanning to specific ports and protocols (`T` for TCP, `U` for UDP, `B` for both):
 
-`sudo autorecon --ports {{T:21-25,80,443,U:53,B:123}} {{host_or_ip1,host_or_ip2,...}}`
+`sudo autorecon {{[-p|--ports]}} {{T:21-25,80,443,U:53,B:123}} {{host_or_ip1,host_or_ip2,...}}`

pages/linux/bwa.md

@@ -2,7 +2,7 @@
 
 > Burrows-Wheeler Alignment tool.
 > Short, low-divergent DNA sequences mapper against a large reference genome, such as the human genome.
-> More information: <https://github.com/lh3/bwa>.
+> More information: <https://manned.org/bwa>.
 
 - Index the reference genome:
 

pages/linux/cat.md

@@ -19,7 +19,7 @@
 
 `cat - > {{path/to/file}}`
 
-- [n]umber all output lines:
+- Number all output lines:
 
 `cat {{[-n|--number]}} {{path/to/file}}`
 

pages/linux/cpupower.md

@@ -5,20 +5,20 @@
 
 - List CPUs:
 
-`sudo cpupower --cpu {{all}} info`
+`sudo cpupower {{[-c|--cpu]}} {{all}} info`
 
 - Print information about all cores:
 
-`sudo cpupower --cpu {{all}} info`
+`sudo cpupower {{[-c|--cpu]}} {{all}} info`
 
 - Set all CPUs to a power-saving frequency governor:
 
-`sudo cpupower --cpu {{all}} frequency-set --governor {{powersave}}`
+`sudo cpupower {{[-c|--cpu]}} {{all}} frequency-set --governor {{powersave}}`
 
-- Print CPU 0's available frequency [g]overnors:
+- Print CPU 0's available frequency governors:
 
-`sudo cpupower --cpu {{0}} frequency-info g | grep "analyzing\|governors"`
+`sudo cpupower {{[-c|--cpu]}} {{0}} frequency-info {{[-g|--governors]}} | grep "analyzing\|governors"`
 
 - Print CPU 4's frequency from the hardware, in a human-readable format:
 
-`sudo cpupower --cpu {{4}} frequency-info --hwfreq --human`
+`sudo cpupower {{[-c|--cpu]}} {{4}} frequency-info {{[-w|--hwfreq]}} {{[-m|--human]}}`

pages/linux/cryptcat.md

@@ -1,7 +1,7 @@
 # cryptcat
 
 > Cryptcat is netcat with encryption capabilities.
-> More information: <https://cryptcat.sourceforge.net>.
+> More information: <https://manned.org/cryptcat>.
 
 - [l]isten on a specified [p]ort and print any data received:
 

pages/linux/dbclient.md

@@ -1,7 +1,7 @@
 # dbclient
 
 > Lightweight Dropbear Secure Shell client.
-> More information: <https://manned.org/dbclient.1>.
+> More information: <https://manned.org/dbclient>.
 
 - Connect to a remote host:
 

pages/linux/dpigs.md

@@ -5,20 +5,20 @@
 
 - Display the N largest packages on the system:
 
-`dpigs --lines={{N}}`
+`dpigs {{[-n|--lines]}} {{N}}`
 
-- Use the specified file instead of the default dpkg [s]tatus file:
+- Use the specified file instead of the default dpkg status file:
 
-`dpigs --status={{path/to/file}}`
+`dpigs {{[-s|--status]}} {{path/to/file}}`
 
-- Display the largest [S]ource packages of binary packages installed on the system:
+- Display the largest source packages of binary packages installed on the system:
 
-`dpigs --source`
+`dpigs {{[-S|--source]}}`
 
-- Display package sizes in [H]uman-readable format:
+- Display package sizes in human-readable format:
 
-`dpigs --human-readable`
+`dpigs {{[-H|--human-readable]}}`
 
 - Display help:
 
-`dpigs --help`
+`dpigs {{[-h|--help]}}`

pages/linux/dropbearkey.md

@@ -1,7 +1,7 @@
 # dropbearkey
 
 > Generate SSH keys in Dropbear format.
-> More information: <https://manned.org/dropbearkey.1>.
+> More information: <https://manned.org/dropbearkey>.
 
 - Generate an SSH key of [t]ype ed25519 and write it to key [f]ile:
 

pages/linux/esearch.md

@@ -16,6 +16,6 @@
 
 `esearch -db nuccore -query "{{insulin [PROT] AND rodents [ORGN]}}"`
 
-- Display [h]elp:
+- Display help:
 
-`esearch -h`
+`esearch {{[-h|-help]}}`

pages/linux/getfacl.md

@@ -7,10 +7,10 @@
 
 `getfacl {{path/to/file_or_directory}}`
 
-- Display the file access control list with [n]umeric user and group IDs:
+- Display the file access control list with numeric user and group IDs:
 
-`getfacl --numeric {{path/to/file_or_directory}}`
+`getfacl {{[-n|--numeric]}} {{path/to/file_or_directory}}`
 
-- Display the file access control list with [t]abular output format:
+- Display the file access control list with tabular output format:
 
-`getfacl --tabular {{path/to/file_or_directory}}`
+`getfacl {{[-t|--tabular]}} {{path/to/file_or_directory}}`

pages/linux/iptables-save.md

@@ -8,10 +8,10 @@
 
 `sudo iptables-save`
 
-- Print the `iptables` configuration of a specific [t]able:
+- Print the `iptables` configuration of a specific table:
 
-`sudo iptables-save --table {{table}}`
+`sudo iptables-save {{[-t|--table]}} {{table}}`
 
-- Save the `iptables` configuration to a [f]ile:
+- Save the `iptables` configuration to a file:
 
-`sudo iptables-save --file {{path/to/file}}`
+`sudo iptables-save {{[-f|--file]}} {{path/to/file}}`

pages/linux/lsipc.md

@@ -12,13 +12,13 @@
 
 `lsipc {{--shmems|--queues|--semaphores}}`
 
-- Show full details on the resource with a specific [i]D:
+- Show full details on the resource with a specific ID:
 
-`lsipc {{--shmems|--queues|--semaphores}} --id {{resource_id}}`
+`lsipc {{--shmems|--queues|--semaphores}} {{[-i|--id]}} {{resource_id}}`
 
-- Print the given [o]utput columns (see all supported columns with `--help`):
+- Print the given output columns (see all supported columns with `--help`):
 
-`lsipc --output {{KEY,ID,PERMS,SEND,STATUS,NSEMS,RESOURCE,...}}`
+`lsipc {{[-o|--output]}} {{KEY,ID,PERMS,SEND,STATUS,NSEMS,RESOURCE,...}}`
 
 - Use [r]aw, [J]SON, [l]ist or [e]xport (key="value") format:
 

pages/linux/macchanger.md

@@ -5,24 +5,24 @@
 
 - View the current and permanent MAC addresses of a interface:
 
-`macchanger --show {{interface}}`
+`macchanger {{[-s|--show]}} {{interface}}`
 
 - Set interface to a random MAC:
 
-`macchanger --random {{interface}}`
+`macchanger {{[-r|--random]}} {{interface}}`
 
 - Set an interface to a random MAC address, and pretend to be a [b]urned-[i]n-[a]ddress:
 
-`macchanger --random --bia {{interface}}`
+`macchanger {{[-r|--random]}} {{[-b|--bia]}} {{interface}}`
 
 - Set an interface to a specific MAC address:
 
-`macchanger --mac {{XX:XX:XX:XX:XX:XX}} {{interface}}`
+`macchanger {{[-m|--mac]}} {{XX:XX:XX:XX:XX:XX}} {{interface}}`
 
 - Print the identifications (the first three bytes of a MAC address) of all known vendors:
 
-`macchanger --list`
+`macchanger {{[-l|--list]}}`
 
 - Reset an interface to its permanent hardware MAC address:
 
-`macchanger --permanent {{interface}}`
+`macchanger {{[-p|--permanent]}} {{interface}}`

pages/linux/namcap.md

@@ -1,7 +1,7 @@
 # namcap
 
 > Check binary packages and source `PKGBUILD`s for common packaging mistakes.
-> More information: <https://manned.org/namcap.1>.
+> More information: <https://manned.org/namcap>.
 
 - Check a specific `PKGBUILD` file:
 
@@ -11,6 +11,6 @@
 
 `namcap {{path/to/package.pkg.tar.zst}}`
 
-- Check a file, printing extra [i]nformational messages:
+- Check a file, printing extra informational messages:
 
-`namcap -i {{path/to/file}}`
+`namcap {{[-i|--info]}} {{path/to/file}}`

pages/linux/needrestart.md

@@ -1,7 +1,7 @@
 # needrestart
 
 > Check which daemons need to be restarted after library upgrades.
-> More information: <https://github.com/liske/needrestart>.
+> More information: <https://manned.org/needrestart>.
 
 - List outdated processes:
 

pages/linux/nitch.md

@@ -7,10 +7,10 @@
 
 `nitch`
 
-- Display [h]elp:
+- Display help:
 
-`nitch --help`
+`nitch {{[-h|--help]}}`
 
-- Display [v]ersion:
+- Display version:
 
-`nitch --version`
+`nitch {{[-v|--version]}}`

pages/linux/pkgctl-diff.md

@@ -2,20 +2,20 @@
 
 > Compare package files using different modes.
 > See also: `pkgctl`.
-> More information: <https://manned.org/pkgctl-diff.1>.
+> More information: <https://manned.org/pkgctl-diff>.
 
-- Compare package files in tar content [l]ist different mode (default):
+- Compare package files in tar content list different mode (default):
 
-`pkgctl diff --list {{path/to/file|pkgname}}`
+`pkgctl diff {{[-l|--list]}} {{path/to/file|pkgname}}`
 
-- Compare package files in [d]iffoscope different mode:
+- Compare package files in diffoscope different mode:
 
-`pkgctl diff --diffoscope {{path/to/file|pkgname}}`
+`pkgctl diff {{[-d|--diffoscope]}} {{path/to/file|pkgname}}`
 
 - Compare package files in `.PKGINFO` different mode:
 
-`pkgctl diff --pkginfo {{path/to/file|pkgname}}`
+`pkgctl diff {{[-p|--pkginfo]}} {{path/to/file|pkgname}}`
 
 - Compare package files in `.BUILDINFO` different mode:
 
-`pkgctl diff --buildinfo {{path/to/file|pkgname}}`
+`pkgctl diff {{[-b|--buildinfo]}} {{path/to/file|pkgname}}`

pages/linux/pyrit.md

@@ -1,7 +1,7 @@
 # pyrit
 
 > WPA/WPA2 cracking tool using computational power.
-> More information: <https://github.com/JPaulMora/Pyrit>.
+> More information: <https://manned.org/pyrit>.
 
 - Display system cracking speed:
 

pages/linux/qrcp.md

@@ -15,13 +15,13 @@
 
 `qrcp send --zip {{path/to/file_or_directory}}`
 
-- Use a specific [p]ort:
+- Use a specific port:
 
-`qrcp {{send|receive}} --port {{port_number}}`
+`qrcp {{send|receive}} {{[-p|--port]}} {{port_number}}`
 
-- Use a specific network [i]nterface:
+- Use a specific network interface:
 
-`qrcp {{send|receive}} --interface {{interface}}`
+`qrcp {{send|receive}} {{[-i|--interface]}} {{interface}}`
 
 - Keep the server alive:
 

pages/linux/rig.md

@@ -11,7 +11,7 @@
 
 `rig -{{m|f}}`
 
-- Use data files from a specific directory (default is `/usr/share/rig`):
+- Use [d]ata files from a specific directory (default is `/usr/share/rig`):
 
 `rig -d {{path/to/directory}}`
 
@@ -19,6 +19,6 @@
 
 `rig -c {{number}}`
 
-- Display a specific number of female identities:
+- Display a specific number of [f]emale identities:
 
 `rig -f -c {{number}}`

pages/linux/ruget.md

@@ -7,6 +7,6 @@
 
 `ruget {{https://example.com/file}}`
 
-- Download the contents of a URL to a specified [o]utput file:
+- Download the contents of a URL to a specified output file:
 
-`ruget --output {{file_name}} {{https://example.com/file}}`
+`ruget {{[-o|--output]}} {{file_name}} {{https://example.com/file}}`

pages/linux/setfacl.md

@@ -3,18 +3,18 @@
 > Set file access control lists (ACL).
 > More information: <https://manned.org/setfacl>.
 
-- [M]odify ACL of a file for user with read and write access:
+- Modify ACL of a file for user with read and write access:
 
-`setfacl --modify u:{{username}}:rw {{path/to/file_or_directory}}`
+`setfacl {{[-m|--modify]}} u:{{username}}:rw {{path/to/file_or_directory}}`
 
-- [M]odify [d]efault ACL of a file for all users:
+- Modify default ACL of a file for all users:
 
-`setfacl --modify --default u::rw {{path/to/file_or_directory}}`
+`setfacl {{[-m|--modify]}} {{[-d|--default]}} u::rw {{path/to/file_or_directory}}`
 
 - Remove ACL of a file for a user:
 
-`setfacl --remove u:{{username}} {{path/to/file_or_directory}}`
+`setfacl {{[-x|--remove]}} u:{{username}} {{path/to/file_or_directory}}`
 
 - Remove all ACL entries of a file:
 
-`setfacl --remove-all {{path/to/file_or_directory}}`
+`setfacl {{[-X|--remove-all]}} {{path/to/file_or_directory}}`

pages/linux/setsebool.md

@@ -12,11 +12,11 @@
 
 `sudo setsebool {{httpd_can_network_connect}} {{1|true|on|0|false|off}}`
 
-- Set or unset a boolean [p]ersistently:
+- Set or unset a boolean [P]ersistently:
 
 `sudo setsebool -P {{container_use_devices}} {{1|true|on|0|false|off}}`
 
-- Set or unset multiple booleans [p]ersistently at once:
+- Set or unset multiple booleans [P]ersistently at once:
 
 `sudo setsebool -P {{ftpd_use_fusefs=1 mount_anyfile=0 ...}}`
 

pages/linux/shutdown.md

@@ -15,7 +15,7 @@
 
 `shutdown {{[-r|--reboot]}} +{{5}} &`
 
-- Shutdown at 1:00 pm (Uses 24[h] clock):
+- Shutdown at 1:00 pm (Uses 24h clock):
 
 `shutdown -h 13:00`
 

pages/linux/swaybg.md

@@ -3,14 +3,14 @@
 > Wallpaper tool for Wayland compositors.
 > More information: <https://github.com/swaywm/swaybg/blob/master/swaybg.1.scd>.
 
-- Set the wallpaper to an [i]mage:
+- Set the wallpaper to an image:
 
-`swaybg --image {{path/to/image}}`
+`swaybg {{[-i|--image]}} {{path/to/image}}`
 
-- Set the wallpaper [m]ode:
+- Set the wallpaper mode:
 
-`swaybg --image {{path/to/image}} --mode {{stretch|fit|fill|center|tile|solid_color}}`
+`swaybg {{[-i|--image]}} {{path/to/image}} {{[-m|--mode]}} {{stretch|fit|fill|center|tile|solid_color}}`
 
-- Set the wallpaper to a static [c]olor:
+- Set the wallpaper to a static color:
 
-`swaybg --color "{{#rrggbb}}"`
+`swaybg {{[-c|--color]}} "{{#rrggbb}}"`

pages/linux/tcpick.md

@@ -4,13 +4,13 @@
 > It can capture and display TCP connections and data. It can also monitor network traffic on a interface, host, or port.
 > More information: <https://manned.org/tcpick.8>.
 
-- Capture traffic on a specific [i]nterface, port and host::
+- Capture traffic on a specific interface, port and host::
 
-`sudo tcpick -i {{interface}} -C -h {{host}} -p {{port}}`
+`sudo tcpick {{[-i|--interface]}} {{interface}} {{[-C|--colors]}} -h {{host}} -p {{port}}`
 
 - Capture traffic on port 80 (HTTP) of a specific host:
 
-`sudo tcpick -i {{eth0}} -C -h {{192.168.1.100}} -p {{80}}`
+`sudo tcpick {{[-i|--interface]}} {{eth0}} {{[-C|--colors]}} -h {{192.168.1.100}} -p {{80}}`
 
 - Display help:
 

pages/linux/tlp-stat.md

@@ -14,7 +14,7 @@
 
 - Show verbose information about devices that support verbosity:
 
-`sudo tlp-stat --verbose --{{battery|processor|pcie|usb}}`
+`sudo tlp-stat {{[-v|--verbose]}} --{{battery|processor|pcie|usb}}`
 
 - Show configuration:
 
@@ -28,7 +28,7 @@
 
 `sudo tlp-stat --psup`
 
-- Show [temp]eratures and fan speed:
+- Show [t]emperatures and fan speed:
 
 `sudo tlp-stat {{[-t|--temp]}}`
 

pages/linux/torsocks.md

@@ -2,7 +2,7 @@
 
 > Route the traffic of any application through the Tor network.
 > Note: `torsocks` will assume that it should connect to the Tor SOCKS proxy running at 127.0.0.1:9050 being the defaults of the Tor daemon.
-> More information: <https://gitlab.torproject.org/tpo/core/torsocks/>.
+> More information: <https://manned.org/torsocks>.
 
 - Run a command using Tor:
 
@@ -20,10 +20,10 @@
 
 `torsocks show`
 
-- [i]solate traffic through a different Tor circuit, improving anonymity:
+- Isolate traffic through a different Tor circuit, improving anonymity:
 
-`torsocks --isolate {{curl https://check.torproject.org/api/ip}}`
+`torsocks {{[-i|--isolate]}} {{curl https://check.torproject.org/api/ip}}`
 
-- Connect to a Tor proxy running on a specific [a]ddress and [P]ort:
+- Connect to a Tor proxy running on a specific address and port:
 
-`torsocks --address {{ip}} --port {{port}} {{command}}`
+`torsocks {{[-a|--address]}} {{ip}} {{[-P|--port]}} {{port}} {{command}}`

pages/linux/tunelp.md

@@ -4,22 +4,22 @@
 > Part of `util-linux`.
 > More information: <https://manned.org/tunelp>.
 
-- Check the [s]tatus of a parallel port device:
+- Check the status of a parallel port device:
 
-`tunelp --status {{/dev/lp0}}`
+`tunelp {{[-s|--status]}} {{/dev/lp0}}`
 
-- [r]eset a given parallel port:
+- Reset a given parallel port:
 
-`tunelp --reset {{/dev/lp0}}`
+`tunelp {{[-r|--reset]}} {{/dev/lp0}}`
 
-- Use a given [i]RQ for a device, each one representing an interrupt line:
+- Use a given IRQ for a device, each one representing an interrupt line:
 
-`tunelp -i 5 {{/dev/lp0}}`
+`tunelp {{[-i|--irq]}} 5 {{/dev/lp0}}`
 
-- Try a given number of times to output a [c]haracter to the printer before sleeping for a given [t]ime:
+- Try a given number of times to output a character to the printer before sleeping for a given time:
 
-`tunelp --chars {{times}} --time {{time_in_centiseconds}} {{/dev/lp0}}`
+`tunelp {{[-c|--chars]}} {{times}} {{[-t|--time]}} {{time_in_centiseconds}} {{/dev/lp0}}`
 
-- Enable or disable [a]borting on error (disabled by default):
+- Enable or disable aborting on error (disabled by default):
 
-`tunelp --abort {{on|off}}`
+`tunelp {{[-a|--abort]}} {{on|off}}`

pages/linux/urpmf.md

@@ -2,7 +2,7 @@
 
 > Find files in packages and query information about them in Mageia.
 > See also: `urpmi`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmi.update`, `urpmq`.
-> More information: <https://wiki.mageia.org/en/URPMI#urpmi.removemedia>.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmf>.
 
 - Search for packages that contain a file: