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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id EEB4E138350 for ; Thu, 23 Jan 2020 08:24:54 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 2726DE07F9; Thu, 23 Jan 2020 08:24:54 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 0AE7DE07F9 for ; Thu, 23 Jan 2020 08:24:54 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id C4B8E34E35D for ; Thu, 23 Jan 2020 08:24:52 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 611413E for ; Thu, 23 Jan 2020 08:24:50 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1579767728.4b68e4039e4f0b1a484cac97c3a44c97e604b179.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: ebuild-maintenance/package-moves/ X-VCS-Repository: proj/devmanual X-VCS-Files: ebuild-maintenance/package-moves/text.xml X-VCS-Directories: ebuild-maintenance/package-moves/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 4b68e4039e4f0b1a484cac97c3a44c97e604b179 X-VCS-Branch: master Date: Thu, 23 Jan 2020 08:24:50 +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: 815eea23-3df5-4113-b70f-184c79f7ff21 X-Archives-Hash: 87b515c5b581fc07eb76404fb966a79c commit: 4b68e4039e4f0b1a484cac97c3a44c97e604b179 Author: Michał Górny gentoo org> AuthorDate: Mon Dec 30 17:10:32 2019 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Thu Jan 23 08:22:08 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=4b68e403 ebuild-maintenance/package-and-slot-moves: Add extra warnings Since people are frequently getting moves wrong, try to point out a few important limitations. Signed-off-by: Michał Górny gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> ebuild-maintenance/package-moves/text.xml | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/ebuild-maintenance/package-moves/text.xml b/ebuild-maintenance/package-moves/text.xml index 0d20667..a3a45c2 100644 --- a/ebuild-maintenance/package-moves/text.xml +++ b/ebuild-maintenance/package-moves/text.xml @@ -5,9 +5,29 @@

-This chapter describes the use of package and slot moves. +This chapter describes the use of package and slot moves. The package update +mechanism is a powerful tool, and needs to be used with caution. In particular, +the following must be noted:

+
    +
  1. + Updates are not one-shot operations and they are not stateful. All + updates can be reapplied multiple times to the same system, and all old + updates are applied to fresh Gentoo installations. +
    2. +
  2. + Once an update entry is created, the old package name (or slot) cannot be + reused. Attempting to reuse it will cause updates to apply again, + to the reused name. This also means that updates cannot be undone. +
    3. +
  3. + Updates can only perform one-to-one moves. They cannot be used to merge + packages. Attempting to move two or more packages into a single name may + cause serious problems for users. +
    4. +
+