From unknown Tue Aug 12 08:33:45 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66681] [PATCH] doc: Document Cuirass build notifications. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 22 Oct 2023 13:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 66681 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 66681@debbugs.gnu.org, maxim.cournoyer@gmail.com X-Debbugs-Original-To: guix-patches@gnu.org, maxim.cournoyer@gmail.com Received: via spool by submit@debbugs.gnu.org id=B.169798056321248 (code B ref -1); Sun, 22 Oct 2023 13:17:02 +0000 Received: (at submit) by debbugs.gnu.org; 22 Oct 2023 13:16:03 +0000 Received: from localhost ([127.0.0.1]:45634 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quYJG-0005We-JL for submit@debbugs.gnu.org; Sun, 22 Oct 2023 09:16:03 -0400 Received: from lists.gnu.org ([2001:470:142::17]:42166) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quYJE-0005WA-0k for submit@debbugs.gnu.org; Sun, 22 Oct 2023 09:16:01 -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 1quYIe-00024I-M4 for guix-patches@gnu.org; Sun, 22 Oct 2023 09:15:24 -0400 Received: from mail-vk1-xa33.google.com ([2607:f8b0:4864:20::a33]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1quYIb-0006jr-9z for guix-patches@gnu.org; Sun, 22 Oct 2023 09:15:24 -0400 Received: by mail-vk1-xa33.google.com with SMTP id 71dfb90a1353d-49e1ef0c60dso987837e0c.1 for ; Sun, 22 Oct 2023 06:15:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1697980520; x=1698585320; darn=gnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=s8JxovA2MZBxRtbOSRf3wMoyfXRchFxNZ3YyIs/L2DA=; b=ZOdDBSt9eJMQKVSailQWbGy8SbizJHzbo1JbVjkHCoq3dhVfaYkDHukhGaLZ5BZhO6 i3gM0qMy7NJttEslL8/cJ2trUAtSZn8MaqksAVyPsqTYqGInqrpc1WlbtRm015FZXgov XUnW+1Na1Nnlh5M8pLDJSeZegSfokZlDYDgjIqHyeUCB+FfiSgffkjszN1Zmt49pQvHR q33fzMp+1+vGXG7I/PuMNJM6gJ7mbtdMVl0SYKWzGSmgyIV1NfsonD7EFquLy1qcN+zf jGBQ8/+ktLir0Q2yWh+ZyN7iQ3Df+8ocfWE4OzsSbvQLzx8kdijgoRpaWtMFvs+zj7+D R2+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697980520; x=1698585320; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=s8JxovA2MZBxRtbOSRf3wMoyfXRchFxNZ3YyIs/L2DA=; b=d6hv6Gp6q5zTNaB0lO+IYL7E8daIO8x4iSZYfyiVWBY0gzmxy8TU/gf3p+ZX44z+Y9 CzYkeE0qTowuL0BTKSHuf+tGh3hV+4RiSssEd3BNv9cILvXstfD1uja1IOyr+EFq73Fh Ii0HFcVC0jZy4uNbZxnnHJwurBtGm3bqEpFBx2Trfpw1nqZ3EA/40ObaWXTB2zd3DWfj NawZPNR3UNoq0yKdrJCbzsSyOm0bi8800eHMUuPMRpqtLuAmK9hwzlyDVQHJjW0i+6AQ byiNgQjOwDpI5+nlcZouqDDAgtC851Px20APzCZcMqFirnyfAL0oXashq9zTAVjaqhpS Y5ag== X-Gm-Message-State: AOJu0YwRHLA35oDl0ohob7EnMAqSx8PWV88qoKA/MUgxaR9esglKJJ9t rm7UB8oXResYvy7HTw/qmlaMPfpjso8= X-Google-Smtp-Source: AGHT+IED6XZgzY4gzikh9jVcOtCfG30pXlWPiG3VmYbfMAiapZugf2M3Fo38yQBJ83I650i8jFbPBw== X-Received: by 2002:a67:cb92:0:b0:457:d691:b2f0 with SMTP id h18-20020a67cb92000000b00457d691b2f0mr5803731vsl.31.1697980519675; Sun, 22 Oct 2023 06:15:19 -0700 (PDT) Received: from localhost.localdomain (dsl-205-236-230-191.b2b2c.ca. [205.236.230.191]) by smtp.gmail.com with ESMTPSA id w20-20020a05620a149400b0076cbcf8ad3bsm2006997qkj.55.2023.10.22.06.15.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Oct 2023 06:15:19 -0700 (PDT) From: Maxim Cournoyer Date: Sun, 22 Oct 2023 09:15:04 -0400 Message-ID: <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::a33; envelope-from=maxim.cournoyer@gmail.com; helo=mail-vk1-xa33.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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) * doc/contributing.texi (Tracking Bugs and Changes) : New subsection. Change-Id: Icead24ec18cd4511ee6217aae3c1d11ec552a9c7 --- doc/contributing.texi | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 864190b119..a11747c3c7 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -605,7 +605,7 @@ Packaging Guidelines * Version Numbers:: When the name is not enough. * Synopses and Descriptions:: Helping users find the right package. * Snippets versus Phases:: Whether to use a snippet, or a build phase. -* Cyclic Module Dependencies:: Going full circle. +* Cyclic Module Dependencies:: Going full circle. * Emacs Packages:: Your Elisp fix. * Python Modules:: A touch of British comedy. * Perl Modules:: Little pearls. @@ -1763,6 +1763,7 @@ Tracking Bugs and Changes * Managing Patches and Branches:: How changes to Guix are managed. * Debbugs User Interfaces:: Ways to interact with Debbugs. * Debbugs Usertags:: Tag reports with custom labels. +* Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds. @end menu @node The Issue Tracker @@ -2012,6 +2013,43 @@ Debbugs Usertags consider updating this section of the manual so that others will know what your usertag means. +@node Cuirass Build Notifications +@subsection Cuirass Build Notifications + +@cindex build event notifications, RSS feed +@cindex notifications, build events +Cuirass, the software running on Berlin, one of the official build +servers, includes @acronym{RSS, Really Simple Syndication} feeds as one +of its features (@pxref{Notifications,,,cuirass}). This can be used to +keep track of recently broken or fixed packages caused by changes pushed +to the Guix git repository. Any RSS client can be used. A good one, +included with Emacs, is @xref{Gnus,,,gnus}. To register the feed, copy +its URL, then from the main Gnus buffer, @samp{*Group*}, do the +following: + +@cindex Gnus, configuration to read CI RSS feeds +@cindex RSS feeds, Gnus configuration +@example +@kbd{G R} https://ci.guix.gnu.org/events/rss/?specification=master RET +Guix CI - master RET Build events for specification master. RET +@end example + +@noindent +Then, back at the @samp{*Group*} buffer, press @kbd{s} to save the newly +added RSS group. As for any other Gnus group, you can update its +content by pressing the @kbd{g} key. You should now receive +notifications that read like: + +@example + . [ ?: Cuirass ] Build tree-sitter-meson.aarch64-linux on master is fixed. + . [ ?: Cuirass ] Build rust-pbkdf2.aarch64-linux on master is fixed. + . [ ?: Cuirass ] Build rust-pbkdf2.x86_64-linux on master is fixed. +@end example + +@noindent +where each RSS entry contains a link to the Cuirass build details page +of the associated build. + @node Commit Access @section Commit Access base-commit: e6af40d7b46b5c9e397a38c62c885fb42ccd9d26 -- 2.41.0 From unknown Tue Aug 12 08:33:45 2025 X-Loop: help-debbugs@gnu.org Subject: [bug#66681] [PATCH] doc: Document Cuirass build notifications. Resent-From: Mathieu Othacehe Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 23 Oct 2023 09:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66681 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Maxim Cournoyer Cc: 66681@debbugs.gnu.org Received: via spool by 66681-submit@debbugs.gnu.org id=B66681.169805215314667 (code B ref 66681); Mon, 23 Oct 2023 09:10:02 +0000 Received: (at 66681) by debbugs.gnu.org; 23 Oct 2023 09:09:13 +0000 Received: from localhost ([127.0.0.1]:49040 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quqvw-0003oV-N7 for submit@debbugs.gnu.org; Mon, 23 Oct 2023 05:09:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:37582) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quqvu-0003oE-Fw for 66681@debbugs.gnu.org; Mon, 23 Oct 2023 05:09:11 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1quqvL-0008Et-Cv; Mon, 23 Oct 2023 05:08:35 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=kIhyaz6KsX9y+nmMqLH3u1LMFmmhD5unyUaBxFu00pI=; b=LSdagWSo8AKcs2yy/r2O D9/jls5bw87D1qvvWCmB0HQdjkrBSnKB1PCTLwr8kKEVD5xVgBqPjpo5rl3K3CTotlGbkdSfARj7D EddDB3RBPKYmvOgTGfW3Uk4Vaf//A7h+4Wcr01OzLXqdhfmxN4pvR1arnCGDqzGtVNotzhMcjF+XE CO5lpsKwbHtDyvPh17iNcuNcUizFlbEmrcQQx+UD0WC8VHfcHW1P9mV5zFba3iC5Nfi37PAvxYBhs mp+9riI9Ha6qxBsPTXZ4ByVLRw1O7vsgeHv81a+CR0aUPlTktLmbhtIMXssfAKVIf3vhP2GpQf3Ev EUYVg6WHXNcDdg==; From: Mathieu Othacehe In-Reply-To: <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> (Maxim Cournoyer's message of "Sun, 22 Oct 2023 09:15:04 -0400") References: <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> Date: Mon, 23 Oct 2023 11:08:32 +0200 Message-ID: <87a5s9g0z3.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hello Maxim, > +Cuirass, the software running on Berlin, one of the official build > +servers, includes @acronym{RSS, Really Simple Syndication} feeds as one > +of its features (@pxref{Notifications,,,cuirass}). This can be used to I think it is worth mentioning that any deployed Cuirass installation will offer RSS support, because the above statement can make people think that only the Berlin instance does. Otherwise it looks good to me :) Thanks, Mathieu From unknown Tue Aug 12 08:33:45 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Maxim Cournoyer Subject: bug#66681: closed (Re: [bug#66681] [PATCH] doc: Document Cuirass build notifications.) Message-ID: References: <87il6x737h.fsf@gmail.com> <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> X-Gnu-PR-Message: they-closed 66681 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: patch Reply-To: 66681@debbugs.gnu.org Date: Mon, 23 Oct 2023 15:46:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1698075962-6783-1" This is a multi-part message in MIME format... ------------=_1698075962-6783-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #66681: [PATCH] doc: Document Cuirass build notifications. which was filed against the guix-patches package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 66681@debbugs.gnu.org. --=20 66681: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D66681 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1698075962-6783-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 66681-done) by debbugs.gnu.org; 23 Oct 2023 15:45:48 +0000 Received: from localhost ([127.0.0.1]:51373 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qux7k-0001ks-42 for submit@debbugs.gnu.org; Mon, 23 Oct 2023 11:45:48 -0400 Received: from mail-qk1-x72e.google.com ([2607:f8b0:4864:20::72e]:42491) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qux7f-0001kZ-3W for 66681-done@debbugs.gnu.org; Mon, 23 Oct 2023 11:45:46 -0400 Received: by mail-qk1-x72e.google.com with SMTP id af79cd13be357-77891f362cfso282114585a.1 for <66681-done@debbugs.gnu.org>; Mon, 23 Oct 2023 08:45:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1698075908; x=1698680708; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=y3gaCRwUSuyix8Lo8NSDoIuX0nc0j2xC9l6rmtFI8NI=; b=GjE7IoWlR7KQb2+YCVdEESnlpHTU2bA8Hz25+LByBlJUbN+s0+G01QQCMGXmU5HRSV F7g1JLlqtjUlCon9e1sfuSSQioX++MPfwHNJzsyn1VLtowQdG80GVapE0uJmZAvaIGn3 kuGqq8q6wSBjRc/GIj2Htmm8jxhTrqTpmcRFq+Uo+hYuAeSc4dRt694FSRX5xPKdR5Fp tCv+eLgwRQEL69EA5UVupmNtEYLbYIFE7+Nj0hnkv7u2j+drCe5ydvrD+zFamIyz8qLX UVfU6VvL1nnlcuEF1QUvkpBnqA3iZgnzuywv2PCKfegzben2pBrJ6UqhUtgLBKZHOKKk vJbw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698075908; x=1698680708; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=y3gaCRwUSuyix8Lo8NSDoIuX0nc0j2xC9l6rmtFI8NI=; b=idMRcXNJx/wtu54KFfg2+raFIoW3OftPWIzzAUXwnuTWXELE18mU6lzaMCPM6nv7z9 ovDy03X+RptDsd/CVzWM/5pBbxIdjH3+wRYYcePffZsEoUvNt44KlhmguyMnxLRRYX9A 7rnHov70cSI/cPcK4RjNM6neKXfM26PBb6NXEPMRK5sC9vya5tP9YUZsEZlekUg96kq3 kw6BuxBLQfIwTKxgvWz6aE/XiKyo/oRSmY/5dbNUtaxGLHvxJZC+mzOn/s0yMU2Bma7C cdt1WoIo0DD/5aR9tbE19rDTN7wRv3hIB02PSm7Cl/aWCxZcEyyQA5FTsAsIr19s9Ad9 Bskg== X-Gm-Message-State: AOJu0YxSU3Dy8YPwWy9HdkKy3/QrzPPOVp8+YdxchGz7TaEnbAKbyCU7 YB/M4nuM0axonY2KlWDWzUkRPLITEtjNKQ== X-Google-Smtp-Source: AGHT+IFliSqZiv/qKoxcHXcAui0MIYHxo1qIOz+Cydw5oH9QFUac+oaD+2M8IJ/bpr6rPVGeYCXpOA== X-Received: by 2002:a05:620a:4441:b0:779:d17f:68c8 with SMTP id w1-20020a05620a444100b00779d17f68c8mr5413935qkp.18.1698075908271; Mon, 23 Oct 2023 08:45:08 -0700 (PDT) Received: from hurd (dsl-10-148-194.b2b2c.ca. [72.10.148.194]) by smtp.gmail.com with ESMTPSA id l10-20020a05620a0c0a00b0077589913a8bsm2759215qki.132.2023.10.23.08.45.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 23 Oct 2023 08:45:07 -0700 (PDT) From: Maxim Cournoyer To: Mathieu Othacehe Subject: Re: [bug#66681] [PATCH] doc: Document Cuirass build notifications. In-Reply-To: <87a5s9g0z3.fsf@gnu.org> (Mathieu Othacehe's message of "Mon, 23 Oct 2023 11:08:32 +0200") References: <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> <87a5s9g0z3.fsf@gnu.org> Date: Mon, 23 Oct 2023 11:45:06 -0400 Message-ID: <87il6x737h.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 66681-done Cc: 66681-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi Mathieu, Mathieu Othacehe writes: > Hello Maxim, > >> +Cuirass, the software running on Berlin, one of the official build >> +servers, includes @acronym{RSS, Really Simple Syndication} feeds as one >> +of its features (@pxref{Notifications,,,cuirass}). This can be used to > > I think it is worth mentioning that any deployed Cuirass installation > will offer RSS support, because the above statement can make people > think that only the Berlin instance does. > > Otherwise it looks good to me :) I've rephrased the first sentence to hopefully remove any ambiguity. See cbd20d6274. -- Thanks, Maxim ------------=_1698075962-6783-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 22 Oct 2023 13:16:03 +0000 Received: from localhost ([127.0.0.1]:45634 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quYJG-0005We-JL for submit@debbugs.gnu.org; Sun, 22 Oct 2023 09:16:03 -0400 Received: from lists.gnu.org ([2001:470:142::17]:42166) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quYJE-0005WA-0k for submit@debbugs.gnu.org; Sun, 22 Oct 2023 09:16:01 -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 1quYIe-00024I-M4 for guix-patches@gnu.org; Sun, 22 Oct 2023 09:15:24 -0400 Received: from mail-vk1-xa33.google.com ([2607:f8b0:4864:20::a33]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1quYIb-0006jr-9z for guix-patches@gnu.org; Sun, 22 Oct 2023 09:15:24 -0400 Received: by mail-vk1-xa33.google.com with SMTP id 71dfb90a1353d-49e1ef0c60dso987837e0c.1 for ; Sun, 22 Oct 2023 06:15:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1697980520; x=1698585320; darn=gnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=s8JxovA2MZBxRtbOSRf3wMoyfXRchFxNZ3YyIs/L2DA=; b=ZOdDBSt9eJMQKVSailQWbGy8SbizJHzbo1JbVjkHCoq3dhVfaYkDHukhGaLZ5BZhO6 i3gM0qMy7NJttEslL8/cJ2trUAtSZn8MaqksAVyPsqTYqGInqrpc1WlbtRm015FZXgov XUnW+1Na1Nnlh5M8pLDJSeZegSfokZlDYDgjIqHyeUCB+FfiSgffkjszN1Zmt49pQvHR q33fzMp+1+vGXG7I/PuMNJM6gJ7mbtdMVl0SYKWzGSmgyIV1NfsonD7EFquLy1qcN+zf jGBQ8/+ktLir0Q2yWh+ZyN7iQ3Df+8ocfWE4OzsSbvQLzx8kdijgoRpaWtMFvs+zj7+D R2+w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697980520; x=1698585320; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=s8JxovA2MZBxRtbOSRf3wMoyfXRchFxNZ3YyIs/L2DA=; b=d6hv6Gp6q5zTNaB0lO+IYL7E8daIO8x4iSZYfyiVWBY0gzmxy8TU/gf3p+ZX44z+Y9 CzYkeE0qTowuL0BTKSHuf+tGh3hV+4RiSssEd3BNv9cILvXstfD1uja1IOyr+EFq73Fh Ii0HFcVC0jZy4uNbZxnnHJwurBtGm3bqEpFBx2Trfpw1nqZ3EA/40ObaWXTB2zd3DWfj NawZPNR3UNoq0yKdrJCbzsSyOm0bi8800eHMUuPMRpqtLuAmK9hwzlyDVQHJjW0i+6AQ byiNgQjOwDpI5+nlcZouqDDAgtC851Px20APzCZcMqFirnyfAL0oXashq9zTAVjaqhpS Y5ag== X-Gm-Message-State: AOJu0YwRHLA35oDl0ohob7EnMAqSx8PWV88qoKA/MUgxaR9esglKJJ9t rm7UB8oXResYvy7HTw/qmlaMPfpjso8= X-Google-Smtp-Source: AGHT+IED6XZgzY4gzikh9jVcOtCfG30pXlWPiG3VmYbfMAiapZugf2M3Fo38yQBJ83I650i8jFbPBw== X-Received: by 2002:a67:cb92:0:b0:457:d691:b2f0 with SMTP id h18-20020a67cb92000000b00457d691b2f0mr5803731vsl.31.1697980519675; Sun, 22 Oct 2023 06:15:19 -0700 (PDT) Received: from localhost.localdomain (dsl-205-236-230-191.b2b2c.ca. [205.236.230.191]) by smtp.gmail.com with ESMTPSA id w20-20020a05620a149400b0076cbcf8ad3bsm2006997qkj.55.2023.10.22.06.15.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Oct 2023 06:15:19 -0700 (PDT) From: Maxim Cournoyer To: guix-patches@gnu.org, maxim.cournoyer@gmail.com Subject: [PATCH] doc: Document Cuirass build notifications. Date: Sun, 22 Oct 2023 09:15:04 -0400 Message-ID: <54f0a61d14743718e83abde603e7ec5b88af7c31.1697980504.git.maxim.cournoyer@gmail.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::a33; envelope-from=maxim.cournoyer@gmail.com; helo=mail-vk1-xa33.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 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) * doc/contributing.texi (Tracking Bugs and Changes) : New subsection. Change-Id: Icead24ec18cd4511ee6217aae3c1d11ec552a9c7 --- doc/contributing.texi | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 864190b119..a11747c3c7 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -605,7 +605,7 @@ Packaging Guidelines * Version Numbers:: When the name is not enough. * Synopses and Descriptions:: Helping users find the right package. * Snippets versus Phases:: Whether to use a snippet, or a build phase. -* Cyclic Module Dependencies:: Going full circle. +* Cyclic Module Dependencies:: Going full circle. * Emacs Packages:: Your Elisp fix. * Python Modules:: A touch of British comedy. * Perl Modules:: Little pearls. @@ -1763,6 +1763,7 @@ Tracking Bugs and Changes * Managing Patches and Branches:: How changes to Guix are managed. * Debbugs User Interfaces:: Ways to interact with Debbugs. * Debbugs Usertags:: Tag reports with custom labels. +* Cuirass Build Notifications:: Be alerted of any breakage via RSS feeds. @end menu @node The Issue Tracker @@ -2012,6 +2013,43 @@ Debbugs Usertags consider updating this section of the manual so that others will know what your usertag means. +@node Cuirass Build Notifications +@subsection Cuirass Build Notifications + +@cindex build event notifications, RSS feed +@cindex notifications, build events +Cuirass, the software running on Berlin, one of the official build +servers, includes @acronym{RSS, Really Simple Syndication} feeds as one +of its features (@pxref{Notifications,,,cuirass}). This can be used to +keep track of recently broken or fixed packages caused by changes pushed +to the Guix git repository. Any RSS client can be used. A good one, +included with Emacs, is @xref{Gnus,,,gnus}. To register the feed, copy +its URL, then from the main Gnus buffer, @samp{*Group*}, do the +following: + +@cindex Gnus, configuration to read CI RSS feeds +@cindex RSS feeds, Gnus configuration +@example +@kbd{G R} https://ci.guix.gnu.org/events/rss/?specification=master RET +Guix CI - master RET Build events for specification master. RET +@end example + +@noindent +Then, back at the @samp{*Group*} buffer, press @kbd{s} to save the newly +added RSS group. As for any other Gnus group, you can update its +content by pressing the @kbd{g} key. You should now receive +notifications that read like: + +@example + . [ ?: Cuirass ] Build tree-sitter-meson.aarch64-linux on master is fixed. + . [ ?: Cuirass ] Build rust-pbkdf2.aarch64-linux on master is fixed. + . [ ?: Cuirass ] Build rust-pbkdf2.x86_64-linux on master is fixed. +@end example + +@noindent +where each RSS entry contains a link to the Cuirass build details page +of the associated build. + @node Commit Access @section Commit Access base-commit: e6af40d7b46b5c9e397a38c62c885fb42ccd9d26 -- 2.41.0 ------------=_1698075962-6783-1--