From e1f4daa6ef59a79e61bd25c86a6adcbd0217f5ba Mon Sep 17 00:00:00 2001
From: Angad Singh Grover <127680876+angadsgrover@users.noreply.github.com>
Date: Mon, 11 Nov 2024 22:03:04 +0800
Subject: [PATCH] pacman-s: add alias page; pacman-sync: update page (#14658)

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
---
 pages/linux/pacman-s.md    |  7 +++++++
 pages/linux/pacman-sync.md | 28 ++++++++++++++--------------
 2 files changed, 21 insertions(+), 14 deletions(-)
 create mode 100644 pages/linux/pacman-s.md

diff --git a/pages/linux/pacman-s.md b/pages/linux/pacman-s.md
new file mode 100644
index 0000000000..2f5788557d
--- /dev/null
+++ b/pages/linux/pacman-s.md
@@ -0,0 +1,7 @@
+# pacman -S
+
+> This command is an alias of `pacman --sync`.
+
+- View documentation for the original command:
+
+`tldr pacman-sync`
diff --git a/pages/linux/pacman-sync.md b/pages/linux/pacman-sync.md
index 991a8e0388..11fdc7e4d3 100644
--- a/pages/linux/pacman-sync.md
+++ b/pages/linux/pacman-sync.md
@@ -6,32 +6,32 @@
 
 - Install a new package:
 
-`sudo pacman --sync {{package}}`
+`sudo pacman -S {{package}}`
 
-- Synchronize and update all packages (add `--downloadonly` to download the packages and not update them):
+- [S]ynchronize and refresh ([y]) the package database along with a sys[u]pgrade (add `--downloadonly` to only download the packages and not update them):
 
-`sudo pacman --sync --refresh --sysupgrade`
+`sudo pacman -Syu`
 
-- Update all packages and install a new one without prompting:
+- Update and [u]pgrade all packages and install a new one without prompting:
 
-`sudo pacman --sync --refresh --sysupgrade --noconfirm {{package}}`
+`sudo pacman -Syu --noconfirm {{package}}`
 
-- Search the package database for a regular expression or keyword:
+- Search ([s]) the package database for a regular expression or keyword:
 
-`pacman --sync --search "{{search_pattern}}"`
+`pacman -Ss "{{search_pattern}}"`
 
-- Display information about a package:
+- Display [i]nformation about a package:
 
-`pacman --sync --info {{package}}`
+`pacman -Si {{package}}`
 
 - Overwrite conflicting files during a package update:
 
-`sudo pacman --sync --refresh --sysupgrade --overwrite {{path/to/file}}`
+`sudo pacman -Syu --overwrite {{path/to/file}}`
 
-- Synchronize and update all packages, but ignore a specific package (can be used more than once):
+- [S]ynchronize and [u]pdate all packages, but ignore a specific package (can be used more than once):
 
-`sudo pacman --sync --refresh --sysupgrade --ignore {{package}}`
+`sudo pacman -Syu --ignore {{package}}`
 
-- Remove not installed packages and unused repositories from the cache (use two `--clean` flags to clean all packages):
+- Remove not installed packages and unused repositories from the cache (use the flags `Scc` to [c]lean all packages):
 
-`sudo pacman --sync --clean`
+`sudo pacman -Sc`