From mboxrd@z Thu Jan 1 00:00:00 1970 From: Chris Marusich Subject: One more patch: doc: Add details to the 'guix system switch-generation' section. Date: Wed, 02 Nov 2016 21:51:56 -0700 Message-ID: <8737j9dv2r.fsf_-_@gmail.com> References: <87d1ihscmr.fsf@gnu.org> <20161102054815.11253-1-cmmarusich@gmail.com> <20161102054815.11253-6-cmmarusich@gmail.com> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53098) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1c2A0P-0006C3-3f for guix-devel@gnu.org; Thu, 03 Nov 2016 00:52:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1c2A0O-0007oa-AM for guix-devel@gnu.org; Thu, 03 Nov 2016 00:52:01 -0400 Received: from mail-pf0-x234.google.com ([2607:f8b0:400e:c00::234]:36230) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1c2A0O-0007oW-3U for guix-devel@gnu.org; Thu, 03 Nov 2016 00:52:00 -0400 Received: by mail-pf0-x234.google.com with SMTP id 189so24472475pfz.3 for ; Wed, 02 Nov 2016 21:51:59 -0700 (PDT) Received: from garuda ([2601:602:9d02:4725:4e0f:6eff:fef6:70b9]) by smtp.gmail.com with ESMTPSA id m129sm8509747pfm.13.2016.11.02.21.51.58 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 02 Nov 2016 21:51:58 -0700 (PDT) In-Reply-To: <20161102054815.11253-6-cmmarusich@gmail.com> (cmmarusich@gmail.com's message of "Tue, 1 Nov 2016 22:48:15 -0700") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Hi, I realized I forgot to include some info in the manual, so here's one more patch to add the missing info. Thank you, =2D-=20 Chris --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-Add-details-to-the-guix-system-switch-generation.patch Content-Transfer-Encoding: quoted-printable From=20faee634b5ae6a3033671e6bca07fc5ed1bc699c8 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. =2D-- 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 =2D-- a/doc/guix.texi +++ b/doc/guix.texi @@ -11180,11 +11180,12 @@ once @command{reconfigure} has completed. @end quotation =20 @item switch-generation =2DSwitch to an existing system generation. This action rearranges the =2Dexisting GRUB menu entries. It makes the menu entry for the target =2Dsystem generation the default, and it moves the entries for the other =2Dsystem generations to a submenu. The next time the system boots, it =2Dwill 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. =20 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 e= xample: guix system switch-generation -- -1 @end example =20 =2DCurrently, the effect of invoking this action is only to rearrange the =2DGRUB menu entries. To actually start using the target system =2Dgeneration, you must reboot after running this action. In the future, =2Dit will be updated to do the same things as @command{reconfigure}, like =2Dactivating 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. =20 This action will fail if the specified generation does not exist. =20 =2D-=20 2.10.2 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJYGsJtAAoJEN1AmhXYIkadVC0QAII3GBK1M2x2hqEGDIh7naoI pfp5xp8VykRSo7EcvqiozRa7RN8p57hwTtqWTu33TqxfgJroiN8LXcv4tvIx8/il 3uQ034Lsj50NxxgN/P+H0TOSnS5LPbMi7O/corz3SVZgzhpOoDn+TJFWPU0jjVlG BVFy+aiCLwQJq8oQRB8g2BqasDLYrWd15WRxniyASujbcOT8ry6H2mjZtobY4Fcg gZhEyej+gMhNP/1uViLayRXh/LCVzk9DL3q0KNmSLYn/DSxUUM7wkimJ1+CZXYOD hEuHnDwTM+M30ZO2hJyjTOlfwUVYombrJCHmcxarDCXKwZyTVE7bn1YOvF5TqzTK LaEZma4KV+ums2NNdnh9NBhz0QK3UOaQMfOqmJiku7TJeRTKNp/KHgkuuUOE/46F oeX+F/UN+BORnJFRsOlz+oqvwoAiLnNS8h7bs64ffelHvkm3lZhl6RpGAvIZPbtY DZgn18tNFuxHeAqveAUhQDngAC8Hq1LnfsR5Ez+Ig4XlhiTbKA2ejW56EMoGBooT OMA6e6wwHf0MJvswIcdS5Ge9VY4oOsr/il6FuPkfNz1KIdTZ1mhNMWA3wL3jY3hw yVp/+c0/tUkE+vXkl+Zuh2n4LALSaib8ryBljLX5bdyc/Sy6ZfP5yPrCtdpVVHMq yrnPoER9RTfJ+8C06Hmw =Ooov -----END PGP SIGNATURE----- --==-=-=--