[PR PATCH] Manual.md: document renaming a package

[Chocimier <Chocimier@users.noreply.github.com>]

[-- Attachment #1: Type: text/plain, Size: 334 bytes --]

There is a new pull request by Chocimier against master on the void-packages repository

https://github.com/Chocimier/void-packages-org rename
https://github.com/void-linux/void-packages/pull/34875

Manual.md: document renaming a package
None

A patch file from https://github.com/void-linux/void-packages/pull/34875.patch is attached

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: github-pr-rename-34875.patch --]
[-- Type: text/x-diff, Size: 1485 bytes --]

From 4c0d64478e79e4624cbe6ff10574a3cdf59ba64d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Piotr=20W=C3=B3jcik?= <chocimier@tlen.pl>
Date: Wed, 5 Jan 2022 21:33:24 +0100
Subject: [PATCH] Manual.md: document renaming a package

---
 Manual.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Manual.md b/Manual.md
index 2a7a990d37a1..9d6ea75ae341 100644
--- a/Manual.md
+++ b/Manual.md
@@ -42,6 +42,7 @@ packages for XBPS, the `Void Linux` native packaging system.
 	* [Go packages](#pkgs_go)
 	* [Haskell packages](#pkgs_haskell)
 	* [Font packages](#pkgs_font)
+	* [Renaming a package](#pkg_rename)
 	* [Removing a package](#pkg_remove)
 	* [XBPS Triggers](#xbps_triggers)
 		* [appstream-cache](#triggers_appstream_cache)
@@ -1656,6 +1657,18 @@ cache during the install/removal of the package
 - `font_dirs`: which should be set to the directory where the package
 installs its fonts
 
+<a id="pkg_rename"></a>
+### Renaming a package
+
+- Create empty package 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.
+- 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.
+
 <a id="pkg_remove"></a>
 ### Removing a package