From ad49fc99319d45fe9c91f3b40c35b2d1be413687 Mon Sep 17 00:00:00 2001
From: "K.B.Dharun Krishna" <kbdharunkrishna@gmail.com>
Date: Sun, 8 Oct 2023 16:05:22 +0530
Subject: [PATCH] pkgctl: update page; pkgctl-{build,db-update,release}: add
 page; pkgctl-version: remove page (#10808)

* pkgctl: update page; pkgctl-{build,db-update,release}: add page; pkgctl-version: remove page

---------

Signed-off-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
---
 pages/linux/pkgctl-build.md     | 12 ++++++++++++
 pages/linux/pkgctl-db-update.md |  8 ++++++++
 pages/linux/pkgctl-release.md   |  8 ++++++++
 pages/linux/pkgctl-version.md   |  8 --------
 pages/linux/pkgctl.md           | 30 +++++++++++++++++++++++++++---
 5 files changed, 55 insertions(+), 11 deletions(-)
 create mode 100644 pages/linux/pkgctl-build.md
 create mode 100644 pages/linux/pkgctl-db-update.md
 create mode 100644 pages/linux/pkgctl-release.md
 delete mode 100644 pages/linux/pkgctl-version.md

diff --git a/pages/linux/pkgctl-build.md b/pages/linux/pkgctl-build.md
new file mode 100644
index 000000000..9329d9d4b
--- /dev/null
+++ b/pages/linux/pkgctl-build.md
@@ -0,0 +1,12 @@
+# pkgctl build
+
+> Build packages inside a clean `chroot`.
+> More information: <https://man.archlinux.org/man/pkgctl-build.1>.
+
+- Automatically choose the right build script to build packages in a clean `chroot`:
+
+`pkgctl build`
+
+- Manually build packages in a clean `chroot`:
+
+`pkgctl build --arch {{architecture}} --repo {{repository}} --clean`
diff --git a/pages/linux/pkgctl-db-update.md b/pages/linux/pkgctl-db-update.md
new file mode 100644
index 000000000..d9808e83c
--- /dev/null
+++ b/pages/linux/pkgctl-db-update.md
@@ -0,0 +1,8 @@
+# pkgctl db update
+
+> Update the pacman database as final release step for packages that have been transfered and staged on <https://repos.archlinux.org>.
+> More information: <https://man.archlinux.org/man/pkgctl-db-update.1>.
+
+- Update the binary repository as final release step:
+
+`pkgctl db update`
diff --git a/pages/linux/pkgctl-release.md b/pages/linux/pkgctl-release.md
new file mode 100644
index 000000000..1cf519f8f
--- /dev/null
+++ b/pages/linux/pkgctl-release.md
@@ -0,0 +1,8 @@
+# pkgctl release
+
+> Release step to commit, tag and upload build artifacts.
+> More information: <https://man.archlinux.org/man/pkgctl-release.1>.
+
+- Release a build artifact:
+
+`pkgctl release --repo {{repository}} --message {{commit_message}}`
diff --git a/pages/linux/pkgctl-version.md b/pages/linux/pkgctl-version.md
deleted file mode 100644
index 2293e4a7c..000000000
--- a/pages/linux/pkgctl-version.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# pkgctl version
-
-> Display `pkgctl` version information.
-> More information: <https://man.archlinux.org/man/pkgctl-version.1>.
-
-- Display version:
-
-`pkgctl version`
diff --git a/pages/linux/pkgctl.md b/pages/linux/pkgctl.md
index 0bdf0a2e7..66513ef99 100644
--- a/pages/linux/pkgctl.md
+++ b/pages/linux/pkgctl.md
@@ -1,8 +1,32 @@
 # pkgctl
 
-> Unified command-line devtools frontend for Arch Linux.
+> Unified command-line frontend for Arch Linux devtools.
 > More information: <https://man.archlinux.org/man/pkgctl.1>.
 
-- Download PKGBUILD of a package in a folder named `package_name`:
+- View documentation for authenticating `pkgctl` with services like GitLab:
 
-`pkgctl repo clone --protocol=https {{package_name}}`
+`tldr pkgctl auth`
+
+- View documentation for building packages inside a clean `chroot`:
+
+`tldr pkgctl build`
+
+- View documentation for updating the binary repository as final release step:
+
+`tldr pkgctl db update`
+
+- View documentation for comparing package files using different modes:
+
+`tldr pkgctl diff`
+
+- View documentation for releasing build artifacts:
+
+`tldr pkgctl release`
+
+- View documentation for managing Git packaging repositories and their configuration:
+
+`tldr pkgctl repo`
+
+- Display version:
+
+`pkgctl version`