linux/{a, b}*: add option placeholders (#16954)

pages/linux/aurman.md

@@ -6,27 +6,27 @@
 
 - Synchronize and update all packages:
 
-`aurman --sync --refresh --sysupgrade`
+`aurman {{[-S|--sync]}} {{[-y|--refresh]}} {{[-u|--sysupgrade]}}`
 
 - Synchronize and update all packages without show changes of `PKGBUILD` files:
 
-`aurman --sync --refresh --sysupgrade --noedit`
+`aurman {{[-S|--sync]}} {{[-y|--refresh]}} {{[-u|--sysupgrade]}} --noedit`
 
 - Install a new package:
 
-`aurman --sync {{package}}`
+`aurman {{[-S|--sync]}} {{package}}`
 
 - Install a new package without show changes of `PKGBUILD` files:
 
-`aurman --sync --noedit {{package}}`
+`aurman {{[-S|--sync]}} --noedit {{package}}`
 
 - Install a new package without prompting:
 
-`aurman --sync --noedit --noconfirm {{package}}`
+`aurman {{[-S|--sync]}} --noedit --noconfirm {{package}}`
 
 - Search the package database for a keyword from the official repositories and AUR:
 
-`aurman --sync --search {{keyword}}`
+`aurman {{[-S|--sync]}} {{[-s|--search]}} {{keyword}}`
 
 - Remove a package and its dependencies:
 
@@ -34,4 +34,4 @@
 
 - Clear the package cache (use two `--clean` flags to clean all packages):
 
-`aurman --sync --clean`
+`aurman {{[-S|--sync]}} {{[-c|--clean]}}`

pages/linux/aurvote.md

@@ -14,12 +14,12 @@
 
 - Unvote one or more AUR packages:
 
-`aurvote --unvote {{package1 package2 ...}}`
+`aurvote {{[-u|--unvote]}} {{package1 package2 ...}}`
 
 - Check if one or more AUR packages have already been voted:
 
-`aurvote --check {{package1 package2 ...}}`
+`aurvote {{[-c|--check]}} {{package1 package2 ...}}`
 
 - Display help:
 
-`aurvote --help`
+`aurvote {{[-h|--help]}}`

pages/linux/autorandr.md

@@ -1,11 +1,11 @@
 # autorandr
 
 > Automatically change screen layout.
-> More information: <https://github.com/phillipberndt/autorandr>.
+> More information: <https://manned.org/autorandr>.
 
 - Save the current screen layout:
 
-`autorandr --save {{profile_name}}`
+`autorandr {{[-s|--save]}} {{profile_name}}`
 
 - Show the saved profiles:
 
@@ -13,12 +13,12 @@
 
 - Load the first detected profile:
 
-`autorandr --change`
+`autorandr {{[-c|--change]}}`
 
 - Load a specific profile:
 
-`autorandr --load {{profile_name}}`
+`autorandr {{[-l|--load]}} {{profile_name}}`
 
 - Set the default profile:
 
-`autorandr --default {{profile_name}}`
+`autorandr {{[-d|--default]}} {{profile_name}}`

pages/linux/balooctl.md

@@ -33,4 +33,4 @@
 
 - Display help:
 
-`balooctl --help`
+`balooctl {{[-h|--help]}}`

pages/linux/bcachefs.md

@@ -14,7 +14,7 @@
 
 - Create a RAID 0 filesystem where an SSD acts as a cache and an HDD acts as a long-term storage:
 
-`sudo bcachefs format --label=ssd.ssd1 {{path/to/ssd/partition}} --label=hdd.hdd1 {{path/to/hdd/partition}} --replicas=1 --foreground_target=ssd --promote_target=ssd --background_target=hdd`
+`sudo bcachefs format {{[-l|--label]}} {{ssd.ssd1}} {{path/to/ssd/partition}} {{[-l|--label]}} {{hdd.hdd1}} {{path/to/hdd/partition}} --replicas 1 --foreground_target {{ssd}} --promote_target {{ssd}} --background_target {{hdd}}`
 
 - Mount a multidevice filesystem:
 
@@ -22,11 +22,11 @@
 
 - Display disk usage:
 
-`bcachefs fs usage --human-readable {{path/to/mountpoint}}`
+`bcachefs fs usage {{[-h|--human-readable]}} {{path/to/mountpoint}}`
 
 - Set replicas after formatting and mounting:
 
-`sudo bcachefs set-fs-option --metadata_replicas={{2}} --data_replicas={{2}} {{path/to/partition}}`
+`sudo bcachefs set-fs-option --metadata_replicas {{2}} --data_replicas {{2}} {{path/to/partition}}`
 
 - Force `bcachefs` to ensure all files are replicated:
 

pages/linux/bchunk.md

@@ -1,7 +1,7 @@
 # bchunk
 
 > Convert CD images to a set of `.iso` and `.cdr` tracks.
-> More information: <http://he.fi/bchunk>.
+> More information: <https://manned.org/bchunk>.
 
 - Convert binary CD into a standard iso9960 image file:
 

pages/linux/betterdiscordctl.md

@@ -9,16 +9,16 @@
 
 - Install BetterDiscord on Discord Canary:
 
-`sudo betterdiscordctl --d-flavors canary install`
+`sudo betterdiscordctl {{[-f|--d-flavors]}} canary install`
 
 - Install BetterDiscord on Discord PTB:
 
-`sudo betterdiscordctl --d-flavors ptb install`
+`sudo betterdiscordctl {{[-f|--d-flavors]}} ptb install`
 
 - Install BetterDiscord on Discord installed with Flatpak:
 
-`sudo betterdiscordctl --d-install flatpak install`
+`sudo betterdiscordctl {{[-i|--d-install]}} flatpak install`
 
 - Install BetterDiscord on Discord installed with Snap:
 
-`sudo betterdiscordctl --d-install snap install`
+`sudo betterdiscordctl {{[-i|--d-install]}} snap install`

pages/linux/bleachbit.md

@@ -9,16 +9,16 @@
 
 - Shred a file:
 
-`bleachbit --shred {{path/to/file}}`
+`bleachbit {{[-s|--shred]}} {{path/to/file}}`
 
 - List available cleaner options:
 
-`bleachbit --list-cleaners`
+`bleachbit {{[-l|--list-cleaners]}}`
 
 - Preview the files that will be deleted and other changes that will be made before actually performing the clean-up operation:
 
-`bleachbit --preview {{--preset|cleaner1.option1 cleaner2.* ...}}`
+`bleachbit {{[-p|--preview]}} --preset {{cleaner1.option1 cleaner2.option2 ...}}`
 
 - Perform the clean-up operation and delete files:
 
-`bleachbit --clean {{--preset|cleaner1.option1 cleaner2.* ...}}`
+`bleachbit {{[-c|--clean]}} --preset {{cleaner1.option1 cleaner2.option2 ...}}`

pages/linux/bluebuild.md

@@ -13,7 +13,7 @@
 
 - Generate a Containerfile:
 
-`bluebuild generate --output {{Containerfile}} {{path/to/recipe.yml}}`
+`bluebuild generate {{[-o|--output]}} {{Containerfile}} {{path/to/recipe.yml}}`
 
 - Generate an ISO from a recipe:
 
@@ -21,4 +21,4 @@
 
 - Display help:
 
-`bluebuild --help`
+`bluebuild {{[-h|--help]}}`

pages/linux/bluetoothd.md

@@ -9,16 +9,16 @@
 
 - Start the daemon, logging to `stdout`:
 
-`bluetoothd --nodetach`
+`bluetoothd {{[-n|--nodetach]}}`
 
 - Start the daemon with a specific configuration file (defaults to `/etc/bluetooth/main.conf`):
 
-`bluetoothd --configfile {{path/to/file}}`
+`bluetoothd {{[-f|--configfile]}} {{path/to/file}}`
 
 - Start the daemon with verbose output to `stderr`:
 
-`bluetoothd --debug`
+`bluetoothd {{[-d|--debug]}}`
 
 - Start the daemon with verbose output coming from specific files in the bluetoothd or plugins source:
 
-`bluetoothd --debug={{path/to/file1:path/to/file2:...}}`
+`bluetoothd {{[-d|--debug=]}}{{path/to/file1:path/to/file2:...}}`

pages/linux/br.md

@@ -10,16 +10,16 @@
 
 - Start displaying the size of files and directories:
 
-`br --sizes`
+`br {{[-s|--sizes]}}`
 
 - Start displaying permissions:
 
-`br --permissions`
+`br {{[-p|--permissions]}}`
 
 - Start displaying directories only:
 
-`br --only-folders`
+`br {{[-f|--only-folders]}}`
 
 - Start displaying hidden files and directories:
 
-`br --hidden`
+`br {{[-h|--hidden]}}`

pages/linux/brightnessctl.md

@@ -1,11 +1,11 @@
 # brightnessctl
 
 > Utility for reading and controlling device brightness for Linux operating systems.
-> More information: <https://github.com/Hummer12007/brightnessctl>.
+> More information: <https://github.com/Hummer12007/brightnessctl#usage>.
 
 - List devices with changeable brightness:
 
-`brightnessctl --list`
+`brightnessctl {{[-l|--list]}}`
 
 - Print the current brightness of the display backlight:
 

pages/linux/bspc.md

@@ -6,23 +6,23 @@
 
 - Define two virtual desktops:
 
-`bspc monitor --reset-desktops {{desktop_name1}} {{desktop_name2}}`
+`bspc monitor {{[-d|--reset-desktops]}} {{desktop_name1}} {{desktop_name2}}`
 
 - Focus the given desktop:
 
-`bspc desktop --focus {{number}}`
+`bspc desktop {{[-f|--focus]}} {{number}}`
 
 - Close the windows rooted at the selected node:
 
-`bspc node --close`
+`bspc node {{[-c|--close]}}`
 
 - Send the selected node to the given desktop:
 
-`bspc node --to-desktop {{number}}`
+`bspc node {{[-d|--to-desktop]}} {{number}}`
 
 - Toggle full screen mode for the selected node:
 
-`bspc node --state ~fullscreen`
+`bspc node {{[-t|--state]}} ~fullscreen`
 
 - Set the value of a specific setting:
 

pages/linux/btrbk.md

@@ -13,11 +13,11 @@
 
 - Print what would happen in a run without making the displayed changes:
 
-`sudo btrbk --verbose dryrun`
+`sudo btrbk {{[-v|--verbose]}} dryrun`
 
 - Run backup routines verbosely, show progress bar:
 
-`sudo btrbk --progress --verbose run`
+`sudo btrbk --progress {{[-v|--verbose]}} run`
 
 - Only create snapshots for configured subvolumes:
 

pages/linux/btrfs-balance.md

@@ -13,7 +13,7 @@
 
 - Balance data block groups which are less than 15% utilized, running the operation in the background:
 
-`sudo btrfs balance start --bg -dusage={{15}} {{path/to/btrfs_filesystem}}`
+`sudo btrfs balance start {{[--bg|--background]}} -dusage={{15}} {{path/to/btrfs_filesystem}}`
 
 - Balance a max of 10 metadata chunks with less than 20% utilization and at least 1 chunk on a given device `devid` (see `btrfs filesystem show`):
 

pages/linux/btrfs-subvolume.md

@@ -15,7 +15,7 @@
 
 `sudo btrfs subvolume delete {{path/to/subvolume}}`
 
-- Create a read-only snapshot of an existing subvolume:
+- Create a [r]ead-only snapshot of an existing subvolume:
 
 `sudo btrfs subvolume snapshot -r {{path/to/source_subvolume}} {{path/to/target}}`
 

pages/linux/btrfs-version.md

@@ -7,6 +7,6 @@
 
 `btrfs version --help`
 
-- Display btrfs-progs version:
+- Display version:
 
 `btrfs version`

pages/linux/bully.md

@@ -6,8 +6,8 @@
 
 - Crack the password:
 
-`bully --bssid "{{mac}}" --channel "{{channel}}" --bruteforce "{{interface}}"`
+`bully {{[-b|--bssid]}} "{{mac}}" {{[-c|--channel]}} "{{channel}}" {{[-B|--bruteforce]}} "{{interface}}"`
 
 - Display help:
 
-`bully --help`
+`bully {{[-h|--help]}}`

pages/linux/byzanz-record.md

@@ -9,11 +9,11 @@
 
 - Show information while and after recording:
 
-`byzanz-record --verbose {{path/to/file.[byzanz|flv|gif|ogg|ogv|webm]}}`
+`byzanz-record {{[-v|--verbose]}} {{path/to/file.[byzanz|flv|gif|ogg|ogv|webm]}}`
 
 - Record the screen for a minute:
 
-`byzanz-record --duration 60 {{path/to/file.[byzanz|flv|gif|ogg|ogv|webm]}}`
+`byzanz-record {{[-d|--duration]}} 60 {{path/to/file.[byzanz|flv|gif|ogg|ogv|webm]}}`
 
 - Delay recording for 10 seconds: