summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorLudovic Courtès <ludovic.courtes@inria.fr>2022-09-23 19:04:29 +0200
committerLudovic Courtès <ludo@gnu.org>2022-09-29 22:59:49 +0200
commit28ade1bab207974cce6a014e7187968511fc5526 (patch)
treee0a79545d3460fca04a72c31083f2e74e4c5af53 /doc/guix.texi
parent1bf18818c66fbdd329211e18c85ccd310fa74890 (diff)
downloadguix-28ade1bab207974cce6a014e7187968511fc5526.tar.gz
transformations: '--with-source' now operates in depth.
The '--with-source' option is the first one that was implemented, and
it's the only one that would operate only on leaf packages rather than
traversing the dependency graph.  This change makes it consistent with
the rest of the transformation options.

* guix/transformations.scm (evaluate-source-replacement-specs): New
procedure.
(transform-package-source): Rewrite using it.
* tests/transformations.scm ("options->transformation, with-source, no
matches"): Rewrite since we no longer get a warning.
("options->transformation, with-source, in depth"): New test.
* doc/guix.texi (Package Transformation Options): Adjust examples.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi7
1 files changed, 4 insertions, 3 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 84f7064faf..535c8cdfc3 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12364,14 +12364,15 @@ one provided by the distribution.  The example below downloads
 the @code{ed} package:
 
 @example
-guix build ed --with-source=mirror://gnu/ed/ed-1.7.tar.gz
+guix build ed --with-source=mirror://gnu/ed/ed-1.4.tar.gz
 @end example
 
 As a developer, @option{--with-source} makes it easy to test release
-candidates:
+candidates, and even to test their impact on packages that depend on
+them:
 
 @example
-guix build guile --with-source=../guile-2.0.9.219-e1bb7.tar.xz
+guix build elogind --with-source=@dots{}/shepherd-0.9.0rc1.tar.gz 
 @end example
 
 @dots{} or to build from a checkout in a pristine environment: