From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <gentoo-commits+bounces-1368768-garchives=archives.gentoo.org@lists.gentoo.org> 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 B11C615808C for <garchives@archives.gentoo.org>; Fri, 18 Feb 2022 18:19:59 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 78CB1E0729; Fri, 18 Feb 2022 18:19:58 +0000 (UTC) Received: from smtp.gentoo.org (smtp.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 64273E0729 for <gentoo-commits@lists.gentoo.org>; Fri, 18 Feb 2022 18:19:58 +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 3DBCD343572 for <gentoo-commits@lists.gentoo.org>; Fri, 18 Feb 2022 18:19:57 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 7C5DD2DD for <gentoo-commits@lists.gentoo.org>; Fri, 18 Feb 2022 18:19:55 +0000 (UTC) From: "Sam James" <sam@gentoo.org> 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" <sam@gentoo.org> Message-ID: <1645208364.5e91e851b96bc43a952870403194abcd7d7c52dd.sam@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: general-concepts/portage-cache/ X-VCS-Repository: proj/devmanual X-VCS-Files: general-concepts/portage-cache/text.xml X-VCS-Directories: general-concepts/portage-cache/ X-VCS-Committer: sam X-VCS-Committer-Name: Sam James X-VCS-Revision: 5e91e851b96bc43a952870403194abcd7d7c52dd X-VCS-Branch: master Date: Fri, 18 Feb 2022 18:19:55 +0000 (UTC) Precedence: bulk List-Post: <mailto:gentoo-commits@lists.gentoo.org> List-Help: <mailto:gentoo-commits+help@lists.gentoo.org> List-Unsubscribe: <mailto:gentoo-commits+unsubscribe@lists.gentoo.org> List-Subscribe: <mailto:gentoo-commits+subscribe@lists.gentoo.org> List-Id: Gentoo Linux mail <gentoo-commits.gentoo.org> X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 70a671eb-4369-4eae-a528-331d6cfb49c9 X-Archives-Hash: 1501b2ade00270d8081233341d63823d commit: 5e91e851b96bc43a952870403194abcd7d7c52dd Author: Sam James <sam <AT> gentoo <DOT> org> AuthorDate: Mon Jan 24 04:15:19 2022 +0000 Commit: Sam James <sam <AT> gentoo <DOT> org> CommitDate: Fri Feb 18 18:19:24 2022 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=5e91e851 general-concepts/portage-cache: add "metadata invariance" term Signed-off-by: Sam James <sam <AT> gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/269 Signed-off-by: Sam James <sam <AT> gentoo.org> general-concepts/portage-cache/text.xml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/general-concepts/portage-cache/text.xml b/general-concepts/portage-cache/text.xml index a1394af..857cf6b 100644 --- a/general-concepts/portage-cache/text.xml +++ b/general-concepts/portage-cache/text.xml @@ -11,6 +11,11 @@ these variables must be either static or generated using only unchanging 'version / name' variables (<c>P</c>, <c>PN</c>, <c>PV</c>, <c>PR</c>, <c>PVR</c> and <c>PF</c>). </p> +<p> +The cache, when generated, must be identical independent of the used machine +or environment. This concept is referred to as <e>metadata invariance</e>. +</p> + <p> So, the following will not work: </p>