From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 sKF4KyFN9mTZ9QAAauVa8A:P1 (envelope-from ) for ; Mon, 04 Sep 2023 23:33:21 +0200 Received: from aspmx1.migadu.com ([2001:41d0:306:2d92::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id sKF4KyFN9mTZ9QAAauVa8A (envelope-from ) for ; Mon, 04 Sep 2023 23:33:21 +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 CB9DC4297B for ; Mon, 4 Sep 2023 23:33:20 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=systemreboot.net header.s=default header.b=pLmrCBrF; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=systemreboot.net (policy=none) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693863201; h=from:from:sender:sender: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-cc: resent-from:resent-sender:resent-message-id:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=rDF9XoY21W/+3X3J4juN4tSydbDEQFu5CHSNiuwQAVE=; b=RK2m5mN9KgDRW3I/eWKVkeeaMPnIdJF0GwKEEZEarG5RN45tR3YeYLSdJLBqQnaGootvmS BcBkGdPYhwchnXStt+KZf1FdRPlXHQV5vYvB0rX5qboRQfuZX91UdOGXaTIHIMpYZg/myx GLUVhtFRvXHaTlXGfp6vBs13hjE/fkvpdCMlf+5mO2GfjQP0BY/x3QAcN/yGpdeVT3d4Wz CMx6VHAhmkJLky/lbYB+0MnS7naZWJSQ8VpRLUQGK/8VHYQ8xZNFSEeaPwmuppDiMLxvKY O2X6cKb13xzbhYJ5qON5fcF4LYLpJ0a+xfYKBEOZzYxsmxG+6Rr+RoAoLUQ4vA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693863201; a=rsa-sha256; cv=none; b=jo5jmaO4Buca4KjkqU09Hip6C62bTh7JJ5q5GBgXJter2aYpeXUDfTRuc9iqVHbD6xfKy9 HlldUScovV0KxGKheCXvJBQZZ9FtnoO6+yakaWby18Xyqpc1BzUe18YB9UjdkXT0RccT86 uW9+9gef9XEJN6AR7mvtW3PuybGvf98cXfLO/PJZn79nyvK8k6nndjiIYRBkqu1F4b934i 1vraVIUZBI5beDY1fpDJJdWw7K+TTS5vab/Gl9LGknmGlikULh8W6+fp+4HY6JQ7T2cvxY j3gdN1t4nnxL8JukopqRyLOExNSVAXTevpW6XfxBs/ZsegEBxg3tMOaDcvwHwQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=systemreboot.net header.s=default header.b=pLmrCBrF; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=systemreboot.net (policy=none) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdHBx-0005rf-0M; Mon, 04 Sep 2023 17:33:05 -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 1qdHBu-0005rB-U9 for guix-patches@gnu.org; Mon, 04 Sep 2023 17:33:02 -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 1qdHBu-0003z6-K7 for guix-patches@gnu.org; Mon, 04 Sep 2023 17:33:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1qdHBu-0003Vy-DH for guix-patches@gnu.org; Mon, 04 Sep 2023 17:33:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#65746] [PATCH] doc: Document mumi command-line interface. Resent-From: Arun Isaac Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 04 Sep 2023 21:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 65746 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 65746@debbugs.gnu.org Cc: Arun Isaac X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.169386316513483 (code B ref -1); Mon, 04 Sep 2023 21:33:02 +0000 Received: (at submit) by debbugs.gnu.org; 4 Sep 2023 21:32:45 +0000 Received: from localhost ([127.0.0.1]:52847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qdHBc-0003VO-Er for submit@debbugs.gnu.org; Mon, 04 Sep 2023 17:32:44 -0400 Received: from lists.gnu.org ([2001:470:142::17]:49028) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qdHBY-0003V9-Q6 for submit@debbugs.gnu.org; Mon, 04 Sep 2023 17:32:43 -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 1qdHBT-0005oj-0m for guix-patches@gnu.org; Mon, 04 Sep 2023 17:32:35 -0400 Received: from mugam.systemreboot.net ([139.59.75.54]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qdHBN-0003o2-Se for guix-patches@gnu.org; Mon, 04 Sep 2023 17:32:34 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=systemreboot.net; s=default; h=Content-Transfer-Encoding:Content-Type: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=rDF9XoY21W/+3X3J4juN4tSydbDEQFu5CHSNiuwQAVE=; b=pLmrCBrF3JB/GpSDM6+1NJWk15 GqmLOmHS2+iuw3NGzRuKjCt25tgbTnVw164f6xlwe79FqVL43QpMp6uR6VttpUGR68cf9j8yVLBIo Mcc+QBS+81JOWiWPrHdlTSwWOzxbASMehYzJHkgGdGBsxYtOA3XGHsme2xa5j1quh1pRyogY/iH3F UOXm9n84N7znQ3CPXTU8kq9YsVvew7gfzZ/MVMZkOReVSehXjpJNGyeC51NH/fRzXkuEs27lLiIa1 5Wb/+mSW7krYe7CIQwLyaXX2P/5/hwD9EIqSpK1oTCVz7axAjMxmEqoYAZh80lRwJ9FnijP8vhxgb dl0IcYxw==; Received: from [192.168.2.1] (port=57256 helo=localhost.localdomain) by systemreboot.net with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96) (envelope-from ) id 1qdHBG-001CqG-09; Mon, 04 Sep 2023 22:32:22 +0100 From: Arun Isaac Date: Mon, 4 Sep 2023 22:31:57 +0100 Message-ID: X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=139.59.75.54; envelope-from=arunisaac@systemreboot.net; helo=mugam.systemreboot.net 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, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Scanner: mx2.migadu.com X-Spam-Score: -4.12 X-Migadu-Queue-Id: CB9DC4297B X-Migadu-Spam-Score: -4.12 X-TUID: skhZF5+qUR8I * doc/contributing.texi (Debbugs User Interfaces)[Command-line interface]: New subsubsection. * doc/guix.texi: Bump copyright year. --- doc/contributing.texi | 84 +++++++++++++++++++++++++++++++++++++++++++ doc/guix.texi | 2 +- 2 files changed, 85 insertions(+), 1 deletion(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index 69f0327afb..d752838861 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1625,6 +1625,8 @@ Managing Patches and Branches @node Debbugs User Interfaces @subsection Debbugs User Interfaces +@subsubsection Web interface + A web interface (actually @emph{two} web interfaces!) are available to browse issues: @@ -1646,6 +1648,88 @@ Debbugs User Interfaces @indicateurl{https://issues.guix.gnu.org/@var{n}} or @indicateurl{https://bugs.gnu.org/@var{n}}. +@subsubsection Command-line interface + +Mumi also comes with a command-line interface that can be used to search +existing issues, open new issues and send patches. You do not need to +use Emacs to use the mumi command-line client. You interact with it +only on the command-line. + +To use the mumi command-line interface, navigate to a local clone of the +guix git repository, and drop into a shell with mumi, git and +git:send-email installed. + +@example +$ cd guix +~/guix$ guix shell mumi git git:send-email +@end example + +To search for issues, say all open issues about "zig", run + +@example +~/guix [env]$ mumi search zig is:open + +#60889 Add zig-build-system +opened on 17 Jan 17:37 Z by Ekaitz Zarraga +#61036 [PATCH 0/3] Update zig to 0.10.1 +opened on 24 Jan 09:42 Z by Efraim Flashner +#39136 [PATCH] gnu: services: Add endlessh. +opened on 14 Jan 2020 21:21 by Nicol? Balzarotti +#60424 [PATCH] gnu: Add python-online-judge-tools +opened on 30 Dec 2022 07:03 by gemmaro +#45601 [PATCH 0/6] vlang 0.2 update +opened on 1 Jan 2021 19:23 by Ryan Prior +@end example + +Pick an issue and make it the "current" issue. + +@example +~/guix [env]$ mumi current 61036 + +#61036 [PATCH 0/3] Update zig to 0.10.1 +opened on 24 Jan 09:42 Z by Efraim Flashner +@end example + +Once an issue is the current issue, you can easily create and send +patches to it using + +@example +~/guix [env]$ git format-patch origin/master +~/guix [env]$ mumi send-email foo.patch bar.patch +@end example + +Note that you do not have to pass in @samp{--to} or @samp{--cc} +arguments to @command{git format-patch}. @command{mumi send-email} will +put them in correctly when sending the patches. + +To open a new issue, run + +@example +~/guix [env]$ mumi new +@end example + +and send patches + +@example +~/guix [env]$ mumi send-email foo.patch bar.patch +@end example + +@command{mumi send-email} is really a wrapper around @command{git +send-email} that automates away all the nitty-gritty of sending patches. +It uses the current issue state to automatically figure out the correct +@samp{To} address to send to, other participants to @samp{Cc}, headers +to add, etc. + +Also note that, unlike @command{git send-email}, @command{mumi +send-email} works perfectly well with single and multiple patches alike. +It automates away the debbugs dance of sending the first patch, waiting +for a response from debbugs and sending the remaining patches. It does +so by sending the first patch, polling the server for a response, and +then sending the remaining patches. This polling can unfortunately take +a few minutes. So, please be patient. + +@subsubsection Emacs interface + If you use Emacs, you may find it more convenient to interact with issues using @file{debbugs.el}, which you can install with: diff --git a/doc/guix.texi b/doc/guix.texi index 9e79641736..eca9c3c487 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -53,7 +53,7 @@ Copyright @copyright{} 2017–2022 Tobias Geerinckx-Rice@* Copyright @copyright{} 2017 George Clemmer@* Copyright @copyright{} 2017 Andy Wingo@* -Copyright @copyright{} 2017, 2018, 2019, 2020 Arun Isaac@* +Copyright @copyright{} 2017, 2018, 2019, 2020, 2023 Arun Isaac@* Copyright @copyright{} 2017 nee@* Copyright @copyright{} 2018 Rutger Helling@* Copyright @copyright{} 2018, 2021 Oleg Pykhalov@* base-commit: bedcdf0fb5ac035f696790827679406c7146396c -- 2.39.2