summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2022-10-14 01:02:14 +0100
committerSam James <sam@gentoo.org>2022-10-14 01:04:46 +0100
commit5493c697dd05162ef850be8d0476fa09c3e6d623 (patch)
tree698b4b47b7de0a67296331b0851a1f2e9ba93348 /sys-apps
parentsys-apps/man-pages: use now-released upstream tarball for 6.00 (diff)
downloadgentoo-5493c697dd05162ef850be8d0476fa09c3e6d623.tar.gz
gentoo-5493c697dd05162ef850be8d0476fa09c3e6d623.tar.bz2
gentoo-5493c697dd05162ef850be8d0476fa09c3e6d623.zip
sys-apps/man-pages: add maintenance notes
Based on a conversation with Alex upstream. Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'sys-apps')
-rw-r--r--sys-apps/man-pages/man-pages-6.00.ebuild20
-rw-r--r--sys-apps/man-pages/man-pages-9999.ebuild16
2 files changed, 28 insertions, 8 deletions
diff --git a/sys-apps/man-pages/man-pages-6.00.ebuild b/sys-apps/man-pages/man-pages-6.00.ebuild
index f2cbce53efb1..51dc629de30e 100644
--- a/sys-apps/man-pages/man-pages-6.00.ebuild
+++ b/sys-apps/man-pages/man-pages-6.00.ebuild
@@ -3,15 +3,23 @@
EAPI=8
-# Sometimes there's no dist tarball available post-release and upstream
-# encourage distros to make their own. Set to 1 if none is available, 0 otherwise.
+# Maintenance notes:
+# - Upstream are very friendly, do approach them if have any questions;
+#
+# - It's considered fine (and somewhat encouraged) for us to make snapshots
+# if we want specific fixes, perhaps aligned with newer kernels, glibc, etc.
+# Just generate it with 'make dist'. We can set DISTVERSION if we want a vanity
+# name or if the comit hash is too long;
+#
+# - If we do use a snapshot, *don't* grab it directly from git and use it
+# raw in the ebuild. Use 'make dist' as above;
+#
+# - Sometimes there's no dist tarball available post-release and upstream
+# encourage distros to make their own. Set MAN_PAGES_GENTOO_DIST to 1 if none is
+# available, 0 otherwise.
MAN_PAGES_GENTOO_DIST=0
GENTOO_PATCH=2
-if [[ ${PV} != 6.00 ]] ; then
- die "Please use 9999 as a template for the next bump for SRC_URI fixes."
-fi
-
DESCRIPTION="A somewhat comprehensive collection of Linux man pages"
HOMEPAGE="https://www.kernel.org/doc/man-pages/"
if [[ ${PV} == 9999 ]] ; then
diff --git a/sys-apps/man-pages/man-pages-9999.ebuild b/sys-apps/man-pages/man-pages-9999.ebuild
index ee0ddfecfa15..4da3d9ecbf1d 100644
--- a/sys-apps/man-pages/man-pages-9999.ebuild
+++ b/sys-apps/man-pages/man-pages-9999.ebuild
@@ -3,8 +3,20 @@
EAPI=8
-# Sometimes there's no dist tarball available post-release and upstream
-# encourage distros to make their own. Set to 1 if none is available, 0 otherwise.
+# Maintenance notes:
+# - Upstream are very friendly, do approach them if have any questions;
+#
+# - It's considered fine (and somewhat encouraged) for us to make snapshots
+# if we want specific fixes, perhaps aligned with newer kernels, glibc, etc.
+# Just generate it with 'make dist'. We can set DISTVERSION if we want a vanity
+# name or if the comit hash is too long;
+#
+# - If we do use a snapshot, *don't* grab it directly from git and use it
+# raw in the ebuild. Use 'make dist' as above;
+#
+# - Sometimes there's no dist tarball available post-release and upstream
+# encourage distros to make their own. Set MAN_PAGES_GENTOO_DIST to 1 if none is
+# available, 0 otherwise.
MAN_PAGES_GENTOO_DIST=0
GENTOO_PATCH=2