From 9474e53630c36317af7cd222e97a9e516e6e437f Mon Sep 17 00:00:00 2001 From: classabbyamp Date: Tue, 30 Dec 2025 20:38:56 -0500 Subject: [PATCH] Manual: adjust package renaming procedure --- Manual.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/Manual.md b/Manual.md index d382c360d03..e85cfb57d28 100644 --- a/Manual.md +++ b/Manual.md @@ -1764,14 +1764,13 @@ installs its fonts ### Renaming a package -- Create empty package of old name, depending on new package. This is +- Create an empty subpackage of old name, depending on new package. This is necessary to provide updates to systems where old package is already -installed. This should be a subpackage of new one, except when version -number of new package decreased: then create a separate template using -old version and increased revision. +installed. This should be a subpackage of new one. When the version +number of the transitional package decreases, add `reverts` entries to it. +- append `" (transitional dummy package)"` to the package's `short_desc`. - Edit references to package in other templates and common/shlibs. -- Don't set `replaces=`, it can result in removing both packages from -systems by xbps. +- Set `replaces="old-name>=0` on the new package. ### Removing a package