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/linux/aa-complain.md

@@ -6,7 +6,7 @@
 
 - Set policy to complain mode:
 
-`sudo aa-complain {{path/to/profile}}`
+`sudo aa-complain {{path/to/profile1 path/to/profile2 ...}}`
 
 - Set policies to complain mode:
 

pages/linux/aa-disable.md

@@ -1,13 +1,13 @@
 # aa-disable
 
-> Disable AppArmor security policy.
+> Disable AppArmor security policies.
 > See also: `aa-complain`, `aa-enforce`, `aa-status`.
 > More information: <https://gitlab.com/apparmor/apparmor/-/wikis/manpage_aa-disable.8>.
 
 - Disable profile:
 
-`sudo aa-disable {{path/to/profile}}`
+`sudo aa-disable {{path/to/profile1 path/to/profile2 ...}}`
 
-- Disable profiles:
+- Disable profiles (defaults to `/etc/apparmor.d`):
 
 `sudo aa-disable --dir {{path/to/profiles}}`

pages/linux/aa-enforce.md

@@ -6,7 +6,7 @@
 
 - Enable profile:
 
-`sudo aa-enforce {{path/to/profile}}`
+`sudo aa-enforce {{path/to/profile1 path/to/profile2 ...}}`
 
 - Enable profiles:
 

pages/linux/auracle.md

@@ -7,13 +7,13 @@
 
 `auracle search '{{regular_expression}}'`
 
-- Display package information for a space-separated list of AUR packages:
+- Display information about one or more AUR packages:
 
-`auracle info {{package1}} {{package2}}`
+`auracle info {{package1 package2 ...}}`
 
-- Display the `PKGBUILD` file (build information) for a space-separated list of AUR packages:
+- Display the `PKGBUILD` file (build information) of one or more AUR packages:
 
-`auracle show {{package1}} {{package2}}`
+`auracle show {{package1 package2 ...}}`
 
 - Display updates for installed AUR packages:
 

pages/linux/bluetoothd.md

@@ -21,4 +21,4 @@
 
 - Start the daemon with verbose output coming from specific files in the bluetoothd or plugins source:
 
-`bluetoothd --debug={{path/to/file1}}:{{path/to/file2}}:{{path/to/file3}}`
+`bluetoothd --debug={{path/to/file1:path/to/file2:...}}`

pages/linux/cgroups.md

@@ -4,14 +4,14 @@
 > Cgroups however is not a command, but rather a collection of commands, see the relevant pages below.
 > More information: <https://www.kernel.org/doc/Documentation/cgroup-v2.txt>.
 
-- Show the tldr page for `cgclassify`:
+- View documentation for `cgclassify`:
 
 `tldr cgclassify`
 
-- Show the tldr page for `cgcreate`:
+- View documentation for `cgcreate`:
 
 `tldr cgcreate`
 
-- Show the tldr page for `cgexec`:
+- View documentation for `cgexec`:
 
 `tldr cgexec`

pages/linux/dracut.md

@@ -16,6 +16,6 @@
 
 `dracut --kver {{kernel_version}}`
 
-- Show a list of available modules:
+- List available modules:
 
 `dracut --list-modules`

pages/linux/filefrag.md

@@ -3,13 +3,9 @@
 > Report how badly fragmented a particular file might be.
 > More information: <https://manned.org/filefrag>.
 
-- Display a report for a specific file:
+- Display a report for one or more files:
 
-`filefrag {{path/to/file}}`
-
-- Display a report for space-separated list of files:
-
-`filefrag {{path/to/file1}} {{path/to/file2}}`
+`filefrag {{path/to/file1 path/to/file2 ...}}`
 
 - Display a report using a 1024 byte blocksize:
 
@@ -17,12 +13,12 @@
 
 - Sync the file before requesting the mapping:
 
-`filefrag -s {{path/to/files}}`
+`filefrag -s {{path/to/file1 path/to/file2 ...}}`
 
 - Display mapping of extended attributes:
 
-`filefrag -x {{path/to/files}}`
+`filefrag -x {{path/to/file1 path/to/file2 ...}}`
 
 - Display a report with verbose information:
 
-`filefrag -v {{path/to/files}}`
+`filefrag -v {{path/to/file1 path/to/file2 ...}}`

pages/linux/fprintd-list.md

@@ -7,7 +7,7 @@
 
 `fprintd-list {{username}}`
 
-- List enrolled fingerprints for a space-separated list of users:
+- List enrolled fingerprints for one or more users:
 
 `fprintd-list {{username1 username2 ...}}`
 

