[gentoo-commits] repo/gentoo:master commit in: sys-apps/man-pages/

["Sam James" <sam@gentoo.org>]

commit:     5493c697dd05162ef850be8d0476fa09c3e6d623
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Fri Oct 14 00:02:14 2022 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Fri Oct 14 00:04:46 2022 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=5493c697

sys-apps/man-pages: add maintenance notes

Based on a conversation with Alex upstream.

Signed-off-by: Sam James <sam <AT> gentoo.org>

 sys-apps/man-pages/man-pages-6.00.ebuild | 20 ++++++++++++++------
 sys-apps/man-pages/man-pages-9999.ebuild | 16 ++++++++++++++--
 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