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

@@ -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`

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`

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}}`

pages/linux/pkgctl-version.md

@@ -1,8 +0,0 @@
-# pkgctl version
-
-> Display `pkgctl` version information.
-> More information: <https://man.archlinux.org/man/pkgctl-version.1>.
-
-- Display version:
-
-`pkgctl version`

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`