From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.169745983431059 (code B ref -1); Mon, 16 Oct 2023 12:38:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Oct 2023 12:37:14 +0000 Received: from localhost ([127.0.0.1]:55439 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqQ-00084t-0X for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:14 -0400 Received: from lists.gnu.org ([2001:470:142::17]:42164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqN-00084Y-7Y for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMps-0003E9-Ha for guix-patches@gnu.org; Mon, 16 Oct 2023 08:36:40 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMps-0005a8-9I; Mon, 16 Oct 2023 08:36:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=P5Qwg4KrWs1Hf6UJASraMhJ9gqeBKDHXV3C6TTC/72A=; b=Et1RlzfZZMt9U5 sRs4D2/Pv2GjFYUKAnO+AM5ORHf2eeP5MK0Hq5ZM+/tQeMRk7QwU3jL33FhGWVPlt2sLjuFmKRBgI BHlPyizf1CzJwBWjsEPSrTWgrCeX7bfnic44/geDOhV+sp+tX9XzEzlCdtbowYs3HsGRmsX/bNR4u 2DT7Twug8ekmVSNhvNKX549D60EYldfJiYcahbkJAJ0Lvcc2WWP7ykEiwvzVTG6lR+TDDlkwPph0N /0C9ZGJZqBUSopO/RPRN9T2TeHW7MV7TTjELykraqX9z0jYp0W9yvKCoWPtclLZ/tM1A0mggEhovP 2yY2sTXv5xXwjYLkOQ5A==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:36:28 +0200 Message-ID: X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello! These patches reorganize things a bit in the manual to make important things more easily findable to newcomers, and adds a word of caution regarding the section on multiple profiles in the cookbook (I’ve seen newcomers attempt to adopt that software management style on their systems, when it’s complex and in fact largely unnecessary since the addition of a fast cache in ‘guix shell’). Thoughts? Ludo’. Ludovic Courtès (4): doc: Move “System Troubleshooting Tips” below. doc: Mention Guix Home in “Getting Started”. doc: cookbook: Suggest ‘guix shell’ as an alternative to multiple profiles. doc: cookbook: Add cross references to the manual regarding manifests. doc/guix-cookbook.texi | 51 ++++---- doc/guix.texi | 257 ++++++++++++++++++++--------------------- 2 files changed, 152 insertions(+), 156 deletions(-) base-commit: a0d2ecde943bd1854ddbb7c0cad35a1fc64dc5ab -- 2.41.0 From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 1/4] doc: Move =?UTF-8?Q?=E2=80=9CSystem?= Troubleshooting =?UTF-8?Q?Tips=E2=80=9D?= below. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169746025432029 (code B ref 66577); Mon, 16 Oct 2023 12:45:01 +0000 Received: (at 66577) by debbugs.gnu.org; 16 Oct 2023 12:44:14 +0000 Received: from localhost ([127.0.0.1]:55457 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxB-0008KV-Pi for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41862) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMx8-0008KA-Su for 66577@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:12 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMwc-00077o-S7; Mon, 16 Oct 2023 08:43:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=4Q7ZPlDZ9DB4+R5CB99DnGt25pfxguLIjfx1OXvaqWc=; b=kghxRYi3rIxVdEo9rWVF iXbOrh0PHhCodgbsuzkCWRvEfb+9jrb2eElDnZTr1XrVeUmltwSw/Bg++DJDk6LODc8924znfEonc XPlarmzkUvH+oo8UapQS9UJy3hrDyKIML1riuWMJjY8vUosiqUpb9u5PD29mjB+mj6HLSK7gnilw2 ez1KXJ7bd5yBFbMP8lqFRWne7M3HjtXxIP/PZZq7OIdu5Iqgx8ezH6SRHWvadwFbmIWtRGsOSJmCj 4dG9dZMeT1860+p2VIvzisMn7QAneWQuxvIDxXVVJmOJMKcbeK/q3E7Ej6kQWTeufNZoIgp99m7ze OYj1KTRUL43nAQ==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:43:00 +0200 Message-ID: X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) So far this section would appear before “Getting Started”. This moves it right after “System Configuration”. * doc/guix.texi (System Troubleshooting Tips): Move after “System Configuration”. --- doc/guix.texi | 245 +++++++++++++++++++++++++------------------------- 1 file changed, 123 insertions(+), 122 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 3517c95251..8ebf50469e 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -185,7 +185,6 @@ Top * Introduction:: What is Guix about? * Installation:: Installing Guix. * System Installation:: Installing the whole operating system. -* System Troubleshooting Tips:: When things don't go as planned. * Getting Started:: Your first steps. * Package Management:: Package installation, upgrade, etc. * Channels:: Customizing the package collection. @@ -194,6 +193,7 @@ Top * Utilities:: Package management commands. * Foreign Architectures:: Build for foreign architectures. * System Configuration:: Configuring the operating system. +* System Troubleshooting Tips:: When things don't go as planned. * Home Configuration:: Configuring the home environment. * Documentation:: Browsing software user manuals. * Platforms:: Defining platforms. @@ -251,10 +251,6 @@ Top * Keyboard Layout and Networking and Partitioning:: Initial setup. * Proceeding with the Installation:: Installing. -System Troubleshooting Tips - -* Chrooting into an existing system:: - Package Management * Features:: How Guix will make your life brighter. @@ -427,6 +423,10 @@ Top * Shepherd Services:: A particular type of service. * Complex Configurations:: Defining bindings for complex configurations. +System Troubleshooting Tips + +* Chrooting into an existing system:: + Home Configuration * Declaring the Home Environment:: Customizing your Home. @@ -2978,123 +2978,6 @@ Building the Installation Image @code{A20-OLinuXino-Lime2} is the name of the board. If you specify an invalid board, a list of possible boards will be printed. -@c ********************************************************************* -@cindex troubleshooting, guix system -@cindex guix system troubleshooting -@node System Troubleshooting Tips -@chapter System Troubleshooting Tips - -Guix System allows rebooting into a previous generation should the last -one be malfunctioning, which makes it quite robust against being broken -irreversibly. This feature depends on GRUB being correctly functioning -though, which means that if for whatever reasons your GRUB installation -becomes corrupted during a system reconfiguration, you may not be able -to easily boot into a previous generation. A technique that can be used -in this case is to @i{chroot} into your broken system and reconfigure it -from there. Such technique is explained below. - -@cindex chroot, guix system -@cindex chrooting, guix system -@cindex repairing GRUB, via chroot -@menu -* Chrooting into an existing system:: -@end menu - -@node Chrooting into an existing system -@section Chrooting into an existing system - -This section details how to @i{chroot} to an already installed Guix -System with the aim of reconfiguring it, for example to fix a broken -GRUB installation. The process is similar to how it would be done on -other GNU/Linux systems, but there are some Guix System particularities -such as the daemon and profiles that make it worthy of explaining here. - -@enumerate -@item -Obtain a bootable image of Guix System. It is recommended the latest -development snapshot so the kernel and the tools used are at least as as -new as those of your installed system; it can be retrieved from the -@url{https://ci.guix.gnu.org/search/latest/ISO-9660?query=spec:images+status:success+system:x86_64-linux+image.iso, -https://ci.guix.gnu.org} URL. Follow the @pxref{USB Stick and DVD -Installation} section for copying it to a bootable media. - -@item -Boot the image, and proceed with the graphical text-based installer -until your network is configured. Alternatively, you could configure -the network manually by following the -@ref{manual-installation-networking} section. If you get the error -@samp{RTNETLINK answers: Operation not possible due to RF-kill}, try -@samp{rfkill list} followed by @samp{rfkill unblock 0}, where @samp{0} -is your device identifier (ID). - -@item -Switch to a virtual console (tty) if you haven't already by pressing -simultaneously the @kbd{Control + Alt + F4} keys. Mount your file -system at @file{/mnt}. Assuming your root partition is -@file{/dev/sda2}, you would do: - -@example sh -mount /dev/sda2 /mnt -@end example - -@item -Mount special block devices and Linux-specific directories: - -@example sh -mount --rbind /proc /mnt/proc -mount --rbind /sys /mnt/sys -mount --rbind /dev /mnt/dev -@end example - -If your system is EFI-based, you must also mount the ESP partition. -Assuming it is @file{/dev/sda1}, you can do so with: - -@example sh -mount /dev/sda1 /mnt/boot/efi -@end example - -@item -Enter your system via chroot: - -@example sh -chroot /mnt /bin/sh -@end example - -@item -Source the system profile as well as your @var{user} profile to setup -the environment, where @var{user} is the user name used for the Guix -System you are attempting to repair: - -@example sh -source /var/guix/profiles/system/profile/etc/profile -source /home/@var{user}/.guix-profile/etc/profile -@end example - -To ensure you are working with the Guix revision you normally would as -your normal user, also source your current Guix profile: - -@example sh -source /home/@var{user}/.config/guix/current/etc/profile -@end example - -@item -Start a minimal @command{guix-daemon} in the background: - -@example sh -guix-daemon --build-users-group=guixbuild --disable-chroot & -@end example - -@item -Edit your Guix System configuration if needed, then reconfigure with: - -@example sh -guix system reconfigure your-config.scm -@end example - -@item -Finally, you should be good to reboot the system to test your fix. - -@end enumerate @c ********************************************************************* @node Getting Started @@ -43020,6 +42903,124 @@ Complex Configurations @end example +@c ********************************************************************* +@cindex troubleshooting, Guix System +@cindex guix system troubleshooting +@node System Troubleshooting Tips +@chapter System Troubleshooting Tips + +Guix System allows rebooting into a previous generation should the last +one be malfunctioning, which makes it quite robust against being broken +irreversibly. This feature depends on GRUB being correctly functioning +though, which means that if for whatever reasons your GRUB installation +becomes corrupted during a system reconfiguration, you may not be able +to easily boot into a previous generation. A technique that can be used +in this case is to @i{chroot} into your broken system and reconfigure it +from there. Such technique is explained below. + +@cindex chroot, guix system +@cindex chrooting, guix system +@cindex repairing GRUB, via chroot +@menu +* Chrooting into an existing system:: +@end menu + +@node Chrooting into an existing system +@section Chrooting into an existing system + +This section details how to @i{chroot} to an already installed Guix +System with the aim of reconfiguring it, for example to fix a broken +GRUB installation. The process is similar to how it would be done on +other GNU/Linux systems, but there are some Guix System particularities +such as the daemon and profiles that make it worthy of explaining here. + +@enumerate +@item +Obtain a bootable image of Guix System. It is recommended the latest +development snapshot so the kernel and the tools used are at least as as +new as those of your installed system; it can be retrieved from the +@url{https://ci.guix.gnu.org/search/latest/ISO-9660?query=spec:images+status:success+system:x86_64-linux+image.iso, +https://ci.guix.gnu.org} URL. Follow the @pxref{USB Stick and DVD +Installation} section for copying it to a bootable media. + +@item +Boot the image, and proceed with the graphical text-based installer +until your network is configured. Alternatively, you could configure +the network manually by following the +@ref{manual-installation-networking} section. If you get the error +@samp{RTNETLINK answers: Operation not possible due to RF-kill}, try +@samp{rfkill list} followed by @samp{rfkill unblock 0}, where @samp{0} +is your device identifier (ID). + +@item +Switch to a virtual console (tty) if you haven't already by pressing +simultaneously the @kbd{Control + Alt + F4} keys. Mount your file +system at @file{/mnt}. Assuming your root partition is +@file{/dev/sda2}, you would do: + +@example sh +mount /dev/sda2 /mnt +@end example + +@item +Mount special block devices and Linux-specific directories: + +@example sh +mount --rbind /proc /mnt/proc +mount --rbind /sys /mnt/sys +mount --rbind /dev /mnt/dev +@end example + +If your system is EFI-based, you must also mount the ESP partition. +Assuming it is @file{/dev/sda1}, you can do so with: + +@example sh +mount /dev/sda1 /mnt/boot/efi +@end example + +@item +Enter your system via chroot: + +@example sh +chroot /mnt /bin/sh +@end example + +@item +Source the system profile as well as your @var{user} profile to setup +the environment, where @var{user} is the user name used for the Guix +System you are attempting to repair: + +@example sh +source /var/guix/profiles/system/profile/etc/profile +source /home/@var{user}/.guix-profile/etc/profile +@end example + +To ensure you are working with the Guix revision you normally would as +your normal user, also source your current Guix profile: + +@example sh +source /home/@var{user}/.config/guix/current/etc/profile +@end example + +@item +Start a minimal @command{guix-daemon} in the background: + +@example sh +guix-daemon --build-users-group=guixbuild --disable-chroot & +@end example + +@item +Edit your Guix System configuration if needed, then reconfigure with: + +@example sh +guix system reconfigure your-config.scm +@end example + +@item +Finally, you should be good to reboot the system to test your fix. + +@end enumerate + @node Home Configuration @chapter Home Configuration @cindex home configuration -- 2.41.0 From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 2/4] doc: Mention Guix Home in =?UTF-8?Q?=E2=80=9CGetting_?= =?UTF-8?Q?Started=E2=80=9D.?= Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169746025532035 (code B ref 66577); Mon, 16 Oct 2023 12:45:02 +0000 Received: (at 66577) by debbugs.gnu.org; 16 Oct 2023 12:44:15 +0000 Received: from localhost ([127.0.0.1]:55459 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxC-0008KY-Q1 for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:15 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41870) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxA-0008KC-AP for 66577@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:12 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMwe-00077x-9o; Mon, 16 Oct 2023 08:43:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=cJRk3IAfTblzO5r+ZLLZm4fgPkS76QaOXHxoyC681i0=; b=GlWArb2WjC5mm9IEGXmA IWKJOVFo4M2EDAn6BwHfxpYzrWR/8CWAT43zvnLyCaOwEza1THQoPvdaXoFQ541TBMvczDehItHRr 3YM6zn1ASCFM+I+mzbDOSRHiF6b8JsJIvH6g4qjEUCuLaY4vrkIjDBj94J44UCwHkJ4F2vI6C2bwA 2NoorGjGQPU+8yX7ayWScC7P0f7JzEW7AbO1SMNM9uaE3ZphBifK3iGY06aB484D8un5u+pIHmbLz YiM5L0DUgwKWkWG9HIEvfaxN4xdGBHEOuVlUeRnVOlQosv4kbu8AI1iQDO0kV4sh2V2KLm58tK8J2 iIr9BlVMJncU6g==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:43:01 +0200 Message-ID: <2de53646c5355b42fec247780399fccb7c6a4f38.1697459606.git.ludo@gnu.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * doc/guix.texi (Getting Started): Mention Guix Home. (Home Configuration): Remove “still under development” note. --- doc/guix.texi | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 8ebf50469e..f5d20873be 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3069,11 +3069,15 @@ Getting Started @quotation Going further @xref{Package Management}, for more about package management. You may like @dfn{declarative} package management with @command{guix package ---manifest}, managing separate @dfn{profiles} with @option{--profile}, +--manifest}, deleting old generations, collecting garbage, and other nifty features that will come in handy as you become more familiar with Guix. If you are a developer, @pxref{Development} for additional tools. And if you're curious, @pxref{Features}, to peek under the hood. + +You can also manage the configuration of your entire @dfn{home +environment}---your user ``dot files'', services, and packages---using +Guix Home. @xref{Home Configuration}, to learn more about it! @end quotation Once you've installed a set of packages, you will want to periodically @@ -43036,12 +43040,6 @@ Home Configuration @c Maybe later, it will be possible to make home configuration a part of @c system configuration to make everything managed by guix system. -@quotation Note -The functionality described in this section is still under development -and is subject to change. Get in touch with us on -@email{guix-devel@@gnu.org}! -@end quotation - The user's home environment usually consists of three basic parts: software, configuration, and state. Software in mainstream distros are usually installed system-wide, but with GNU Guix most software packages -- 2.41.0 From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 4/4] doc: cookbook: Add cross references to the manual regarding manifests. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169746026732068 (code B ref 66577); Mon, 16 Oct 2023 12:45:02 +0000 Received: (at 66577) by debbugs.gnu.org; 16 Oct 2023 12:44:27 +0000 Received: from localhost ([127.0.0.1]:55465 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxP-0008L9-8m for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:27 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57688) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxN-0008Kq-9R for 66577@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:25 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMwg-00078G-3K; Mon, 16 Oct 2023 08:43:43 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=0qqW2Xr661Ogvx5FKzioK4b6KoVZp+oB99X/v3qnIT4=; b=AAZTPoTdibn6VhWdiVGD JV+4Fhi9gRfjrJDSk0LQZV/irrVUXukcuMig7sHB3Tj+yPkh8qt3ODX47KxOWphmuhglg7PQO69XH /jPtlHtCiy8caVgOVOelxlqg3ze2Xh71h3d9+gJ7sD1icdnTXMab96C7e6DdXUCYSrcJngGbeXQW9 WPXIMXTFw9Cekjo2xYnvmDHDBqf3uC+BWXJn7T1t75aap3U44+3iROd7RJNNbJBGL4xHELIJF2FGp k82w4lIjG3NqcUwETw/gtX3FTCYTtoRVGcKuWsQ6oSg7Iix8ljZLC8KNOJ9mqE/jwbrpGFWjBDAkG h/unlAZXlyIe7w==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:43:03 +0200 Message-ID: <0a08f973a486c025453c98b1ab34cb4ffc24fc82.1697459606.git.ludo@gnu.org> X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) * doc/guix-cookbook.texi (The benefits of manifests) (Reproducible profiles): Add cross-references. --- doc/guix-cookbook.texi | 12 ++++++++---- 1 file 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 @@ Default 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 @@ Reproducible profiles @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 -- 2.41.0 From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 3/4] doc: cookbook: Suggest =?UTF-8?Q?=E2=80=98guix_?= =?UTF-8?Q?shell=E2=80=99?= as an alternative to multiple profiles. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 16 Oct 2023 12:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169746026832075 (code B ref 66577); Mon, 16 Oct 2023 12:45:02 +0000 Received: (at 66577) by debbugs.gnu.org; 16 Oct 2023 12:44:28 +0000 Received: from localhost ([127.0.0.1]:55467 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxP-0008LB-J7 for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:57690) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMxN-0008Kr-9W for 66577@debbugs.gnu.org; Mon, 16 Oct 2023 08:44:26 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMwg-000784-8z; Mon, 16 Oct 2023 08:43:51 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:References:In-Reply-To:Date:Subject:To: From; bh=d3oi5uupG96JyFR1gLHUQV0Id0gOlZzFwqDJ5qByVM0=; b=fASC7vZdpBNo8vwR+4QB XnM1+Q6bfvfniWLgGcow/njBbNH2CplrFQqmiBp1AbC3VmBNbhY0rKdWc/lAXwl9DPtQKgQD+B2KE c27fNJGUsaiR6stg5olafO8sMMLB2p+O7y37QQ2/j+T/IHaVjs/xsqfpr03paqhXp6+e51IOx5Ntp yJOA1rlJFHUJoTO/8SlG3Ysv5bSVXBDCqIl/hCEudWbwler+m1QljGjhNAwrHSUxUv4rcZNwMLp83 PR3/1WpbjiLsLRmqEn5IjMnL8UZkBhQ7wwt/rCrUWEnO3fJmf7dwXB/9zUH5Smlj0OtLMdKkwo+PT u5SIxc0FYAm8vw==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Date: Mon, 16 Oct 2023 14:43:02 +0200 Message-ID: X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Multiple profiles are relatively hard to set up and maintain, especially for newcomers. Thus, suggest ‘guix shell’ as an alternative. * doc/guix-cookbook.texi (Guix Profiles in Practice): Add note linking to ‘guix shell’. (The benefits of manifests): Remove outdated info about ‘guix environment’ and profiles that may be GC’d. Update. --- doc/guix-cookbook.texi | 39 ++++++++++++++++----------------------- 1 file changed, 16 insertions(+), 23 deletions(-) diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index 712c131a51..1259f6aac7 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -3714,7 +3714,7 @@ Guix Profiles in Practice @section Guix Profiles in Practice Guix provides a very useful feature that may be quite foreign to newcomers: -@emph{profiles}. They are a way to group package installations together and all users +@dfn{profiles}. They are a way to group package installations together and all users on the same system are free to use as many profiles as they want. Whether you're a developer or not, you may find that multiple profiles bring you @@ -3722,6 +3722,16 @@ Guix Profiles in Practice @emph{traditional package managers}, they are very convenient to use once you've understood how to set them up. +@quotation Note +This section is an opinionated guide on the use of multiple profiles. +It predates @command{guix shell} and its fast profile cache +(@pxref{Invoking guix shell,,, guix, GNU Guix Reference Manual}). + +In many cases, you may find that using @command{guix shell} to set up +the environment you need, when you need it, is less work that +maintaining a dedicated profile. Your call! +@end quotation + If you are familiar with Python's @samp{virtualenv}, you can think of a profile as a kind of universal @samp{virtualenv} that can hold any kind of software whatsoever, not just Python software. Furthermore, profiles are self-sufficient: they capture @@ -4034,29 +4044,12 @@ The benefits of manifests they ``pin'' packages in the store, which prevents them from being garbage-collected (@pxref{Invoking guix gc,,, guix, GNU Guix Reference Manual}) and ensures that they will still be available at any point in -the future. +the future. The @command{guix shell} command also protects +recently-used profiles from garbage collection; profiles that have not +been used for a while may be garbage-collected though, along with the +packages they refer to. -Let's take an example: - -@enumerate -@item -We have an environment for hacking on a project for which there isn't a Guix -package yet. We build the environment using a manifest, and then run @code{guix - environment -m manifest.scm}. So far so good. - -@item -Many weeks pass and we have run a couple of @code{guix pull} in the mean time. -Maybe a dependency from our manifest has been updated; or we may have run -@code{guix gc} and some packages needed by our manifest have been -garbage-collected. - -@item -Eventually, we set to work on that project again, so we run @code{guix shell - -m manifest.scm}. But now we have to wait for Guix to build and install -stuff! -@end enumerate - -Ideally, we could spare the rebuild time. And indeed we can, all we need is to +To be 100% sure that a given profile will never be collected, install the manifest to a profile and use @code{GUIX_PROFILE=/the/profile; . "$GUIX_PROFILE"/etc/profile} as explained above: this guarantees that our hacking environment will be available at all times. -- 2.41.0 From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook Resent-From: Mathieu Othacehe Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 17 Oct 2023 10:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 66577@debbugs.gnu.org Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169753720720353 (code B ref 66577); Tue, 17 Oct 2023 10:07:01 +0000 Received: (at 66577) by debbugs.gnu.org; 17 Oct 2023 10:06:47 +0000 Received: from localhost ([127.0.0.1]:58693 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsgyN-0005ID-EZ for submit@debbugs.gnu.org; Tue, 17 Oct 2023 06:06:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:38526) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsgyK-0005Hz-WD for 66577@debbugs.gnu.org; Tue, 17 Oct 2023 06:06:46 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsgxo-0007vZ-9H; Tue, 17 Oct 2023 06:06:12 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=bH92XT+LM4+whXKvmUYgSCtu6wx+p1MsoG4xUIQPsd8=; b=qRjYk9NF2pPdQYpPiPtj qL7gC74ZSDNag1e11g/qNPy5Q8bw2Ixat5DGAJKyTrlZnWkSePwHElOPMvVo5nz0MwY1VLQMDlxUI FZxoPP1TfgvNk8TsxDSoStZusLsVuDiLwszs9g0Q0kIH9eBUOBTc8e7EvrCjO1K44AADtQuB/HyDj ye75TzX3i6rxgsjXsE4LcaDrpor7Vkee0fQ83ky5nZdyDeWo8Zca2ZmL3cQZVs/yyzVtYoMBN7M7X RAi85pePIaozppY0Q+B35M2SF7lnsWfQ74Cc4Z7uqNax6mpLgODNwaSTbS+Bz+0h0SZgCCxnihNp6 sWpY4pUg6chF8g==; From: Mathieu Othacehe In-Reply-To: ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Mon, 16 Oct 2023 14:36:28 +0200") References: Date: Tue, 17 Oct 2023 12:05:58 +0200 Message-ID: <87il75mum1.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hello, > regarding the section on multiple profiles in the cookbook (I=E2=80=99ve = seen > newcomers attempt to adopt that software management style on their > systems, when it=E2=80=99s complex and in fact largely unnecessary since = the > addition of a fast cache in =E2=80=98guix shell=E2=80=99). It is clear that "guix shell" is now an easier alternative to manual profile management. So that commit: > > doc: cookbook: Suggest =E2=80=98guix shell=E2=80=99 as an alternative t= o multiple > profiles. and the rest of the series looks good to me. Thanks, Mathieu From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 2/4] doc: Mention Guix Home in =?UTF-8?Q?=E2=80=9CGetting_?= =?UTF-8?Q?Started=E2=80=9D.?= Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 18 Oct 2023 17:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= , 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169765175914007 (code B ref 66577); Wed, 18 Oct 2023 17:56:02 +0000 Received: (at 66577) by debbugs.gnu.org; 18 Oct 2023 17:55:59 +0000 Received: from localhost ([127.0.0.1]:34618 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qtAly-0003dq-Ln for submit@debbugs.gnu.org; Wed, 18 Oct 2023 13:55:58 -0400 Received: from mail-wr1-x434.google.com ([2a00:1450:4864:20::434]:41057) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qtAlv-0003cD-OK for 66577@debbugs.gnu.org; Wed, 18 Oct 2023 13:55:57 -0400 Received: by mail-wr1-x434.google.com with SMTP id ffacd0b85a97d-32d842adc6bso1569340f8f.0 for <66577@debbugs.gnu.org>; Wed, 18 Oct 2023 10:55:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1697651724; x=1698256524; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=q2kI8KBbSDda1u5J45SK3FLM9qS3OhTI1rJ4jpoLC4c=; b=Ajt+tO/cp0t0Ib+KVrwiCx6PE8M4Od7F+dFGuVx+1q7rvmA08DOZotPaUgtrVTjvoE GrMCqkELOYHeY8fyBDOw5z4u4zptnlPMeAMOg1JBJJoZ3CT175p9+IB5/J2zONsrWAHx ctvLmd+Gwig4C3ZbeJvHIYkcsqwLIKfH995Kx8E/4ZbPT/kMNiHoAd2I4Y8gGgRuiMs2 KavuVVVN0RIsi+RbqA8dLzCj8idAlLIN4XCddhwPofEEUg2dt4uU9jVd2gQ3ENntvFtt iNxqErcCHNFVk/aNYcpdDX3VoGlWT4OQ8n96qAUxqsVQyzP8IgXyuFfF2QcPvDgNv+38 xVQA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697651724; x=1698256524; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=q2kI8KBbSDda1u5J45SK3FLM9qS3OhTI1rJ4jpoLC4c=; b=Covysht9wQ6popQb95RXr4Z7PY/TGFVP+Iny4l9offXx2SgOez2QZfNkTV6enz25UG 4ErQ3MTPPKI4GoEOan5ESrhWCHI10Ahti5OvCZOOLBQ5M8HQChXcak7NC5fLyUSyMJLP 1B1WSfeSUTK5eNTx42iEx4wjvulWGWJlbVsjLvQtObkhzIaNVwr2DqecFMGPP0JRH3wp Se/kLyYfWGi/Ied/CBkYF8Jz7Q2UpeWm1vCWnyvKph0388D7Hi4LH/FVnFUgNXqvHg/D lpQOSiQtwVQkIqfI7OO9VeLorA+/lrJfWUW1odASY+iAOkAsUSYhM60fOrhMNUGJk2Dy umRg== X-Gm-Message-State: AOJu0Yzq24p2EuiPkd0sSHsLYq3ARWpc8N5duFsurJMc3IxJtPOuhb0e 6kCVt49F68mz1v4nW3x6WXSjq2shdQg= X-Google-Smtp-Source: AGHT+IGWvydLsZ0RVF0+SnOYchdlvU3Z/uph+AXezs4+6bT/9u6kYdYUrOveOMqCAPZzYiusHFXzGQ== X-Received: by 2002:adf:fd8d:0:b0:32d:c250:72f9 with SMTP id d13-20020adffd8d000000b0032dc25072f9mr3946638wrr.5.1697651723592; Wed, 18 Oct 2023 10:55:23 -0700 (PDT) Received: from pfiuh07 ([193.48.40.241]) by smtp.gmail.com with ESMTPSA id n13-20020adffe0d000000b0032d9382e6e0sm2599540wrr.45.2023.10.18.10.55.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Oct 2023 10:55:23 -0700 (PDT) From: Simon Tournier In-Reply-To: <2de53646c5355b42fec247780399fccb7c6a4f38.1697459606.git.ludo@gnu.org> References: <2de53646c5355b42fec247780399fccb7c6a4f38.1697459606.git.ludo@gnu.org> Date: Wed, 18 Oct 2023 18:19:23 +0200 Message-ID: <87cyxbq4xg.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Ludo, On Mon, 16 Oct 2023 at 14:43, Ludovic Court=C3=A8s wrote: > @quotation Going further > @xref{Package Management}, for more about package management. You may > like @dfn{declarative} package management with @command{guix package > ---manifest}, managing separate @dfn{profiles} with @option{--profile}, > +--manifest}, > deleting old generations, collecting garbage, and other nifty features > that will come in handy as you become more familiar with Guix. If you > are a developer, @pxref{Development} for additional tools. And if > you're curious, @pxref{Features}, to peek under the hood. It is part of =E2=80=9CGoing further=E2=80=9D, so I would let =C2=AB managi= ng separate @dfn{profiles} with @option{--profile} =C2=BB. For what it is worth, I recommend for some newcomer to still use a separated profile inside the project folder, just aside the files manifest.scm and channels.scm. I agree that =E2=80=9Cguix shell=E2=80=9D is really cool now, but all the b= alance is the duration of the project with the cache cleanup. Well, this mention does not bother, IMHO, and it invites to know more for the interested reader since it is =E2=80=9CGoing further=E2=80=9D=E2=80= =A6 > +You can also manage the configuration of your entire @dfn{home > +environment}---your user ``dot files'', services, and packages---using > +Guix Home. @xref{Home Configuration}, to learn more about it! > @end quotation =E2=80=A6I mean, similarly, Guix Home is not something I recommend for newcomers. But it is good to mention it in =E2=80=9CGoing further=E2=80=9D= . :-) Cheers, simon From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook Resent-From: Simon Tournier Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 18 Oct 2023 17:56:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= , 66577@debbugs.gnu.org Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169765175914014 (code B ref 66577); Wed, 18 Oct 2023 17:56:02 +0000 Received: (at 66577) by debbugs.gnu.org; 18 Oct 2023 17:55:59 +0000 Received: from localhost ([127.0.0.1]:34620 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qtAlz-0003ds-1b for submit@debbugs.gnu.org; Wed, 18 Oct 2023 13:55:59 -0400 Received: from mail-wr1-x434.google.com ([2a00:1450:4864:20::434]:41403) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qtAlx-0003dT-Dr for 66577@debbugs.gnu.org; Wed, 18 Oct 2023 13:55:57 -0400 Received: by mail-wr1-x434.google.com with SMTP id ffacd0b85a97d-32da02fca9aso1279794f8f.1 for <66577@debbugs.gnu.org>; Wed, 18 Oct 2023 10:55:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1697651724; x=1698256524; darn=debbugs.gnu.org; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=S5K6Sc0Rp5+v8FkN7S1O0Bg78CTcPVyj6KTFdctQb+I=; b=LYoD00l4BSwwJ/f1j0P/PPPJ6lDl8NXpHAk+paiKaQUUki9ekz/QK/izoRGEuObBun CuSZ5jxJOgYgTY8OxQbQJY1mVpv/80Qz7pL7W7B0x3rONWQX8Xd3bO441EJ8TD45FJgM emtZ9ctLeDH2zIzj7ds518E/ViE1V4FSuun+uW3A1cXbJp6GS8++0sIiQ9eJUfxIJ3ip R1i2SZSVB3uPmQ89+ho55eEEIMe0cjx8dlDGA2KJq6y4Hj+/YILi1n5hYaWXsSlO4sP4 LnW+jn82Qzeu4LZM+cVkGK38vTK44Ov4K2kFcrRdnQQFoMSgpwgITSMAtnMgGyf+ja8a ORWA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697651724; x=1698256524; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=S5K6Sc0Rp5+v8FkN7S1O0Bg78CTcPVyj6KTFdctQb+I=; b=n4h29yUBylcJ5qnKxHrkapwDqFpjTPZdJZMX8CIxHiUnyCuuaJ1N2nte3gO1RiDh9w QA2kyAdEIwczGKwH/jkM2Ff3PeDoE6x+NtMcBlTIS4UHcFHPIOfE9DK/ZjPNPJrNPkBW 8ER3RwSuB093UnLhkaedldYlKayNbJH/BjuodXV784sROnv/DeVXxyp+cKTgpBsTpQCB dCbewMjgFnqvjLcIAO1otYx3KNm1jMIjJM7B4foF5k1yg+so4ftZu3UFDMn0JF+Ind8U jspu8wkbLaybXzWvNdb6gEPeU/L8bQlrzr8eCUAsiH88aVL9n/tvxqZ/RGVthhZzIhdy duNQ== X-Gm-Message-State: AOJu0YwfrVTs6WPmENCZzGBhXbkNq2YIcenXPetlR6td+JyGBgScoKai XTxVXlAwLgEZVZfhlRPIBqg= X-Google-Smtp-Source: AGHT+IHatkiP3f8hYXi3vDVImyoet1sqwQ5s7xA7QCRuv28idO6ssobuoWBr7K0HDVbSb/Vzd1bZKw== X-Received: by 2002:a05:6000:1282:b0:32d:c1e2:7aa9 with SMTP id f2-20020a056000128200b0032dc1e27aa9mr5220606wrx.0.1697651724638; Wed, 18 Oct 2023 10:55:24 -0700 (PDT) Received: from pfiuh07 ([193.48.40.241]) by smtp.gmail.com with ESMTPSA id b16-20020a056000055000b00326f5d0ce0asm2641417wrf.21.2023.10.18.10.55.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 18 Oct 2023 10:55:24 -0700 (PDT) From: Simon Tournier In-Reply-To: References: Date: Wed, 18 Oct 2023 18:34:30 +0200 Message-ID: <874jinq489.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, Cool! That=E2=80=99s better. On Mon, 16 Oct 2023 at 14:36, Ludovic Court=C3=A8s wrote: > Ludovic Court=C3=A8s (4): > doc: Move =E2=80=9CSystem Troubleshooting Tips=E2=80=9D below. > doc: Mention Guix Home in =E2=80=9CGetting Started=E2=80=9D. > doc: cookbook: Suggest =E2=80=98guix shell=E2=80=99 as an alternative t= o multiple > profiles. > doc: cookbook: Add cross references to the manual regarding manifests. LGTM, except keep the mention about profile in =E2=80=9CGoing further=E2=80= =9D of =E2=80=9CGetting Started=E2=80=9D. Cheers, simon From unknown Fri Sep 05 08:20:30 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66577] [PATCH 2/4] doc: Mention Guix Home in =?UTF-8?Q?=E2=80=9CGetting_?= =?UTF-8?Q?Started=E2=80=9D.?= Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 24 Oct 2023 13:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66577 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Simon Tournier Cc: 66577@debbugs.gnu.org Received: via spool by 66577-submit@debbugs.gnu.org id=B66577.169815566223724 (code B ref 66577); Tue, 24 Oct 2023 13:55:02 +0000 Received: (at 66577) by debbugs.gnu.org; 24 Oct 2023 13:54:22 +0000 Received: from localhost ([127.0.0.1]:53496 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qvHrS-0006Aa-CL for submit@debbugs.gnu.org; Tue, 24 Oct 2023 09:54:22 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35406) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qvHrM-0006AG-VL for 66577@debbugs.gnu.org; Tue, 24 Oct 2023 09:54:20 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvHql-0001OR-R7; Tue, 24 Oct 2023 09:53:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=XECV9N358MRnsFqyMu01Kls+Bap15U9HcQ5CBCE2CeE=; b=Lul+mmhrGCCZiD/UswVC E7FDRnH/8vn50r2XpgycDo0xvglUJxRNPkKnoS3XeII5Wlsznx8V9C6oG9gzyGHXnu2t10Q3HRn+1 5ImKejK/Tw/aad+6+iXniTLPk2zNen/xMf7mYFdNFIsjswu6i7LaT60WwUX9ESndirjOBZvbhA2OS OAObydcIf9YFjFudlFY23jhnRfVlXGeZupoDLyBHasjZ4JoCvlxZ1nGX+ziz/MlKjVmiJ9DDO/ty+ PcepgHZdzc9pIZ/hVLTNlp/enOZfGkdM4TChp2Vc1b8FhM1yWwR0OhgHtibeelM5DqhcTMK4yM7SL HuwMwch31AiCsw==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= In-Reply-To: <87cyxbq4xg.fsf@gmail.com> (Simon Tournier's message of "Wed, 18 Oct 2023 18:19:23 +0200") References: <2de53646c5355b42fec247780399fccb7c6a4f38.1697459606.git.ludo@gnu.org> <87cyxbq4xg.fsf@gmail.com> Date: Tue, 24 Oct 2023 15:53:23 +0200 Message-ID: <87fs2086uk.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hi, Simon Tournier skribis: > On Mon, 16 Oct 2023 at 14:43, Ludovic Court=C3=A8s wrote: > >> @quotation Going further >> @xref{Package Management}, for more about package management. You may >> like @dfn{declarative} package management with @command{guix package >> ---manifest}, managing separate @dfn{profiles} with @option{--profile}, >> +--manifest}, >> deleting old generations, collecting garbage, and other nifty features >> that will come in handy as you become more familiar with Guix. If you >> are a developer, @pxref{Development} for additional tools. And if >> you're curious, @pxref{Features}, to peek under the hood. > > It is part of =E2=80=9CGoing further=E2=80=9D, so I would let =C2=AB mana= ging separate > @dfn{profiles} with @option{--profile} =C2=BB. For what it is worth, I > recommend for some newcomer to still use a separated profile inside the > project folder, just aside the files manifest.scm and channels.scm. Yeah, I thought about concision and =E2=80=98--profile=E2=80=99 seemed less= important than =E2=80=9Cdeleting old generations=E2=80=9D etc. Also, caching in =E2=80=98guix shell=E2=80=99 was designed to automate what= one would do manually with =E2=80=98-p=E2=80=99: registering the GC root, cleaning thing= s up that are unused. The goal was to provide a simpler interface, which ideally also means simpler onboarding. Anyway, no strong opinion, so I=E2=80=99ve re-added the =E2=80=9Cmanaging s= eparate profiles=E2=80=9D bit. Thanks, Ludo=E2=80=99. From unknown Fri Sep 05 08:20:30 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Subject: bug#66577: closed (Re: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook) Message-ID: References: <87r0lk57ac.fsf@gnu.org> X-Gnu-PR-Message: they-closed 66577 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: patch Reply-To: 66577@debbugs.gnu.org Date: Tue, 24 Oct 2023 16:13:01 +0000 Content-Type: multipart/mixed; boundary="----------=_1698163981-19345-1" This is a multi-part message in MIME format... ------------=_1698163981-19345-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #66577: [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbo= ok which was filed against the guix-patches package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 66577@debbugs.gnu.org. --=20 66577: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D66577 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1698163981-19345-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 66577-done) by debbugs.gnu.org; 24 Oct 2023 16:12:52 +0000 Received: from localhost ([127.0.0.1]:56506 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qvK1T-00051g-T0 for submit@debbugs.gnu.org; Tue, 24 Oct 2023 12:12:52 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51482) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qvK1Q-00051O-UE for 66577-done@debbugs.gnu.org; Tue, 24 Oct 2023 12:12:49 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qvK0r-0006cU-Rj; Tue, 24 Oct 2023 12:12:13 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=P82kFSFlJzA5xAN7npfzR1ey4HnBBCIWcbS33a485b0=; b=Ibhmzlgfyh3ECpeI3GaI igmUSzJ5YFvYL3yRdCmfgCJmmHzfo2De3xpS+v1CqIJDuy/eO0TP6Egq4XD8AbHgP49X4vIKpOJjw Sbbx6Nvy+UOfqhe7ulNf+4ojjA0lfYT0XNicqiWMqp6CKYdlJI9zqlwkkkhLmMkEP9mU4AC+1hM63 VjMC8YIZCv27NGJsxYk9+IRSAlChKZitTbbbMdd1jWtN3ZoqJU6Yii6SrOIyfBzbknGvF9La/Zuph Fdn+EaCcdysdo+MGOqQmpqs5RDzYT08TADCRzJrimjmgPrW+pRemOJ3tO+fS7f+UDwsXXnTAXq1fT Q+r+1/BdF/SAOQ==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Simon Tournier , Mathieu Othacehe Subject: Re: [bug#66577] [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook In-Reply-To: <874jinq489.fsf@gmail.com> (Simon Tournier's message of "Wed, 18 Oct 2023 18:34:30 +0200") References: <874jinq489.fsf@gmail.com> Date: Tue, 24 Oct 2023 18:12:11 +0200 Message-ID: <87r0lk57ac.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 66577-done Cc: 66577-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hey, Pushed as 216f8ffff49c54ad56209c4fd6528f2d80ee8fed with the change Simon suggested. Thank you Mathieu and Simon for your feedback! Ludo=E2=80=99. ------------=_1698163981-19345-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 16 Oct 2023 12:37:14 +0000 Received: from localhost ([127.0.0.1]:55439 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqQ-00084t-0X for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:14 -0400 Received: from lists.gnu.org ([2001:470:142::17]:42164) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qsMqN-00084Y-7Y for submit@debbugs.gnu.org; Mon, 16 Oct 2023 08:37:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMps-0003E9-Ha for guix-patches@gnu.org; Mon, 16 Oct 2023 08:36:40 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qsMps-0005a8-9I; Mon, 16 Oct 2023 08:36:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:Subject:To:From:in-reply-to: references; bh=P5Qwg4KrWs1Hf6UJASraMhJ9gqeBKDHXV3C6TTC/72A=; b=Et1RlzfZZMt9U5 sRs4D2/Pv2GjFYUKAnO+AM5ORHf2eeP5MK0Hq5ZM+/tQeMRk7QwU3jL33FhGWVPlt2sLjuFmKRBgI BHlPyizf1CzJwBWjsEPSrTWgrCeX7bfnic44/geDOhV+sp+tX9XzEzlCdtbowYs3HsGRmsX/bNR4u 2DT7Twug8ekmVSNhvNKX549D60EYldfJiYcahbkJAJ0Lvcc2WWP7ykEiwvzVTG6lR+TDDlkwPph0N /0C9ZGJZqBUSopO/RPRN9T2TeHW7MV7TTjELykraqX9z0jYp0W9yvKCoWPtclLZ/tM1A0mggEhovP 2yY2sTXv5xXwjYLkOQ5A==; From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= To: guix-patches@gnu.org Subject: [PATCH 0/4] Newcomer-oriented improvements to the manual and cookbook Date: Mon, 16 Oct 2023 14:36:28 +0200 Message-ID: X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: submit Cc: =?UTF-8?q?Ludovic=20Court=C3=A8s?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hello! These patches reorganize things a bit in the manual to make important things more easily findable to newcomers, and adds a word of caution regarding the section on multiple profiles in the cookbook (I’ve seen newcomers attempt to adopt that software management style on their systems, when it’s complex and in fact largely unnecessary since the addition of a fast cache in ‘guix shell’). Thoughts? Ludo’. Ludovic Courtès (4): doc: Move “System Troubleshooting Tips” below. doc: Mention Guix Home in “Getting Started”. doc: cookbook: Suggest ‘guix shell’ as an alternative to multiple profiles. doc: cookbook: Add cross references to the manual regarding manifests. doc/guix-cookbook.texi | 51 ++++---- doc/guix.texi | 257 ++++++++++++++++++++--------------------- 2 files changed, 152 insertions(+), 156 deletions(-) base-commit: a0d2ecde943bd1854ddbb7c0cad35a1fc64dc5ab -- 2.41.0 ------------=_1698163981-19345-1--