pages/linux/lastb.md

@@ -1,24 +1,24 @@
 # lastb
 
-> Show a listing of last logged in users.
+> List last logged in users.
 > More information: <https://manned.org/lastb>.
 
-- Show a list of all last logged in users:
+- List last logged in users:
 
 `sudo lastb`
 
-- Show a list of all last logged in users since a given time:
+- List all last logged in users since a given time:
 
 `sudo lastb --since {{YYYY-MM-DD}}`
 
-- Show a list of all last logged in users until a given time:
+- List all last logged in users until a given time:
 
 `sudo lastb --until {{YYYY-MM-DD}}`
 
-- Show a list of all logged in users at a specific time:
+- List all logged in users at a specific time:
 
 `sudo lastb --present {{hh:mm}}`
 
-- Show a list of all last logged in users and translate the IP into a hostname:
+- List all last logged in users and translate the IP into a hostname:
 
 `sudo lastb --dns`

pages/linux/libreoffice.md

@@ -3,17 +3,17 @@
 > CLI for the powerful and free office suite LibreOffice.
 > More information: <https://www.libreoffice.org/>.
 
-- Open a space-separated list of files in read-only mode:
+- Open one or more files in read-only mode:
 
-`libreoffice --view {{path/to/file1}} {{path/to/file2}}`
+`libreoffice --view {{path/to/file1 path/to/file2 ...}}`
 
-- Display the content of specific files:
+- Display the content of one or more files:
 
-`libreoffice --cat {{path/to/file1}} {{path/to/file2}}`
+`libreoffice --cat {{path/to/file1 path/to/file2 ...}}`
 
-- Print files to a specific printer:
+- Print files using a specific printer:
 
-`libreoffice --pt {{printer_name}} {{path/to/file1}} {{path/to/file2}}`
+`libreoffice --pt {{printer_name}} {{path/to/file1 path/to/file2 ...}}`
 
 - Convert all `.doc` files in current directory to PDF:
 

pages/linux/libtoolize.md

@@ -1,6 +1,6 @@
 # libtoolize
 
-> A tool used in the autotools build system to prepare a package for the use of `libtool`.
+> A tool used in the autotools build system to prepare a package for using `libtool`.
 > It performs various tasks, including generating necessary files and directories to integrate `libtool` seamlessly into a project.
 > More information: <https://www.gnu.org/software/libtool/manual/libtool.html#Invoking-libtoolize>.
 

pages/linux/lsblk.md

@@ -29,8 +29,8 @@
 
 - Exclude the devices specified by the comma-separated list of major device numbers:
 
-`lsblk -e {{1,7}}`
+`lsblk -e {{1,7,...}}`
 
 - Display a customized summary using a comma-separated list of columns:
 
-`lsblk --output {{NAME}},{{SERIAL}},{{MODEL}},{{TRAN}},{{TYPE}},{{SIZE}},{{FSTYPE}},{{MOUNTPOINT}}`
+`lsblk --output {{NAME,SERIAL,MODEL,TRAN,TYPE,SIZE,FSTYPE,MOUNTPOINT,...}}`

pages/linux/mediamtx.md

@@ -9,7 +9,7 @@
 
 - Run MediaMTX with a custom configuration location:
 
-`mediamtx {{path/to/config}}.yml`
+`mediamtx {{path/to/config.yml}}`
 
 - Start MediaMTX as a daemon:
 

pages/linux/module.md

@@ -29,4 +29,4 @@
 
 - Specify user-created modules:
 
-`module use {{path/to/modulefiles}}`
+`module use {{path/to/module_file1 path/to/module_file2 ...}}`

pages/linux/networkctl.md

@@ -4,7 +4,7 @@
 > Manage the network configuration using `systemd-networkd`.
 > More information: <https://www.freedesktop.org/software/systemd/man/networkctl.html>.
 
-- Show a list of existing links and their status:
+- List existing links with their status:
 
 `networkctl list`
 

pages/linux/nmtui.md

@@ -8,7 +8,7 @@
 
 `nmtui`
 
-- Show a list of available connections, with the option to activate or deactivate them:
+- List available connections, with the option to activate or deactivate them:
 
 `nmtui connect`
 

pages/linux/obabel.md

@@ -17,4 +17,4 @@
 
 - Render multiple inputs into one picture:
 
-`obabel {{path/to/file1}} {{path/to/file2}} -O {{path/to/output_file.png}}`
+`obabel {{path/to/file1 path/to/file2 ...}} -O {{path/to/output_file.png}}`

