From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id pZGxL4QPZF8nagAA0tVLHw (envelope-from ) for ; Fri, 18 Sep 2020 01:38:12 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id 8LDUKoQPZF8XGgAAbx9fmQ (envelope-from ) for ; Fri, 18 Sep 2020 01:38:12 +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 1D0AE940291 for ; Fri, 18 Sep 2020 01:38:12 +0000 (UTC) Received: from localhost ([::1]:45160 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kJ5Ll-0002w4-8q for larch@yhetil.org; Thu, 17 Sep 2020 21:38:09 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54860) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kJ5Le-0002vg-Uw for guix-patches@gnu.org; Thu, 17 Sep 2020 21:38:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56859) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kJ5Le-0003rT-KP for guix-patches@gnu.org; Thu, 17 Sep 2020 21:38:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kJ5Le-0002vt-IB for guix-patches@gnu.org; Thu, 17 Sep 2020 21:38:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43482] [PATCH 0/3] doc: Reorder "Channels" section Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 18 Sep 2020 01:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 43482 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 43482@debbugs.gnu.org Cc: zimoun X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.160039307911263 (code B ref -1); Fri, 18 Sep 2020 01:38:02 +0000 Received: (at submit) by debbugs.gnu.org; 18 Sep 2020 01:37:59 +0000 Received: from localhost ([127.0.0.1]:40172 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kJ5Lb-0002va-Ee for submit@debbugs.gnu.org; Thu, 17 Sep 2020 21:37:59 -0400 Received: from lists.gnu.org ([209.51.188.17]:39820) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kJ5La-0002vU-IA for submit@debbugs.gnu.org; Thu, 17 Sep 2020 21:37:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54846) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kJ5La-0002uN-Bh for guix-patches@gnu.org; Thu, 17 Sep 2020 21:37:58 -0400 Received: from mail-wr1-x42a.google.com ([2a00:1450:4864:20::42a]:43414) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kJ5LY-0003pz-8q for guix-patches@gnu.org; Thu, 17 Sep 2020 21:37:57 -0400 Received: by mail-wr1-x42a.google.com with SMTP id k15so3913732wrn.10 for ; Thu, 17 Sep 2020 18:37:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=lci0a7cs8oQWU9Z2KkpdL1d2WlCgqI8z9/8X6rDnlY4=; b=WPQe+1bs0WaDv0U05Rrp55aiHiF+rkPJBylN7lG3HruybYHXmXg30thXvFSuZgGSLJ t4FDoSdjmjNCQSWEQd2bemObr7xNPxjV9vAdawGMoF2/Nihuzx06wET8T5fZS8Yr7MOI euUIAe07X3mdtSP31BBPpXLJNpmUVrh8rk2+XQ14cKBFIl1d8yKSPsxaBmUEN2p4+45D cbFiJFgc/71WSvQi43M440+XVY65lYB7aHw+fZeWMcmJWgaU78O/08EDbbpIGW7PKSVO 6+G3YnjfDYwLZNaJr//Ie8Z2J+tWy9SiHgdz8rUlxB1OpG3tg40DQ6hYtqm14BEW0Bmp Joog== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=lci0a7cs8oQWU9Z2KkpdL1d2WlCgqI8z9/8X6rDnlY4=; b=Ret3zbB9lCOxJxo3xrWgxrG+V1aWa/9UM+Syb6VvwveDpemAegBPUyXDv4g3yBLJdN fPenmvU2INdSOV/jJM95wPOL0SM30DxWceC15qUog0/qwe5xDnKhsnbD95rRlN/bUflJ PLzvJdxDEz0gR9M+fhLdqZZyM+Z4GoULjjQcqZGR9ZcAr+NnbtCbhOKMJ57Zxgq2k6dp fF9GuPPPyexYgkMl9VFGCotM4RSdQH6BNLsoq7LiOVhFHkBi0StDIg/rRyyQmfI/27id eKmjDJppy3H7V3100a/Xpx1fNNm4RaYuXZ0G6WKIwNo/GTcU4ZCpm5DfojdDepBR3Od2 sg0A== X-Gm-Message-State: AOAM5339f3i/rb7T7nGdAa31Gc/lIE4fXB5cTmUF7VLh9XyNh2KxDXqA 140gxoyh0tuk5hI6Icc5rNdrZXvE0tQ= X-Google-Smtp-Source: ABdhPJy+jfwlSryrquGndq7wUsJCrEp6hP2jtVnQ8L0BwjxcEfLqssFTJUMPTxzndVVPfl4vIABozw== X-Received: by 2002:a5d:4d8a:: with SMTP id b10mr34596219wru.82.1600393073923; Thu, 17 Sep 2020 18:37:53 -0700 (PDT) Received: from lili.univ-paris-diderot.fr ([88.126.110.68]) by smtp.gmail.com with ESMTPSA id c4sm2065763wrp.85.2020.09.17.18.37.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 17 Sep 2020 18:37:53 -0700 (PDT) From: zimoun Date: Fri, 18 Sep 2020 03:37:44 +0200 Message-Id: <20200918013744.3448-1-zimon.toutoune@gmail.com> X-Mailer: git-send-email 2.28.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2a00:1450:4864:20::42a; envelope-from=zimon.toutoune@gmail.com; helo=mail-wr1-x42a.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. 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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.7 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -2.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=fail (rsa verify failed) header.d=gmail.com header.s=20161025 header.b=WPQe+1bs; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); 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: 4.09 X-TUID: a1h1yxRcN5u2 Dear, As discussed here [1], the Channels is modified to satisfy a more logical order, at least mine. :-) The patch 0003 can be hard to review. Basically, I have moved the sections: 5.6 Invoking @command{guix pull} 5.7 Channels 5.7.1 Specifying Additional Channels 5.7.2 Using a Custom Guix Channel 5.7.3 Replicating Guix 5.7.4 Channel Authentication 5.7.5 Primary URL 5.7.6 Writing custom channels 5.7.7 Package Modules in a Sub-directory 5.7.8 Declaring Channel Dependencies 5.7.9 Specifying Channel Authorizations 5.7.10 Writing Channel News 5.8 Invoking @command{guix time-machine} And I did some minor tweaks trying to have user vs developer of channels. Say that from 5.7.1 to 5.7.5, the channel are collection of "variants". Then it becomes "your own channel". I added these words which deserve a better wording, I guess. --8<---------------cut here---------------start------------->8--- Last, as a channel author, you may want to run an authenticated channel (@pxref{Channel Authentication}), then @pxref{Specifying Channel Authorizations} for details. --8<---------------cut here---------------end--------------->8--- At the end of the section "Writing custom channels". And after some thinking, I find better to have "guix pull" and time-machine visible from Package Management section: . Well, that is a start. :-) [1] https://lists.gnu.org/archive/html/guix-devel/2020-09/msg00153.html All the best, simon zimoun (3): doc: Update the master menu. doc: Add the "Channels" section menu. doc: Reorder the "Channels" section. doc/guix.texi | 353 +++++++++++++++++++++++++++++--------------------- 1 file changed, 202 insertions(+), 151 deletions(-) base-commit: 679d5e6b3dcac4ee1f419c04b3719fead0bd9ee5 -- 2.28.0