From 7aa21e2f07fe7f7f3084761afa2bc333f6ee4f6e Mon Sep 17 00:00:00 2001
From: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
Date: Mon, 15 Jan 2024 01:46:02 -0300
Subject: [PATCH] urpmi: add pages (#12025)
---
pages/linux/urpme.md | 17 ++++++++++++++++
pages/linux/urpmf.md | 21 ++++++++++++++++++++
pages/linux/urpmi-addmedia.md | 22 +++++++++++++++++++++
pages/linux/urpmi-removemedia.md | 18 +++++++++++++++++
pages/linux/urpmi-update.md | 22 +++++++++++++++++++++
pages/linux/urpmi.md | 25 ++++++++++++++++++++++++
pages/linux/urpmq.md | 33 ++++++++++++++++++++++++++++++++
7 files changed, 158 insertions(+)
create mode 100644 pages/linux/urpme.md
create mode 100644 pages/linux/urpmf.md
create mode 100644 pages/linux/urpmi-addmedia.md
create mode 100644 pages/linux/urpmi-removemedia.md
create mode 100644 pages/linux/urpmi-update.md
create mode 100644 pages/linux/urpmi.md
create mode 100644 pages/linux/urpmq.md
diff --git a/pages/linux/urpme.md b/pages/linux/urpme.md
new file mode 100644
index 0000000000..2498732fe9
--- /dev/null
+++ b/pages/linux/urpme.md
@@ -0,0 +1,17 @@
+# urpme
+
+> Uninstall packages in Mageia.
+> See also: `urpmi`, `urpmi.update`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpme>.
+
+- Uninstall a package:
+
+`sudo urpme {{package}}`
+
+- Uninstall orphan packages (Note: use it with caution as it might unintentionally remove important packages):
+
+`sudo urpme --auto-orphans`
+
+- Uninstall a package and its dependencies:
+
+`sudo urpme --auto-orphans {{package}}`
diff --git a/pages/linux/urpmf.md b/pages/linux/urpmf.md
new file mode 100644
index 0000000000..231ef99bf5
--- /dev/null
+++ b/pages/linux/urpmf.md
@@ -0,0 +1,21 @@
+# urpmf
+
+> Find files in packages and query information about them in Mageia.
+> See also: `urpmi`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmi.update`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmi.removemedia>.
+
+- Search for packages that contain a file:
+
+`urpmf {{filename}}`
+
+- Search for packages that contain both a keyword [a]nd another in their summaries:
+
+`urpmf --summary {{keyword1}} -a {{keyword2}}`
+
+- Search for packages that contain a keyword [o]r another in their descriptions:
+
+`urpmf --description {{keyword1}} -o {{keyword2}}`
+
+- Search for packages that do not contain a keyword in their name ignoring case distinction using "|" as the [F]ield separator (":" by default):
+
+`urpmf --description ! {{keyword}} -F'|'`
diff --git a/pages/linux/urpmi-addmedia.md b/pages/linux/urpmi-addmedia.md
new file mode 100644
index 0000000000..a283b37b86
--- /dev/null
+++ b/pages/linux/urpmi-addmedia.md
@@ -0,0 +1,22 @@
+# urpmi.addmedia
+
+> Add media in Mageia.
+> NOTE: Mageia documentation uses medium and repository as synonymous.
+> See also: `urpmi`, `urpmi.update`, `urpme`, `urpmi.removemedia`, `urpmf`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpme>.
+
+- Add a medium:
+
+`sudo urpmi.addmedia {{medium}} {{ftp://ftp.site.com/path/to/Mageia/RPMS}}`
+
+- Add a medium from a hard drive (run `genhdlist2` in the directory first):
+
+`sudo urpmi.addmedia --distrib HD file:/{{/path/to/repo}}`
+
+- Add important media from a chosen mirror:
+
+`sudo urpmi.addmedia --distrib ftp://{{mirror_website}/mirror/mageia/distrib/{{version}}/{{arch}}`
+
+- Automatically select mirrors from a mirror list:
+
+`sudo urpmi.addmedia --distrib --mirrorlist {{mirrorlist}}`
diff --git a/pages/linux/urpmi-removemedia.md b/pages/linux/urpmi-removemedia.md
new file mode 100644
index 0000000000..8c1d1241bc
--- /dev/null
+++ b/pages/linux/urpmi-removemedia.md
@@ -0,0 +1,18 @@
+# urpmi.removemedia
+
+> Remove media in Mageia.
+> NOTE: Mageia documentation uses medium and repository as synonymous.
+> See also: `urpmi`, `urpme`, `urpmi.addmedia`, `urpmi.update`, `urpmf`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmi.removemedia>.
+
+- Remove a medium:
+
+`sudo urpmi.removemedia {{medium}}`
+
+- Remove all media:
+
+`sudo urpmi.removemedia -a`
+
+- Remove media fuzz[y] matching on media names:
+
+`sudo urpmi.removemedia -y {{keyword}}`
diff --git a/pages/linux/urpmi-update.md b/pages/linux/urpmi-update.md
new file mode 100644
index 0000000000..b5dd15b94e
--- /dev/null
+++ b/pages/linux/urpmi-update.md
@@ -0,0 +1,22 @@
+# urpmi.update
+
+> Update the list of packages from a package repository in Mageia.
+> NOTE: Mageia documentation uses medium and repository as synonymous.
+> See also: `urpmi`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmi.update>.
+
+- Update all enabled media:
+
+`urpmi.update -a`
+
+- Update specific media (including disabled media):
+
+`urpmi.update {{medium1 medium2 ...}}`
+
+- Update all media that contain a specific keyword:
+
+`urpmi.update {{keyword}}`
+
+- Update all configured media:
+
+`urpmi.update e`
diff --git a/pages/linux/urpmi.md b/pages/linux/urpmi.md
new file mode 100644
index 0000000000..ab77945497
--- /dev/null
+++ b/pages/linux/urpmi.md
@@ -0,0 +1,25 @@
+# urpmi
+
+> Install packages in Mageia.
+> See also: `urpm.update`, `urpme`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpmq`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmi>.
+
+- Install a package from the repository or from a local RPM file:
+
+`sudo urpmi {{package|path/to/file.rpm}}`
+
+- Download a package without installing it:
+
+`urpmi --no-install {{package}}`
+
+- Update all installed packages (run `urpmi.update -a` to get the available updates):
+
+`sudo urpmi --auto-select`
+
+- Update a package of one or more machines on the network according to `/etc/urpmi/parallel.cfg`:
+
+`sudo urpmi --parallel local {{package}}`
+
+- Mark all orphaned packages as manually installed:
+
+`sudo urpmi $(urpmq --auto-orphans -f)`
diff --git a/pages/linux/urpmq.md b/pages/linux/urpmq.md
new file mode 100644
index 0000000000..5af1210fcb
--- /dev/null
+++ b/pages/linux/urpmq.md
@@ -0,0 +1,33 @@
+# urpmq
+
+> Query information about packages and media in Mageia.
+> See also: `urpmi`, `urpmi.update`, `urpmi.addmedia`, `urpmi.removemedia`, `urpmf`, `urpme`.
+> More information: <https://wiki.mageia.org/en/URPMI#urpmq>.
+
+- Display information about an installable package:
+
+`urpmq -i {{package}}`
+
+- Display direct dependencies of a package:
+
+`urpmq --requires {{package}}`
+
+- Display direct and indirect dependencies of a package:
+
+`urpmq --requires-recursive {{package}}`
+
+- List the not installed packages needed for an RPM file with their sources:
+
+`sudo urpmq --requires-recursive -m --sources {{path/to/file.rpm}}`
+
+- List all configured media with their URLs, including inactive media:
+
+`urpmq --list-media --list-url`
+
+- Search for a package printing [g]roup, version and [r]elease:
+
+`urpmq -g -r --fuzzy {{keyword}}`
+
+- Search for a package with using its exact name:
+
+`urpmq -g -r {{package}}`