pages/linux/phar.md

@@ -3,9 +3,9 @@
 > Create, update or extract PHP archives (PHAR).
 > More information: <https://manned.org/phar>.
 
-- Add space-separated files or directories to a Phar file:
+- Add one or more files or directories to a Phar file:
 
-`phar add -f {{path/to/phar_file}} {{files_or_directories}}`
+`phar add -f {{path/to/phar_file}} {{path/to/file_or_directory1 path/to/file_or_directory2 ...}}`
 
 - Display the contents of a Phar file:
 

pages/linux/po4a-gettextize.md

@@ -7,7 +7,7 @@
 
 `po4a-gettextize --format {{text}} --master {{path/to/master.txt}} --po {{path/to/result.po}}`
 
-- Get a list of available formats:
+- List all available formats:
 
 `po4a-gettextize --help-format`
 

pages/linux/po4a-translate.md

@@ -8,6 +8,6 @@
 
 `po4a-translate --format {{text}} --master {{path/to/master.doc}} --po {{path/to/result.po}} --localized {{path/to/translated.txt}}`
 
-- Get a list of available formats:
+- List all available formats:
 
 `po4a-translate --help-format`

pages/linux/po4a-updatepo.md

@@ -7,7 +7,7 @@
 
 `po4a-updatepo --format {{text}} --master {{path/to/master.txt}} --po {{path/to/result.po}}`
 
-- Get a list of available formats:
+- List available formats:
 
 `po4a-updatepo --help-format`
 

pages/linux/scontrol.md

@@ -9,16 +9,16 @@
 
 - Suspend a comma-separated list of running jobs:
 
-`scontrol suspend {{job_id}}`
+`scontrol suspend {{job_id1,job_id2,...}}`
 
 - Resume a comma-separated list of suspended jobs:
 
-`scontrol resume {{job_id}}`
+`scontrol resume {{job_id1,job_id2,...}}`
 
 - Hold a comma-separated list of queued jobs (Use `release` command to permit the jobs to be scheduled):
 
-`scontrol hold {{job_id}}`
+`scontrol hold {{job_id1,job_id2,...}}`
 
 - Release a comma-separated list of suspended job:
 
-`scontrol release {{job_id}}`
+`scontrol release {{job_id1,job_id2,...}}`

pages/linux/snapper.md

@@ -25,4 +25,4 @@
 
 - Delete a range of snapshots:
 
-`snapper -c {{config}} delete {{snapshot_X}}-{{snapshot_Y}}`
+`snapper -c {{config}} delete {{snapshot1}}-{{snapshot2}}`

pages/linux/sstat.md

@@ -9,7 +9,7 @@
 
 - Display job ID, average CPU and average virtual memory size of a comma-separated list of jobs, with pipes as column delimiters:
 
-`sstat --parsable --jobs={{job_id}} --format={{JobID}},{{AveCPU}},{{AveVMSize}}`
+`sstat --parsable --jobs={{job_id}} --format={{JobID,AveCPU,AveVMSize}}`
 
 - Display list of fields available:
 

pages/linux/sxiv.md

@@ -5,7 +5,7 @@
 
 - Open an image:
 
-`sxiv {{path/to/file}}`
+`sxiv {{path/to/image}}`
 
 - Open an image in fullscreen mode:
 
@@ -15,10 +15,10 @@
 
 `echo {{path/to/file}} | sxiv -i`
 
-- Open a space-separated list of images as a slideshow:
+- Open one or more images as a slideshow:
 
-`sxiv -S {{seconds}} {{path/to/file}}`
+`sxiv -S {{seconds}} {{path/to/image1 path/to/image2}}`
 
-- Open a space-separated list of images in thumbnail mode:
+- Open one or more images in thumbnail mode:
 
-`sxiv -t {{path/to/file}}`
+`sxiv -t {{path/to/image1 path/to/image2}}`

pages/linux/systemd-mount.md

@@ -11,7 +11,7 @@
 
 `systemd-mount {{path/to/file_or_device}} {{path/to/mount_point}}`
 
-- Show a list of all local, known block devices with file systems that may be mounted:
+- List all local, known block devices with file systems that may be mounted:
 
 `systemd-mount --list`
 

pages/linux/xfce4-terminal.md

@@ -25,4 +25,4 @@
 
 - Open multiple new tabs, executing a command in each:
 
-`xfce4-terminal --tab --command "{{command_a}}" --tab --command "{{command_b}}"`
+`xfce4-terminal --tab --command "{{command1}}" --tab --command "{{command2}}"`