pages*: improve list placeholders and wording of descriptions (#12111)

* pages*: improve wording and list placeholders

* clamav: fix verb tenses

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

* buzzphrase: use k instead of n for number of phrases

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

* adguardhome: use non-default instead of different

* adguardhome: use configuration instead of config

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* goimports, module: fix list placeholders

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* pages*: leave stems and extensions in the same placeholders

* pages*: fix list placeholders

* pages*: fix list placeholders

* pages*: apply suggestions from code review

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

* qpdf: enclose n with backticks

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

---------

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>

pages/android/settings.md

@@ -3,7 +3,7 @@
 > Get information about the Android OS.
 > More information: <https://adbinstaller.com/commands/adb-shell-settings-5b670d5ee7958178a2955536>.
 
-- Display a list of settings in the `global` namespace:
+- List the settings in the `global` namespace:
 
 `settings list {{global}}`
 

pages/common/2to3.md

@@ -19,7 +19,7 @@
 
 `2to3 --write {{path/to/file.py}} --nofix={{has_key}} --nofix={{isinstance}}`
 
-- Display a list of all available language features that can be converted from Python 2 to Python 3:
+- List all available language features that can be converted from Python 2 to Python 3:
 
 `2to3 --list-fixes`
 

pages/common/adb.md

@@ -28,6 +28,6 @@
 
 `adb push {{path/to/local_file_or_directory}} {{path/to/device_destination_directory}}`
 
-- Get a list of connected devices:
+- List all connected devices:
 
 `adb devices`

pages/common/adguardhome.md

@@ -7,7 +7,7 @@
 
 `AdGuardHome`
 
-- Run AdGuard Home with a specific config:
+- Specify a configuration file:
 
 `AdGuardHome --config {{path/to/AdGuardHome.yaml}}`
 

pages/common/asciinema.md

@@ -13,11 +13,11 @@
 
 - Make a new recording and save it to a local file:
 
-`asciinema rec {{path/to/file}}.cast`
+`asciinema rec {{path/to/file.cast}}`
 
 - Replay a terminal recording from a local file:
 
-`asciinema play {{path/to/file}}.cast`
+`asciinema play {{path/to/file.cast}}`
 
 - Replay a terminal recording hosted on asciinema.org:
 
@@ -29,8 +29,8 @@
 
 - Print the full output of a locally saved recording:
 
-`asciinema cat {{path/to/file}}.cast`
+`asciinema cat {{path/to/file.cast}}`
 
 - Upload a locally saved terminal session to asciinema.org:
 
-`asciinema upload {{path/to/file}}.cast`
+`asciinema upload {{path/to/file.cast}}`

pages/common/aws-backup.md

@@ -15,7 +15,7 @@
 
 `aws backup delete-backup-plan --backup-plan-id {{id}}`
 
-- Return a list of all active backup plans for the current account:
+- List all active backup plans for the current account:
 
 `aws backup list-backup-plans`
 

pages/common/aws-cloud9.md

@@ -3,7 +3,7 @@
 > Manage Cloud9 - a collection of tools to code, build, run, test, debug, and release software in the cloud.
 > More information: <https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/index.html>.
 
-- Get a list of Cloud9 development environment identifiers:
+- List all Cloud9 development environment identifiers:
 
 `aws cloud9 list-environments`
 

pages/common/aws-lambda.md

@@ -5,11 +5,11 @@
 
 - Run a function:
 
-`aws lambda invoke --function-name {{name}} {{path/to/response}}.json`
+`aws lambda invoke --function-name {{name}} {{path/to/response.json}}`
 
 - Run a function with an input payload in JSON format:
 
-`aws lambda invoke --function-name {{name}} --payload {{json}} {{path/to/response}}.json`
+`aws lambda invoke --function-name {{name}} --payload {{json}} {{path/to/response.json}}`
 
 - List functions:
 

pages/common/aws-s3.md

@@ -10,7 +10,7 @@
 
 - Sync files and directories from local to bucket:
 
-`aws s3 sync {{path/to/files}} s3://{{bucket_name}}`
+`aws s3 sync {{path/to/file1 path/to/file2 ...}} s3://{{bucket_name}}`
 
 - Sync files and directories from bucket to local:
 
@@ -18,7 +18,7 @@
 
 - Sync files and directories with exclusions:
 
-`aws s3 sync {{path/to/files}} s3://{{bucket_name}} --exclude {{path/to/file}} --exclude {{path/to/directory}}/*`
+`aws s3 sync {{path/to/file1 path/to/file2 ...}} s3://{{bucket_name}} --exclude {{path/to/file}} --exclude {{path/to/directory}}/*`
 
 - Remove file from bucket:
 

pages/common/az-account.md

@@ -4,7 +4,7 @@
 > Part of `azure-cli` (also known as `az`).
 > More information: <https://learn.microsoft.com/cli/azure/account>.
 
-- Print a list of subscriptions for the logged in account:
+- List all subscriptions for the logged in account:
 
 `az account list`
 

pages/common/az-pipelines.md

@@ -28,6 +28,6 @@
 
 `az pipelines update --org {{organization_url}} --project {{project_name}} --name {{pipeline_name}} --new-name {{pipeline_new_name}} --new-folder-path {{user1/production_pipelines}}`
 
-- Get a list of agents in a pool:
+- List all agents in a pool:
 
 `az pipelines agent list --org {{organization_url}} --pool-id {{agent_pool}}`

pages/common/babel.md

@@ -21,7 +21,7 @@
 
 - Ignore specified comma-separated files in a directory:
 
-`babel {{path/to/input_directory}} --ignore {{ignored_files}}`
+`babel {{path/to/input_directory}} --ignore {{ignored_file1,ignored_file2,...}}`
 
 - Transpile and output as minified JavaScript:
 
@@ -29,7 +29,7 @@
 
 - Choose a set of presets for output formatting:
 
-`babel {{path/to/input_file}} --presets {{presets}}`
+`babel {{path/to/input_file}} --presets {{preset1,preset2,...}}`
 
 - Display help:
 

pages/common/bat.md

@@ -4,17 +4,17 @@
 > A `cat` clone with syntax highlighting and Git integration.
 > More information: <https://github.com/sharkdp/bat>.
 
-- Print the contents of a file to `stdout`:
+- Print the contents of one or more files to `stdout`:
 
-`bat {{path/to/file}}`
+`bat {{path/to/file1 path/to/file2 ...}}`
 
 - Concatenate several files into the target file:
 
-`bat {{file1}} {{file2}} > {{target_file}}`
+`bat {{path/to/file1 path/to/file2 ...}} > {{path/to/target_file}}`
 
 - Append several files into the target file:
 
-`bat {{file1}} {{file2}} >> {{target_file}}`
+`bat {{path/to/file1 path/to/file2 ...}} >> {{path/to/target_file}}`
 
 - Number all output lines:
 

pages/common/bcomps.md

@@ -14,7 +14,7 @@
 
 - Write each block and block-cutvertex tree to multiple numbered filenames based on `output.gv`:
 
-`bcomps -x -o {{path/to/output.gv}} {{path/to/input1.gv}} {{path/to/input2.gv ...}}`
+`bcomps -x -o {{path/to/output.gv}} {{path/to/input1.gv path/to/input2.gv ...}}`
 
 - Display help:
 

pages/common/behat.md

@@ -23,6 +23,6 @@
 
 `behat --out {{path/to/file}}`
 
-- Display a list of definitions in your test suites:
+- List the definitions in your test suites:
 
 `behat --definitions`

pages/common/bgpgrep.md

@@ -4,26 +4,26 @@
 > Can read files compressed with `gzip`, `bzip2` and `xz`.
 > More information: <https://codeberg.org/1414codeforge/ubgpsuite>.
 
-- Output all routes:
+- List all routes:
 
 `bgpgrep {{master6.mrt}}`
 
-- Output all routes received from a specific peer, determined by the peer's AS number:
+- List routes received from a specific peer, determined by the peer's AS number:
 
 `bgpgrep {{master4.mrt}} -peer {{64498}}`
 
-- Output all routes received from a specific peer, determined by the peer's IP address:
+- List routes received from a specific peer, determined by the peer's IP address:
 
 `bgpgrep {{master4.mrt.bz2}} -peer {{2001:db8:dead:cafe:acd::19e}}`
 
-- Output all routes which have certain ASNs in their AS path:
+- List routes which have certain ASNs in their AS path:
 
 `bgpgrep {{master6.mrt.bz2}} -aspath '{{64498 64510}}'`
 
-- Output all routes that lead to a specific address:
+- List routes that lead to a specific address:
 
 `bgpgrep {{master6.mrt.bz2}} -supernet '{{2001:db8:dead:cafe:aef::5}}'`
 
-- Output all routes that have communities from a specific AS:
+- List routes that have communities from a specific AS:
 
 `bgpgrep {{master4.mrt}} -communities \( '{{64497}}:*' \)`

pages/common/black.md

@@ -11,11 +11,11 @@
 
 `black -c "{{code}}"`
 
-- Output whether a file or a directory would have changes made to them if they were to be formatted:
+- Show whether a file or a directory would have changes made to them if they were to be formatted:
 
 `black --check {{path/to/file_or_directory}}`
 
-- Output changes that would be made to a file or a directory without performing them (dry-run):
+- Show changes that would be made to a file or a directory without performing them (dry-run):
 
 `black --diff {{path/to/file_or_directory}}`
 

pages/common/blender.md

@@ -6,27 +6,27 @@
 
 - Render all frames of an animation in the background, without loading the UI (output is saved to `/tmp`):
 
-`blender --background {{path/to/file}}.blend --render-anim`
+`blender --background {{path/to/file.blend}} --render-anim`
 
 - Render an animation using a specific image naming pattern, in a path relative (`//`) to the .blend file:
 
-`blender --background {{path/to/file}}.blend --render-output //{{render/frame_###.png}} --render-anim`
+`blender --background {{path/to/file.blend}} --render-output //{{render/frame_###.png}} --render-anim`
 
 - Render the 10th frame of an animation as a single image, saved to an existing directory (absolute path):
 
-`blender --background {{path/to/file}}.blend --render-output {{/path/to/output_directory}} --render-frame {{10}}`
+`blender --background {{path/to/file.blend}} --render-output {{/path/to/output_directory}} --render-frame {{10}}`
 
 - Render the second last frame in an animation as a JPEG image, saved to an existing directory (relative path):
 
-`blender --background {{path/to/file}}.blend --render-output //{{output_directory}} --render-frame {{JPEG}} --render-frame {{-2}}`
+`blender --background {{path/to/file.blend}} --render-output //{{output_directory}} --render-frame {{JPEG}} --render-frame {{-2}}`
 
 - Render the animation of a specific scene, starting at frame 10 and ending at frame 500:
 
-`blender --background {{path/to/file}}.blend --scene {{scene_name}} --frame-start {{10}} --frame-end {{500}} --render-anim`
+`blender --background {{path/to/file.blend}} --scene {{scene_name}} --frame-start {{10}} --frame-end {{500}} --render-anim`
 
 - Render an animation at a specific resolution, by passing a Python expression:
 
-`blender --background {{path/to/file}}.blend --python-expr '{{import bpy; bpy.data.scenes[0].render.resolution_percentage = 25}}' --render-anim`
+`blender --background {{path/to/file.blend}} --python-expr '{{import bpy; bpy.data.scenes[0].render.resolution_percentage = 25}}' --render-anim`
 
 - Start an interactive Blender session in the terminal with a Python console (do `import bpy` after starting):
 

pages/common/brew-bundle.md

@@ -23,6 +23,6 @@
 
 `brew bundle check`
 
-- Output a list of all entries in the Brewfile:
+- List all entries in the Brewfile:
 
 `brew bundle list --all`

pages/common/buzzphrase.md

@@ -7,10 +7,10 @@
 
 `buzzphrase`
 
-- Output a phrase formatted as [i]mperative verb + past tense [v]erb + [a]djective + plural [N]oun:
+- Print a phrase formatted as [i]mperative verb + past tense [v]erb + [a]djective + plural [N]oun:
 
 `buzzphrase {{'{i} {v} {a} {N}'}}`
 
-- Output 4 phrases formatted as present participle [V]erb + [a]djective + singular [n]oun + [f]inal:
+- Print `k` phrases formatted as present participle [V]erb + [a]djective + singular [n]oun + [f]inal:
 
-`buzzphrase {{4 '{V} {a} {n} {f}'}}`
+`buzzphrase {{k}} {{'{V} {a} {n} {f}'}}`

pages/common/cake.md

@@ -7,7 +7,7 @@
 
 `cake`
 
-- Display a list of available routes:
+- List available routes:
 
 `cake routes`
 

pages/common/cdk.md

@@ -11,13 +11,13 @@
 
 `cdk synth {{stack_name}}`
 
-- Deploy a space-separated list of stacks:
+- Deploy one or more stacks:
 
-`cdk deploy {{stack_name}}`
+`cdk deploy {{stack_name1 stack_name2 ...}}`
 
-- Destroy a space-separated list of stacks:
+- Destroy one or more stacks:
 
-`cdk destroy {{stack_name}}`
+`cdk destroy {{stack_name1 stack_name2 ...}}`
 
 - Compare the specified stack with the deployed stack or a local CloudFormation template:
 
@@ -25,7 +25,7 @@
 
 - Create a new CDK project in the current directory for a specified language:
 
-`cdk init -l {{language_name}}`
+`cdk init -l {{language}}`
 
 - Open the CDK API reference in your browser:
 

pages/common/clamav.md

@@ -4,14 +4,14 @@
 > ClamAV isn't a command, but a set of commands.
 > More information: <https://www.clamav.net>.
 
-- Show the tldr page for scan files using the `clamd` daemon:
+- View documentation for scanning files using the `clamd` daemon:
 
 `tldr clamdscan`
 
-- Show the tldr page for scan files without the `clamd` daemon running:
+- View documentation for scanning files without the `clamd` daemon running:
 
 `tldr clamscan`
 
-- Show the tldr page for update the virus definitions:
+- View documentation for updating the virus definitions:
 
 `tldr freshclam`

pages/common/clamdscan.md

@@ -15,7 +15,7 @@
 
 `clamdscan --infected`
 
-- Output the scan report to a log file:
+- Print the scan report to a log file:
 
 `clamdscan --log {{path/to/log_file}}`
 

pages/common/clamscan.md

@@ -23,7 +23,7 @@
 
 `clamscan --infected`
 
-- Output the scan report to a log file:
+- Print the scan report to a log file:
 
 `clamscan --log {{path/to/log_file}}`
 

pages/common/clockwork-cli.md

@@ -13,4 +13,4 @@
 
 - Monitor Clockwork logs for multiple projects:
 
-`clockwork-cli {{path/to/directory1 path/to/directory2 …}}`
+`clockwork-cli {{path/to/directory1 path/to/directory2 ...}}`

pages/common/codespell.md

@@ -25,7 +25,7 @@
 
 - Do not check the specified words:
 
-`codespell --ignore-words-list {{words,to,ignore}}`
+`codespell --ignore-words-list {{ignored_word1,ignored_word2,...}}`
 
 - Print 3 lines of context around, before or after each match:
 

pages/common/conda-install.md

@@ -3,9 +3,9 @@
 > Install packages into an existing conda environment.
 > More information: <https://docs.conda.io/projects/conda/en/latest/commands/install.html>.
 
-- Install a single package into the currently active conda environment:
+- Install one or more package into the currently active conda environment:
 
-`conda install {{package}}`
+`conda install {{package1 package2 ...}}`
 
 - Install a single package into the currently active conda environment using channel conda-forge:
 
@@ -15,10 +15,6 @@
 
 `conda install -c conda-forge --override-channels {{package}}`
 
-- Install multiple packages:
-
-`conda install {{package1 package2 ...}}`
-
 - Install a specific version of a package:
 
 `conda install {{package}}={{version}}`

pages/common/cotton.md

@@ -5,12 +5,12 @@
 
 - Use a specific base URL:
 
-`cotton -u {{base_url}} {{path/to/file}}.md`
+`cotton -u {{base_url}} {{path/to/file.md}}`
 
 - Disable certificate verification (insecure mode):
 
-`cotton -u {{base_url}} -i {{path/to/file}}.md`
+`cotton -u {{base_url}} -i {{path/to/file.md}}`
 
 - Stop running when a test fails:
 
-`cotton -u {{base_url}} -s {{path/to/file}}.md`
+`cotton -u {{base_url}} -s {{path/to/file.md}}`

pages/common/cpio.md

@@ -6,7 +6,7 @@
 
 - Take a list of file names from `stdin` and add them [o]nto an archive in cpio's binary format:
 
-`echo "{{file1}} {{file2}} {{file3}}" | cpio -o > {{archive.cpio}}`
+`echo "{{path/to/file1 path/to/file2 ...}}" | cpio -o > {{archive.cpio}}`
 
 - Copy all files and directories in a directory and add them [o]nto an archive, in [v]erbose mode:
 

pages/common/cryfs.md

@@ -15,6 +15,6 @@
 
 `cryfs --unmount-idle {{10}} {{path/to/cipher_dir}} {{path/to/mount_point}}`
 
-- Show a list of supported ciphers:
+- List supported ciphers:
 
 `cryfs --show-ciphers`

pages/common/cs.md

@@ -5,7 +5,7 @@
 > Some subcommands such as `install`, `launch`, `java`, `fetch`, `resolve`, `complete-dep`, etc. have their own usage documentation.
 > More information: <https://get-coursier.io/docs/overview>.
 
-- Show a list of the installed applications:
+- List installed applications:
 
 `cs list`
 

pages/common/csslint.md

@@ -9,7 +9,7 @@
 
 - Lint multiple CSS files:
 
-`csslint {{file1.css}} {{file2.css}} {{file3.css}}`
+`csslint {{file1.css file2.css ...}}`
 
 - List all possible style rules:
 

pages/common/ctest.md

@@ -7,7 +7,7 @@
 
 `ctest -j{{4}} --output-on-failure`
 
-- Show a list of available tests:
+- List available tests:
 
 `ctest -N`
 

pages/common/diffstat.md

@@ -5,8 +5,8 @@
 
 - Display changes in a histogram:
 
-`diff {{file1}} {{file2}} | diffstat`
+`diff {{path/to/file1}} {{path/to/file2}} | diffstat`
 
 - Display inserted, deleted and modified changes as a table:
 
-`diff {{file1}} {{file2}} | diffstat -t`
+`diff {{path/to/file1}} {{path/to/file2}} | diffstat -t`

pages/common/dirname.md

@@ -9,8 +9,8 @@
 
 - Calculate the parent directory of multiple paths:
 
-`dirname {{path/to/file_a}} {{path/to/directory_b}}`
+`dirname {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
 
 - Delimit output with a NUL character instead of a newline (useful when combining with `xargs`):
 
-`dirname --zero {{path/to/directory_a}} {{path/to/file_b}}`
+`dirname --zero {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`

pages/common/docker-network.md

@@ -11,9 +11,9 @@
 
 `docker network create --driver {{driver_name}} {{network_name}}`
 
-- Display detailed information of a space-separated list of networks:
+- Display detailed information about one or more networks:
 
-`docker network inspect {{network_name}}`
+`docker network inspect {{network_name1 network_name2 ...}}`
 
 - Connect a container to a network using a name or ID:
 
@@ -27,6 +27,6 @@
 
 `docker network prune`
 
-- Remove a space-separated list of unused networks:
+- Remove one or more unused networks:
 
-`docker network rm {{network_name}}`
+`docker network rm {{network_name1 network_name2 ...}}`

pages/common/docker-service.md

@@ -11,18 +11,18 @@
 
 `docker service create --name {{service_name}} {{image}}:{{tag}}`
 
-- Display detailed information of a space-separated list of services:
+- Display detailed information about one or more services:
 
-`docker service inspect {{service_name|ID}}`
+`docker service inspect {{service_name_or_ID1 service_name_or_ID2}}`
 
-- List the tasks of a space-separated list of services:
+- List the tasks of one or more services:
 
-`docker service ps {{service_name|ID}}`
+`docker service ps {{service_name_or_ID1 service_name_or_ID2 ...}}`
 
 - Scale to a specific number of replicas for a space-separated list of services:
 
 `docker service scale {{service_name}}={{count_of_replicas}}`
 
-- Remove a space-separated list of services:
+- Remove one or more services:
 
-`docker service rm {{service_name|ID}}`
+`docker service rm {{service_name_or_ID1 service_name_or_ID2}}`

pages/common/docker-start.md

@@ -15,6 +15,6 @@
 
 `docker start --attach {{container}}`
 
-- Start one or more space-separated containers:
+- Start one or more containers:
 
 `docker start {{container1 container2 ...}}`

pages/common/docker-stats.md

@@ -7,9 +7,9 @@
 
 `docker stats`
 
-- Display a live stream of statistics for a space-separated list of containers:
+- Display a live stream of statistics for one or more containers:
 
-`docker stats {{container_name}}`
+`docker stats {{container1 container2 ...}}`
 
 - Change the columns format to display container's CPU usage percentage:
 

pages/common/dust.md

@@ -7,9 +7,9 @@
 
 `dust`
 
-- Display information for a space-separated list of directories:
+- Display information about one or more directories:
 
-`dust {{path/to/directory1}} {{path/to/directory2}}`
+`dust {{path/to/directory1 path/to/directory2 ...}}`
 
 - Display 30 directories (defaults to 21):
 

pages/common/dvc-diff.md

@@ -9,7 +9,7 @@
 
 - Compare the changes in DVC tracked files from 1 Git commit to another:
 
-`dvc diff {{revision_b}} {{revision_a}}`
+`dvc diff {{revision1}} {{revision2}}`
 
 - Compare DVC tracked files, along with their latest hash:
 

pages/common/dvc-freeze.md

@@ -5,6 +5,6 @@
 > See also `dvs unfreeze`.
 > More information: <https://dvc.org/doc/command-reference/freeze>.
 
-- Freeze 1 or more specified stages:
+- Freeze one or more specified stages:
 
-`dvc freeze {{stage_name_a}} [{{stage_name_b}} ...]`
+`dvc freeze {{stage_name1 stage_name2 ...}}`

pages/common/dvc-unfreeze.md

@@ -5,6 +5,6 @@
 > See also `dvc freeze`.
 > More information: <https://dvc.org/doc/command-reference/unfreeze>.
 
-- Unfreeze 1 or more specified stages:
+- Unfreeze one or more specified stages:
 
-`dvc unfreeze {{stage_name_a}} [{{stage_name_b}} ...]`
+`dvc unfreeze {{stage_name1 stage_name2 ...}}`

pages/common/egrep.md

@@ -9,7 +9,7 @@
 
 - Search for a pattern within multiple files:
 
-`egrep "{{search_pattern}}" {{path/to/file1}} {{path/to/file2}} {{path/to/file3}}`
+`egrep "{{search_pattern}}" {{path/to/file1 path/to/file2 ...}}`
 
 - Search `stdin` for a pattern:
 

pages/common/env.md

@@ -23,6 +23,6 @@
 
 `env {{variable}}={{value}} {{program}}`
 
-- Set multiple variables and run a program:
+- Set one or more variables and run a program:
 
 `env {{variable1}}={{value}} {{variable2}}={{value}} {{variable3}}={{value}} {{program}}`

pages/common/erl.md

@@ -5,7 +5,7 @@
 
 - Compile and run sequential Erlang program as a common script and then exit:
 
-`erlc {{files}} && erl -noshell '{{mymodule:myfunction(arguments)}}, init:stop().'`
+`erlc {{path/to/file1 path/to/file2 ...}} && erl -noshell '{{mymodule:myfunction(arguments)}}, init:stop().'`
 
 - Connect to a running Erlang node:
 
@@ -13,4 +13,4 @@
 
 - Tell the Erlang shell to load modules from a directory:
 
-`erl -pa {{directory_with_beam_files}}`
+`erl -pa {{path/to/directory_with_beam_files}}`

pages/common/evil-winrm.md

@@ -24,7 +24,7 @@
 
 `PS > upload {{path/to/local/file}} {{path/to/remote/file}}`
 
-- Get a list of loaded PowerShell functions:
+- List all loaded PowerShell functions:
 
 `PS > menu`
 

pages/common/ffmpeg.md

@@ -5,7 +5,7 @@
 
 - Extract the sound from a video and save it as MP3:
 
-`ffmpeg -i {{path/to/video.mp4}} -vn {{path/to/sound}}.mp3`
+`ffmpeg -i {{path/to/video.mp4}} -vn {{path/to/sound.mp3}}`
 
 - Save a video as GIF, scaling the height to 1000px and setting framerate to 15:
 

pages/common/fgrep.md

@@ -8,9 +8,9 @@
 
 `fgrep {{search_string}} {{path/to/file}}`
 
-- Search only lines that match entirely in files:
+- Search only lines that match entirely in one or more files:
 
-`fgrep -x {{search_string}} {{path/to/file1}} {{path/to/file2}}`
+`fgrep -x {{search_string}} {{path/to/file1 path/to/file2 ...}}`
 
 - Count the number of lines that match the given string in a file:
 
@@ -26,4 +26,4 @@
 
 - Display filenames whose content matches the search string at least once:
 
-`fgrep -l {{search_string}} {{path/to/file1}} {{path/to/file2}}`
+`fgrep -l {{search_string}} {{path/to/file1 path/to/file2 ...}}`

pages/common/fossil-commit.md

@@ -17,4 +17,4 @@
 
 - Create a new version containing changes from the specified files; user will be prompted for a comment:
 
-`fossil commit {{path/to/file1}} {{path/to/file2}}`
+`fossil commit {{path/to/file1 path/to/file2 ...}}`

pages/common/g++.md

@@ -22,7 +22,7 @@
 
 - Compile and link multiple source code files into an executable binary:
 
-`g++ -c {{path/to/source_1.cpp path/to/source_2.cpp ...}} && g++ -o {{path/to/output_executable}} {{path/to/source_1.o path/to/source_2.o ...}}`
+`g++ -c {{path/to/source1.cpp path/to/source2.cpp ...}} && g++ -o {{path/to/output_executable}} {{path/to/source1.o path/to/source2.o ...}}`
 
 - Optimize the compiled program for performance:
 

pages/common/gcloud-components-install.md

@@ -8,13 +8,9 @@
 
 `gcloud components list`
 
-- Install a specific component (installs any dependencies as well):
+- Install one or more components (installs any dependencies as well):
 
-`gcloud components install {{component_id}}`
-
-- Install multiple specific components:
-
-`gcloud components install {{component_id1}} {{component_id2}}`
+`gcloud components install {{component_id1 component_id2 ...}}`
 
 - Check the current version of Google Cloud CLI:
 

pages/common/gh-gist.md

@@ -3,7 +3,7 @@
 > Work with GitHub Gists.
 > More information: <https://cli.github.com/manual/gh_gist>.
 
-- Create a new Gist from a space-separated list of files:
+- Create a new Gist from one or more files:
 
 `gh gist create {{path/to/file1 path/to/file2 ...}}`
 

pages/common/ghci.md

@@ -21,4 +21,4 @@
 
 - Start a REPL with a colon-separated list of directories for finding source files:
 
-`ghci -i{{path/to/directory1}}:{{path/to/directory2}}`
+`ghci -i{{path/to/directory1:path/to/directory2:...}}`

pages/common/git-bulk.md

@@ -18,7 +18,7 @@
 
 - Clone repositories from a newline-separated list of remote locations then register them as workspaces:
 
-`git bulk --addworkspace {{workspace-name}} {{absolute/path/to/root/directory}} --from {{absolute/path/to/file}}`
+`git bulk --addworkspace {{workspace-name}} {{/path/to/root/directory}} --from {{/path/to/file}}`
 
 - List all registered workspaces:
 

pages/common/git-cherry-pick.md

@@ -14,7 +14,7 @@
 
 - Apply multiple (non-sequential) commits to the current branch:
 
-`git cherry-pick {{commit_1}} {{commit_2}}`
+`git cherry-pick {{commit1 commit2 ...}}`
 
 - Add the changes of a commit to the working directory, without creating a commit:
 

pages/common/git-delete-branch.md

@@ -4,10 +4,6 @@
 > Part of `git-extras`. If deleting the checked out branch, only the remote branch will be deleted.
 > More information: <https://github.com/tj/git-extras/blob/master/Commands.md#git-delete-branch>.
 
-- Delete a local and remote Git branch:
-
-`git delete-branch {{branch_name}}`
-
-- Delete multiple local and remote Git branches:
+- Delete one or more local and remote Git branches:
 
 `git delete-branch {{branch_name1 branch_name2 ...}}`

pages/common/git-merge-base.md

@@ -7,7 +7,7 @@
 
 `git merge-base {{commit_1}} {{commit_2}}`
 
-- Output all best common ancestors of two commits:
+- Print all best common ancestors of two commits:
 
 `git merge-base --all {{commit_1}} {{commit_2}}`
 

pages/common/git-remote.md

@@ -3,7 +3,7 @@
 > Manage set of tracked repositories ("remotes").
 > More information: <https://git-scm.com/docs/git-remote>.
 
-- Show a list of existing remotes, their names and URL:
+- List existing remotes with their names and URLs:
 
 `git remote -v`
 

pages/common/git-show-branch.md

@@ -9,7 +9,7 @@
 
 - Compare commits in the history of multiple commits or branches:
 
-`git show-branch {{branch_name|ref|commit}}`
+`git show-branch {{branch_name1|ref1|commit1 branch_name2|ref2|commit2 ...}}`
 
 - Compare all remote tracking branches:
 

pages/common/glab-release.md

@@ -25,4 +25,4 @@
 
 - Upload assets to a specific release:
 
-`glab release upload {{tag}} {{path/to/file1}} {{path/to/file2}}`
+`glab release upload {{tag}} {{path/to/file1 path/to/file2 ...}}`

pages/common/gnmic-get.md

@@ -9,11 +9,11 @@
 
 - Query the device state at multiple paths:
 
-`gnmic -a {{ip:port}} get --path {{path1}} --path {{path2}}`
+`gnmic -a {{ip:port}} get --path {{path/to/file_or_directory1}} --path {{path/to/file_or_directory2}}`
 
 - Query the device state at multiple paths with a common prefix:
 
-`gnmic -a {{ip:port}} get --prefix {{prefix}} --path {{path1}} --path {{path2}}`
+`gnmic -a {{ip:port}} get --prefix {{prefix}} --path {{path/to/file_or_directory1}} --path {{path/to/file_or_directory2}}`
 
 - Query the device state and specify response encoding (json_ietf):
 

pages/common/gnmic-set.md

@@ -7,11 +7,11 @@
 
 `gnmic --address {{ip:port}} set --update-path {{path}} --update-value {{value}}`
 
-- Update the value of a path to match the contents of a json file:
+- Update the value of a path to match the contents of a JSON file:
 
 `gnmic -a {{ip:port}} set --update-path {{path}} --update-file {{filepath}}`
 
-- Replace the value of a path to match the contents of a json file:
+- Replace the value of a path to match the contents of a JSON file:
 
 `gnmic -a {{ip:port}} set --replace-path {{path}} --replace-file {{filepath}}`
 

pages/common/go-doc.md

@@ -1,9 +1,9 @@
 # go doc
 
-> Show documentation for a package or symbol.
+> View documentation for a package or symbol.
 > More information: <https://golang.org/cmd/go/#hdr-Show_documentation_for_package_or_symbol>.
 
-- Show documentation for the current package:
+- View documentation for the current package:
 
 `go doc`
 

pages/common/go-tool.md

@@ -16,6 +16,6 @@
 
 `go tool -n {{command}} {{arguments}}`
 
-- Display documentation for a specified tool:
+- View documentation for a specified tool:
 
 `go tool {{command}} --help`

pages/common/godoc.md

@@ -1,6 +1,6 @@
 # godoc
 
-> Show documentation for go packages.
+> View documentation for go packages.
 > More information: <https://godoc.org/>.
 
 - Display help for a specific package:

pages/common/goimports.md

@@ -5,16 +5,16 @@
 
 - Display the completed import source file:
 
-`goimports {{path/to/file}}.go`
+`goimports {{path/to/file.go}}`
 
 - Write the result back to the source file instead of `stdout`:
 
-`goimports -w {{path/to/file}}.go`
+`goimports -w {{path/to/file.go}}`
 
 - Display diffs and write the result back to the source file:
 
-`goimports -w -d {{path/to/file}}.go`
+`goimports -w -d {{path/to/file.go}}`
 
 - Set the import prefix string after 3rd-party packages (comma-separated list):
 
-`goimports -local {{path/to/package}} {{path/to/file}}.go`
+`goimports -local {{path/to/package1,path/to/package2,...}} {{path/to/file.go}}`

pages/common/goreload.md

@@ -5,11 +5,11 @@
 
 - Set the name of the binary file to watch (defaults to `.goreload`):
 
-`goreload -b {{path/to/binary}} {{path/to/file}}.go`
+`goreload -b {{path/to/binary}} {{path/to/file.go}}`
 
 - Set a custom log prefix (defaults to `goreload`):
 
-`goreload --logPrefix {{prefix}} {{path/to/file}}.go`
+`goreload --logPrefix {{prefix}} {{path/to/file.go}}`
 
 - Reload whenever any file changes:
 

pages/common/grunt.md

@@ -7,9 +7,9 @@
 
 `grunt`
 
-- Run one or more specific space-separated task(s):
+- Run one or more tasks:
 
-`grunt {{task_name}}`
+`grunt {{task1 task2 ...}}`
 
 - Specify an alternative configuration file:
 

pages/common/hadolint.md

@@ -21,4 +21,4 @@
 
 - Lint multiple Dockerfiles using specific trusted registries:
 
-`hadolint --trusted-registry {{docker.io}} --trusted-registry {{example.com}}:{{5000}} {{path/to/Dockerfile}} {{path/to/another/Dockerfile}}`
+`hadolint --trusted-registry {{docker.io}} --trusted-registry {{example.com}}:{{5000}} {{path/to/Dockerfile1 path/to/Dockerfile2 ...}}`

pages/common/hashid.md

@@ -7,9 +7,9 @@
 
 `hashid`
 
-- Identify hashes passed as arguments (multiple hashes can be passed):
+- Identify one or more hashes:
 
-`hashid {{hash}}`
+`hashid {{hash1 hash2 ...}}`
 
 - Identify hashes on a file (one hash per line):
 

pages/common/hr.md

@@ -13,4 +13,4 @@
 
 - Print a multiline horizontal rule:
 
-`hr {{string_a}} {{string_b}} {{string_c}}`
+`hr {{string1 string2 ...}}`

pages/common/idea.md

@@ -13,7 +13,7 @@
 
 - Open the diff viewer to compare up to 3 files:
 
-`idea diff {{path/to/file1}} {{path/to/file2}}`
+`idea diff {{path/to/file1 path/to/file2 path/to/optional_file3}}`
 
 - Open the merge dialog to perform a two-way file merge:
 

pages/common/img2pdf.md

@@ -3,9 +3,9 @@
 > Command-line lossless converter of raster images to PDF.
 > More information: <https://gitlab.mister-muffin.de/josch/img2pdf>.
 
-- Convert multiple images to a single PDF, each image being on its own page:
+- Convert one or more images to a single PDF, each image being on its own page:
 
-`img2pdf {{path/to/image1.jpg}} {{path/to/image2.jpg}} --output {{path/to/file.pdf}}`
+`img2pdf {{path/to/image1.jpg path/to/image2.jpg ...}} --output {{path/to/file.pdf}}`
 
 - Convert only the first frame of a multi-frame image to PDF:
 

pages/common/in-toto-record.md

@@ -5,8 +5,8 @@
 
 - Start the record (creates a preliminary link file):
 
-`in-toto-record start -n {{edit-files}} -k {{path/to/key_file}} -m {{.}}`
+`in-toto-record start -n {{path/to/edit_file1 path/to/edit_file2 ...}} -k {{path/to/key_file}} -m {{.}}`
 
 - Stop the record (expects a preliminary link file):
 
-`in-toto-record stop -n {{edit-files}} -k {{path/to/key_file}} -p {{.}}`
+`in-toto-record stop -n {{path/to/edit_file1 path/to/edit_file2 ...}} -k {{path/to/key_file}} -p {{.}}`

pages/common/inkview.md

@@ -10,4 +10,4 @@
 
 - Preview multiple SVGs (use arrow keys to navigate):
 
-`inkview {{path/to/file_a.svg}} {{path/to/file_b.svg}} {{path/to/file_c.svg}}`
+`inkview {{path/to/file1.svg path/to/file2.svg ...}}`

pages/common/ivpn.md

@@ -7,6 +7,6 @@
 
 `ivpn status`
 
-- Print a list of available servers to connect to:
+- List available servers to connect to:
 
 `ivpn servers`

pages/common/javac.md

@@ -9,7 +9,7 @@
 
 - Compile several `.java` files:
 
-`javac {{path/to/file1.java}} {{path/to/file2.java}} {{path/to/file3.java}}`
+`javac {{path/to/file1.java path/to/file2.java ...}}`
 
 - Compile all `.java` files in current directory:
 

pages/common/javap.md

@@ -1,13 +1,9 @@
 # javap
 
-> Disassemble one or more class files and list them.
+> Disassemble class files and list them.
 > More information: <https://docs.oracle.com/en/java/javase/20/docs/specs/man/javap.html>.
 
-- Disassemble and list a `.class` file:
-
-`javap {{path/to/file.class}}`
-
-- Disassemble and list multiple `.class` files:
+- Disassemble and list one or more `.class` files:
 
 `javap {{path/to/file1.class path/to/file2.class ...}}`
 

pages/common/jello.md

@@ -23,9 +23,9 @@
 
 `cat {{file.json}} | jello '[i.{{key_name}} for i in _]'`
 
-- Output the value of multiple keys as a new JSON object (assuming the input JSON has the keys `key_name` and `other_key_name`):
+- Output the value of multiple keys as a new JSON object (assuming the input JSON has the keys `key_name1` and `key_name2`):
 
-`cat {{file.json}} | jello '{"{{my_new_key}}": _.{{key_name}}, "{{my_other_key}}": _.{{other_key_name}}}'`
+`cat {{file.json}} | jello '{"{{key1}}": _.{{key_name1}}, "{{key_name}}": _.{{key_name2}}}'`
 
 - Output the value of a given key to a string (and disable JSON output):
 

pages/common/jest.md

@@ -9,7 +9,7 @@
 
 - Run the test suites from the given files:
 
-`jest {{path/to/file1}} {{path/to/file2}}`
+`jest {{path/to/file1 path/to/file2 ...}}`
 
 - Run the test suites from files within the current and subdirectories, whose paths match the given regular expression:
 

pages/common/jmeter.md

@@ -5,16 +5,16 @@
 
 - Run a specific test plan in nongui mode:
 
-`jmeter --nongui --testfile {{path/to/file}}.jmx`
+`jmeter --nongui --testfile {{path/to/file.jmx}}`
 
 - Run a test plan in nongui mode using a specific log file:
 
-`jmeter --nogui --testfile {{path/to/file}}.jmx --logfile {{path/to/logfile}}.jtl`
+`jmeter --nogui --testfile {{path/to/file.jmx}} --logfile {{path/to/logfile.jtl}}`
 
 - Run a test plan in nongui mode using a specific proxy:
 
-`jmeter --nongui --testfile {{path/to/file}}.jmx --proxyHost {{127.0.0.1}} --proxyPort {{8888}}`
+`jmeter --nongui --testfile {{path/to/file.jmx}} --proxyHost {{127.0.0.1}} --proxyPort {{8888}}`
 
 - Run a test plan in nongui mode using a specific JMeter property:
 
-`jmeter --jmeterproperty {{key}}='{{value}}' --nongui --testfile {{path/to/file}}.jmx`
+`jmeter --jmeterproperty {{key}}='{{value}}' --nongui --testfile {{path/to/file.jmx}}`

pages/common/john.md

@@ -13,7 +13,7 @@
 
 - Display users' cracked passwords by user identifier from multiple files:
 
-`john --show --users={{user_ids}} {{path/to/hashes*}} {{path/to/other/hashes*}}`
+`john --show --users={{user_ids}} {{path/to/hashes1.txt path/to/hashes2.txt ...}}`
 
 - Crack password hashes, using a custom wordlist:
 

pages/common/join.md

@@ -5,19 +5,19 @@
 
 - Join two files on the first (default) field:
 
-`join {{file1}} {{file2}}`
+`join {{path/to/file1}} {{path/to/file2}}`
 
 - Join two files using a comma (instead of a space) as the field separator:
 
-`join -t {{','}} {{file1}} {{file2}}`
+`join -t {{','}} {{path/to/file1}} {{path/to/file2}}`
 
 - Join field3 of file1 with field1 of file2:
 
-`join -1 {{3}} -2 {{1}} {{file1}} {{file2}}`
+`join -1 {{3}} -2 {{1}} {{path/to/file1}} {{path/to/file2}}`
 
 - Produce a line for each unpairable line for file1:
 
-`join -a {{1}} {{file1}} {{file2}}`
+`join -a {{1}} {{path/to/file1}} {{path/to/file2}}`
 
 - Join a file from `stdin`:
 

pages/common/kdenlive.md

@@ -9,7 +9,7 @@
 
 - Open a specific file:
 
-`kdenlive {{path/to/file}}.kdenlive`
+`kdenlive {{path/to/file.kdenlive}}`
 
 - Set a specific path for an MLT environment:
 

pages/common/kube-capacity.md

@@ -4,7 +4,7 @@
 > Combine the best parts of `kubectl top` and `kubectl describe` into a CLI focused on cluster resources.
 > More information: <https://github.com/robscott/kube-capacity>.
 
-- Output a list of nodes with the total CPU and Memory resource requests and limits:
+- List nodes including the total CPU and Memory resource requests and limits:
 
 `kube-capacity`
 

pages/common/lebab.md

@@ -6,7 +6,7 @@
 
 - Transpile using one or more comma-separated transformations:
 
-`lebab --transform {{transformation}}`
+`lebab --transform {{transformation1,transformation2,...}}`
 
 - Transpile a file to `stdout`:
 

pages/common/linode-cli-events.md

@@ -4,7 +4,7 @@
 > See also: `linode-cli`.
 > More information: <https://www.linode.com/docs/products/tools/cli/guides/events/>.
 
-- View a list of events on your account:
+- List the events on your account:
 
 `linode-cli events list`
 

pages/common/lpstat.md

@@ -15,6 +15,6 @@
 
 `lpstat -t`
 
-- Show a list of print jobs queued by a specific user:
+- List print jobs queued by a specific user:
 
 `lpstat -u {{user}}`

pages/common/lzop.md

@@ -9,7 +9,7 @@
 
 - Decompress a file:
 
-`lzop -d {{path/to/file}}.lzo`
+`lzop -d {{path/to/file.lzo}}`
 
 - Compress a file, while specifying the compression level. 0 = Worst, 9 = Best (Default level is 3):
 

pages/common/magento.md

@@ -3,13 +3,13 @@
 > Manage the Magento PHP framework.
 > More information: <https://magento.com>.
 
-- Enable one or more space-separated modules:
+- Enable one or more modules:
 
-`magento module:enable {{module(s)}}`
+`magento module:enable {{module1 module2 ...}}`
 
-- Disable one or more space-separated modules:
+- Disable one or more modules:
 
-`magento module:disable {{module(s)}}`
+`magento module:disable {{module1 module2 ...}}`
 
 - Update the database after enabling modules:
 

pages/common/mediainfo.md

@@ -11,6 +11,6 @@
 
 `mediainfo --Logfile={{out.txt}} {{file}}`
 
-- Display the list of metadata attributes that can be extracted:
+- List metadata attributes that can be extracted:
 
 `mediainfo --Info-Parameters`

pages/common/monodis.md

@@ -23,7 +23,7 @@
 
 `monodis --method {{path/to/assembly.exe}}`
 
-- Show a list of resources embedded within an assembly:
+- List resources embedded within an assembly:
 
 `monodis --manifest {{path/to/assembly.dll}}`
 

pages/common/most.md

@@ -9,7 +9,7 @@
 
 - Open several files:
 
-`most {{path/to/file1}} {{path/to/file2}}`
+`most {{path/to/file1 path/to/file2 ...}}`
 
 - Open a file at the first occurrence of "string":
 

pages/common/multitail.md

@@ -17,4 +17,4 @@
 
 - Show 5 logfiles while merging 2 and put them in 2 columns with only one in the left column:
 
-`multitail -s 2 -sn 1,3 {{mergefile}} -I {{file1}} {{file2}} {{file3}} {{file4}}`
+`multitail -s 2 -sn 1,3 {{path/to/mergefile}} -I {{path/to/file1}} {{path/to/file2}} {{path/to/file3}} {{path/to/file4}}`

pages/common/newsboat.md

@@ -15,7 +15,7 @@
 
 `newsboat -r`
 
-- Execute a space-separated list of commands in non-interactive mode:
+- Execute one or more commands in non-interactive mode:
 
 `newsboat -x {{reload print-unread ...}}`
 

pages/common/nth.md

@@ -11,7 +11,7 @@
 
 `nth -f {{path/to/hashes}}`
 
-- Output in json format:
+- Print in JSON format:
 
 `nth -t {{5f4dcc3b5aa765d61d8327deb882cf99}} -g`
 

pages/common/ogr2ogr.md

@@ -5,7 +5,7 @@
 
 - Convert a Shapefile into a GeoPackage:
 
-`ogr2ogr -f GPKG {{path/to/output}}.gpkg {{path/to/input}}.shp`
+`ogr2ogr -f GPKG {{path/to/output.gpkg}} {{path/to/input.shp}}`
 
 - Reduce a GeoJSON to features matching a condition:
 
@@ -13,16 +13,16 @@
 
 - Change coordinate reference system of a GeoPackage from `EPSG:4326` to `EPSG:3857`:
 
-`ogr2ogr -s_srs {{EPSG:4326}} -t_srs {{EPSG:3857}} -f GPKG {{path/to/output}}.gpkg {{path/to/input}}.gpkg`
+`ogr2ogr -s_srs {{EPSG:4326}} -t_srs {{EPSG:3857}} -f GPKG {{path/to/output.gpkg}} {{path/to/input.gpkg}}`
 
 - Convert a CSV file into a GeoPackage, specifying the names of the coordinate columns and assigning a coordinate reference system:
 
-`ogr2ogr -f GPKG {{path/to/output}}.gpkg {{path/to/input}}.csv -oo X_POSSIBLE_NAMES={{longitude}} -oo Y_POSSIBLE_NAMES={{latitude}} -a_srs {{EPSG:4326}}`
+`ogr2ogr -f GPKG {{path/to/output.gpkg}} {{path/to/input.csv}} -oo X_POSSIBLE_NAMES={{longitude}} -oo Y_POSSIBLE_NAMES={{latitude}} -a_srs {{EPSG:4326}}`
 
 - Load a GeoPackage into a PostGIS database:
 
-`ogr2ogr -f PostgreSQL PG:dbname="{{database_name}}" {{path/to/input}}.gpkg`
+`ogr2ogr -f PostgreSQL PG:dbname="{{database_name}}" {{path/to/input.gpkg}}`
 
 - Clip layers of a GeoPackage file to the given bounding box:
 
-`ogr2ogr -spat {{min_x}} {{min_y}} {{max_x}} {{max_y}} -f GPKG {{path/to/output}}.gpkg {{path/to/input}}.gpkg`
+`ogr2ogr -spat {{min_x}} {{min_y}} {{max_x}} {{max_y}} -f GPKG {{path/to/output.gpkg}} {{path/to/input.gpkg}}`

pages/common/opusenc.md

@@ -5,16 +5,16 @@
 
 - Convert WAV to Opus using default options:
 
-`opusenc {{path/to/input.wav}} {{path/to/output}}.opus`
+`opusenc {{path/to/input.wav}} {{path/to/output.opus}}`
 
 - Convert stereo audio at the highest quality level:
 
-`opusenc --bitrate {{512}} {{path/to/input.wav}} {{path/to/output}}.opus`
+`opusenc --bitrate {{512}} {{path/to/input.wav}} {{path/to/output.opus}}`
 
 - Convert 5.1 surround sound audio at the highest quality level:
 
-`opusenc --bitrate {{1536}} {{path/to/input.flac}} {{path/to/output}}.opus`
+`opusenc --bitrate {{1536}} {{path/to/input.flac}} {{path/to/output.opus}}`
 
 - Convert speech audio at the lowest quality level:
 
-`opusenc {{path/to/input.wav}} --downmix-mono --bitrate {{6}} {{path/to/out}}.opus`
+`opusenc {{path/to/input.wav}} --downmix-mono --bitrate {{6}} {{path/to/out.opus}}`