common/*: switch from using mnemonics to option placeholders (#16034)

Author: Managor

pages/common/abduco.md

@@ -1,7 +1,7 @@
 # abduco
 
 > Terminal session manager.
-> More information: <https://www.brain-dump.org/projects/abduco/>.
+> More information: <https://manned.org/abduco>.
 
 - List sessions:
 

pages/common/ac.md

@@ -1,7 +1,7 @@
 # ac
 
 > Print statistics on how long users have been connected.
-> More information: <https://man.openbsd.org/ac>.
+> More information: <https://manned.org/ac.8>.
 
 - Print how long the current user has been connected in hours:
 

pages/common/act.md

@@ -1,11 +1,11 @@
 # act
 
 > Execute GitHub Actions locally using Docker.
-> More information: <https://github.com/nektos/act>.
+> More information: <https://manned.org/act>.
 
-- [l]ist the available jobs:
+- List the available jobs:
 
-`act -l`
+`act {{[-l|--list]}}`
 
 - Run the default event:
 
@@ -15,18 +15,18 @@
 
 `act {{event_type}}`
 
-- Run a specific [j]ob:
+- Run a specific job:
 
-`act -j {{job_id}}`
+`act {{[-j|--job]}} {{job_id}}`
 
 - Do [n]ot actually run the actions (i.e. a dry run):
 
-`act -n`
+`act {{[-n|--dryrun]}}`
 
-- Show [v]erbose logs:
+- Show verbose logs:
 
-`act -v`
+`act {{[-v|--verbose]}}`
 
-- Run a specific [W]orkflow with the push event:
+- Run a specific workflow with the push event:
 
-`act push -W {{path/to/workflow}}`
+`act push {{[-W|--workflows]}} {{path/to/workflow}}`

pages/common/ag.md

@@ -1,7 +1,7 @@
 # ag
 
 > The Silver Searcher. Like `ack`, but aims to be faster.
-> More information: <https://github.com/ggreer/the_silver_searcher>.
+> More information: <https://manned.org/ag>.
 
 - Find files containing "foo", and print the line matches in context:
 
@@ -11,22 +11,22 @@
 
 `ag {{foo}} {{path/to/directory}}`
 
-- Find files containing "foo", but only [l]ist the filenames:
+- Find files containing "foo", but only list the filenames:
 
-`ag -l {{foo}}`
+`ag {{[-l|--files-with-matches]}} {{foo}}`
 
-- Find files containing "FOO" case-[i]nsensitively, and print [o]nly the match, rather than the whole line:
+- Find files containing "FOO" case-insensitively, and print only the match, rather than the whole line:
 
-`ag -i -o {{FOO}}`
+`ag {{[-i|--ignore-case]}} {{[-o|--only-matching]}} {{FOO}}`
 
 - Find "foo" in files with a name matching "bar":
 
-`ag {{foo}} -G {{bar}}`
+`ag {{foo}} {{[-G|--file-search-regex]}} {{bar}}`
 
 - Find files whose contents match a regular expression:
 
 `ag '{{^ba(r|z)$}}'`
 
 - Find files with a name matching "foo":
 
-`ag -g {{foo}}`
+`ag {{[-g|--filename-pattern]}} {{foo}}`

pages/common/age-keygen.md

@@ -6,7 +6,7 @@
 
 - Generate a key pair, save it to an unencrypted file, and print the public key to `stdout`:
 
-`age-keygen --output {{path/to/file}}`
+`age-keygen {{[-o|--output]}} {{path/to/file}}`
 
 - Convert an identit[y] to a recipient and print the public key to `stdout`:
 

pages/common/alacritty.md

@@ -1,7 +1,7 @@
 # alacritty
 
 > Cross-platform, GPU-accelerated terminal emulator.
-> More information: <https://github.com/alacritty/alacritty>.
+> More information: <https://manned.org/alacritty>.
 
 - Start a new Alacritty process and create a window:
 
@@ -21,7 +21,7 @@
 
 - [e]xecute a command in a new Alacritty window (also works with `alacritty msg create-window`):
 
-`alacritty -e {{command}}`
+`alacritty {{[-e|--command]}} {{command}}`
 
 - Use an alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.toml`):
 

pages/common/ani-cli.md

@@ -1,36 +1,36 @@
 # ani-cli
 
 > A cli to browse and watch anime.
-> More information: <https://github.com/pystardust/ani-cli>.
+> More information: <https://manned.org/ani-cli>.
 
 - Search anime by name:
 
 `ani-cli "{{anime_name}}"`
 
-- [d]ownload episode:
+- Download episode:
 
-`ani-cli -d "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} "{{anime_name}}"`
 
-- [d]ownload a [r]ange of episodes:
+- Download a range of episodes:
 
-`ani-cli -d -r "{{1 6}}" "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} {{[-r|--range]}} "{{1 6}}" "{{anime_name}}"`
 
-- [d]ownload the entire series (a range of all episodes):
+- Download the entire series (a range of all episodes):
 
-`ani-cli -d -r "1 -1" "{{anime_name}}"`
+`ani-cli {{[-d|--download]}} {{[-r|--range]}} "1 -1" "{{anime_name}}"`
 
-- Use [v]LC as the media player:
+- Use VLC as the media player:
 
-`ani-cli -v "{{anime_name}}"`
+`ani-cli {{[-v|-vlc]}} "{{anime_name}}"`
 
-- Watch a specific [e]pisode:
+- Watch a specific episode:
 
-`ani-cli -e {{episode_number}} "{{anime_name}}"`
+`ani-cli {{[-e|--episode]}} {{episode_number}} "{{anime_name}}"`
 
-- [c]ontinue watching anime from history:
+- Continue watching anime from history:
 
-`ani-cli -c`
+`ani-cli {{[-c|--continue]}}`
 
-- [U]pdate `ani-cli`:
+- Update `ani-cli`:
 
-`ani-cli -U`
+`ani-cli {{[-U|--update]}}`

pages/common/ansible-playbook.md

@@ -7,26 +7,26 @@
 
 `ansible-playbook {{playbook}}`
 
-- Run tasks in playbook with custom host [i]nventory:
+- Run tasks in playbook with custom host inventory:
 
-`ansible-playbook {{playbook}} -i {{inventory_file}}`
+`ansible-playbook {{playbook}} {{[-i|--inventory]}} {{inventory_file}}`
 
-- Run tasks in playbook with [e]xtra variables defined via the command-line:
+- Run tasks in playbook with extra variables defined via the command-line:
 
-`ansible-playbook {{playbook}} -e "{{variable1}}={{value1}} {{variable2}}={{value2}}"`
+`ansible-playbook {{playbook}} {{[-e|--extra-vars]}} "{{variable1}}={{value1}} {{variable2}}={{value2}}"`
 
-- Run tasks in playbook with [e]xtra variables defined in a JSON file:
+- Run tasks in playbook with extra variables defined in a JSON file:
 
-`ansible-playbook {{playbook}} -e "@{{variables.json}}"`
+`ansible-playbook {{playbook}} {{[-e|--extra-vars]}} "@{{variables.json}}"`
 
 - Run tasks in playbook for the given tags:
 
-`ansible-playbook {{playbook}} --tags {{tag1,tag2}}`
+`ansible-playbook {{playbook}} {{[-t|--tags]}} {{tag1,tag2}}`
 
 - Run tasks in a playbook starting at a specific task:
 
 `ansible-playbook {{playbook}} --start-at {{task_name}}`
 
 - Run tasks in a playbook without making any changes (dry-run):
 
-`ansible-playbook {{playbook}} --check --diff`
+`ansible-playbook {{playbook}} {{[-C|--check]}} {{[-D|--diff]}}`

pages/common/ansible.md

@@ -2,32 +2,32 @@
 
 > Manage groups of computers remotely over SSH. (use the `/etc/ansible/hosts` file to add new groups/hosts).
 > Some subcommands such as `galaxy` have their own usage documentation.
-> More information: <https://www.ansible.com/>.
+> More information: <https://docs.ansible.com/ansible/latest/cli/ansible.html>.
 
 - List hosts belonging to a group:
 
 `ansible {{group}} --list-hosts`
 
-- Ping a group of hosts by invoking the ping [m]odule:
+- Ping a group of hosts by invoking the ping module:
 
-`ansible {{group}} -m ping`
+`ansible {{group}} {{[-m|--module-name]}} ping`
 
 - Display facts about a group of hosts by invoking the setup [m]odule:
 
-`ansible {{group}} -m setup`
+`ansible {{group}} {{[-m|--module-name]}} setup`
 
 - Execute a command on a group of hosts by invoking command module with arguments:
 
-`ansible {{group}} -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - Execute a command with administrative privileges:
 
-`ansible {{group}} --become --ask-become-pass -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-b|--become]}} --ask-become-pass {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - Execute a command using a custom inventory file:
 
-`ansible {{group}} -i {{inventory_file}} -m command -a '{{my_command}}'`
+`ansible {{group}} {{[-i|--inventory]}} {{inventory_file}} {{[-m|--module-name]}} command {{[-a|--args]}} '{{my_command}}'`
 
 - List the groups in an inventory:
 
-`ansible localhost -m debug -a '{{var=groups.keys()}}'`
+`ansible localhost {{[-m|--module-name]}} debug {{[-a|--args]}} '{{var=groups.keys()}}'`

pages/common/ant.md

@@ -1,24 +1,24 @@
 # ant
 
 > Apache Ant: build and manage Java-based projects.
-> More information: <https://ant.apache.org>.
+> More information: <https://ant.apache.org/manual/index.html>.
 
 - Build a project with default build file `build.xml`:
 
 `ant`
 
-- Build a project using build [f]ile other than `build.xml`:
+- Build a project using build file other than `build.xml`:
 
-`ant -f {{buildfile.xml}}`
+`ant {{[-f|-buildfile]}} {{buildfile.xml}}`
 
 - Print information on possible targets for this project:
 
-`ant -p`
+`ant {{[-p|-projecthelp]}}`
 
 - Print debugging information:
 
-`ant -d`
+`ant {{[-d|-debug]}}`
 
 - Execute all targets that do not depend on fail target(s):
 
-`ant -k`
+`ant {{[-k|-keep-going]}}`

pages/common/apkleaks.md

@@ -4,14 +4,14 @@
 > Note: APKLeaks utilizes the `jadx` disassembler to decompile APK files.
 > More information: <https://github.com/dwisiswant0/apkleaks>.
 
-- Scan an APK [f]ile for URIs, endpoints, and secrets:
+- Scan an APK file for URIs, endpoints, and secrets:
 
-`apkleaks --file {{path/to/file.apk}}`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}}`
 
-- Scan and save the [o]utput to a specific file:
+- Scan and save the output to a specific file:
 
-`apkleaks --file {{path/to/file.apk}} --output {{path/to/output.txt}}`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}} {{[-o|--output]}} {{path/to/output.txt}}`
 
-- Pass `jadx` disassembler [a]rguments:
+- Pass `jadx` disassembler arguments:
 
-`apkleaks --file {{path/to/file.apk}} --args "{{--threads-count 5 --deobf}}"`
+`apkleaks {{[-f|--file]}} {{path/to/file.apk}} {{[-a|--args]}} "{{--threads-count 5 --deobf}}"`

pages/common/apropos.md

@@ -9,8 +9,8 @@
 
 - Search without restricting the output to the terminal width ([l]ong output):
 
-`apropos -l {{regular_expression}}`
+`apropos {{[-l|--long]}} {{regular_expression}}`
 
-- Search for pages that match [a]ll the expressions given:
+- Search for pages that match all the expressions given:
 
-`apropos {{regular_expression_1}} -a {{regular_expression_2}} -a {{regular_expression_3}}`
+`apropos {{regular_expression_1}} {{[-a|--and]}} {{regular_expression_2}} {{[-a|--and]}} {{regular_expression_3}}`

pages/common/arp.md

@@ -1,7 +1,7 @@
 # arp
 
 > Show and manipulate your system's ARP cache.
-> More information: <https://manned.org/arp>.
+> More information: <https://manned.org/arp.8>.
 
 - Show the current ARP table:
 

pages/common/arping.md

@@ -2,7 +2,7 @@
 
 > Discover and probe hosts in a network using the ARP protocol.
 > Useful for MAC address discovery.
-> More information: <https://github.com/ThomasHabets/arping>.
+> More information: <https://manned.org/arping>.
 
 - Ping a host by ARP request packets:
 

pages/common/atoum.md

@@ -1,7 +1,7 @@
 # atoum
 
 > A simple, modern and intuitive unit testing framework for PHP.
-> More information: <https://atoum.org>.
+> More information: <https://atoum.readthedocs.io/en/latest/option_cli.html>.
 
 - Initialize a configuration file:
 
@@ -11,26 +11,26 @@
 
 `atoum`
 
-- Run tests using the specified [c]onfiguration file:
+- Run tests using the specified configuration file:
 
-`atoum -c {{path/to/file}}`
+`atoum {{[-c|--configuration]}} {{path/to/file}}`
 
-- Run a specific test [f]ile:
+- Run a specific test file:
 
-`atoum -f {{path/to/file}}`
+`atoum {{[-f|--files]}} {{path/to/file}}`
 
-- Run a specific [d]irectory of tests:
+- Run a specific directory of tests:
 
-`atoum -d {{path/to/directory}}`
+`atoum {{[-d|--directories]}} {{path/to/directory}}`
 
-- Run all tests under a specific name[s]pace:
+- Run all tests under a specific namespace:
 
-`atoum -ns {{namespace}}`
+`atoum {{[-ns|--namespaces]}} {{namespace}}`
 
-- Run all tests with a specific [t]ag:
+- Run all tests with a specific tag:
 
-`atoum -t {{tag}}`
+`atoum {{[-t|--tags]}} {{tag}}`
 
 - Load a custom bootstrap file before running tests:
 
-`atoum --bootstrap-file {{path/to/file}}`
+`atoum {{[-bf|--bootstrap-file]}} {{path/to/file}}`

pages/common/autossh.md

@@ -2,7 +2,7 @@
 
 > Run, monitor and restart SSH connections.
 > Auto-reconnects to keep port forwarding tunnels up. Accepts all SSH flags.
-> More information: <https://www.harding.motd.ca/autossh>.
+> More information: <https://manned.org/autossh>.
 
 - Start an SSH session, restarting when the [M]onitoring port fails to return data:
 

pages/common/avrdude.md

@@ -1,7 +1,7 @@
 # avrdude
 
 > Driver program for Atmel AVR microcontrollers programming.
-> More information: <https://www.nongnu.org/avrdude/>.
+> More information: <https://www.nongnu.org/avrdude/user-manual/avrdude_3.html#Option-Descriptions>.
 
 - [r]ead the flash ROM of a AVR microcontroller with a specific [p]art ID: