From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id uECqOW8wLWX4sQAAauVa8A:P1 (envelope-from ) for ; Mon, 16 Oct 2023 14:45:36 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id uECqOW8wLWX4sQAAauVa8A (envelope-from ) for ; Mon, 16 Oct 2023 14:45:36 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id CBD9E46431 for ; Mon, 16 Oct 2023 14:45:35 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=AAZTPoTd; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1697460335; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=0qqW2Xr661Ogvx5FKzioK4b6KoVZp+oB99X/v3qnIT4=; b=FvJL2u3hr2LK9jUIblCMuy6OFn2WlPQKvLMGI3KHvHUrb+Ho9a6lCSKFNrQnZmX2LgI1RB 8A+b4dhyq6gBHlxHIKflLAuMZRCKmCex3Gw0Rki3mNpzX6m9GxlLBgGH3v6PkJVv+s6vTH IOpgoEQTpAYS0GMPlzZDIQDNCAqOThZX6HC5O5Igg8bmY9N62P0cxS9RZlmgzBqC+JbPlM PWLyuLAeOgocHyzYRtx9cI9a52EY30pioBzcqzGZro/DloeMw5RQgYTHgI6g0iGD5NjcX6 rWbISZ8BqstIlawbQeCa1GDCotc2LELiq34L+KNOmU+vo99aPgqW9SY+O3znfw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1697460335; a=rsa-sha256; cv=none; b=KI7JYrPdnoq4MePjK1Cfu76O5WcjnO8p+MC7IWnH8s0d4A6govcnbrj465Ysat+zWfp1Mx dIUKVtJUWCF+KrGiPUUAmkPwIdWbgiVS0BmD4jgwlD4voafnZ1QWM3mKxy8s+gAIf7zkeD fsmxLFH4hspPgcRGhVb3HvhYnnjmGKbV5ghq1h1kzn7IKNzNiWVR1N4L0o698zMiYicFjn e+bmfUMCaO8Z0cPJEO+c1Q0fkA83Mmxs0JZCxaDRTJqaIx637TVaZSAtujA3EVDywlKWg4 88uwGHogPjHT62SdUixuYJSLzoQS4pkaJSKR3UmRKvzN/xrEgvyidPSq8JeNjg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=AAZTPoTd; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qsMxl-0006dJ-Hz; Mon, 16 Oct 2023 08:44:49 -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 1qsMxa-0006aP-3j for guix-patches@gnu.org; Mon, 16 Oct 2023 08:44:40 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qsMxZ-0007JJ-Rx for guix-patches@gnu.org; Mon, 16 Oct 2023 08:44:37 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qsMxy-0008Ma-Jp for guix-patches@gnu.org; Mon, 16 Oct 2023 08:45:02 -0400 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Spam-Score: -5.37 X-Migadu-Queue-Id: CBD9E46431 X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -5.37 X-TUID: nhfwt3cQfqul * 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