diff --git a/doc/guix.texi b/doc/guix.texi
index 3e335306f1..c49e51b72e 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -8210,6 +8210,9 @@ Add @var{package}s to the front of the input list.
 
 @item (append @var{package}@dots{})
 Add @var{package}s to the end of the input list.
+
+@item (replace @var{name} @var{replacement})
+Replace the package called @var{name} with @var{replacement}.
 @end table
 
 The example below removes the GMP and ACL inputs of Coreutils and adds