pages/*, style-guide: update contents, fix Markdown (#10492)

* pages/*, style-guide: update pages, fix Markdown (commit 1)

* Update pages

* style-guide.de: update page

* Apply suggestions from code review

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

* Apply suggestions from code review

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

* pip3: remove search command

* rpm: update path placeholder

Co-authored-by: pixel <pixel+github@chrissx.de>

* Update pages/linux/pkgfile.md

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

---------

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

pages/linux/apt-file.md

@@ -13,7 +13,7 @@
 
 - List the contents of a specific package:
 
-`apt-file {{show|list}} {{package_name}}`
+`apt-file {{show|list}} {{package}}`
 
 - Search for packages that match the `regular_expression`:
 

pages/linux/apt-mark.md

@@ -5,15 +5,15 @@
 
 - Mark a package as automatically installed:
 
-`sudo apt-mark auto {{package_name}}`
+`sudo apt-mark auto {{package}}`
 
 - Hold a package at its current version and prevent updates to it:
 
-`sudo apt-mark hold {{package_name}}`
+`sudo apt-mark hold {{package}}`
 
 - Allow a package to be updated again:
 
-`sudo apt-mark unhold {{package_name}}`
+`sudo apt-mark unhold {{package}}`
 
 - Show manually installed packages:
 

pages/linux/aura.md

@@ -5,11 +5,11 @@
 
 - Search for packages from the official repositories and AUR:
 
-`aura --aursync --both --search {{package_name|search_regex}}`
+`aura --aursync --both --search {{keyword|regular_expression}}`
 
 - Install a package from the AUR:
 
-`aura --aursync {{package_name}}`
+`aura --aursync {{package}}`
 
 - Update all AUR packages in a verbose mode and remove all make dependencies:
 
@@ -17,7 +17,7 @@
 
 - Install a package from the official repositories:
 
-`aura --sync {{package_name}}`
+`aura --sync {{package}}`
 
 - Synchronize and update all packages from the official repositories:
 
@@ -25,11 +25,11 @@
 
 - Downgrade a package using the package cache:
 
-`aura --downgrade {{package_name}}`
+`aura --downgrade {{package}}`
 
 - Remove a package and its dependencies:
 
-`aura --remove --recursive --unneeded {{package_name}}`
+`aura --remove --recursive --unneeded {{package}}`
 
 - Remove orphan packages (installed as dependencies but not required by any package):
 

pages/linux/aurman.md

@@ -14,15 +14,15 @@
 
 - Install a new package:
 
-`aurman --sync {{package_name}}`
+`aurman --sync {{package}}`
 
 - Install a new package without show changes of `PKGBUILD` files:
 
-`aurman --sync --noedit {{package_name}}`
+`aurman --sync --noedit {{package}}`
 
 - Install a new package without prompting:
 
-`aurman --sync --noedit --noconfirm {{package_name}}`
+`aurman --sync --noedit --noconfirm {{package}}`
 
 - Search the package database for a keyword from the official repositories and AUR:
 
@@ -30,7 +30,7 @@
 
 - Remove a package and its dependencies:
 
-`aurman --remove --recursive --nosave {{package_name}}`
+`aurman --remove --recursive --nosave {{package}}`
 
 - Clear the package cache (use two `--clean` flags to clean all packages):
 

pages/linux/cpulimit.md

@@ -13,7 +13,7 @@
 
 - Launch a given program and limit it to only use 50% of the CPU:
 
-`cpulimit --limit {{50}} -- {{program arg1 arg2 ...}}`
+`cpulimit --limit {{50}} -- {{program argument1 argument2 ...}}`
 
 - Launch a program, limit its CPU usage to 50% and run cpulimit in the background:
 

pages/linux/debman.md

@@ -3,14 +3,14 @@
 > Read man pages from uninstalled packages.
 > More information: <https://manpages.debian.org/latest/debian-goodies/debman.1.html>.
 
-- Read a man page for a command that is provided by a specified package name:
+- Read a man page for a command that is provided by a specified package:
 
-`debman -p {{package_name}} {{command_name}}`
+`debman -p {{package}} {{command}}`
 
 - Specify a package version to download:
 
-`debman -p {{package_name}}={{version}} {{command_name}}`
+`debman -p {{package}}={{version}} {{command}}`
 
 - Read a man page in a `.deb` file:
 
-`debman -f {{path/to/filename.deb}} {{command_name}}`
+`debman -f {{path/to/filename.deb}} {{command}}`

pages/linux/dget.md

@@ -5,7 +5,7 @@
 
 - Download a binary package:
 
-`dget {{package_name}}`
+`dget {{package}}`
 
 - Download and extract a package source from its `.dsc` file:
 

pages/linux/distrobox-export.md

@@ -6,7 +6,7 @@
 
 - Export an app from the container to the host (the desktop entry/icon will show up in your host system's application list):
 
-`distrobox-export --app {{package_name}} --extra-flags "--foreground"`
+`distrobox-export --app {{package}} --extra-flags "--foreground"`
 
 - Export a binary from the container to the host:
 

pages/linux/dpkg.md

@@ -11,7 +11,7 @@
 
 - Remove a package:
 
-`dpkg -r {{package_name}}`
+`dpkg -r {{package}}`
 
 - List installed packages:
 
@@ -19,7 +19,7 @@
 
 - List a package's contents:
 
-`dpkg -L {{package_name}}`
+`dpkg -L {{package}}`
 
 - List contents of a local package file:
 
@@ -27,4 +27,4 @@
 
 - Find out which package owns a file:
 
-`dpkg -S {{filename}}`
+`dpkg -S {{path/to/file}}`

pages/linux/eix.md

@@ -6,11 +6,11 @@
 
 - Search for a package:
 
-`eix {{package_name}}`
+`eix {{query}}`
 
 - Search for installed packages:
 
-`eix --installed {{package_name}}`
+`eix --installed {{query}}`
 
 - Search in package descriptions:
 

pages/linux/emerge.md

@@ -18,11 +18,11 @@
 
 - Install a new package, with confirmation:
 
-`emerge -av {{package_name}}`
+`emerge -av {{package}}`
 
 - Remove a package, with confirmation:
 
-`emerge -Cav {{package_name}}`
+`emerge -Cav {{package}}`
 
 - Remove orphaned packages (that were installed only as dependencies):
 

pages/linux/eopkg.md

@@ -5,7 +5,7 @@
 
 - Install a specific package:
 
-`sudo eopkg install {{package_name}}`
+`sudo eopkg install {{package}}`
 
 - Update all packages:
 

pages/linux/equery.md

@@ -9,16 +9,16 @@
 
 - Search for installed packages in the Portage tree and in overlays:
 
-`equery list -po {{package_name}}`
+`equery list -po {{package1 package2 ...}}`
 
 - List all packages that depend on a given package:
 
-`equery depends {{package_name}}`
+`equery depends {{package}}`
 
 - List all packages that a given package depends on:
 
-`equery depgraph {{package_name}}`
+`equery depgraph {{package}}`
 
 - List all files installed by a package:
 
-`equery files --tree {{package_name}}`
+`equery files --tree {{package}}`

pages/linux/fixfiles.md

@@ -17,7 +17,7 @@
 
 - Use the [R]pm database to discover all files within specific packages and restore the file contexts:
 
-`fixfiles -R {{rpm_package_name1,rpm_package_name2 ...}}`
+`fixfiles -R {{rpm_package1,rpm_package2 ...}}`
 
 - Run a diff on the `PREVIOUS_FILECONTEXT` file to the [C]urrently installed one, and restore the context of all affected files:
 

pages/linux/gnome-software.md

@@ -11,9 +11,9 @@
 
 `gnome-software --mode {{updates|updated|installed|overview}}`
 
-- Launch the GNOME Software GUI if it's not open, and view the specified package:
+- Launch the GNOME Software GUI if it's not open and view the details of the specified package:
 
-`gnome-software --details {{package_name}}`
+`gnome-software --details {{package}}`
 
 - Display the version:
 

pages/linux/guix-package.md

@@ -5,11 +5,11 @@
 
 - Install a new package:
 
-`guix package -i {{package_name}}`
+`guix package -i {{package}}`
 
 - Remove a package:
 
-`guix package -r {{package_name}}`
+`guix package -r {{package}}`
 
 - Search the package database for a regular expression:
 

pages/linux/pacaur.md

@@ -13,11 +13,11 @@
 
 - Install a new package (includes AUR):
 
-`pacaur -S {{package_name}}`
+`pacaur -S {{package}}`
 
 - Remove a package and its dependencies (includes AUR packages):
 
-`pacaur -Rs {{package_name}}`
+`pacaur -Rs {{package}}`
 
 - Search the package database for a keyword (includes AUR):
 

pages/linux/pacman-database.md

@@ -7,11 +7,11 @@
 
 - Mark a package as implicitly installed:
 
-`sudo pacman --database --asdeps {{package_name}}`
+`sudo pacman --database --asdeps {{package}}`
 
 - Mark a package as explicitly installed:
 
-`sudo pacman --database --asexplicit {{package_name}}`
+`sudo pacman --database --asexplicit {{package}}`
 
 - Check that all the package dependencies are installed:
 

pages/linux/pacman-deptest.md

@@ -6,7 +6,7 @@
 
 - Print the package names of the dependencies that aren't installed:
 
-`pacman --deptest {{package_name1}} {{package_name2}}`
+`pacman --deptest {{package1 package2 ...}}`
 
 - Check if the installed package satisfies the given minimum version:
 

pages/linux/pacman-files.md

@@ -22,7 +22,7 @@
 
 - List the files owned by a specific package:
 
-`pacman --files --list {{package_name}}`
+`pacman --files --list {{package}}`
 
 - Display help:
 

pages/linux/pacman-query.md

@@ -18,11 +18,11 @@
 
 - Display information about an installed package:
 
-`pacman --query --info {{package_name}}`
+`pacman --query --info {{package}}`
 
 - List files owned by a package:
 
-`pacman --query --list {{package_name}}`
+`pacman --query --list {{package}}`
 
 - List orphan packages (installed as dependencies but not required by any package):
 

pages/linux/pacman-remove.md

@@ -6,15 +6,15 @@
 
 - Remove a package and its dependencies:
 
-`sudo pacman --remove --recursive {{package_name}}`
+`sudo pacman --remove --recursive {{package}}`
 
 - Remove a package and both its dependencies and configuration files:
 
-`sudo pacman --remove --recursive --nosave {{package_name}}`
+`sudo pacman --remove --recursive --nosave {{package}}`
 
 - Remove a package without prompting:
 
-`sudo pacman --remove --noconfirm {{package_name}}`
+`sudo pacman --remove --noconfirm {{package}}`
 
 - Remove orphan packages (installed as dependencies but not required by any package):
 
@@ -22,11 +22,11 @@
 
 - Remove a package and all packages that depend on it:
 
-`sudo pacman --remove --cascade {{package_name}}`
+`sudo pacman --remove --cascade {{package}}`
 
 - List packages that would be affected (does not remove any packages):
 
-`pacman --remove --print {{package_name}}`
+`pacman --remove --print {{package}}`
 
 - Display help for this subcommand:
 

pages/linux/pacman-sync.md

@@ -6,7 +6,7 @@
 
 - Install a new package:
 
-`sudo pacman --sync {{package_name}}`
+`sudo pacman --sync {{package}}`
 
 - Synchronize and update all packages (add `--downloadonly` to download the packages and not update them):
 
@@ -14,7 +14,7 @@
 
 - Update all packages and install a new one without prompting:
 
-`sudo pacman --sync --refresh --sysupgrade --noconfirm {{package_name}}`
+`sudo pacman --sync --refresh --sysupgrade --noconfirm {{package}}`
 
 - Search the package database for a regular expression or keyword:
 
@@ -22,7 +22,7 @@
 
 - Display information about a package:
 
-`pacman --sync --info {{package_name}}`
+`pacman --sync --info {{package}}`
 
 - Overwrite conflicting files during a package update:
 
@@ -30,7 +30,7 @@
 
 - Synchronize and update all packages, but ignore a specific package (can be used more than once):
 
-`sudo pacman --sync --refresh --sysupgrade --ignore {{package_name}}`
+`sudo pacman --sync --refresh --sysupgrade --ignore {{package}}`
 
 - Remove not installed packages and unused repositories from the cache (use two `--clean` flags to clean all packages):
 

pages/linux/pacman.md

@@ -11,11 +11,11 @@
 
 - Install a new package:
 
-`sudo pacman -S {{package_name}}`
+`sudo pacman -S {{package}}`
 
 - Remove a package and its dependencies:
 
-`sudo pacman -Rs {{package_name}}`
+`sudo pacman -Rs {{package}}`
 
 - Search the database for packages containing a specific file:
 

pages/linux/pacstall.md

@@ -5,15 +5,15 @@
 
 - Search the package database for a package name:
 
-`pacstall --search {{package_name}}`
+`pacstall --search {{query}}`
 
 - Install a package:
 
-`pacstall --install {{package_name}}`
+`pacstall --install {{package}}`
 
 - Remove a package:
 
-`pacstall --remove {{package_name}}`
+`pacstall --remove {{package}}`
 
 - Add a repository to the database (only GitHub and GitLab are supported):
 
@@ -29,7 +29,7 @@
 
 - Display information about a package:
 
-`pacstall --query-info {{package_name}}`
+`pacstall --query-info {{package}}`
 
 - List all installed packages:
 

pages/linux/paru.md

@@ -17,12 +17,12 @@
 
 - Get information about a package:
 
-`paru -Si {{package_name}}`
+`paru -Si {{package}}`
 
 - Download `PKGBUILD` and other package source files from the AUR or ABS:
 
-`paru --getpkgbuild {{package_name}}`
+`paru --getpkgbuild {{package}}`
 
 - Display the `PKGBUILD` file of a package:
 
-`paru --getpkgbuild --print {{package_name}}`
+`paru --getpkgbuild --print {{package}}`

pages/linux/pkgadd.md

@@ -5,8 +5,8 @@
 
 - Install a local software package:
 
-`pkgadd {{package_name}}`
+`pkgadd {{package}}`
 
 - Update an already installed package from a local package:
 
-`pkgadd -u {{package_name}}`
+`pkgadd -u {{package}}`

pages/linux/pkgfile.md

@@ -14,11 +14,11 @@
 
 - List all files provided by a package:
 
-`pkgfile --list {{package_name}}`
+`pkgfile --list {{package}}`
 
-- List only files provided by a package located within the `bin` or `sbin` directory:
+- List executables provided by a package:
 
-`pkgfile --list --binaries {{package_name}}`
+`pkgfile --list --binaries {{package}}`
 
 - Search for a package that owns a specific file using case-insensitive matching:
 

pages/linux/pkginfo.md

@@ -9,7 +9,7 @@
 
 - List files owned by a package:
 
-`pkginfo -l {{package_name}}`
+`pkginfo -l {{package}}`
 
 - List the owner(s) of files matching a pattern:
 

pages/linux/pkgrm.md

@@ -5,4 +5,4 @@
 
 - Remove an installed package:
 
-`pkgrm {{package_name}}`
+`pkgrm {{package}}`

pages/linux/prt-get.md

@@ -5,19 +5,19 @@
 
 - Install a package:
 
-`prt-get install {{package_name}}`
+`prt-get install {{package}}`
 
 - Install a package with dependency handling:
 
-`prt-get depinst {{package_name}}`
+`prt-get depinst {{package}}`
 
 - Update a package manually:
 
-`prt-get upgrade {{package_name}}`
+`prt-get upgrade {{package}}`
 
 - Remove a package:
 
-`prt-get remove {{package_name}}`
+`prt-get remove {{package}}`
 
 - Upgrade the system from the local ports tree:
 
@@ -25,7 +25,7 @@
 
 - Search the ports tree:
 
-`prt-get search {{package_name}}`
+`prt-get search {{query}}`
 
 - Search for a file in a package:
 

pages/linux/qm-guest-exec.md

@@ -5,16 +5,16 @@
 
 - Execute a specific command via a guest agent:
 
-`qm guest exec {{vm_id}} {{command}} {{arg1 arg2 ...}}`
+`qm guest exec {{vm_id}} {{command}} {{argument1 argument2 ...}}`
 
 - Execute a specific command via a guest agent asynchronously:
 
-`qm guest exec {{vm_id}} {{arg1 arg2 ...}} --synchronous 0`
+`qm guest exec {{vm_id}} {{argument1 argument2 ...}} --synchronous 0`
 
 - Execute a specific command via a guest agent with a specified timeout of 10 seconds:
 
-`qm guest exec {{vm_id}} {{arg1 arg2 ...}} --timeout {{10}}`
+`qm guest exec {{vm_id}} {{argument1 argument2...}} --timeout {{10}}`
 
 - Execute a specific command via a guest agent and forward input from STDIN until EOF to the guest agent:
 
-`qm guest exec {{vm_id}} {{arg1 arg2 ...}} --pass-stdin 1`
+`qm guest exec {{vm_id}} {{argument1 argument2 ...}} --pass-stdin 1`

pages/linux/rpm.md

@@ -14,7 +14,7 @@
 
 - Forcibly install a package regardless of currently installed versions:
 
-`rpm --upgrade {{package_name.rpm}} --force`
+`rpm --upgrade {{path/to/package.rpm}} --force`
 
 - Identify owner of a file and show version of the package:
 
@@ -26,7 +26,7 @@
 
 - Show scriptlets from an RPM file:
 
-`rpm --query --package --scripts {{package_name.rpm}}`
+`rpm --query --package --scripts {{package.rpm}}`
 
 - Show changed, missing and/or incorrectly installed files of matching packages:
 
@@ -34,4 +34,4 @@
 
 - Display the changelog of a specific package:
 
-`rpm --query --changelog {{package_name}}`
+`rpm --query --changelog {{package}}`

pages/linux/slapt-get.md

@@ -10,11 +10,11 @@
 
 - Install a package, or update it to the latest available version:
 
-`slapt-get --install {{package_name}}`
+`slapt-get --install {{package}}`
 
 - Remove a package:
 
-`slapt-get --remove {{package_name}}`
+`slapt-get --remove {{package}}`
 
 - Upgrade all installed packages to their latest available versions:
 
@@ -22,8 +22,8 @@
 
 - Locate packages by the package name, disk set, or version:
 
-`slapt-get --search {{package_name}}`
+`slapt-get --search {{query}}`
 
 - Show information about a package:
 
-`slapt-get --show {{package_name}}`
+`slapt-get --show {{package}}`

pages/linux/snap.md

@@ -6,19 +6,19 @@
 
 - Search for a package:
 
-`snap find {{package_name}}`
+`snap find {{query}}`
 
 - Install a package:
 
-`snap install {{package_name}}`
+`snap install {{package}}`
 
 - Update a package:
 
-`snap refresh {{package_name}}`
+`snap refresh {{package}}`
 
 - Update a package to another channel (track, risk, or branch):
 
-`snap refresh {{package_name}} --channel={{channel}}`
+`snap refresh {{package}} --channel={{channel}}`
 
 - Update all packages:
 
@@ -30,7 +30,7 @@
 
 - Uninstall a package:
 
-`snap remove {{package_name}}`
+`snap remove {{package}}`
 
 - Check for recent snap changes in the system:
 

pages/linux/yaourt.md

@@ -9,15 +9,15 @@
 
 - Install a new package (includes AUR):
 
-`yaourt -S {{package_name}}`
+`yaourt -S {{package}}`
 
 - Remove a package and its dependencies (includes AUR packages):
 
-`yaourt -Rs {{package_name}}`
+`yaourt -Rs {{package}}`
 
 - Search the package database for a keyword (including AUR):
 
-`yaourt -Ss {{package_name}}`
+`yaourt -Ss {{query}}`
 
 - List installed packages, versions, and repositories (AUR packages will be listed under the repository name 'local'):
 

pages/linux/yay.md

@@ -18,11 +18,11 @@
 
 - Install a new package from the repos and AUR:
 
-`yay -S {{package_name}}`
+`yay -S {{package}}`
 
 - Remove an installed package and both its dependencies and configuration files:
 
-`yay -Rns {{package_name}}`
+`yay -Rns {{package}}`
 
 - Search the package database for a keyword from the repos and AUR: