common/*: add option placeholders part 1 (#16205)

pages/common/ddgr.md

@@ -13,11 +13,11 @@
 
 - Limit the number of search results to `n`:
 
-`ddgr -n {{n}} {{keyword}}`
+`ddgr {{[-n|--num]}} {{n}} {{keyword}}`
 
 - Display the complete URL in search results:
 
-`ddgr -x {{keyword}}`
+`ddgr {{[-x|--expand]}} {{keyword}}`
 
 - Search DuckDuckGo for a keyword and open the first result in the browser:
 
@@ -25,7 +25,7 @@
 
 - Perform a website-specific search:
 
-`ddgr -w {{site}} {{keyword}}`
+`ddgr {{[-w|--site]}} {{site}} {{keyword}}`
 
 - Search for a specific file type:
 

pages/common/egrep.md

@@ -17,12 +17,12 @@
 
 - Print file name and line number for each match:
 
-`egrep --with-filename --line-number "{{search_pattern}}" {{path/to/file}}`
+`egrep {{[-H|--with-filename]}} {{[-n|--line-number]}} "{{search_pattern}}" {{path/to/file}}`
 
 - Search for a pattern in all files recursively in a directory, ignoring binary files:
 
-`egrep --recursive --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}`
+`egrep {{[-r|--recursive]}} --binary-files={{without-match}} "{{search_pattern}}" {{path/to/directory}}`
 
 - Search for lines that do not match a pattern:
 
-`egrep --invert-match "{{search_pattern}}" {{path/to/file}}`
+`egrep {{[-v|--invert-match]}} "{{search_pattern}}" {{path/to/file}}`

pages/common/faker.md

@@ -11,18 +11,18 @@
 
 `faker {{name|address|passport_full|credit_card_full|phone_number|email|company|date_time|user_name|password|job|...}}`
 
-- Generate a number of fake addresses from a specific country (use `localectl list-locales | cut -d. -f1` to get list of locales):
+- Generate a number of fake addresses from a specific country (use `localectl list-locales | cut --delimiter . --fields 1` to get list of locales):
 
-`faker --repeat {{number}} --lang {{de_DE|de_CH|...}} address`
+`faker {{[-r|--repeat]}} {{number}} {{[-l|--lang]}} {{de_DE|de_CH|...}} address`
 
-- Generate a number of cities in a specific country and output them to a file (use `localectl list-locales | cut -d. -f1` to get list of locales):
+- Generate a number of cities in a specific country and output them to a file (use `localectl list-locales | cut --delimiter . --fields 1` to get list of locales):
 
-`faker --repeat {{number}} --lang {{en_AU|en_US|...}} city -o {{path/to/file.txt}}`
+`faker {{[-r|--repeat]}} {{number}} {{[-l|--lang]}} {{en_AU|en_US|...}} city -o {{path/to/file.txt}}`
 
 - Generate a number of random HTTP user-agents showing verbose output:
 
-`faker --repeat {{number}} --verbose user_agent`
+`faker {{[-r|--repeat]}} {{number}} {{[-v|--verbose]}} user_agent`
 
 - Generate a number of domain names and separate each using a specific separator:
 
-`faker --repeat {{number}} --sep '{{,}}' domain_name`
+`faker {{[-r|--repeat]}} {{number}} {{[-s|--sep]}} '{{,}}' domain_name`

pages/common/googler.md

@@ -9,19 +9,19 @@
 
 - Search Google and open the first result in web browser:
 
-`googler -j {{keyword}}`
+`googler {{[-j|--first]}} {{keyword}}`
 
 - Show `n` search results (default: 10):
 
-`googler -n {{n}} {{keyword}}`
+`googler {{[-n|--count]}} {{n}} {{keyword}}`
 
 - Disable automatic spelling correction:
 
-`googler -x {{keyword}}`
+`googler {{[-x|--exact]}} {{keyword}}`
 
 - Search one site for a keyword:
 
-`googler -w {{site}} {{keyword}}`
+`googler {{[-w|--site]}} {{site}} {{keyword}}`
 
 - Show Google search result in JSON format:
 
@@ -29,7 +29,7 @@
 
 - Perform in-place self-upgrade:
 
-`googler -u`
+`googler {{[-u|--upgrade]}}`
 
 - Display help in interactive mode:
 

pages/common/jq.md

@@ -9,7 +9,7 @@
 
 - Execute a specific script:
 
-`{{cat path/to/file.json}} | jq --from-file {{path/to/script.jq}}`
+`{{cat path/to/file.json}} | jq {{[-f|--from-file]}} {{path/to/script.jq}}`
 
 - Pass specific arguments:
 

pages/common/julia.md

@@ -17,16 +17,16 @@
 
 - Evaluate a string containing Julia code:
 
-`julia -e '{{julia_code}}'`
+`julia {{[-e|--eval]}} '{{julia_code}}'`
 
 - Evaluate a string of Julia code, passing arguments to it:
 
-`julia -e '{{for x in ARGS; println(x); end}}' {{arguments}}`
+`julia {{[-e|--eval]}} '{{for x in ARGS; println(x); end}}' {{arguments}}`
 
 - Evaluate an expression and print the result:
 
-`julia -E '{{(1 - cos(pi/4))/2}}'`
+`julia {{[-E|--print]}} '{{(1 - cos(pi/4))/2}}'`
 
 - Start Julia in multithreaded mode, using `n` threads:
 
-`julia -t {{n}}`
+`julia {{[-t|--threads]}} {{n}}`

pages/common/mpg321.md

@@ -2,11 +2,11 @@
 
 > High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2, and 3.
 > Mpg321 was written (sometime in 1999) to be a drop-in replacement for the (previously) non-free mpg123 player.
-> More information: <https://mpg321.sourceforge.net/>.
+> More information: <https://manned.org/mpg321>.
 
 - Play an audio source exactly `n` times (0 means forever):
 
-`mpg321 -l {{n}} {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
+`mpg321 {{[-l|--loop]}} {{n}} {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
 
 - Play a directory recursively:
 
@@ -18,12 +18,12 @@
 
 - Play files randomly until interrupted:
 
-`mpg321 -Z {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
+`mpg321 {{[-Z|--random]}} {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
 
 - Shuffle the files before playing them once:
 
-`mpg321 -z {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
+`mpg321 {{[-z|--shuffle]}} {{path/to/file_a|URL}} {{path/to/file_b|URL}} {{...}}`
 
 - Play all files in the current directory and subdirectories, randomly (until interrupted), with Basic Keys enabled:
 
-`mpg321 -B -Z -K .`
+`mpg321 -B {{[-Z|--random]}} -K .`

pages/common/mytop.md

@@ -9,12 +9,12 @@
 
 - Connect with a specified username and password:
 
-`mytop -u {{user}} -p {{password}}`
+`mytop {{[-u|-user]}} {{user}} {{[-p|-password]}} {{password}}`
 
 - Connect with a specified username (the user will be prompted for a password):
 
-`mytop -u {{user}} --prompt`
+`mytop {{[-u|-user]}} {{user}} -prompt`
 
 - Do not show any idle (sleeping) threads:
 
-`mytop -u {{user}} -p {{password}} --noidle`
+`mytop {{[-u|-user]}} {{user}} {{[-p|-password]}} {{password}} --noidle`

pages/common/naabu.md

@@ -10,24 +10,24 @@
 
 - Display available network interfaces and public IP address of the local host:
 
-`naabu -interface-list`
+`naabu {{[-il|-interface-list]}}`
 
 - Scan all ports of the remote host (CONNECT scan without `sudo`):
 
-`naabu -p - -host {{host}}`
+`naabu {{[-p|-port]}} - -host {{host}}`
 
 - Scan the top 1000 ports of the remote host:
 
-`naabu -top-ports 1000 -host {{host}}`
+`naabu {{[-tp|-top-ports]}} 1000 -host {{host}}`
 
 - Scan TCP ports 80, 443 and UDP port 53 of the remote host:
 
-`naabu -p 80,443,u:53 -host {{host}}`
+`naabu {{[-p|-port]}} 80,443,u:53 -host {{host}}`
 
 - Show CDN type the remote host is using, if any:
 
-`naabu -p 80,443 -cdn -host {{host}}`
+`naabu {{[-p|-port]}} 80,443 -cdn -host {{host}}`
 
 - Run `nmap` from `naabu` for additional functionalities (`nmap` must be installed):
 
-`sudo naabu -v -host {{host}} -nmap-cli 'nmap {{-v -T5 -sC}}'`
+`sudo naabu {{[-v|-verbose]}} -host {{host}} -nmap-cli 'nmap {{-v -T5 -sC}}'`

pages/common/newsboat.md

@@ -5,7 +5,7 @@
 
 - First import feed URLs from an OPML file:
 
-`newsboat -i {{my-feeds.xml}}`
+`newsboat {{[-i|--import-from-opml]}} {{my-feeds.xml}}`
 
 - Alternatively, add feeds manually:
 
@@ -13,11 +13,11 @@
 
 - Start Newsboat and refresh all feeds on startup:
 
-`newsboat -r`
+`newsboat {{[-r|--refresh-on-start]}}`
 
 - Execute one or more commands in non-interactive mode:
 
-`newsboat -x {{reload print-unread ...}}`
+`newsboat {{[-x|--execute]}} {{reload print-unread ...}}`
 
 - See keyboard shortcuts (the most relevant are visible in the status line):
 

pages/common/nikto.md

@@ -5,20 +5,20 @@
 
 - Perform a basic Nikto scan against a target host:
 
-`perl nikto.pl -h {{192.168.0.1}}`
+`perl nikto.pl {{[-h|-host]}} {{192.168.0.1}}`
 
 - Specify the port number when performing a basic scan:
 
-`perl nikto.pl -h {{192.168.0.1}} -p {{443}}`
+`perl nikto.pl {{[-h|-host]}} {{192.168.0.1}} {{[-p|-port]}} {{443}}`
 
 - Scan ports and protocols with full URL syntax:
 
-`perl nikto.pl -h {{https://192.168.0.1:443/}}`
+`perl nikto.pl {{[-h|-host]}} {{https://192.168.0.1:443/}}`
 
 - Scan multiple ports in the same scanning session:
 
-`perl nikto.pl -h {{192.168.0.1}} -p {{80,88,443}}`
+`perl nikto.pl {{[-h|-host]}} {{192.168.0.1}} {{[-p|-port]}} {{80,88,443}}`
 
 - Update to the latest plugins and databases:
 
-`perl nikto.pl -update`
+`perl nikto.pl {{[-u|-update]}}`

pages/common/nim.md

@@ -6,19 +6,19 @@
 
 - Compile a source file:
 
-`nim compile {{path/to/file.nim}}`
+`nim {{[c|compile]}} {{path/to/file.nim}}`
 
 - Compile and run a source file:
 
-`nim compile -r {{path/to/file.nim}}`
+`nim {{[c|compile]}} {{[-r|--run]}} {{path/to/file.nim}}`
 
 - Compile a source file with release optimizations enabled:
 
-`nim compile -d:release {{path/to/file.nim}}`
+`nim {{[c|compile]}} {{[-d|--define]}}:release {{path/to/file.nim}}`
 
 - Build a release binary optimized for low file size:
 
-`nim compile -d:release --opt:size {{path/to/file.nim}}`
+`nim {{[c|compile]}} {{[-d|--define]}}:release --opt:size {{path/to/file.nim}}`
 
 - Generate HTML documentation for a module (output will be placed in the current directory):
 

pages/common/nimble.md

@@ -14,7 +14,7 @@
 
 - List installed packages:
 
-`nimble list -i`
+`nimble list {{[-i|--installed]}}`
 
 - Create a new Nimble package in the current directory:
 

pages/common/nix-classic.md

@@ -6,19 +6,19 @@
 
 - Search for a package in nixpkgs via its name:
 
-`nix-env -qaP {{search_term_regexp}}`
+`nix-env {{[-qaP|--query --available --attr-path]}} {{search_term_regexp}}`
 
 - Start a shell with the specified packages available:
 
-`nix-shell -p {{pkg1 pkg2 pkg3...}}`
+`nix-shell {{[-p|--packages]}} {{pkg1 pkg2 pkg3...}}`
 
 - Install some packages permanently:
 
-`nix-env -iA {{nixpkgs.pkg1 nixpkgs.pkg2...}}`
+`nix-env {{[-iA|--install --attr]}} {{nixpkgs.pkg1 nixpkgs.pkg2...}}`
 
 - Show all dependencies of a store path (package), in a tree format:
 
-`nix-store --query --tree {{/nix/store/...}}`
+`nix-store {{[-q|--query]}} --tree {{/nix/store/...}}`
 
 - Update the channels (repositories):
 

pages/common/nix-env.md

@@ -5,32 +5,32 @@
 
 - List all installed packages:
 
-`nix-env -q`
+`nix-env {{[-q|--query]}}`
 
 - Query installed packages:
 
-`nix-env -q {{search_term}}`
+`nix-env {{[-q|--query]}} {{search_term}}`
 
 - Query available packages:
 
-`nix-env -qa {{search_term}}`
+`nix-env {{[-qa|--query --available]}} {{search_term}}`
 
 - Install package:
 
-`nix-env -iA nixpkgs.{{pkg_name}}`
+`nix-env {{[-iA|--install --attr]}} nixpkgs.{{pkg_name}}`
 
 - Install a package from a URL:
 
-`nix-env -i {{pkg_name}} --file {{example.com}}`
+`nix-env {{[-i|--install]}} {{pkg_name}} {{[-f|--file]}} {{example.com}}`
 
 - Uninstall package:
 
-`nix-env -e {{pkg_name}}`
+`nix-env {{[-e|--uninstall]}} {{pkg_name}}`
 
 - Upgrade one package:
 
-`nix-env -u {{pkg_name}}`
+`nix-env {{[-u|--upgrade]}} {{pkg_name}}`
 
 - Upgrade all packages:
 
-`nix-env -u`
+`nix-env {{[-u|--upgrade]}}`

pages/common/nix-shell.md

@@ -18,12 +18,12 @@
 
 - Start with packages loaded from nixpkgs:
 
-`nix-shell --packages {{package1 package2 ...}}`
+`nix-shell {{[-p|--packages]}} {{package1 package2 ...}}`
 
 - Start with packages loaded from specific nixpkgs revision:
 
-`nix-shell --packages {{package1 package2 ...}} -I nixpkgs={{https://github.com/NixOS/nixpkgs/archive/nixpkgs_revision.tar.gz}}`
+`nix-shell {{[-p|--packages]}} {{package1 package2 ...}} {{[-I|--include]}} nixpkgs={{https://github.com/NixOS/nixpkgs/archive/nixpkgs_revision.tar.gz}}`
 
 - Evaluate rest of file in specific interpreter, for use in `#!-scripts` (see <https://nixos.org/manual/nix/stable/#use-as-a-interpreter>):
 
-`nix-shell -i {{interpreter}} --packages {{package1 package2 ...}}`
+`nix-shell -i {{interpreter}} {{[-p|--packages]}} {{package1 package2 ...}}`

pages/common/nix-store.md

@@ -18,12 +18,12 @@
 
 - Show all dependencies of a store path (package), in a tree format:
 
-`nix-store --query --tree {{/nix/store/...}}`
+`nix-store {{[-q|--query]}} --tree {{/nix/store/...}}`
 
 - Calculate the total size of a certain store path with all the dependencies:
 
-`du -cLsh $(nix-store --query --references {{/nix/store/...}})`
+`du {{[-cLsh|--total --dereference --summarize --human-readable]}} $(nix-store {{[-q|--query]}} --references {{/nix/store/...}})`
 
 - Show all dependents of a particular store path:
 
-`nix-store --query --referrers {{/nix/store/...}}`
+`nix-store {{[-q|--query]}} --referrers {{/nix/store/...}}`

pages/common/nix.md

@@ -7,7 +7,7 @@
 
 - Enable the `nix` command:
 
-`mkdir -p ~/.config/nix; echo 'experimental-features = nix-command flakes' > ~/.config/nix/nix.conf`
+`mkdir {{[-p|--parents]}} ~/.config/nix; echo 'experimental-features = nix-command flakes' > ~/.config/nix/nix.conf`
 
 - Search for a package in nixpkgs via its name or description:
 

pages/common/node.md

@@ -17,11 +17,11 @@
 
 - Evaluate JavaScript code by passing it as an argument:
 
-`node -e "{{code}}"`
+`node {{[-e|--eval]}} "{{code}}"`
 
 - Evaluate and print the result, useful to print node's dependencies versions:
 
-`node -p "process.versions"`
+`node {{[-p|--print]}} "process.versions"`
 
 - Activate inspector, pausing execution until a debugger is connected once source code is fully parsed:
 

pages/common/noti.md

@@ -13,4 +13,4 @@
 
 - Monitor a process by PID and trigger a notification when the PID disappears:
 
-`noti -w {{process_id}}`
+`noti {{[-w|--pwatch]}} {{process_id}}`

pages/common/npm-access.md

@@ -17,7 +17,7 @@
 
 - Set package status (public or private):
 
-`npm access set status={{public|private}} {{package_name}}`
+`npm access set status {{public|private}} {{package_name}}`
 
 - Grant access to a package:
 
@@ -29,4 +29,4 @@
 
 - Configure two-factor authentication requirement:
 
-`npm access set mfa={{none|publish|automation}} {{package_name}}`
+`npm access set mfa {{none|publish|automation}} {{package_name}}`

pages/common/npm-adduser.md

@@ -5,16 +5,16 @@
 
 - Create a new user in the specified registry and save credentials to `.npmrc`:
 
-`npm adduser --registry={{registry_url}}`
+`npm adduser --registry {{registry_url}}`
 
 - Log in to a private registry with a specific scope:
 
-`npm login --scope={{@mycorp}} --registry={{https://registry.mycorp.com}}`
+`npm login --scope {{@mycorp}} --registry {{https://registry.mycorp.com}}`
 
 - Log out from a specific scope and remove the auth token:
 
-`npm logout --scope={{@mycorp}}`
+`npm logout --scope {{@mycorp}}`
 
 - Create a scoped package during initialization:
 
-`npm init --scope={{@foo}} {{--yes}}`
+`npm init --scope {{@foo}} {{[-y|--yes]}}`

pages/common/npm-audit.md

@@ -30,4 +30,4 @@
 
 - Configure the audit to only fail on vulnerabilities above a specified severity:
 
-`npm audit --audit-level={{info|low|moderate|high|critical}}`
+`npm audit --audit-level {{info|low|moderate|high|critical}}`

pages/common/npm-check.md

@@ -9,12 +9,12 @@
 
 - Interactively update out-of-date packages:
 
-`npm-check --update`
+`npm-check {{[-u|--update]}}`
 
 - Update everything without prompting:
 
-`npm-check --update-all`
+`npm-check {{[-y|--update-all]}}`
 
 - Don't check for unused packages:
 
-`npm-check --skip-unused`
+`npm-check {{[-s|--skip-unused]}}`

pages/common/npm-ci.md

@@ -10,7 +10,7 @@
 
 - Install project dependencies but skip the specified dependency type:
 
-`npm ci --omit={{dev|optional|peer}}`
+`npm ci --omit {{dev|optional|peer}}`
 
 - Install project dependencies without running any pre-/post-scripts defined in `package.json`:
 

pages/common/npm-dedupe.md

@@ -17,11 +17,11 @@
 
 - Skip optional/peer dependencies during deduplication:
 
-`npm dedupe --omit={{optional|peer}}`
+`npm dedupe --omit {{optional|peer}}`
 
 - Enable detailed logging for troubleshooting:
 
-`npm dedupe --loglevel=verbose`
+`npm dedupe --loglevel verbose`
 
 - Limit deduplication to a specific package:
 

pages/common/npm-find-dupes.md

@@ -9,7 +9,7 @@
 
 - Include `devDependencies` in duplicate detection:
 
-`npm find-dupes --include=dev`
+`npm find-dupes --include dev`
 
 - List all duplicate instances of a specific package in `node-modules`:
 
@@ -17,11 +17,11 @@
 
 - Exclude optional dependencies from duplicate detection:
 
-`npm find-dupes --omit=optional`
+`npm find-dupes --omit optional`
 
 - Set the logging level for output:
 
-`npm find-dupes --loglevel={{silent|error|warn|info|verbose}}`
+`npm find-dupes --loglevel {{silent|error|warn|info|verbose}}`
 
 - Output duplicate information in JSON format:
 
@@ -29,8 +29,8 @@
 
 - Limit duplicate search to specific scopes:
 
-`npm find-dupes --scope={{@scope1,@scope2}}`
+`npm find-dupes --scope {{@scope1,@scope2}}`
 
 - Exclude specific scopes from duplicate detection:
 
-`npm find-dupes --omit-scope={{@scope1,@scope2}}`
+`npm find-dupes --omit-scope {{@scope1,@scope2}}`

pages/common/npm-fund.md

@@ -11,6 +11,6 @@
 
 `npm fund {{package}}`
 
-- List dependencies with a funding URL for a specific [w]orkspace for the project in the current directory:
+- List dependencies with a funding URL for a specific workspace for the project in the current directory:
 
-`npm fund -w {{workspace}}`
+`npm fund {{[-w|--workspace]}} {{workspace}}`

pages/common/npm-home.md

@@ -1,4 +1,4 @@
-# npm home
+# npm-home
 
 > Open the npm page, Yarn page, or GitHub repository of a package in the web browser.
 > More information: <https://github.com/sindresorhus/npm-home>.
@@ -9,8 +9,8 @@
 
 - Open the GitHub repository of a specific package in the web browser:
 
-`npm-home -g {{package}}`
+`npm-home {{[-g|--github]}} {{package}}`
 
 - Open the Yarn page of a specific package in the web browser:
 
-`npm-home -y {{package}}`
+`npm-home {{[-y|--yarn]}} {{package}}`

pages/common/npm-init.md

@@ -9,7 +9,7 @@
 
 - Initialize a new package with default values:
 
-`npm init -y`
+`npm init {{[-y|--yes]}}`
 
 - Initialize a new package using a specific initializer:
 

pages/common/npm-login.md

@@ -10,8 +10,8 @@
 
 - Log in using a custom registry:
 
-`npm login --registry={{registry_url}}`
+`npm login --registry {{registry_url}}`
 
 - Log in using a specific authentication strategy:
 
-`npm login --auth-type={{legacy|web}}`
+`npm login --auth-type {{legacy|web}}`

pages/common/npm-logout.md

@@ -10,4 +10,4 @@
 
 - Log out using a custom registry:
 
-`npm logout --registry={{registry_url}}`
+`npm logout --registry {{registry_url}}`

pages/common/npm-ls.md

@@ -9,15 +9,15 @@
 
 - Print all installed packages including peer dependencies:
 
-`npm ls --all`
+`npm ls {{[-a|--all]}}`
 
 - Print dependencies with extended information:
 
-`npm ls --long`
+`npm ls {{[-l|--long]}}`
 
 - Print dependencies in parseable format:
 
-`npm ls --parseable`
+`npm ls {{[-p|--parseable]}}`
 
 - Print dependencies in JSON format:
 

pages/common/npm-outdated.md

@@ -9,4 +9,4 @@
 
 - Find packages that are outdated regardless of the current project:
 
-`npm outdated --all`
+`npm outdated {{[-a|--all]}}`

pages/common/npm-query.md

@@ -25,8 +25,8 @@
 
 - Find all dependencies with postinstall scripts and uninstall them:
 
-`npm query ":attr(scripts, [postinstall])" | jq 'map(.name) | join("\n")' -r | xargs -I {} npm uninstall {}`
+`npm query ":attr(scripts, [postinstall])" | jq 'map(.name) | join("\n")' {{[-r|--raw-output]}} | xargs -I _ npm uninstall _`
 
 - Find all Git dependencies and print which application requires them:
 
-`npm query ":type(git)" | jq 'map(.name)' | xargs -I {} npm why {}`
+`npm query ":type(git)" | jq 'map(.name)' | xargs -I _ npm why _`

pages/common/npm-root.md

@@ -9,4 +9,4 @@
 
 - Display path to the global `node_modules` directory:
 
-`npm root --global`
+`npm root {{[-g|--global]}}`

pages/common/npm-uninstall.md

@@ -9,7 +9,7 @@
 
 - Remove a package globally:
 
-`npm uninstall -g {{package_name}}`
+`npm uninstall {{[-g|--global]}} {{package_name}}`
 
 - Remove multiple packages at once:
 

pages/common/npm-unpublish.md

@@ -9,7 +9,7 @@
 
 - Unpublish the entire package:
 
-`npm unpublish {{package_name}} --force`
+`npm unpublish {{package_name}} {{[-f|--force]}}`
 
 - Unpublish a package that is scoped:
 

pages/common/npm-update.md

@@ -13,7 +13,7 @@
 
 - Update a package globally:
 
-`npm update -g {{package}}`
+`npm update {{[-g|--global]}} {{package}}`
 
 - Update multiple packages at once:
 

pages/common/npm-version.md

@@ -21,4 +21,4 @@
 
 - Bump the major version with a custom commit message:
 
-`npm version major -m "{{Upgrade to %s for reasons}}"`
+`npm version major {{[-m|--message]}} "{{Upgrade to %s for reasons}}"`

pages/common/nth.md

@@ -5,16 +5,16 @@
 
 - Name a hash:
 
-`nth -t {{5f4dcc3b5aa765d61d8327deb882cf99}}`
+`nth {{[-t|--text]}} {{5f4dcc3b5aa765d61d8327deb882cf99}}`
 
 - Name hashes in a file:
 
-`nth -f {{path/to/hashes}}`
+`nth {{[-f|--file]}} {{path/to/hashes}}`
 
 - Print in JSON format:
 
-`nth -t {{5f4dcc3b5aa765d61d8327deb882cf99}} -g`
+`nth {{[-t|--text]}} {{5f4dcc3b5aa765d61d8327deb882cf99}} {{[-g|--greppable]}}`
 
 - Decode hash in Base64 before naming it:
 
-`nth -t {{NWY0ZGNjM2I1YWE3NjVkNjFkODMyN2RlYjg4MmNmOTkK}} -b64`
+`nth {{[-t|--text]}} {{NWY0ZGNjM2I1YWE3NjVkNjFkODMyN2RlYjg4MmNmOTkK}} {{[-b64|--base64]}}`

pages/common/nxc.md

@@ -2,7 +2,7 @@
 
 > Network service enumeration and exploitation tool.
 > Some subcommands such as `smb` have their own usage documentation.
-> More information: <https://www.netexec.wiki/>.
+> More information: <https://www.netexec.wiki/getting-started/selecting-and-using-a-protocol>.
 
 - [L]ist available modules for the specified protocol:
 

pages/common/objdump.md

@@ -5,20 +5,20 @@
 
 - Display the file header information:
 
-`objdump -f {{path/to/binary}}`
+`objdump {{[-f|--file-headers]}} {{path/to/binary}}`
 
 - Display all header information:
 
-`objdump -x {{path/to/binary}}`
+`objdump {{[-x|--all-headers]}} {{path/to/binary}}`
 
 - Display the disassembled output of executable sections:
 
-`objdump -d {{path/to/binary}}`
+`objdump {{[-d|--disassemble]}} {{path/to/binary}}`
 
 - Display the disassembled executable sections in Intel syntax:
 
-`objdump -M intel -d {{path/to/binary}}`
+`objdump {{[-M|--disassembler-options]}} intel {{[-d|--disassemble]}} {{path/to/binary}}`
 
 - Display a complete binary hex dump of all sections:
 
-`objdump -s {{path/to/binary}}`
+`objdump {{[-s|--full-contents]}} {{path/to/binary}}`

pages/common/olevba.md

@@ -14,15 +14,15 @@
 
 - Provide a password for encrypted Microsoft Office files (may be repeated):
 
-`olevba --password {{password}} {{path/to/encrypted_file}}`
+`olevba {{[-p|--password]}} {{password}} {{path/to/encrypted_file}}`
 
 - Display only analysis results, without showing macro source code:
 
-`olevba -a {{path/to/file}}`
+`olevba {{[-a|--analysis]}} {{path/to/file}}`
 
 - Display only macro source code:
 
-`olevba -c {{path/to/file}}`
+`olevba {{[-c|--code]}} {{path/to/file}}`
 
 - Show obfuscated strings and their decoded content:
 

pages/common/onionsearch.md

@@ -22,4 +22,4 @@
 
 - List all supported search engines:
 
-`onionsearch --help | grep -A1 -i "supported engines"`
+`onionsearch --help | grep {{[-A|--after-context]}} 1 {{[-i|--ignore-case]}} "supported engines"`

pages/common/open.md

@@ -4,7 +4,7 @@
 
 - View documentation for the command available in macOS:
 
-`tldr open -p osx`
+`tldr open {{[-p|--platform]}} osx`
 
 - View documentation for the command available through fish:
 

pages/common/openscad.md

@@ -1,7 +1,7 @@
 # openscad
 
 > Software for creating solid 3D CAD objects.
-> More information: <https://openscad.org>.
+> More information: <https://manned.org/openscad>.
 
 - Open a file:
 

pages/common/openttd.md

@@ -1,7 +1,7 @@
 # openttd
 
 > Open source clone of the Microprose game "Transport Tycoon Deluxe".
-> More information: <https://www.openttd.org>.
+> More information: <https://wiki.openttd.org/en/Manual/Command%20line>.
 
 - Start a new game:
 

pages/common/optipng.md

@@ -9,11 +9,11 @@
 
 - Compress a PNG with the best compression:
 
-`optipng -o{{7}} {{path/to/file.png}}`
+`optipng -o {{7}} {{path/to/file.png}}`
 
 - Compress a PNG with the fastest compression:
 
-`optipng -o{{0}} {{path/to/file.png}}`
+`optipng -o {{0}} {{path/to/file.png}}`
 
 - Compress a PNG and add interlacing:
 

pages/common/p7zip.md

@@ -10,16 +10,16 @@
 
 - Archive a file keeping the input file:
 
-`p7zip -k {{path/to/file}}`
+`p7zip {{[-k|--heep]}} {{path/to/file}}`
 
 - Decompress a file, replacing it with the original uncompressed version:
 
-`p7zip -d {{compressed.ext}}.7z`
+`p7zip {{[-d|--decompress]}} {{compressed.ext}}.7z`
 
 - Decompress a file keeping the input file:
 
-`p7zip -d -k {{compressed.ext}}.7z`
+`p7zip {{[-d|--decompress]}} {{[-k|--heep]}} {{compressed.ext}}.7z`
 
 - Skip some checks and force compression or decompression:
 
-`p7zip -f {{path/to/file}}`
+`p7zip {{[-f|--force]}} {{path/to/file}}`

pages/common/parallel.md

@@ -9,7 +9,7 @@
 
 - Read arguments from `stdin`, run 4 jobs at once:
 
-`ls *.txt | parallel -j4 gzip`
+`ls *.txt | parallel {{[-j|--jobs]}} 4 gzip`
 
 - Convert JPEG images to PNG using replacement strings:
 
@@ -25,11 +25,11 @@
 
 - Run on multiple machines via SSH:
 
-`parallel -S {{machine1}},{{machine2}} {{command}} ::: {{arg1}} {{arg2}}`
+`parallel {{[-S|--sshlogin]}} {{machine1}},{{machine2}} {{command}} ::: {{arg1}} {{arg2}}`
 
 - Download 4 files simultaneously from a text file containing links showing progress:
 
-`parallel -j4 --bar --eta wget {{[-q|--quote]}} {} :::: {{path/to/links.txt}}`
+`parallel {{[-j|--jobs]}} 4 --bar --eta wget {{[-q|--quote]}} {} :::: {{path/to/links.txt}}`
 
 - Print the jobs which `parallel` is running in `stderr`:
 

pages/common/pass.md

@@ -10,7 +10,7 @@
 
 - Save a new password and additional information (press `<Ctrl d>` on a new line to complete):
 
-`pass insert --multiline {{path/to/data}}`
+`pass insert {{[-m|--multiline]}} {{path/to/data}}`
 
 - Edit an entry:
 
@@ -18,7 +18,7 @@
 
 - Copy a password (first line of the data file) to the clipboard:
 
-`pass -c {{path/to/data}}`
+`pass {{[-c|--clip]}} {{path/to/data}}`
 
 - List the whole store tree:
 
@@ -26,7 +26,7 @@
 
 - Generate a new random password with a given length, and copy it to the clipboard:
 
-`pass generate -c {{path/to/data}} {{num}}`
+`pass generate {{[-c|--clip]}} {{path/to/data}} {{num}}`
 
 - Initialize a new Git repository (any changes done by pass will be committed automatically):
 

pages/common/patch.md

@@ -14,12 +14,12 @@
 
 - Patch a file writing the result to a different file:
 
-`patch {{path/to/input_file}} -o {{path/to/output_file}} < {{patch.diff}}`
+`patch {{path/to/input_file}} {{[-o|--output]}} {{path/to/output_file}} < {{patch.diff}}`
 
 - Apply a patch to the current directory:
 
-`patch -p1 < {{patch.diff}}`
+`patch {{[-p|--strip]}} 1 < {{patch.diff}}`
 
 - Apply the reverse of a patch:
 
-`patch -R < {{patch.diff}}`
+`patch {{[-R|--reverse]}} < {{patch.diff}}`

pages/common/pathchk.md

@@ -13,7 +13,7 @@
 
 - Check pathnames for validity on all POSIX compliant systems:
 
-`pathchk --portability {{path1 path2 …}}`
+`pathchk {{[-p -P|--portability]}} {{path1 path2 …}}`
 
 - Only check for empty pathnames or leading dashes (-):
 

pages/common/peerindex.md

@@ -10,4 +10,4 @@
 
 - Display all peers that have provided routing information:
 
-`peerindex -r {{master6.mrt}}`
+`peerindex {{[-r|--only-refs]}} {{master6.mrt}}`

pages/common/pg_ctl.md

@@ -5,20 +5,20 @@
 
 - Initialize a new PostgreSQL database cluster:
 
-`pg_ctl -D {{data_directory}} init`
+`pg_ctl {{[-D|--pgdata]}} {{data_directory}} init`
 
 - Start a PostgreSQL server:
 
-`pg_ctl -D {{data_directory}} start`
+`pg_ctl {{[-D|--pgdata]}} {{data_directory}} start`
 
 - Stop a PostgreSQL server:
 
-`pg_ctl -D {{data_directory}} stop`
+`pg_ctl {{[-D|--pgdata]}} {{data_directory}} stop`
 
 - Restart a PostgreSQL server:
 
-`pg_ctl -D {{data_directory}} restart`
+`pg_ctl {{[-D|--pgdata]}} {{data_directory}} restart`
 
 - Reload the PostgreSQL server configuration:
 
-`pg_ctl -D {{data_directory}} reload`
+`pg_ctl {{[-D|--pgdata]}} {{data_directory}} reload`

pages/common/pg_dump.md

@@ -9,20 +9,20 @@
 
 - Same as above, customize username:
 
-`pg_dump -U {{username}} {{db_name}} > {{output_file.sql}}`
+`pg_dump {{[-U|--username]}} {{username}} {{db_name}} > {{output_file.sql}}`
 
 - Same as above, customize host and port:
 
-`pg_dump -h {{host}} -p {{port}} {{db_name}} > {{output_file.sql}}`
+`pg_dump {{[-h|--host]}} {{host}} {{[-p|--port]}} {{port}} {{db_name}} > {{output_file.sql}}`
 
 - Dump a database into a custom-format archive file:
 
-`pg_dump -Fc {{db_name}} > {{output_file.dump}}`
+`pg_dump {{[-F|--format]}} {{[c|custom]}} {{db_name}} > {{output_file.dump}}`
 
 - Dump only database data into an SQL-script file:
 
-`pg_dump -a {{db_name}} > {{path/to/output_file.sql}}`
+`pg_dump {{[-a|--data-only]}} {{db_name}} > {{path/to/output_file.sql}}`
 
 - Dump only schema (data definitions) into an SQL-script file:
 
-`pg_dump -s {{db_name}} > {{path/to/output_file.sql}}`
+`pg_dump {{[-s|--schema-only]}} {{db_name}} > {{path/to/output_file.sql}}`

pages/common/pg_isready.md

@@ -9,8 +9,8 @@
 
 - Check connection with a specific hostname and port:
 
-`pg_isready --host={{hostname}} --port={{port}}`
+`pg_isready {{[-h|--host]}} {{hostname}} {{[-p|--port]}} {{port}}`
 
 - Check connection displaying a message only when the connection fails:
 
-`pg_isready --quiet`
+`pg_isready {{[-q|--quiet]}}`

pages/common/pg_restore.md

@@ -5,24 +5,24 @@
 
 - Restore an archive into an existing database:
 
-`pg_restore -d {{db_name}} {{archive_file.dump}}`
+`pg_restore {{[-d|--dbname]}} {{db_name}} {{archive_file.dump}}`
 
 - Same as above, customize username:
 
-`pg_restore -U {{username}} -d {{db_name}} {{archive_file.dump}}`
+`pg_restore {{[-U|--username]}} {{username}} {{[-d|--dbname]}} {{db_name}} {{archive_file.dump}}`
 
 - Same as above, customize host and port:
 
-`pg_restore -h {{host}} -p {{port}} -d {{db_name}} {{archive_file.dump}}`
+`pg_restore {{[-h|--host]}} {{host}} {{[-p|--port]}} {{port}} {{[-d|--dbname]}} {{db_name}} {{archive_file.dump}}`
 
 - List database objects included in the archive:
 
-`pg_restore --list {{archive_file.dump}}`
+`pg_restore {{[-l|--list]}} {{archive_file.dump}}`
 
 - Clean database objects before creating them:
 
-`pg_restore --clean -d {{db_name}} {{archive_file.dump}}`
+`pg_restore {{[-c|--clean]}} {{[-d|--dbname]}} {{db_name}} {{archive_file.dump}}`
 
 - Use multiple jobs to do the restoring:
 
-`pg_restore -j {{2}} -d {{db_name}} {{archive_file.dump}}`
+`pg_restore {{[-j|--jobs]}} {{2}} {{[-d|--dbname]}} {{db_name}} {{archive_file.dump}}`

pages/common/phing.md

@@ -1,7 +1,7 @@
 # phing
 
 > A PHP build tool based on Apache Ant.
-> More information: <https://www.phing.info>.
+> More information: <https://www.phing.info/guide/chunkhtml/ch03s03.html>.
 
 - Perform the default task in the `build.xml` file:
 
@@ -9,7 +9,7 @@
 
 - Initialize a new build file:
 
-`phing -i {{path/to/build.xml}}`
+`phing {{[-i|--init]}} {{path/to/build.xml}}`
 
 - Perform a specific task:
 
@@ -17,7 +17,7 @@
 
 - Use the given build file path:
 
-`phing -f {{path/to/build.xml}} {{task_name}}`
+`phing {{[-f|-buildfile]}} {{path/to/build.xml}} {{task_name}}`
 
 - Log to the given file:
 

pages/common/phpspec.md

@@ -17,11 +17,11 @@
 
 - Run specifications using a specific configuration file:
 
-`phpspec run -c {{path/to/configuration_file}}`
+`phpspec run {{[-c|--config]}} {{path/to/configuration_file}}`
 
 - Run specifications using a specific bootstrap file:
 
-`phpspec run -b {{path/to/bootstrap_file}}`
+`phpspec run {{[-b|--bootstrap]}} {{path/to/bootstrap_file}}`
 
 - Disable code generation prompts:
 

pages/common/pigz.md

@@ -9,11 +9,11 @@
 
 - Compress a file using the best compression method:
 
-`pigz -9 {{path/to/file}}`
+`pigz {{[-9|--best]}} {{path/to/file}}`
 
 - Compress a file using no compression and 4 processors:
 
-`pigz -0 -p{{4}} {{path/to/file}}`
+`pigz -0 {{[-p|--processes]}} {{4}} {{path/to/file}}`
 
 - Compress a directory using tar:
 
@@ -21,8 +21,8 @@
 
 - Decompress a file:
 
-`pigz -d {{archive.gz}}`
+`pigz {{[-d|--decompress]}} {{archive.gz}}`
 
 - List the contents of an archive:
 
-`pigz -l {{archive.tar.gz}}`
+`pigz {{[-l|--list]}} {{archive.tar.gz}}`

pages/common/pip-freeze.md

@@ -13,7 +13,7 @@
 
 - List installed packages in a virtual environment, excluding globally installed packages:
 
-`pip freeze --local > requirements.txt`
+`pip freeze {{[-l|--local]}} > requirements.txt`
 
 - List installed packages in the user-site:
 

pages/common/pip-install.md

@@ -13,12 +13,12 @@
 
 - Install packages listed in a file:
 
-`pip install -r {{path/to/requirements.txt}}`
+`pip install {{[-r|--requirement]}} {{path/to/requirements.txt}}`
 
 - Install packages from an URL or local file archive (.tar.gz | .whl):
 
-`pip install --find-links {{url|path/to/file}}`
+`pip install {{[-f|--find-links]}} {{url|path/to/file}}`
 
 - Install the local package in the current directory in develop (editable) mode:
 
-`pip install --editable {{.}}`
+`pip install {{[-e|--editable]}} {{.}}`

pages/common/pip-uninstall.md

@@ -9,8 +9,8 @@
 
 - Uninstall packages listed in a specific file:
 
-`pip uninstall --requirement {{path/to/requirements.txt}}`
+`pip uninstall {{[-r|--requirement]}} {{path/to/requirements.txt}}`
 
 - Uninstall package without asking for confirmation:
 
-`pip uninstall --yes {{package}}`
+`pip uninstall {{[-y|--yes]}} {{package}}`

pages/common/pip.md

@@ -14,7 +14,7 @@
 
 - Upgrade a package:
 
-`pip install --upgrade {{package}}`
+`pip install {{[-U|--upgrade]}} {{package}}`
 
 - Uninstall a package:
 
@@ -30,4 +30,4 @@
 
 - Install packages from a file:
 
-`pip install --requirement {{requirements.txt}}`
+`pip install {{[-r|--requirement]}} {{requirements.txt}}`

pages/common/pip3.md

@@ -13,7 +13,7 @@
 
 - Upgrade a package:
 
-`pip3 install --upgrade {{package}}`
+`pip3 install {{[-U|--upgrade]}} {{package}}`
 
 - Uninstall a package:
 
@@ -25,7 +25,7 @@
 
 - Install packages from a file:
 
-`pip3 install --requirement {{requirements.txt}}`
+`pip3 install {{[-r|--requirement]}} {{requirements.txt}}`
 
 - Show installed package info:
 

pages/common/podman-compose.md

@@ -9,7 +9,7 @@
 
 - Create and start all containers in the background using a local `docker-compose.yml`:
 
-`podman-compose up -d`
+`podman-compose up {{[-d|--detach]}}`
 
 - Start all containers, building if needed:
 
@@ -25,11 +25,11 @@
 
 - Remove all containers, networks, and volumes:
 
-`podman-compose down --volumes`
+`podman-compose down {{[-v|--volumes]}}`
 
 - Follow logs for a container (omit all container names):
 
-`podman-compose logs --follow {{container_name}}`
+`podman-compose logs {{[-f|--follow]}} {{container_name}}`
 
 - Run a one-time command in a service with no ports mapped:
 

pages/common/popeye.md

@@ -9,12 +9,12 @@
 
 - Scan a specific namespace:
 
-`popeye -n {{namespace}}`
+`popeye {{[-n|--namespace]}} {{namespace}}`
 
 - Scan specific Kubernetes context:
 
-`popeye --context={{context}}`
+`popeye --context {{context}}`
 
 - Use a spinach configuration file for scanning:
 
-`popeye -f {{spinach.yaml}}`
+`popeye {{[-f|--file]}} {{spinach.yaml}}`

pages/common/powershell.md

@@ -10,4 +10,4 @@
 
 - View the documentation for the command referring to the legacy Windows PowerShell (version 5.1 and below):
 
-`tldr powershell -p windows`
+`tldr powershell {{[-p|--platform]}} windows`

pages/common/progress.md

@@ -9,12 +9,12 @@
 
 - Show the progress of running coreutils in quiet mode:
 
-`progress -q`
+`progress {{[-q|--quiet]}}`
 
 - Launch and monitor a single long-running command:
 
-`{{command}} & progress --monitor --pid $!`
+`{{command}} & progress {{[-m|--monitor]}} {{[-p|--pid]}} $!`
 
 - Include an estimate of time remaining for completion:
 
-`progress --wait --command {{firefox}}`
+`progress {{[-w|--wait]}} {{[-c|--command]}} {{firefox}}`

pages/common/proxify.md

@@ -10,11 +10,11 @@
 
 - Start a HTTP proxy on a custom network interface and port (may require `sudo` for a port number lower than `1024`):
 
-`proxify -http-addr "{{ip_address}}:{{port_number}}"`
+`proxify {{[-ha|-http-addr]}} "{{ip_address}}:{{port_number}}"`
 
 - Specify output format and output file:
 
-`proxify -output-format {{jsonl|yaml}} -output {{path/to/file}}`
+`proxify {{[-of|-output-format]}} {{jsonl|yaml}} {{[-o|-output]}} {{path/to/file}}`
 
 - Display help:
 

pages/common/psql.md

@@ -9,16 +9,16 @@
 
 - Connect to the database on given server host running on given port with given username, without a password prompt:
 
-`psql -h {{host}} -p {{port}} -U {{username}} {{database}}`
+`psql {{[-h|--host]}} {{host}} {{[-p|--port]}} {{port}} {{[-U|--username]}} {{username}} {{database}}`
 
 - Connect to the database; user will be prompted for password:
 
-`psql -h {{host}} -p {{port}} -U {{username}} -W {{database}}`
+`psql {{[-h|--host]}} {{host}} {{[-p|--port]}} {{port}} {{[-U|--username]}} {{username}} {{[-W|--password]}} {{database}}`
 
 - Execute a single SQL query or PostgreSQL command on the given database (useful in shell scripts):
 
-`psql -c '{{query}}' {{database}}`
+`psql {{[-c|--command]}} '{{query}}' {{database}}`
 
 - Execute commands from a file on the given database:
 
-`psql {{database}} -f {{file.sql}}`
+`psql {{database}} {{[-f|--file]}} {{file.sql}}`

pages/common/pssh.md

@@ -5,24 +5,24 @@
 
 - Run a command on two hosts, and print its output on each server inline:
 
-`pssh -i -H "{{host1}} {{host2}}" {{hostname -i}}`
+`pssh {{[-i|--inline]}} {{[-H|--host]}} "{{host1}} {{host2}}" {{hostname --ip-addresses}}`
 
 - Run a command and save the output to separate files:
 
-`pssh -H {{host1}} -H {{host2}} -o {{path/to/output_dir}} {{hostname -i}}`
+`pssh {{[-H|--host]}} {{host1}} {{[-H|--host]}} {{host2}} {{[-o|--outdir]}} {{path/to/output_dir}} {{hostname --ip-addresses}}`
 
 - Run a command on multiple hosts, specified in a new-line separated file:
 
-`pssh -i -h {{path/to/hosts_file}} {{hostname -i}}`
+`pssh {{[-i|--inline]}} {{[-h|--hosts]}} {{path/to/hosts_file}} {{hostname --ip-addresses}}`
 
 - Run a command as root (this asks for the root password):
 
-`pssh -i -h {{path/to/hosts_file}} -A -l {{root_username}} {{hostname -i}}`
+`pssh {{[-i|--inline]}} {{[-h|--hosts]}} {{path/to/hosts_file}} {{[-A|--askpass]}} {{[-l|--user]}} {{root_username}} {{hostname --ip-addresses}}`
 
 - Run a command with extra SSH arguments:
 
-`pssh -i -h {{path/to/hosts_file}} -x "{{-O VisualHostKey=yes}}" {{hostname -i}}`
+`pssh {{[-i|--inline]}} {{[-h|--hosts]}} {{path/to/hosts_file}} {{[-x|--extra-arg]}} "{{-O VisualHostKey=yes}}" {{hostname --ip-addresses}}`
 
 - Run a command limiting the number of parallel connections to 10:
 
-`pssh -i -h {{path/to/hosts_file}} -p {{10}} '{{cd dir; ./script.sh; exit}}'`
+`pssh {{[-i|--inline]}} {{[-h|--hosts]}} {{path/to/hosts_file}} {{[-p|-par]}} {{10}} '{{cd dir; ./script.sh; exit}}'`

pages/common/pt.md

@@ -10,15 +10,15 @@
 
 - Find files containing "foo" and display count of matches in each file:
 
-`pt -c {{foo}}`
+`pt {{[-c|--count]}} {{foo}}`
 
 - Find files containing "foo" as a whole word and ignore its case:
 
-`pt -wi {{foo}}`
+`pt {{[-wi|--word-regexp --ignore-case]}} {{foo}}`
 
 - Find "foo" in files with a given extension using a regular expression:
 
-`pt -G='{{\.bar$}}' {{foo}}`
+`pt {{[-G|--file-search-regexp]}}='{{\.bar$}}' {{foo}}`
 
 - Find files whose contents match the regular expression, up to 2 directories deep:
 

pages/common/ptpython.md

@@ -13,7 +13,7 @@
 
 - Execute a specific Python file and start a REPL:
 
-`ptpython -i {{path/to/file.py}}`
+`ptpython {{[-i|--interactive]}} {{path/to/file.py}}`
 
 - Open the menu:
 

pages/common/pueue-add.md

@@ -13,16 +13,16 @@
 
 - Add a command but do not start it if it's the first in a queue:
 
-`pueue add --stashed -- {{rsync --archive --compress /local/directory /remote/directory}}`
+`pueue add {{[-s|--stashed]}} -- {{rsync {{[-a|--archive]}} {{[-z|--compress]}} /local/directory /remote/directory}}`
 
 - Add a command to a group and start it immediately, see `pueue group` to manage groups:
 
-`pueue add --immediate --group "{{CPU_intensive}}" -- {{ffmpeg -i input.mp4 frame_%d.png}}`
+`pueue add {{[-i|--immediate]}} {{[-g|--group]}} "{{CPU_intensive}}" -- {{ffmpeg -i input.mp4 frame_%d.png}}`
 
 - Add a command and start it after commands 9 and 12 finish successfully:
 
-`pueue add --after {{9}} {{12}} --group "{{torrents}}" -- {{transmission-cli torrent_file.torrent}}`
+`pueue add {{[-a|--after]}} {{9}} {{12}} {{[-g|--group]}} "{{torrents}}" -- {{transmission-cli torrent_file.torrent}}`
 
 - Add a command with a label after some delay has passed, see `pueue enqueue` for valid datetime formats:
 
-`pueue add --label "{{compressing large file}}" --delay "{{wednesday 10:30pm}}" -- "{{7z a compressed_file.7z large_file.xml}}"`
+`pueue add {{[-l|--label]}} "{{compressing large file}}" {{[-d|--delay]}} "{{wednesday 10:30pm}}" -- "{{7z a compressed_file.7z large_file.xml}}"`

pages/common/pueue-clean.md

@@ -9,4 +9,4 @@
 
 - Only clean commands that finished successfully:
 
-`pueue clean --successful-only`
+`pueue clean {{[-s|--successful-only]}}`

pages/common/pueue-enqueue.md

@@ -10,20 +10,20 @@
 
 - Enqueue a stashed task after 60 seconds:
 
-`pueue enqueue --delay {{60}} {{task_id}}`
+`pueue enqueue {{[-d|--delay]}} {{60}} {{task_id}}`
 
 - Enqueue a stashed task next Wednesday:
 
-`pueue enqueue --delay {{wednesday}} {{task_id}}`
+`pueue enqueue {{[-d|--delay]}} {{wednesday}} {{task_id}}`
 
 - Enqueue a stashed task after four months:
 
-`pueue enqueue --delay "4 months" {{task_id}}`
+`pueue enqueue {{[-d|--delay]}} "4 months" {{task_id}}`
 
 - Enqueue a stashed task on 2021-02-19:
 
-`pueue enqueue --delay {{2021-02-19}} {{task_id}}`
+`pueue enqueue {{[-d|--delay]}} {{2021-02-19}} {{task_id}}`
 
 - List all available date/time formats:
 
-`pueue enqueue --help`
+`pueue enqueue {{[-h|--help]}}`

pages/common/pueue-group.md

@@ -9,8 +9,8 @@
 
 - Add a custom group:
 
-`pueue group --add "{{group_name}}"`
+`pueue group add "{{group_name}}"`
 
 - Remove a group and move its tasks to the default group:
 
-`pueue group --remove "{{group_name}}"`
+`pueue group remove "{{group_name}}"`

pages/common/pueue-kill.md

@@ -17,8 +17,8 @@
 
 - Kill all tasks in a group and pause the group:
 
-`pueue kill --group {{group_name}}`
+`pueue kill {{[-g|--group]}} {{group_name}}`
 
 - Kill all tasks across all groups and pause all groups:
 
-`pueue kill --all`
+`pueue kill {{[-a|--all]}}`

pages/common/pueue-log.md

@@ -18,4 +18,4 @@
 
 - Print a specific number of lines from the tail of output:
 
-`pueue log --lines {{number_of_lines}} {{task_id}}`
+`pueue log {{[-l|--lines]}} {{number_of_lines}} {{task_id}}`

pages/common/pueue-parallel.md

@@ -9,4 +9,4 @@
 
 - Set the maximum number of tasks allowed to run in parallel, in a specific group:
 
-`pueue parallel --group {{group_name}} {{maximum_number_of_parallel_tasks}}`
+`pueue parallel {{[-g|--group]}} {{group_name}} {{maximum_number_of_parallel_tasks}}`

pages/common/pueue-pause.md

@@ -18,8 +18,8 @@
 
 - Pause all tasks in a group and prevent it from starting new tasks:
 
-`pueue pause --group {{group_name}}`
+`pueue pause {{[-g|--group]}} {{group_name}}`
 
 - Pause all tasks and prevent all groups from starting new tasks:
 
-`pueue pause --all`
+`pueue pause {{[-a|--all]}}`

pages/common/pueue-reset.md

@@ -13,4 +13,4 @@
 
 - Reset without asking for confirmation:
 
-`pueue reset --force`
+`pueue reset {{[-f|--force]}}`

pages/common/pueue-restart.md

@@ -9,7 +9,7 @@
 
 - Restart multiple tasks at once, and start them immediately (do not enqueue):
 
-`pueue restart --start-immediately {{task_id}} {{task_id}}`
+`pueue restart {{[-k|--immediately]}} {{task_id}} {{task_id}}`
 
 - Restart a specific task from a different path:
 
@@ -17,12 +17,12 @@
 
 - Edit a command before restarting:
 
-`pueue restart --edit {{task_id}}`
+`pueue restart {{[-e|--edit]}} {{task_id}}`
 
 - Restart a task in-place (without enqueuing as a separate task):
 
-`pueue restart --in-place {{task_id}}`
+`pueue restart {{[-i|--in-place]}} {{task_id}}`
 
 - Restart all failed tasks and stash them:
 
-`pueue restart --all-failed --stashed`
+`pueue restart {{[-a|--all-failed]}} --stashed`

pages/common/pueue-start.md

@@ -18,7 +18,7 @@
 
 - Resume all tasks and start their children:
 
-`pueue start --all --children`
+`pueue start {{[-a|--all]}} --children`
 
 - Resume all tasks in a specific group:
 

pages/common/pueue-status.md

@@ -9,4 +9,4 @@
 
 - Show the status of a specific group:
 
-`pueue status --group {{group_name}}`
+`pueue status {{[-g|--group]}} {{group_name}}`

pages/common/pueue.md

@@ -6,7 +6,7 @@
 
 - Show general help and available subcommands:
 
-`pueue --help`
+`pueue {{[-h|--help]}}`
 
 - Execute a pueue subcommand:
 
@@ -14,4 +14,4 @@
 
 - Check the version of pueue:
 
-`pueue --version`
+`pueue {{[-V|--version]}}`

pages/common/pushd.md

@@ -2,7 +2,7 @@
 
 > Place a directory on a stack so it can be accessed later.
 > See also `popd` to switch back to original directory and `dirs` to display directory stack contents.
-> More information: <https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html>.
+> More information: <https://www.gnu.org/software/bash/manual/html_node/Directory-Stack-Builtins.html#index-popd>.
 
 - Switch to directory and push it on the stack:
 

pages/common/pv.md

@@ -9,20 +9,20 @@
 
 - Measure the speed and amount of data flow between pipes (`--size` is optional):
 
-`command1 | pv --size {{expected_amount_of_data_for_eta}} | command2`
+`command1 | pv {{[-s|--size]}} {{expected_amount_of_data_for_eta}} | command2`
 
 - Filter a file, see both progress and amount of output data:
 
-`pv -cN in {{big_text_file}} | grep {{pattern}} | pv -cN out > {{filtered_file}}`
+`pv {{[-cN|--cursor --name]}} in {{big_text_file}} | grep {{pattern}} | pv {{[-cN|--cursor --name]}} out > {{filtered_file}}`
 
 - Attach to an already running process and see its file reading progress:
 
-`pv -d {{PID}}`
+`pv {{[-d|--watchfd]}} {{PID}}`
 
 - Read an erroneous file, skip errors as `dd conv=sync,noerror` would:
 
-`pv -EE {{path/to/faulty_media}} > image.img`
+`pv {{[-EE|--skip-errors --skip-errors]}} {{path/to/faulty_media}} > image.img`
 
 - Stop reading after reading specified amount of data, rate limit to 1K/s:
 
-`pv -L 1K --stop-at --size {{maximum_file_size_to_be_read}}`
+`pv {{[-L|--rate-limit]}} 1K {{[-S|--stop-at-size]}} {{maximum_file_size_to_be_read}}`

pages/common/py-spy.md

@@ -5,7 +5,7 @@
 
 - Show a live view of the functions that take the most execution time of a running process:
 
-`py-spy top --pid {{pid}}`
+`py-spy top {{[-p|--pid]}} {{pid}}`
 
 - Start a program and show a live view of the functions that take the most execution time:
 
@@ -13,8 +13,8 @@
 
 - Produce an SVG flame graph of the function call execution time:
 
-`py-spy record -o {{path/to/profile.svg}} --pid {{pid}}`
+`py-spy record {{[-o|--output]}} {{path/to/profile.svg}} {{[-p|--pid]}} {{pid}}`
 
 - Dump the call stack of a running process:
 
-`py-spy dump --pid {{pid}}`
+`py-spy dump {{[-p|--pid]}} {{pid}}`

pages/common/q.md

@@ -5,15 +5,15 @@
 
 - Query a CSV file by specifying the delimiter as ',':
 
-`q -d',' "SELECT * from {{path/to/file}}"`
+`q {{[-d|--delimiter]}} ',' "SELECT * from {{path/to/file}}"`
 
 - Query a TSV file:
 
-`q -t "SELECT * from {{path/to/file}}"`
+`q {{[-t|--tab-delimited]}} "SELECT * from {{path/to/file}}"`
 
 - Query file with header row:
 
-`q -d{{delimiter}} -H "SELECT * from {{path/to/file}}"`
+`q {{[-d|--delimiter]}} {{delimiter}} {{[-H|--skip-header]}} "SELECT * from {{path/to/file}}"`
 
 - Read data from `stdin`; '-' in the query represents the data from `stdin`:
 
@@ -25,4 +25,4 @@
 
 - Format output using an output delimiter with an output header line (Note: command will output column names based on the input file header or the column aliases overridden in the query):
 
-`q -D{{delimiter}} -O "SELECT {{column}} as {{alias}} from {{path/to/file}}"`
+`q {{[-D|--output-delimiter]}} {{delimiter}} {{[-O|--output-header]}} "SELECT {{column}} as {{alias}} from {{path/to/file}}"`

pages/common/qrencode.md

@@ -1,20 +1,20 @@
 # qrencode
 
 > QR Code generator. Supports PNG and EPS.
-> More information: <https://fukuchi.org/works/qrencode>.
+> More information: <https://manned.org/qrencode>.
 
 - Convert a string to a QR code and save to an output file:
 
-`qrencode -o {{path/to/output_file.png}} {{string}}`
+`qrencode {{[-o|--output]}} {{path/to/output_file.png}} {{string}}`
 
 - Convert an input file to a QR code and save to an output file:
 
-`qrencode -o {{path/to/output_file.png}} -r {{path/to/input_file}}`
+`qrencode {{[-o|--output]}} {{path/to/output_file.png}} {{[-r|--read-from]}} {{path/to/input_file}}`
 
 - Convert a string to a QR code and print it in terminal:
 
-`qrencode -t ansiutf8 {{string}}`
+`qrencode {{[-t|--type]}} ansiutf8 {{string}}`
 
 - Convert input from pipe to a QR code and print it in terminal:
 
-`echo {{string}} | qrencode -t ansiutf8`
+`echo {{string}} | qrencode {{[-t|--type]}} ansiutf8`

pages/common/quilt.md

@@ -1,7 +1,7 @@
 # quilt
 
 > Manage a series of patches.
-> More information: <https://savannah.nongnu.org/projects/quilt>.
+> More information: <https://manned.org/quilt>.
 
 - Import an existing patch from a file:
 

pages/common/quota.md

@@ -5,20 +5,20 @@
 
 - Show disk quotas in human-readable units for the current user:
 
-`quota -s`
+`quota {{[-s|--human-readable]}}`
 
 - Verbose output (also display quotas on filesystems where no storage is allocated):
 
-`quota -v`
+`quota {{[-v|--verbose]}}`
 
 - Quiet output (only display quotas on filesystems where usage is over quota):
 
-`quota -q`
+`quota {{[-q|--quiet]}}`
 
 - Print quotas for the groups of which the current user is a member:
 
-`quota -g`
+`quota {{[-g|--group]}}`
 
 - Show disk quotas for another user:
 
-`sudo quota -u {{username}}`
+`sudo quota {{[-u|--user]}} {{username}}`

pages/common/r.md

@@ -9,11 +9,11 @@
 
 - Start R in vanilla mode (i.e. a blank session that doesn't save the workspace at the end):
 
-`R --vanilla`
+`R {{[-v|--vanilla]}}`
 
 - Execute a file:
 
-`R -f {{path/to/file.R}}`
+`R {{[-f|--file]}} {{path/to/file.R}}`
 
 - Execute an R expression and then exit:
 
@@ -21,7 +21,7 @@
 
 - Run R with a debugger:
 
-`R -d {{debugger}}`
+`R {{[-d|--debugger]}} {{debugger}}`
 
 - Check R packages from package sources:
 

pages/common/rails-console.md

@@ -9,12 +9,12 @@
 
 - Start the Rails console and roll back all data modifications on exit:
 
-`rails console --sandbox`
+`rails console {{[-s|--sandbox]}}`
 
 - Start the Rails console on a specified environment:
 
-`rails console --environment {{dev|test|production|...}}`
+`rails console {{[-e|--environment]}} {{dev|test|production|...}}`
 
 - Display help:
 
-`rails console --help`
+`rails console {{[-h|--help]}}`

pages/common/rails-new.md

@@ -13,12 +13,12 @@
 
 - Create a Rails app with `postgresql` as the database:
 
-`rails new {{app_name}} --database postgresql`
+`rails new {{app_name}} {{[-d|--database]}} postgresql`
 
 - Create a Rails app without generating JavaScript files:
 
-`rails new {{app_name}} --skip-javascript`
+`rails new {{app_name}} {{[-J|--skip-javascript]}}`
 
 - Display help:
 
-`rails new --help`
+`rails new {{[-h|--help]}}`

pages/common/rails-routes.md

@@ -13,8 +13,8 @@
 
 - List routes partially matching URL helper method name, HTTP verb, or URL path:
 
-`rails routes -g {{posts_path|GET|/posts}}`
+`rails routes {{[-g|--grep]}} {{posts_path|GET|/posts}}`
 
 - List routes that map to a specified controller:
 
-`rails routes -c {{posts|Posts|Blogs::PostsController}}`
+`rails routes {{[-c|--controller]}} {{posts|Posts|Blogs::PostsController}}`