From patchwork Fri Jan 12 23:53:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Khodabakhsh X-Patchwork-Id: 58833 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 7A72D27BBE2; Sat, 13 Jan 2024 08:02:26 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_INVALID,DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI, RCVD_IN_MSPIKE_H5,RCVD_IN_MSPIKE_WL,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 8577627BBE9 for ; Sat, 13 Jan 2024 08:02:25 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rOYy6-00088C-FK; Sat, 13 Jan 2024 03:02:14 -0500 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 1rOYDV-0006aS-Rg for guix-patches@gnu.org; Sat, 13 Jan 2024 02:14:06 -0500 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 1rOYDV-0000ow-Bn for guix-patches@gnu.org; Sat, 13 Jan 2024 02:14:05 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1rOYDT-0002rd-OM for guix-patches@gnu.org; Sat, 13 Jan 2024 02:14:03 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#68419] [PATCH] Clarify definition of channel files in the cookbook. Resent-From: Daniel Khodabakhsh Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 13 Jan 2024 07:14:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 68419 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 68419@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.170512999010905 (code B ref -1); Sat, 13 Jan 2024 07:14:03 +0000 Received: (at submit) by debbugs.gnu.org; 13 Jan 2024 07:13:10 +0000 Received: from localhost ([127.0.0.1]:38253 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rOYCb-0002pk-HX for submit@debbugs.gnu.org; Sat, 13 Jan 2024 02:13:09 -0500 Received: from lists.gnu.org ([2001:470:142::17]:55214) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rORLc-0006nL-Ir for submit@debbugs.gnu.org; Fri, 12 Jan 2024 18:54:01 -0500 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 1rORLY-0008V6-Pa for guix-patches@gnu.org; Fri, 12 Jan 2024 18:53:56 -0500 Received: from mail-oa1-x2c.google.com ([2001:4860:4864:20::2c]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rORLX-0006Is-7i for guix-patches@gnu.org; Fri, 12 Jan 2024 18:53:56 -0500 Received: by mail-oa1-x2c.google.com with SMTP id 586e51a60fabf-204235d0913so4072171fac.1 for ; Fri, 12 Jan 2024 15:53:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705103633; x=1705708433; darn=gnu.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=m97gFAJWzfFWBidIMte4qnbe4S5PaNd3q/ygow5Bd+4=; b=ZsJeJMH+SO01J5TD2MDpRAyADkwlxsO5tHuWfbCGQCtggT1Z7CPNnEK4TCb2J5Aw3Z D27BoMzuMXPcD+8AcU+AhH29scPMgNskxosdMA3caFAsJi4RPy9l5DjKYOSP7GNTcGLV h2wbno3QUIAj67vk5NSH+HuZSUMu8cDuRbWINe+TckbyZv5pTRlUSTzMBr7YOgw6SM3Z wq6ROQo+XSuVU5HAuAjLG/YWvPjsdMOXiRyXtBeWXoNIFUQAodSN5qc7ovXWxTWRR7oo 9SXnqR3l8ZOFxMSDBrlH+Ws5BIpPvEgiWViQXyX67pXLaXY1WLkjDuM2Sm3Gnl0XRuNL UlQQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705103633; x=1705708433; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=m97gFAJWzfFWBidIMte4qnbe4S5PaNd3q/ygow5Bd+4=; b=Wwm4OSzh7R0WWh/LFbvDBApAgAL0EWMfA6CSibIfTZabWsmN7tTlysQ/Vpv0wOwQS0 fnAUzKl0yy3mh0ig/Aar6obc61nVqdrNzpwq7d5u6kwMy7QF0dVNthDSRcyvJwSxfCKl f5zBy+imA+Tip7qQ+Vy17OLoqLXd5yeNKMG4so/Aq+EHTz11jPIhc0st63kMfYkvLLZ1 CxzCmjN125/diuQO96/iQZUm7StiQf3zjc0YEX4jjzM5MBB5Zr3gfNCQKKNeMnYRzWS/ duByfd7KRXDN+8u1OSV3ROHxXyzt5K/WqUp/0veYd2H4WHVYUR/+b7Xv3WVkHqncLZZZ mq/Q== X-Gm-Message-State: AOJu0YzYXa2ZUeDXzP6bsSscaTqHMRgbZZney30vl6FSQP8UwdgpAepO pk0rd3nAgxge+5Lcjl0hz5zQacUkiuauf7XVnwhgLrmm/DQ= X-Google-Smtp-Source: AGHT+IHNLhKZ+3N+6QJML2lCcg8PD9kNkfuPpJkdGMyI3yunLnG4XeVxtdvAkZr14hbGeBiUl1PXYBfGzzpyg0ihCe8= X-Received: by 2002:a05:6871:487:b0:203:e6e:c72b with SMTP id f7-20020a056871048700b002030e6ec72bmr2558078oaj.67.1705103633177; Fri, 12 Jan 2024 15:53:53 -0800 (PST) MIME-Version: 1.0 From: Daniel Khodabakhsh Date: Fri, 12 Jan 2024 23:53:40 +0000 Message-ID: Received-SPF: pass client-ip=2001:4860:4864:20::2c; envelope-from=d.khodabakhsh@gmail.com; helo=mail-oa1-x2c.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sat, 13 Jan 2024 02:13:05 -0500 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Mailman-Approved-At: Sat, 13 Jan 2024 03:02:12 -0500 X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches From 8bad2696e628f9415a4e720b60df095d65686ba9 Mon Sep 17 00:00:00 2001 From: Daniel Khodabakhsh Date: Fri, 12 Jan 2024 12:49:27 -0800 Subject: [PATCH] Clarify definition of channel files in the cookbook. --- doc/guix-cookbook.texi | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) @code{define-public}. This is effectively assigning the package to the @code{my-hello} variable so that it can be referenced, among other as dependency of other diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index 2366c13..21fec10 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -805,7 +805,7 @@ mkdir ~/my-channel @end example Suppose you want to add the @samp{my-hello} package we saw previously; -it first needs some adjustments: +@file{my-hello.scm} first needs some adjustments: @lisp (define-module (my-hello) @@ -835,6 +835,10 @@ command-line arguments, multiple languages, and so on.") (license gpl3+))) @end lisp +Instead of starting with a @code{user-module} expression, a @code{define-module} +expression is used. This expression defines the name of the module and must match +the file name used (@samp{my-hello} from @file{my-hello.scm}). + Note that we have assigned the package value to an exported variable name with