diff options
author | Ludovic Courtès <ludo@gnu.org> | 2023-10-16 14:32:30 +0200 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2023-10-24 18:06:21 +0200 |
commit | 216f8ffff49c54ad56209c4fd6528f2d80ee8fed (patch) | |
tree | bb93f8600d92454d368bef3319d1dea34cbde1da /doc | |
parent | 37b0ddbcb7d1e664a72e4a76f60d5bac711d3d27 (diff) | |
download | guix-216f8ffff49c54ad56209c4fd6528f2d80ee8fed.tar guix-216f8ffff49c54ad56209c4fd6528f2d80ee8fed.tar.gz |
doc: cookbook: Add cross references to the manual regarding manifests.
* doc/guix-cookbook.texi (The benefits of manifests)
(Reproducible profiles): Add cross-references.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/guix-cookbook.texi | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index 1259f6aac7..b1fe1b932f 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -3987,7 +3987,9 @@ without having to specify the path to a profile. @node The benefits of manifests @subsection The benefits of manifests -Manifests are a convenient way to keep your package lists around and, say, +Manifests let you @dfn{declare} the set of packages you'd like to have +in a profile (@pxref{Writing Manifests,,, guix, GNU Guix Reference Manual}). +They are a convenient way to keep your package lists around and, say, to synchronize them across multiple machines using a version control system. A common complaint about manifests is that they can be slow to install when they @@ -4064,16 +4066,18 @@ To reproduce a profile bit-for-bit, we need two pieces of information: @itemize @item -a manifest, +a manifest (@pxref{Writing Manifests,,, guix, GNU Guix Reference Manual}); @item -a Guix channel specification. +a Guix channel specification (@pxref{Replicating Guix,,, guix, GNU Guix +Reference Manual}). @end itemize Indeed, manifests alone might not be enough: different Guix versions (or different channels) can produce different outputs for a given manifest. You can output the Guix channel specification with @samp{guix describe ---format=channels}. +--format=channels} (@pxref{Invoking guix describe,,, guix, GNU Guix +Reference Manual}). Save this to a file, say @samp{channel-specs.scm}. On another computer, you can use the channel specification file and the manifest |