From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id EC47D158021 for ; Fri, 14 Oct 2022 00:05:25 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3EA5CE086F; Fri, 14 Oct 2022 00:05:24 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 2B17EE086F for ; Fri, 14 Oct 2022 00:05:23 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id DD1DA33BEF2 for ; Fri, 14 Oct 2022 00:05:22 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 22F65617 for ; Fri, 14 Oct 2022 00:05:21 +0000 (UTC) From: "Sam James" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Sam James" Message-ID: <1665705886.5493c697dd05162ef850be8d0476fa09c3e6d623.sam@gentoo> Subject: [gentoo-commits] repo/gentoo:master commit in: sys-apps/man-pages/ X-VCS-Repository: repo/gentoo X-VCS-Files: sys-apps/man-pages/man-pages-6.00.ebuild sys-apps/man-pages/man-pages-9999.ebuild X-VCS-Directories: sys-apps/man-pages/ X-VCS-Committer: sam X-VCS-Committer-Name: Sam James X-VCS-Revision: 5493c697dd05162ef850be8d0476fa09c3e6d623 X-VCS-Branch: master Date: Fri, 14 Oct 2022 00:05:21 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 9d58d133-7271-469f-9578-dadff208dfc9 X-Archives-Hash: bfcdfb347f3d078ce3800ab396326cb6 commit: 5493c697dd05162ef850be8d0476fa09c3e6d623 Author: Sam James gentoo org> AuthorDate: Fri Oct 14 00:02:14 2022 +0000 Commit: Sam James gentoo 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 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