From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id UJtUAZu0bF/2ZgAA0tVLHw (envelope-from ) for ; Thu, 24 Sep 2020 15:00:43 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id aAvCOJq0bF9UXQAAB5/wlQ (envelope-from ) for ; Thu, 24 Sep 2020 15:00:42 +0000 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 37B109401BE for ; Thu, 24 Sep 2020 15:00:42 +0000 (UTC) Received: from localhost ([::1]:47746 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kLSjf-0003lP-Uk for larch@yhetil.org; Thu, 24 Sep 2020 11:00:39 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39408) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kLSj4-0003kt-KG for guix-patches@gnu.org; Thu, 24 Sep 2020 11:00:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:57922) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kLSj4-00008O-6w for guix-patches@gnu.org; Thu, 24 Sep 2020 11:00:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kLSj4-0002sj-4D for guix-patches@gnu.org; Thu, 24 Sep 2020 11:00:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43482] [PATCH 3/3] doc: Reorder the "Channels" section. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 24 Sep 2020 15:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43482 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: zimoun Cc: 43482@debbugs.gnu.org Received: via spool by 43482-submit@debbugs.gnu.org id=B43482.160095959611041 (code B ref 43482); Thu, 24 Sep 2020 15:00:02 +0000 Received: (at 43482) by debbugs.gnu.org; 24 Sep 2020 14:59:56 +0000 Received: from localhost ([127.0.0.1]:41235 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kLSiy-0002s1-El for submit@debbugs.gnu.org; Thu, 24 Sep 2020 10:59:56 -0400 Received: from eggs.gnu.org ([209.51.188.92]:60798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kLSiw-0002ro-KT for 43482@debbugs.gnu.org; Thu, 24 Sep 2020 10:59:54 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:34446) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kLSir-00006Q-8e; Thu, 24 Sep 2020 10:59:49 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=57414 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kLSij-0008Ap-EI; Thu, 24 Sep 2020 10:59:44 -0400 From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <20200918014502.6081-1-zimon.toutoune@gmail.com> <20200918014502.6081-3-zimon.toutoune@gmail.com> Date: Thu, 24 Sep 2020 16:59:39 +0200 In-Reply-To: <20200918014502.6081-3-zimon.toutoune@gmail.com> (zimoun's message of "Fri, 18 Sep 2020 03:45:02 +0200") Message-ID: <874knn8bl0.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) 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 X-Spam-Score: -3.3 (---) 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" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: -1.51 X-TUID: A2sf2nqPnuXW zimoun skribis: > * doc/guix.texi (Channels): Reorder the section. > Minor tweaks to keep uniformity. > Update the master menu. It would be nice if you could better describe what=E2=80=99s moved where si= nce looking at the diff doesn=E2=80=99t help understand it. > +@node Writing custom channels > +@subsection Writing custom channels Should be =E2=80=9CWriting Custom Channels=E2=80=9D. Maybe =E2=80=9CCreating a Channel=E2=80=9D is more to the point actually? > To create a channel, create a Git repository containing your own package > modules and make it available. The repository can contain anything, but= a > useful channel will contain Guile modules that export packages. Once you > @@ -4398,6 +4470,24 @@ module, then the module will be available under th= e name @code{(my-packages > my-tools)}, and you will be able to use it like any other module > (@pxref{Modules,,, guile, GNU Guile Reference Manual}). >=20=20 > +Last, as a channel author, you may want to run an authenticated channel > +(@pxref{Channel Authentication}), then @pxref{Specifying Channel > +Authorizations} for details. Maybe something like: As a channel author, consider bundling authentication material with your channel so that users can authenticate it. @xref{Channel Authentication}, and @ref{Specifying Channel Authorizations}, for info on how to do it. (Note: @pxref cannot be used in the middle of a sentence like you did above. I always end up re-reading the Texinfo manual to find which cross-reference command to use in which context=E2=80=A6) Could you send updated patches? Thanks! Ludo=E2=80=99.