From 9d2acad21faae3e772db4fb7469dc36637e0ee48 Mon Sep 17 00:00:00 2001
From: You Gao <djx3rn@virginia.edu>
Date: Thu, 26 Dec 2024 13:17:15 -0500
Subject: [PATCH] pacman-u: add alias page; pacman-upgrade: update page
 (#15179)

---
 pages/linux/pacman-u.md       |  7 +++++++
 pages/linux/pacman-upgrade.md | 16 ++++++++--------
 2 files changed, 15 insertions(+), 8 deletions(-)
 create mode 100644 pages/linux/pacman-u.md

diff --git a/pages/linux/pacman-u.md b/pages/linux/pacman-u.md
new file mode 100644
index 0000000000..fa2e3c11a5
--- /dev/null
+++ b/pages/linux/pacman-u.md
@@ -0,0 +1,7 @@
+# pacman -U
+
+> This command is an alias of `pacman --upgrade`.
+
+- View documentation for the original command:
+
+`tldr pacman upgrade`
diff --git a/pages/linux/pacman-upgrade.md b/pages/linux/pacman-upgrade.md
index faecbbffd0..fa1ea0f03a 100644
--- a/pages/linux/pacman-upgrade.md
+++ b/pages/linux/pacman-upgrade.md
@@ -6,24 +6,24 @@
 
 - Install one or more packages from files:
 
-`sudo pacman --upgrade {{path/to/package1.pkg.tar.zst}} {{path/to/package2.pkg.tar.zst}}`
+`sudo pacman -U {{path/to/package1.pkg.tar.zst}} {{path/to/package2.pkg.tar.zst}}`
 
 - Install a package without prompting:
 
-`sudo pacman --upgrade --noconfirm {{path/to/package.pkg.tar.zst}}`
+`sudo pacman -U --noconfirm {{path/to/package.pkg.tar.zst}}`
 
 - Overwrite conflicting files during a package installation:
 
-`sudo pacman --upgrade --overwrite {{path/to/file}} {{path/to/package.pkg.tar.zst}}`
+`sudo pacman -U --overwrite {{path/to/file}} {{path/to/package.pkg.tar.zst}}`
 
-- Install a package, skipping the dependency version checks:
+- Install a package, skipping the dependency [(d)] version checks:
 
-`sudo pacman --upgrade --nodeps {{path/to/package.pkg.tar.zst}}`
+`sudo pacman -Ud {{path/to/package.pkg.tar.zst}}`
 
-- List packages that would be affected (does not install any packages):
+- Fetch and [p]rint packages that would be affected by upgrade (does not install any packages):
 
-`pacman --upgrade --print {{path/to/package.pkg.tar.zst}}`
+`pacman -Up {{path/to/package.pkg.tar.zst}}`
 
 - Display help:
 
-`pacman --upgrade --help`
+`pacman -U --help`