From faee634b5ae6a3033671e6bca07fc5ed1bc699c8 Mon Sep 17 00:00:00 2001
From: Chris Marusich
Date: Wed, 2 Nov 2016 20:38:26 -0700
Subject: [PATCH] doc: Add details to the 'guix system switch-generation'
section.
* doc/guix.texi (Invoking guix system) : Mention the fact
that we also switch the profile to an existing generation (i.e., flip
symlinks), and that we do it atomically.
---
doc/guix.texi | 22 ++++++++++++----------
1 file changed, 12 insertions(+), 10 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index fbcf3b0..b8cb01f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11180,11 +11180,12 @@ once @command{reconfigure} has completed.
@end quotation
@item switch-generation
-Switch to an existing system generation. This action rearranges the
-existing GRUB menu entries. It makes the menu entry for the target
-system generation the default, and it moves the entries for the other
-system generations to a submenu. The next time the system boots, it
-will use the specified system generation.
+Switch to an existing system generation. This action atomically
+switches the system profile to the specified system generation. It also
+rearranges the system's existing GRUB menu entries. It makes the menu
+entry for the specified system generation the default, and it moves the
+entries for the other generations to a submenu. The next time the
+system boots, it will use the specified system generation.
The target generation can be specified explicitly by its generation
number. For example, the following invocation would switch to system
@@ -11205,11 +11206,12 @@ prevent it from being parsed as an option. For example:
guix system switch-generation -- -1
@end example
-Currently, the effect of invoking this action is only to rearrange the
-GRUB menu entries. To actually start using the target system
-generation, you must reboot after running this action. In the future,
-it will be updated to do the same things as @command{reconfigure}, like
-activating and deactivating services.
+Currently, the effect of invoking this action is @emph{only} to switch
+the system profile to an existing generation and rearrange the GRUB menu
+entries. To actually start using the target system generation, you must
+reboot after running this action. In the future, it will be updated to
+do the same things as @command{reconfigure}, like activating and
+deactivating services.
This action will fail if the specified generation does not exist.
--
2.10.2