1 files changed, 8 insertions, 7 deletions

diff --git a/doc/guix.texi b/doc/guix.texi
index d974a5cdf24..7950843c3c2 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -15733,13 +15733,6 @@ guix import npm-binary buffer-crc32@@1.0.0
 @end example
 
 @quotation Note
-Generated package expressions skip the build step of the
-@code{node-build-system}. As such, generated package expressions often
-refer to transpiled or generated files, instead of being built from
-source.
-@end quotation
-
-@quotation Note
 Currently, the generated package definition contains a phase to delete
 the development dependencies (@code{devDependencies}) from the
 @file{package.json} file, if there are such dependencies, to reduce the
@@ -15756,6 +15749,14 @@ Additional options include:
 Traverse the dependency graph of the given upstream package recursively
 and generate package expressions for all those packages that are not yet
 in Guix.
+@item --binary
+@itemx -b
+Import a binary NPM package.  This means preferring the use of a
+@url{https://registry.npmjs.org/} source origin, which typically bundles
+pre-built artifacts, along removing the @code{build} phase to avoid
+rebuilding such artifacts from source.  This should only be used as a
+last resort, as it is preferable building everything from source, to
+preserve referential transparency and the chain of trust.
 @end table
 
 @item opam