01/03: doc: Clarify that package transformations are preserved across upgrades.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 4de829a2230f6b5867207d3f722d393884f65057
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Fri Jan 22 17:29:35 2021 +0100

    doc: Clarify that package transformations are preserved across upgrades.
    
    Reported by pineapples on #guix.
    
    This is a followup to 8e1907a72430aa989125b053573ef0897c480697.
    
    * doc/guix.texi (Invoking guix package): Remove sentence that says that
    package transformations are lost upon upgrading and explicitly say the
    opposite.
---
 doc/guix.texi | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 4a20b3b..7e7c432 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -3576,11 +3576,8 @@ Consequently, this command must be used with care.
 Finally, since @command{guix package} may actually start build
 processes, it supports all the common build options (@pxref{Common Build
 Options}).  It also supports package transformation options, such as
-@option{--with-source} (@pxref{Package Transformation Options}).
-However, note that package transformations are lost when upgrading; to
-preserve transformations across upgrades, you should define your own
-package variant in a Guile module and add it to @env{GUIX_PACKAGE_PATH}
-(@pxref{Defining Packages}).
+@option{--with-source}, and preserves them across upgrades
+(@pxref{Package Transformation Options}).
 
 @node Substitutes
 @section Substitutes