From 80147cbd87953749ee60ac819fb87ca2ae192541 Mon Sep 17 00:00:00 2001
From: Lena <126529524+acuteenvy@users.noreply.github.com>
Date: Sun, 16 Jul 2023 07:26:08 +0200
Subject: [PATCH] xbps-{install,remove,query}: add page; xbps: update page
 (#10354)

* xbps-query: add page

* xbps: remove examples and add redirections to subpages

* xbps-install: add page

* xbps-remove: add page

* xbps*: `package_name` => `package`

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

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
---
 pages/linux/xbps-install.md | 13 +++++++++++++
 pages/linux/xbps-query.md   | 25 +++++++++++++++++++++++++
 pages/linux/xbps-remove.md  | 21 +++++++++++++++++++++
 pages/linux/xbps.md         | 33 +++++++++------------------------
 4 files changed, 68 insertions(+), 24 deletions(-)
 create mode 100644 pages/linux/xbps-install.md
 create mode 100644 pages/linux/xbps-query.md
 create mode 100644 pages/linux/xbps-remove.md

diff --git a/pages/linux/xbps-install.md b/pages/linux/xbps-install.md
new file mode 100644
index 000000000..aeda326a9
--- /dev/null
+++ b/pages/linux/xbps-install.md
@@ -0,0 +1,13 @@
+# xbps-install
+
+> XBPS utility to (re)install and update packages.
+> See also: `xbps`.
+> More information: <https://man.voidlinux.org/xbps-install.1>.
+
+- Install a new package:
+
+`xbps-install {{package}}`
+
+- Synchronize and update all packages:
+
+`xbps-install --sync --update`
diff --git a/pages/linux/xbps-query.md b/pages/linux/xbps-query.md
new file mode 100644
index 000000000..2827f1f08
--- /dev/null
+++ b/pages/linux/xbps-query.md
@@ -0,0 +1,25 @@
+# xbps-query
+
+> XBPS utility to query for package and repository information.
+> See also: `xbps`.
+> More information: <https://man.voidlinux.org/xbps-query.1>.
+
+- Search for a package in remote repositories using a regular expression or a keyword (if `--regex` is omitted):
+
+`xbps-query --search {{regular_expression|keyword}} --repository --regex`
+
+- Show information about an installed package:
+
+`xbps-query --show {{package}}`
+
+- Show information about a package in remote repositories:
+
+`xbps-query --show {{package}} --repository`
+
+- List packages registered in the package database:
+
+`xbps-query --list-pkgs`
+
+- List explicitly installed packages (i.e. not automatically installed as dependencies):
+
+`xbps-query --list-manual-pkgs`
diff --git a/pages/linux/xbps-remove.md b/pages/linux/xbps-remove.md
new file mode 100644
index 000000000..e94782099
--- /dev/null
+++ b/pages/linux/xbps-remove.md
@@ -0,0 +1,21 @@
+# xbps-remove
+
+> XBPS utility to remove packages.
+> See also: `xbps`.
+> More information: <https://man.voidlinux.org/xbps-remove.1>.
+
+- Remove a package:
+
+`xbps-remove {{package}}`
+
+- Remove a package and its dependencies:
+
+`xbps-remove --recursive {{package}}`
+
+- Remove orphan packages (installed as dependencies but no longer required by any package):
+
+`xbps-remove --remove-orphans`
+
+- Remove obsolete packages from the cache:
+
+`xbps-remove --clean-cache`
diff --git a/pages/linux/xbps.md b/pages/linux/xbps.md
index ad57f1fec..1c022cb4a 100644
--- a/pages/linux/xbps.md
+++ b/pages/linux/xbps.md
@@ -1,32 +1,17 @@
 # xbps
 
-> The X Binary Package System (or xbps) is the binary package system used by Void Linux.
-> More information: <https://github.com/void-linux/xbps>.
+> The X Binary Package System is the package manager used by Void Linux.
+> For equivalent commands in other package managers, see <https://wiki.archlinux.org/title/Pacman/Rosetta>.
+> More information: <https://docs.voidlinux.org/xbps/index.html>.
 
-- Install packages and synchronize them with the remote repository:
+- View documentation for installing and updating packages:
 
-`xbps-install --sync {{package_name1}} {{package_name2}}`
+`tldr xbps-install`
 
-- Search for a package in the remote repository:
+- View documentation for removing packages:
 
-`xbps-query --repository -s {{package_name}}`
+`tldr xbps-remove`
 
-- Remove a package, leaving all of its dependencies installed:
+- View documentation for querying for package and repository information:
 
-`xbps-remove {{package_name}}`
-
-- Remove a package and all of its dependencies recursively that are not required by other packages:
-
-`xbps-remove --recursive {{package_name}}`
-
-- Synchronize your repository databases and update your system and dependencies:
-
-`xbps-install --sync --update`
-
-- Remove packages that were installed as dependencies and aren't currently needed:
-
-`xbps-remove --remove-orphans`
-
-- Remove obsolete packages from the cache:
-
-`xbps-remove --clean-cache`
+`tldr xbps-query`