From d65a054bc530b6a12466141d27392c3b3cd36757 Mon Sep 17 00:00:00 2001
From: Hugo Osvaldo Barrera <hugo@whynothugo.nl>
Date: Sun, 19 Nov 2023 23:54:06 +0800
Subject: [PATCH] Add a man page for abump

---
 Makefile    |  2 +-
 abump.1.scd | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+), 1 deletion(-)
 create mode 100644 abump.1.scd

diff --git a/Makefile b/Makefile
index d3922de..9bf4e71 100644
--- a/Makefile
+++ b/Makefile
@@ -11,7 +11,7 @@ SCRIPTS		:= abuild abuild-keygen abuild-sign newapkbuild \
 		   abump apkgrel buildlab apkbuild-cpan apkbuild-pypi checkapk \
 		   apkbuild-gem-resolver
 USR_BIN_FILES	:= $(SCRIPTS) abuild-tar abuild-gzsplit abuild-sudo abuild-fetch abuild-rmtemp
-MAN_1_PAGES	:= newapkbuild.1 abuild.1
+MAN_1_PAGES	:= newapkbuild.1 abuild.1 abump.1
 MAN_5_PAGES	:= APKBUILD.5
 SAMPLES		:= sample.APKBUILD sample.initd sample.confd \
 		sample.pre-install sample.post-install
diff --git a/abump.1.scd b/abump.1.scd
new file mode 100644
index 0000000..0e3fdc4
--- /dev/null
+++ b/abump.1.scd
@@ -0,0 +1,53 @@
+abump(1)
+
+# NAME
+
+*abump* - bump pkgver in an APKBUILD file
+
+# SYNOPSIS
+
+*abump* [-s _CVE-1_,...] [-f _ISSUE_] [-k|--keep] _PKGNAME-1.2.3_
+
+# DESCRIPTION
+
+*abump* updates the *pkgver* in an APKBUILD file, updates its checksums,
+rebuilds it, and finally creates a new commit commit with the changes resulting.
+
+*abump* operates looks for the specified package in nested directories inside
+the current working, assuming a layout like that of the aports repository.
+
+# OPTIONS
+
+*-s, --security CVE1,...*
+	Include CVE in the *secfixes* comment section.
+
+*-f, --fixes ISSUE*
+	Include *Fixes #ISSUE* in the commit message. This will close the upstream
+	issue when the commit is merged into the aports master branch.
+
+*-k, --keep*
+	Keep existing packages.
+
+*-h, --help*
+	Print help information and exit.
+
+# ENVIRONMENT
+
+APORTSDIR
+	Force operating on an alternate directory.
+
+# EXAMPLES
+
+```
+abump mml-1.0.0
+abump glibmm2.68-2.78.0
+abump telegram-desktop-4.11.8
+```
+
+# SEE ALSO
+
+abuild(1), apkgrel(1), newapkbuild(1), APKBUILD(5), apk(8).
+
+# AUTHORS
+
+Natanael Copa <_ncopa@alpinelinux.org_> and open source contributors.