From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id wMTeKPQhS2J7JQAAgWs5BA (envelope-from ) for ; Mon, 04 Apr 2022 18:51:00 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id WLtDIfQhS2LGSwEAG6o9tA (envelope-from ) for ; Mon, 04 Apr 2022 18:51:00 +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 3ADED8096 for ; Mon, 4 Apr 2022 18:51:00 +0200 (CEST) Received: from localhost ([::1]:46402 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nbPus-0003Sm-V2 for larch@yhetil.org; Mon, 04 Apr 2022 12:50:58 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57752) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbPuC-0003Se-OQ for bug-guix@gnu.org; Mon, 04 Apr 2022 12:50:16 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:58926) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nbPty-0001yl-9E for bug-guix@gnu.org; Mon, 04 Apr 2022 12:50:15 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nbPty-0005RC-7y for bug-guix@gnu.org; Mon, 04 Apr 2022 12:50:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels Resent-From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Mon, 04 Apr 2022 16:50:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 54711 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 54711@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.164909098920865 (code B ref -1); Mon, 04 Apr 2022 16:50:02 +0000 Received: (at submit) by debbugs.gnu.org; 4 Apr 2022 16:49:49 +0000 Received: from localhost ([127.0.0.1]:52823 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbPtk-0005QT-K5 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 12:49:48 -0400 Received: from lists.gnu.org ([209.51.188.17]:34328) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbPSe-0004N2-82 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 12:21:48 -0400 Received: from eggs.gnu.org ([209.51.188.92]:52214) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbPSb-0007jD-PE for bug-guix@gnu.org; Mon, 04 Apr 2022 12:21:47 -0400 Received: from cloudserver3216345-3216376.home.pl ([46.242.242.150]:44526) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbPSa-00065w-8R for bug-guix@gnu.org; Mon, 04 Apr 2022 12:21:45 -0400 Received: from localhost (127.0.0.1) (HELO sv147.home.net.pl) by /usr/run/smtp (/usr/run/postfix/private/idea_relay_lmtp) via UNIX with SMTP (IdeaSmtpServer 5.0.0) id ebbdb64c1abac349; Mon, 4 Apr 2022 18:21:40 +0200 Received: from lenovo-x200.lan (unknown [81.190.248.246]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by sv147.home.net.pl (Postfix) with ESMTPSA id DDD805725FF for ; Mon, 4 Apr 2022 18:21:39 +0200 (CEST) Message-ID: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= Date: Mon, 04 Apr 2022 18:21:35 +0200 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-CLIENT-IP: 81.190.248.246 X-CLIENT-HOSTNAME: 81.190.248.246 X-VADE-SPAMSTATE: clean X-VADE-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvvddrudejvddgleehucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecujffqoffgrffnpdggtffipffknecuuegrihhlohhuthemucduhedtnecunecujfgurhepkffuhffvffgtfggggfesthejredttderjeenucfhrhhomhepofgrrhgvkhcurfgrhjhnihhkohifshhkihcuoehmrghilhesmhgrrhgvkhhprghsnhhikhhofihskhhirdhnrghmvgeqnecuggftrfgrthhtvghrnheptdefvefgveefjeekheefkeffjedvgfduueeltefhkeffveegjefhteekjefhveeunecukfhppeekuddrudeltddrvdegkedrvdegieenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpeekuddrudeltddrvdegkedrvdegiedphhgvlhhopehlvghnohhvohdqgidvtddtrdhlrghnpdhmrghilhhfrhhomhepofgrrhgvkhcupeerfgfvhfdqkeersferrfgrpeevheepleeunhhikhhofihskhhireepuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqedpnhgspghrtghpthhtohepuddprhgtphhtthhopegsuhhgqdhguhhigiesghhnuhdrohhrgh X-DCC--Metrics: sv147.home.net.pl 1024; Body=1 Fuz1=1 Fuz2=1 Received-SPF: pass client-ip=46.242.242.150; envelope-from=mail@marekpasnikowski.name; helo=cloudserver3216345-3216376.home.pl X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, 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: Mon, 04 Apr 2022 12:49:47 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1649091060; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=WKJzfw7CHHGpkB2oXDwBs9L29sXp15Oov8eD5ICugc0=; b=ny49tjC4wgia4Q8IrTD9HFB6zcabJocFZIXramca/oYe9SBr3jKCF4JihRx0xJVVM3QBsp GPZtzoJxU6xfSggGXLoi+jEzz2ThUL+S+CrIDN+0CWs7l4IRLECVqRCk6hMF242AZo58TZ FFiqsh4VE6bCVE/T17GUZx/Gjd6ne5jgVkVZVnCmRBIDa2WETKlpOfTgrbclNNO9M9w0pd u9EjdfYETRJzI+Q+oA9ZaMDrcloZkRp789t3GzYZafwj33ZIarf+ahqqPvOJcZxf6h9W0F WCyh4xXwEY7ml0C78VG/xsHjIacUnfobJ6ihYgkstN7wVmL6y1MLxRDWSDRH/g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1649091060; a=rsa-sha256; cv=none; b=kyD/Qn2UX/EYGUzjjWNRmMTymxByoKEHtBzFTQ4czzaCXNduA7wZOPTbjhE4ZH0wXfLuTm LzikGn2i+DHrf7/IVXkkpzw/5Ysh7JUIaVw7en2H43bzWEG3NdaRSWhwGW5FvunrBTde8A GcxNV0rdf1E7GYG4efLbkZJTL6hIboomySU0sy476cccK+7pbSqvYS0l8HxsKjfPJlAVXJ Zq5R3GRv5jUMHaGHTcpu1qm8vVj4EtTcsulQz9PH9kWr6t2BXZi+yKXYFclDthjU/VKeTh 9iZdzQGUTyPn7gWli3iHd3OFyjTO3Bkvvnb8p7qvnoysF94TOQTI8IAKZBBhTw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -4.88 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 3ADED8096 X-Spam-Score: -4.88 X-Migadu-Scanner: scn0.migadu.com X-TUID: gjhg428GrBqK Dear Guix Developers I love the Guix's vision of system management. Thank you for your hard work to implement it. It pains me greatly to see the documentation be completely useless. It gives descriptions of Guix programs, but almost nothing usable for configuration files. I am considering filing a bug report for each inadequate chapter. Please reply whether this is welcome. My aim is to rewrite the documentation in a way usable to someone, who has never used Guix before. I decided to prioritize channel documentation, because this is my current blocker. My goal is to keep a local mirror of the guix repository, with my personal changes and additions. Following is the list of the documentation problems. 1. (channel (introduction -)) is not mentioned at all. 2. What ==is== the channel introduction? Which commit am I supposed to use? How do I find the PGP fingerprint? 3. How do I declare a local repository? 4. How do I declare a channel within the config.scm file? Respectfully, Guix Noob Marek Pasnikowski