From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id +A9aEb4oIGWb6QAAG6o9tA:P1 (envelope-from ) for ; Fri, 06 Oct 2023 17:33:18 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id +A9aEb4oIGWb6QAAG6o9tA (envelope-from ) for ; Fri, 06 Oct 2023 17:33:18 +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 9FF4A5FF84 for ; Fri, 6 Oct 2023 17:33:17 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=protonmail.com header.s=protonmail3 header.b=pIYneGFH; 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"; 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=1696606398; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-to: 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=luW9is+P5R/L7f+Pk3+Thu+qKzM9Vegei6SlmWDzx8g=; b=DvjAaM+HTap0Us0WuLEIvmQwyr7ZdaGT3evyk/X76JqNpwx0uLxvJHwo6oiVrw0P7j57mI /pfSKWLuX3K0PbADG53i54X9jrJOyO+pQAVkZwNUA+GBRnTt6VikMe0SWg2HFefYoXJyJE i6SYIcwj123ia/KR3H8azao7x9VfLAFx49qYCT0uCqXnuRSTb5Hqj/ZoHNuNEm/Q1eKjbN o5CE1DD6zGnm5m3ZVlkfaPeObDeh3kY+kGbQ+dIGM79p2+9zHcl6Lkteh0nKAHXk9QC4HZ QtuvGpUZzfUL4WpboNs3p95ghEEgaP8ICDgkjVaPYmghj/KglvxVg9HdCOv1iw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=protonmail.com header.s=protonmail3 header.b=pIYneGFH; 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"; dmarc=pass (policy=none) header.from=gnu.org ARC-Seal: i=1; s=key1; d=yhetil.org; t=1696606398; a=rsa-sha256; cv=none; b=DNcZbC82OYSihZbZix4BZOLgQc2T0rR64RwUphQ6gkduof7pY1Fss9v5yZUu1Lpyljda/H reM/d2Qpqpl0ccORvSYxZfjihzH1B+3TK8ntf4ZHufJUK8H1gS7tcJ88m4XbyhIi84ln/p EzU6z8MN5mXR4DYGKUidpIs0wyfcdb+xZPF9Y8rzt3E92uZ0gRxBibeqRIEmnCd6+K/geb 6EoOM1nhrmk+O91GnXgSnF2BwGJReK/1u8lgM/93OwHds+KLboGlkeBMoefryFymFti2NW bJeNcS9juauz6RahIw3GKVWvS2vRSka7d6buORehbqM1E3tW0Rm/NAIAaP9B5g== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qomon-00078c-OU; Fri, 06 Oct 2023 11:32:45 -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 1qomom-00077b-8C for bug-guix@gnu.org; Fri, 06 Oct 2023 11:32:44 -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 1qomom-0001Aq-0M for bug-guix@gnu.org; Fri, 06 Oct 2023 11:32:44 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qomp4-00056r-Jy for bug-guix@gnu.org; Fri, 06 Oct 2023 11:33:02 -0400 Subject: bug#66319: Incorrect code snippet in manual References: In-Reply-To: Resent-From: John Kehayias Original-Sender: "Debbugs-submit" Resent-To: bug-guix@gnu.org Resent-Date: Fri, 06 Oct 2023 15:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 66319 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Gabriel Hondet Cc: 66319-done@debbugs.gnu.org Mail-Followup-To: 66319@debbugs.gnu.org, john.kehayias@protonmail.com, gabriel.hondet@cominety.net Received: via spool by 66319-done@debbugs.gnu.org id=D66319.169660633019545 (code D ref 66319); Fri, 06 Oct 2023 15:33:02 +0000 Received: (at 66319-done) by debbugs.gnu.org; 6 Oct 2023 15:32:10 +0000 Received: from localhost ([127.0.0.1]:52407 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qomoE-00055A-8h for submit@debbugs.gnu.org; Fri, 06 Oct 2023 11:32:10 -0400 Received: from mail-40133.protonmail.ch ([185.70.40.133]:64665) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qomoB-00054r-Uh for 66319-done@debbugs.gnu.org; Fri, 06 Oct 2023 11:32:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1696606302; x=1696865502; bh=luW9is+P5R/L7f+Pk3+Thu+qKzM9Vegei6SlmWDzx8g=; h=Date:To:From:Cc:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=pIYneGFHjLuXMO5AP40CXuLeFUesOu1kyt7oHMJI1Pzj9s/Rz5xWbkOBNImkYnS84 XSpC6WOFoGeg+WYBZzj4MwubEKrcb+doxmrlFhUMk4pxEryy67ob3lXsgoASE55kg+ +0hbrU2+LOnUAQ0iDKYSmm4tTPigmB8XwEUlyAnO8eEjEuVybmgRIJ2COtL7wP0zaY u9lww6DPcTziu7KN+SUoqTkbHjz96MS/0MOwMH3B/1lUToxJzjegZ425adRqhoBowR JEzppCjv63iZLNjj2NEqsAx7BIC9Lj1k+wZZeiWJmOsjWDmXAs6A+AqDThDuR9NnDP TNRyDN8Eqdj3w== Date: Fri, 06 Oct 2023 15:31:25 +0000 Message-ID: <878r8fahtn.fsf@protonmail.com> Feedback-ID: 7805494:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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: , Reply-to: John Kehayias From: John Kehayias via Bug reports for GNU Guix Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: bug-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -6.69 X-Migadu-Scanner: mx2.migadu.com X-Migadu-Queue-Id: 9FF4A5FF84 X-Spam-Score: -6.69 X-TUID: BpgtMKrGw8Ub Hi Gabriel, On Mon, Oct 02, 2023 at 06:38 PM, Gabriel Hondet wrote: > Hello, > > The code snippets of the page 'Sending a patch series' look incorrect to > me: the snippets mention the email address > "guix-patches@debbugs.gnu.org" but the text mentions > "guix-patches@gnu.org". > It is possible that one is an alias for the other (I'm not sure), but as far as I know I always use the guix-patches@gnu.org address to start a patch submission. After the initial email, as noted in the manual, you get a bug number @debbugs.gnu.org to use. > For instance, >> We can now send just the cover letter to the guix-patches@gnu.org >> address, which will create an issue that we can send the rest of the >> patches to. >> >> > $ git send-email outgoing/0000-cover-letter.patch -a \ >> > --to=3Dguix-patches@debbugs.gnu.org \ >> > $(etc/teams.scm cc-members ...) >> > $ rm outgoing/0000-cover-letter.patch # we don't want to resend it! > > The documentation I'm looking at is the one accessible at > https://guix.gnu.org/manual/en/html_node/Sending-a-Patch-Series.html#Mult= iple-Patches > on the Monday, 2nd of October at 6pm (CEST) (a.k.a. 2023-10-02T18+02:00 > if you prefer ISO dates). > Ah, so this is the "1.4.0" manual rather than the current one: . This is a long standing confusion that needs to be sorted out, but in short I would say the 1.4.0 manual is just to match the 1.4.0 installer, but once installed and updated you should always use the manual that matches your guix version. You can use "info guix" for instance, or the web "devel" manual for the latest version. So, yes, this is a potential error in the 1.4.0 manual but is corrected in the current version. I don't think we can easily correct the old version (it is already tagged and released) but we do have to clarify the manual online for what version is what. This has been reported before and there are some proposals, not sure why it hasn't been done yet. Sorry about that! > Cheers, > Gabriel Hope that is helpful! I'm going to close this in light of the above, but feel free (or someone else) to reopen if needed. Thanks for the close reading, doc errors and suggestions always welcome! John