pages*: refine wording (#12132)

* pages*: refine wording

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@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/common/ab.md

@@ -19,7 +19,7 @@
 
 `ab -k {{url}}`
 
-- Set the maximum number of seconds ([t]imeout) to spend for benchmarking:
+- Set the maximum number of seconds ([t]imeout) to spend for benchmarking (30 by default):
 
 `ab -t {{60}} {{url}}`
 

pages/common/adguardhome.md

@@ -11,7 +11,7 @@
 
 `AdGuardHome --config {{path/to/AdGuardHome.yaml}}`
 
-- Set the work directory for data to be stored in:
+- Store the data in a specific work directory:
 
 `AdGuardHome --work-dir {{path/to/directory}}`
 

pages/common/alacritty.md

@@ -15,7 +15,7 @@
 
 `alacritty -e {{command}}`
 
-- Specify alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.yml`):
+- Use an alternative configuration file (defaults to `$XDG_CONFIG_HOME/alacritty/alacritty.yml`):
 
 `alacritty --config-file {{path/to/config.yml}}`
 

pages/common/ani-cli.md

@@ -7,22 +7,22 @@
 
 `ani-cli "{{anime_name}}"`
 
-- Download episode:
+- [d]ownload episode:
 
 `ani-cli -d "{{anime_name}}"`
 
-- Use VLC as the media player:
+- Use [v]LC as the media player:
 
 `ani-cli -v "{{anime_name}}"`
 
-- Specify episode to watch:
+- Watch a specific [e]pisode:
 
 `ani-cli -e {{episode_number}} "{{anime_name}}"`
 
-- Continue watching anime from history:
+- [c]ontinue watching anime from history:
 
 `ani-cli -c`
 
-- Update `ani-cli`:
+- [U]pdate `ani-cli`:
 
 `ani-cli -U`

pages/common/cavif.md

@@ -1,9 +1,10 @@
 # cavif
 
-> PNG/JPEG to AVIF converter.
+> PNG/JPEG to AVIF converter. Written in Rust.
+> See also: `convert`.
 > More information: <https://github.com/kornelski/cavif-rs>.
 
-- Convert a JPEG file to AVIF:
+- Convert a JPEG file to AVIF, saving it to `file.avif`:
 
 `cavif {{path/to/file.jpg}}`
 
@@ -11,7 +12,7 @@
 
 `cavif --quality {{60}} {{path/to/file.png}}`
 
-- Set the output location explicitly:
+- Specify the output location:
 
 `cavif {{path/to/file.jpg}} --output {{path/to/file.avif}}`
 

pages/common/chezmoi.md

@@ -3,19 +3,19 @@
 > A multi-machine dotfile manager, written in Go.
 > More information: <https://chezmoi.io>.
 
-- Initialize chezmoi on your machine:
+- Setup up `chezmoi`, creating a Git repository in `~/.local/share/chezmoi`:
 
 `chezmoi init`
 
-- Tell chezmoi to manage a dotfile:
+- Start tracking one or more dotfiles:
 
-`chezmoi add {{path/to/file}}`
+`chezmoi add {{path/to/dotfile1 path/to/dotfile2 ...}}`
 
 - Edit the source state of a tracked dotfile:
 
-`chezmoi edit {{path/to/file}}`
+`chezmoi edit {{path/to/dotfile_or_symlink}}`
 
-- See changes chezmoi would make:
+- See pending changes:
 
 `chezmoi diff`
 
@@ -23,10 +23,10 @@
 
 `chezmoi -v apply`
 
-- Set chezmoi up on another machine by downloading existing dotfiles from a Git repository:
+- Set up `chezmoi` from existing dotfiles of a Git repository:
 
-`chezmoi init {{https://example.com/path/to/repository.git}}`
+`chezmoi init {{repository_url}}`
 
-- Fetch the latest changes from a remote repository:
+- Pull changes from a remote repository and apply them:
 
 `chezmoi update`

pages/common/cmatrix.md

@@ -3,18 +3,18 @@
 > Shows a scrolling Matrix like screen in the terminal.
 > More information: <https://github.com/abishekvashok/cmatrix>.
 
-- Enable asynchronous scrolling:
+- Enable [a]synchronous scrolling:
 
 `cmatrix -a`
 
-- Display red text:
+- Change the text [C]olor (green by default):
 
 `cmatrix -C {{red}}`
 
-- Enable rainbow mode:
+- Enable [r]ainbow mode:
 
 `cmatrix -r`
 
-- Set screen update delay to 2 centiseconds (20 milliseconds):
+- Use a screen [u]pdate delay of 100 centiseconds (1 second):
 
-`cmatrix -u {{2}}`
+`cmatrix -u 100`

pages/common/cs-java.md

@@ -19,7 +19,7 @@
 
 `cs java --installed`
 
-- Set the a specific JVM as one-off "default" for the shell instance:
+- Set a specific JVM as one-off default for the shell instance:
 
 `cs java --jvm {{jvm_name}}:{{jvm_version}} --env`
 

pages/common/csslint.md

@@ -15,14 +15,14 @@
 
 `csslint --list-rules`
 
-- Specify certain rules as errors (which result in a non-zero exit code):
+- Treat certain rules as errors (which results in a non-zero exit code):
 
 `csslint --errors={{errors,universal-selector,imports}} {{file.css}}`
 
-- Specify certain rules as warnings:
+- Treat certain rules as warnings:
 
 `csslint --warnings={{box-sizing,selector-max,floats}} {{file.css}}`
 
-- Specify certain rules to ignore:
+- Ignore specific rules:
 
 `csslint --ignore={{ids,rules-count,shorthand}} {{file.css}}`

pages/common/dc.md

@@ -20,7 +20,7 @@
 
 `dc --expression='4 5 * 17 - p'`
 
-- Set number of decimal places to 7 (7 k), calculate 5 divided by -3 (5 _3 /) and [p]rint:
+- Specify the number of decimal places to 7 (7 k), calculate 5 divided by -3 (5 _3 /) and [p]rint:
 
 `dc --expression='7 k 5 _3 / p'`
 

pages/common/dhcpig.md

@@ -24,7 +24,7 @@
 
 `sudo ./pig.py -c --verbosity=1 {{eth1}}`
 
-- Set debug verbosity and scan network of neighboring devices using ARP packets:
+- Use a debug verbosity of 100 and scan network of neighboring devices using ARP packets:
 
 `sudo ./pig.py -c --verbosity=100 --neighbors-scan-arp {{eth1}}`
 

pages/common/dua.md

@@ -27,6 +27,6 @@
 
 `dua --format {{metric|binary|bytes|GB|GiB|MB|MiB}}`
 
-- Set the number of threads to be used:
+- Use a specific number of threads (defaults to the process number of threads):
 
 `dua --threads {{count}}`

pages/common/dvc-config.md

@@ -30,4 +30,4 @@
 
 - Set a local, global, or system level configuration value:
 
-`dvc config --local/global/system {{key}} {{value}}`
+`dvc config --{{local|global|system}} {{key}} {{value}}`

pages/common/fastfetch.md

@@ -7,7 +7,7 @@
 
 `fastfetch`
 
-- Set the structure of the fetch:
+- Fetch a specific structure:
 
 `fastfetch --structure {{structure}}`
 
@@ -15,10 +15,10 @@
 
 `fastfetch --load-config {{path/to/config_file}}`
 
-- Set the logo to use:
+- Use a specific logo:
 
 `fastfetch --logo {{logo}}`
 
-- Set the color of the keys and title:
+- Use a specific color for the keys and title:
 
 `fastfetch --color {{blue}}`

pages/common/feh.md

@@ -19,14 +19,14 @@
 
 `feh --cycle-once {{path/to/images}}`
 
-- Set the slideshow cycle delay:
+- Use a specific slideshow cycle delay:
 
 `feh --slideshow-delay {{seconds}} {{path/to/images}}`
 
-- Set your wallpaper (centered, filled, maximized, scaled or tiled):
+- Use a specific wallpaper mode (centered, filled, maximized, scaled or tiled):
 
 `feh --bg-{{center|fill|max|scale|tile}} {{path/to/image}}`
 
-- Create a montage of all images within a directory. Outputs as a new image:
+- Create a montage of all images within a directory, outputting as a new image:
 
 `feh --montage --thumb-height {{150}} --thumb-width {{150}} --index-info "{{%nn%wx%h}}" --output {{path/to/montage_image.png}}`

pages/common/gitui.md

@@ -3,7 +3,7 @@
 > Terminal UI for Git.
 > More information: <https://github.com/extrawurst/gitui>.
 
-- Set the color theme (defaults to `theme.ron`):
+- Specify the color theme (defaults to `theme.ron`):
 
 `gitui --theme {{theme}}`
 
@@ -19,11 +19,11 @@
 
 `gitui --bugreport`
 
-- Set the Git directory:
+- Use a specific Git directory:
 
 `gitui --directory {{path/to/directory}}`
 
-- Set the working directory:
+- Use a specific working directory:
 
 `gitui --workdir {{path/to/directory}}`
 

pages/common/gladtex.md

@@ -4,7 +4,7 @@
 > It converts LaTeX formulas to images.
 > More information: <https://manned.org/gladtex.1>.
 
-- Convert to html:
+- Convert to HTML:
 
 `gladtex {{path/to/input.htex}}`
 

pages/common/gnomon.md

@@ -15,10 +15,10 @@
 
 `{{npm test}} | gnomon --type=absolute`
 
-- Set a high threshold of 0.5 seconds for the elapsed time; exceeding which the timestamp will be colored bright red:
+- Use a high threshold of 0.5 seconds, exceeding which the timestamp will be colored bright red:
 
-`{{npm test}} | gnomon --high {{0.5}}`
+`{{npm test}} | gnomon --high 0.5`
 
-- Set a medium threshold of 0.2 seconds (Timestamp will be colored bright yellow):
+- Use a medium threshold of 0.2 seconds, exceeding which the timestamp will be colored bright yellow:
 
 `{{npm test}} | gnomon --medium {{0.2}}`

pages/common/goreload.md

@@ -3,7 +3,7 @@
 > Live reload utility for Go programs.
 > More information: <https://github.com/acoshift/goreload>.
 
-- Set the name of the binary file to watch (defaults to `.goreload`):
+- Watch a binary file (defaults to `.goreload`):
 
 `goreload -b {{path/to/binary}} {{path/to/file.go}}`
 

pages/common/gource.md

@@ -12,18 +12,18 @@
 
 `gource -{{width}}x{{height}}`
 
-- Set a custom timescale for the animation:
+- Specify the timescale for the animation:
 
 `gource -c {{time_scale_multiplier}}`
 
-- Set how long each day should be in the animation (this combines with -c, if provided):
+- Specify how long each day should be in the animation (this combines with -c, if provided):
 
 `gource -s {{seconds}}`
 
-- Set fullscreen mode and a custom background color:
+- Use fullscreen mode and a custom background color:
 
 `gource -f -b {{hex_color_code}}`
 
-- Set a title for the animation:
+- Specify the animation title:
 
 `gource --title {{title}}`

pages/common/kdenlive.md

@@ -11,11 +11,11 @@
 
 `kdenlive {{path/to/file.kdenlive}}`
 
-- Set a specific path for an MLT environment:
+- Use a specific path for an MLT environment:
 
 `kdenlive --mlt-path {{path/to/directory}}`
 
-- Set a specific log level for an MLT environment:
+- Use a specific log level for an MLT environment:
 
 `kdenlive --mlt-log {{verbose|debug}}`
 

pages/common/montage.md

@@ -12,7 +12,7 @@
 
 `montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{+0+0}} {{path/to/montage.jpg}}`
 
-- Set the grid cell size and resize images to fit it before tiling:
+- Specify the grid cell size and resize images to fit it before tiling:
 
 `montage {{path/to/image1.jpg path/to/image2.jpg ...}} -geometry {{640x480+0+0}} {{path/to/montage.jpg}}`
 

pages/common/msbuild.md

@@ -11,15 +11,15 @@
 
 `msbuild {{path/to/project_file}}`
 
-- Set one or more semicolon-separated targets to build:
+- Specify one or more semicolon-separated targets to build:
 
 `msbuild {{path/to/project_file}} /target:{{targets}}`
 
-- Set one or more semicolon-separated properties:
+- Specify one or more semicolon-separated properties:
 
 `msbuild {{path/to/project_file}} /property:{{name=value}}`
 
-- Set the build tools version to use:
+- Specify the build tools version to use:
 
 `msbuild {{path/to/project_file}} /toolsversion:{{version}}`
 

pages/common/nkf.md

@@ -16,11 +16,11 @@
 
 `nkf -w --overwrite {{path/to/file.txt}}`
 
-- Set new line code to LF and overwrite (UNIX type):
+- Use LF as the new line code and overwrite (UNIX type):
 
 `nkf -d --overwrite {{path/to/file.txt}}`
 
-- Set new line code to CRLF and overwrite (windows type):
+- Use CRLF as the new line code and overwrite (windows type):
 
 `nkf -c --overwrite {{path/to/file.txt}}`
 

pages/common/phing.md

@@ -15,13 +15,13 @@
 
 `phing {{task_name}}`
 
-- Specify a custom build file path:
+- Use the given build file path:
 
 `phing -f {{path/to/build.xml}} {{task_name}}`
 
-- Specify a log file to output to:
+- Log to the given file:
 
-`phing -b {{path/to/log_file}} {{task_name}}`
+`phing -logfile {{path/to/log_file}} {{task_name}}`
 
 - Use custom properties in the build:
 

pages/common/ppmtomitsu.md

@@ -7,10 +7,10 @@
 
 `ppmtomitsu {{path/to/file.ppm}} > {{path/to/file.mitsu}}`
 
-- Enlarge the image by the specified factor, use the specified sharpness and produce n copies:
+- Enlarge the image by the specified factor, use the specified sharpness and produce `n` copies:
 
 `ppmtomitsu -enlarge {{1|2|3}} -sharpness {{1|2|3|4}} -copy {{n}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`
 
-- Specify the media that will be used for the printing process:
+- Use the given medium for the printing process:
 
 `ppmtomitsu -media {{A|A4|AS|A4S}} {{path/to/file.ppm}} > {{path/to/file.mitsu}}`

pages/common/scrcpy.md

@@ -27,6 +27,6 @@
 
 `scrcpy --record {{path/to/file.mp4}}`
 
-- Set target directory for pushing files to device by drag and drop (non-APK):
+- Specify the target directory for pushing files to device by drag and drop (non-APK):
 
 `scrcpy --push-target {{path/to/directory}}`

pages/common/streamlink.md

@@ -19,7 +19,7 @@
 
 `streamlink --player={{mpv}} {{example.com/stream}} {{best}}`
 
-- Specify the amount of time to skip from the beginning of the stream. For live streams, this is a negative offset from the end of the stream (rewind):
+- Skip a specific amount of time from the beginning of the stream. For live streams, this is a negative offset from the end of the stream (rewind):
 
 `streamlink --hls-start-offset {{[HH:]MM:SS}} {{example.com/stream}} {{best}}`
 

pages/common/timeout.md

@@ -3,10 +3,10 @@
 > Run a command with a time limit.
 > More information: <https://www.gnu.org/software/coreutils/timeout>.
 
-- Run `sleep 10` and terminate it, if it runs for more than 3 seconds:
+- Run `sleep 10` and terminate it after 3 seconds:
 
-`timeout {{3s}} {{sleep 10}}`
+`timeout 3s sleep 10`
 
-- Specify the signal to be sent to the command after the time limit expires. (By default, TERM is sent):
+- Send a signal to the command after the time limit expires (SIGTERM by default):
 
 `timeout --signal {{INT}} {{5s}} {{sleep 10}}`

pages/common/transmission-cli.md

@@ -16,11 +16,11 @@
 
 `transmission-cli --new {{path/to/source_file_or_directory}}`
 
-- Set the download speed limit to 50 KB/s:
+- Specify the download speed limit (in KB/s):
 
 `transmission-cli --downlimit {{50}} {{url|magnet|path/to/file}}`
 
-- Set the upload speed limit to 50 KB/s:
+- Specify the upload speed limit (in KB/s):
 
 `transmission-cli --uplimit {{50}} {{url|magnet|path/to/file}}`
 

pages/common/waitress-serve.md

@@ -23,6 +23,6 @@
 
 `waitress-serve --call {{import.path.wsgi_factory}}`
 
-- Set the URL scheme to HTTPS:
+- Use the HTTPS URL scheme:
 
 `waitress-serve --url-scheme={{https}} {{import.path:wsgi_func}}`

pages/common/ybacklight.md

@@ -7,14 +7,14 @@
 
 `ybacklight Sc/Sm`
 
-- Set the brightness to 420:
+- Specify the brightness:
 
 `ybacklight s{{420}}`
 
 - Increase the brightness by 42 big steps (4200 by default):
 
-`ybacklight Si{{42}}`
+`ybacklight Si42`
 
 - Decrease the brightness by 300:
 
-`ybacklight d{{300}}`
+`ybacklight d300`

pages/linux/bmon.md

@@ -11,10 +11,10 @@
 
 `bmon -b`
 
-- Set policy to define which network interface(s) is/are displayed:
+- Specify the policy to define which network interface(s) is/are displayed:
 
 `bmon -p {{interface_1,interface_2,interface_3}}`
 
-- Set interval (in seconds) in which rate per counter is calculated:
+- Specify the interval (in seconds) in which rate per counter is calculated:
 
 `bmon -R {{2.0}}`

pages/linux/compress.md

@@ -11,7 +11,7 @@
 
 `compress -f {{path/to/file1 path/to/file2 ...}}`
 
-- Set maximum compression bits (9-16 bits):
+- Specify the maximum compression bits (9-16 bits):
 
 `compress -b {{bits}}`
 

pages/linux/cryptcat.md

@@ -11,11 +11,11 @@
 
 `cryptcat -k {{password}} {{ip_address}} {{port}}`
 
-- Set a timeout [w]:
+- Specify the timeout ([w]):
 
 `cryptcat -k {{password}} -w {{timeout_in_seconds}} {{ip_address}} {{port}}`
 
-- Scan [z] the open ports of a specified host:
+- Scan ([z]) the open ports of a specified host:
 
 `cryptcat -v -z {{ip_address}} {{port}}`
 

pages/linux/handlr.md

@@ -11,7 +11,7 @@
 
 `handlr open {{path/to/file.pdf}}`
 
-- Set imv as the default application for PNG files:
+- Set `imv` as the default application for PNG files:
 
 `handlr set {{.png}} {{imv.desktop}}`
 

pages/osx/brightness.md

@@ -7,9 +7,9 @@
 
 `brightness -l`
 
-- Set the brightness to 100%:
+- Set a specific brightness:
 
-`brightness {{1}}`
+`brightness {{0..1}}`
 
 - Set the brightness to 50%: