From unknown Tue Sep 23 13:12:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#79484: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add new ones Resent-From: James Thomas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 21 Sep 2025 22:58:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 79484 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: 79484@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.17584954788827 (code B ref -1); Sun, 21 Sep 2025 22:58:04 +0000 Received: (at submit) by debbugs.gnu.org; 21 Sep 2025 22:57:58 +0000 Received: from localhost ([127.0.0.1]:57819 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1v0T0I-0002IJ-9Z for submit@debbugs.gnu.org; Sun, 21 Sep 2025 18:57:58 -0400 Received: from lists.gnu.org ([2001:470:142::17]:57334) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1v0T0B-0002H9-6d for submit@debbugs.gnu.org; Sun, 21 Sep 2025 18:57:55 -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 1v0T00-0003Ri-V8 for bug-gnu-emacs@gnu.org; Sun, 21 Sep 2025 18:57:41 -0400 Received: from mout.gmx.net ([212.227.15.15]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1v0Szm-00066Z-AE for bug-gnu-emacs@gnu.org; Sun, 21 Sep 2025 18:57:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net; s=s31663417; t=1758495437; x=1759100237; i=jimjoe@gmx.net; bh=wW4cNookMPLzpxjYe7tyM4EMhBVImrZweEfmXj6JW5w=; h=X-UI-Sender-Class:From:To:Subject:Date:Message-ID:MIME-Version: Content-Type:cc:content-transfer-encoding:content-type:date:from: message-id:mime-version:reply-to:subject:to; b=fBh3xVpsGc1DoB0Tq2SG72zHOynu3l8DUP4kHyM3hY+kfzhK2vHsXT1jtsMDUuFO bkS8KVd8JXaBxTKbZzlxvvXJiCetJTuIBh1U3ezj35xe1Xr0wHNUDQadRwqPlaPQ5 fMbILgSyad5NQL32+5lvwYaI0uz9kH3JGV9YQqejUtiL4bFRrv7f5dj7O52u5hGwo 8y2ZftDxHJx8cnX15eEqF2rY1h2Me30ihD+b96gK87UviKiomm379/ppPRMMMyF/t Sviusu81pbB5foidXC+98vyOJp3C6E7wRXjl4RqT8cLQLQvg8b745tT/SYXUWDnv1 1xvLl/VBTIH7u8EO3w== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from oldmac ([42.108.28.3]) by mail.gmx.net (mrgmx005 [212.227.17.184]) with ESMTPSA (Nemesis) id 1MLQxN-1ujlBn11cJ-00MkLG for ; Mon, 22 Sep 2025 00:57:17 +0200 From: James Thomas Date: Mon, 22 Sep 2025 04:19:28 +0530 Message-ID: <7yjz1rl8uf.fsf@gmx.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Provags-ID: V03:K1:o9ZxubhynZe0IR3rtPHJ5o2vSI3AR0dixFTOPWvxLbocIvxezAz UpjJZdn7b5I4FyeaL9l7J5TurvFX9pBkxvKR/NPfke1oR1A7xq2xptCtA9atL+9xSmM0JRj yJ0ax560GdACfHq7XhOorB+NjwxYZyYPcEp9xXh0jd57XOIqBcxWa75phLkg9cdE1Z1Ufj0 1nPn7J7/2QbIyZlydi7Lg== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:DV8kafRG2Ic=;xJkIHDVHJ0lL0O7JKSvVMJl8qlx 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 W0m9gXNK+hgeFJd/drQtArQwmMnQ Received-SPF: pass client-ip=212.227.15.15; envelope-from=jimjoe@gmx.net; helo=mout.gmx.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 0.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: -1.0 (-) --=-=-= Content-Type: text/plain As used in gnus-start.el & gnus-int.el (for nntp & nnimap as of now). --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-misc-gnus-texi--Optional-Back-End-Function.patch Content-Description: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add Content-Transfer-Encoding: quoted-printable =46rom b0259e2d3cc5f3421a1369d6724b06d4319313d5 Mon Sep 17 00:00:00 2001 From: James Thomas Date: Mon, 22 Sep 2025 03:15:54 +0530 Subject: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add newer ones. =2D-- doc/misc/gnus.texi | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index afde6d5c4d6..b1fccfcf25f 100644 =2D-- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -30276,6 +30276,16 @@ Optional Back End Functions group-buffer =3D *active-line / *group-status @end example =20 +@item (nnchoke-retrieve-group-data-early SERVER &optional INFOS) + +This is for starting an early async retrieval from @code{server} to +update @code{infos}, its current @xref{Group Info} list. The return +value is a token for the corresponding ``-finish-'' function (below). + +@item (nnchoke-finish-retrieve-group-infos SERVER INFOS DATA) + +This will be called later to conclude the async retrieval (above) - +whose token is passed as @code{data} - and should update @code{infos}. =20 @item (nnchoke-request-update-info GROUP INFO &optional SERVER) =20 =2D-=20 2.51.0 --=-=-= Content-Type: text/plain -- --=-=-=-- From unknown Tue Sep 23 13:12:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#79484: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add new ones Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 22 Sep 2025 06:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 79484 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: James Thomas Cc: 79484@debbugs.gnu.org Received: via spool by 79484-submit@debbugs.gnu.org id=B79484.175852289018843 (code B ref 79484); Mon, 22 Sep 2025 06:35:02 +0000 Received: (at 79484) by debbugs.gnu.org; 22 Sep 2025 06:34:50 +0000 Received: from localhost ([127.0.0.1]:60433 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1v0a8Q-0004tn-26 for submit@debbugs.gnu.org; Mon, 22 Sep 2025 02:34:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:56178) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1v0a8N-0004t3-Um for 79484@debbugs.gnu.org; Mon, 22 Sep 2025 02:34:48 -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 1v0a8I-0003yT-8y; Mon, 22 Sep 2025 02:34:42 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=sItDtFeBdAOK2xVbr2ChooRp04Gm443YSTuEb03oeDk=; b=Dwo6jWTOtRdy ADJQogLFNJhrj6oAQlID1oUVnNkJhP8viT8Bi+WsFuhSPIjqDcjkEjCyqYVlkgXDdw9AR6en0kMaX vUqkheTw0kFVND5MPWzGJ0ftyxwJ7fXPClpzoPItdw2xhsG8uvcC9ChQZ2j8B/RvuamNGzrUurW4f rs0UogKKCVhXwjdgrctCDz4q1CMSyqHqlILEw9t0tHkMKIrZJpbFvahv4VvKD408HkKr2G8/mXHW0 blLarpH+2squKxwp1jYjT1Sz8IdFGL1Xil+iTG7Oi5JUV0O+ZzxtHbeUZx6HsQVN+A5O1/DCu9zhl vxzyCAKU6ZKaSy30w8tNEQ==; Date: Mon, 22 Sep 2025 09:34:38 +0300 Message-Id: <86zfandmgx.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <7yjz1rl8uf.fsf@gmx.net> (bug-gnu-emacs@gnu.org) References: <7yjz1rl8uf.fsf@gmx.net> 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 (---) > Date: Mon, 22 Sep 2025 04:19:28 +0530 > From: James Thomas via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > As used in gnus-start.el & gnus-int.el (for nntp & nnimap as of now). Thanks. The patch as submitted has several markup and Texinfo usage issues, see below. > +@item (nnchoke-retrieve-group-data-early SERVER &optional INFOS) The arguments should be in @var{...} and should not be capitalized. (Yes, I know all the rest of this node and its parent and siblings use this incorrect practice, but at the very least we should not proliferate the mistakes. Bonus points for fixing those other nodes as well.) > +This is for starting an early async retrieval from @code{server} to > +update @code{infos}, References to function arguments should use @var, not @code. > its current @xref{Group Info} list. The return @xref is only appropriate at the beginning of a sentence, because it produces a capitalized "See". Also, our convention is to leave 2 spaces between sentences. > +value is a token for the corresponding ``-finish-'' function (below). ^^^^^^^^^^^^ This should be in @code, not quoted by ``...''. > +@item (nnchoke-finish-retrieve-group-infos SERVER INFOS DATA) > + > +This will be called later to conclude the async retrieval (above) - > +whose token is passed as @code{data} - and should update @code{infos}. Same here. Also, please use "--" for a dash, since a single "-" will be typeset as a minus sign, which is not what you want. From unknown Tue Sep 23 13:12:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#79484: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add new ones Resent-From: James Thomas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 22 Sep 2025 23:35:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 79484 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 79484@debbugs.gnu.org Received: via spool by 79484-submit@debbugs.gnu.org id=B79484.175858407413601 (code B ref 79484); Mon, 22 Sep 2025 23:35:02 +0000 Received: (at 79484) by debbugs.gnu.org; 22 Sep 2025 23:34:34 +0000 Received: from localhost ([127.0.0.1]:36845 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1v0q3F-0003XI-7S for submit@debbugs.gnu.org; Mon, 22 Sep 2025 19:34:34 -0400 Received: from mout.gmx.net ([212.227.15.19]:55789) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1v0q3B-0003Wp-EY for 79484@debbugs.gnu.org; Mon, 22 Sep 2025 19:34:31 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net; s=s31663417; t=1758584062; x=1759188862; i=jimjoe@gmx.net; bh=B/BiPYWafpwE8dLkBnh3sOzzh8+9TFF9TcOMIFDg1MM=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:Date:Message-ID: References:MIME-Version:Content-Type:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=cEzfy4RtHX4kX9OQ3x+fLvGCGssj3qmbAEHvw99R5ZTSyr4cq3yTfKJFRG19J1vk c9ijBeNRFrx/xTmjkn5xNj8u965/+FpAYo/CkWSQV15OYLshBX/OKgQU7Uj+rcMRe gc1cCObImtbtzvR0RH1eqfpAq21HGFipCmeryHMR0sDZDM6AUAAnbG5AkF5YUzo7b LAWARvfoKJAHD3uL6CS6Ja8wfr0uKVmlCvZQMAa2A+Gwbs9GDxvd9gVoDUy/eFWui y1wSBXsobdhuv14XYltFlT1qRo62J/gbWzOJTs1QMnCujeTo9rzutIwlLJZGJgCRz IJ4cVvUgDKUe7kbMWA== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from oldmac ([42.108.28.23]) by mail.gmx.net (mrgmx005 [212.227.17.184]) with ESMTPSA (Nemesis) id 1N4hvR-1uK2gc1dLz-015fLx; Tue, 23 Sep 2025 01:34:22 +0200 From: James Thomas In-Reply-To: <86zfandmgx.fsf@gnu.org> Date: Tue, 23 Sep 2025 04:56:04 +0530 Message-ID: <7yqzvyxe5v.fsf@gmx.net> References: <7yjz1rl8uf.fsf@gmx.net> <86zfandmgx.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Provags-ID: V03:K1:cngEohKf80uVpEO6fWrKaoSrH5v1oiWLZuRy3uyEkjJvobHJHSR 1aWwVIutY/pW6pf0SbNC15nXy9bu9m9+DJPj4H8Xvc8uhWVjYEuB2EfSuVm5HVJv70mjkjQ 5rEATO2UIOEXT09EzBUCrdCxXyL67eFJUS+SNaDta/XvdlnQ+8sJXIvfqA7OSPHoeakkG1r H1AJxD7oWqV6qoDWDC3Cg== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:w1Da3C12TgI=;j2T9ma09lH43WAI/4zxIqqfxKGO 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 m X-Spam-Score: -0.7 (/) 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.7 (-) --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Eli Zaretskii wrote: >> Date: Mon, 22 Sep 2025 04:19:28 +0530 >> From: James Thomas via "Bug reports for GNU Emacs, >> the Swiss army knife of text editors" >>=20 >> As used in gnus-start.el & gnus-int.el (for nntp & nnimap as of now). > > Thanks. > > The patch as submitted has several markup and Texinfo usage issues, > see below. > > ... Sorry, corrected: --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-misc-gnus-texi--Optional-Back-End-Function.patch Content-Description: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add Content-Transfer-Encoding: quoted-printable =46rom 3b2992ad8079f4814a8001680c6bed716b6a9466 Mon Sep 17 00:00:00 2001 From: James Thomas Date: Mon, 22 Sep 2025 03:15:54 +0530 Subject: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add newer ones. =2D-- doc/misc/gnus.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index afde6d5c4d6..d30e4481fae 100644 =2D-- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -30276,6 +30276,18 @@ Optional Back End Functions group-buffer =3D *active-line / *group-status @end example =20 +@item (nnchoke-retrieve-group-data-early SERVER &optional INFOS) + +This is for starting an early async retrieval from @var{server} to +update @var{infos}, its current group info structure list. The return +value is a token for the corresponding +@code{nnchoke-finish-retrieve-group-infos}. + +@item (nnchoke-finish-retrieve-group-infos SERVER INFOS DATA) + +This will be called later to conclude the async retrieval of +@code{nnchoke-retrieve-group-data-early} -- whose token is passed as +@var{data} -- and should update @var{infos}. =20 @item (nnchoke-request-update-info GROUP INFO &optional SERVER) =20 =2D-=20 2.51.0 --=-=-= Content-Type: text/plain > (Yes, I know all the rest of this node and its parent and siblings use > this incorrect practice, but at the very least we should not > proliferate the mistakes. Bonus points for fixing those other nodes > as well.) I have done that as a separate patch, for absolution. :-) --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0002-doc-misc-gnus-texi-Fix-formatting.patch Content-Description: [PATCH] ; * doc/misc/gnus.texi Fix formatting. Content-Transfer-Encoding: quoted-printable =46rom 2eeacc9439248643af6a2e4535e0ea2bf7253b5a Mon Sep 17 00:00:00 2001 From: James Thomas Date: Tue, 23 Sep 2025 04:46:48 +0530 Subject: [PATCH] ; * doc/misc/gnus.texi Fix formatting. =2D-- doc/misc/gnus.texi | 58 +++++++++++++++++++++++----------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index d30e4481fae..a447f1547da 100644 =2D-- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -30030,7 +30030,7 @@ Required Back End Functions =20 @table @code =20 -@item (nnchoke-retrieve-headers ARTICLES &optional GROUP SERVER FETCH-OLD= ) +@item (nnchoke-retrieve-headers @code{articles} &optional @code{group} @c= ode{server} @code{fetch-old}) =20 @var{articles} is either a range of article numbers or a list of @code{Message-ID}s. Current back ends do not fully support either---only @@ -30099,7 +30099,7 @@ Required Back End Functions @pxref{Headers}. =20 =20 -@item (nnchoke-open-server SERVER &optional DEFINITIONS) +@item (nnchoke-open-server @code{server} &optional @code{definitions}) =20 @var{server} is here the virtual server name. @var{definitions} is a list of @code{(VARIABLE VALUE)} pairs that define this virtual server. @@ -30112,7 +30112,7 @@ Required Back End Functions non-@code{nil} value. There should be no data returned. =20 =20 -@item (nnchoke-close-server &optional SERVER) +@item (nnchoke-close-server &optional @code{server}) =20 Close connection to @var{server} and free all resources connected to it. Return @code{nil} if the server couldn't be closed for some @@ -30131,7 +30131,7 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-server-opened &optional SERVER) +@item (nnchoke-server-opened &optional @code{server}) =20 If @var{server} is the current virtual server, and the connection to the physical server is alive, then this function should return a @@ -30141,14 +30141,14 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-status-message &optional SERVER) +@item (nnchoke-status-message &optional @code{server}) =20 This function should return the last error message from @var{server}. =20 There should be no data returned. =20 =20 -@item (nnchoke-request-article ARTICLE &optional GROUP SERVER TO-BUFFER) +@item (nnchoke-request-article @code{article} &optional @code{group} @cod= e{server} @code{to-buffer}) =20 The result data from this function should be the article specified by @var{article}. This might either be a @code{Message-ID} or a number. @@ -30169,7 +30169,7 @@ Required Back End Functions on successful article retrieval. =20 =20 -@item (nnchoke-request-group GROUP &optional SERVER FAST INFO) +@item (nnchoke-request-group @code{group} &optional @code{server} @code{f= ast} @code{info}) =20 Get data on @var{group}. This function also has the side effect of making @var{group} the current group. @@ -30204,7 +30204,7 @@ Required Back End Functions @end example =20 =20 -@item (nnchoke-close-group GROUP &optional SERVER) +@item (nnchoke-close-group @code{group} &optional @code{server}) =20 Close @var{group} and free any resources connected to it. This will be a no-op on most back ends. @@ -30212,7 +30212,7 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-list &optional SERVER) +@item (nnchoke-request-list &optional @code{server}) =20 Return a list of all groups available on @var{server}. And that means @emph{all}. @@ -30241,7 +30241,7 @@ Required Back End Functions (@samp{=3Dother-group}) or none of the above (@samp{y}). =20 =20 -@item (nnchoke-request-post &optional SERVER) +@item (nnchoke-request-post &optional @code{server}) =20 This function should post the current buffer. It might return whether the posting was successful or not, but that's not required. If, for @@ -30260,7 +30260,7 @@ Optional Back End Functions =20 @table @code =20 -@item (nnchoke-retrieve-groups GROUPS &optional SERVER) +@item (nnchoke-retrieve-groups @code{groups} &optional @code{server}) =20 @var{groups} is a list of groups, and this function should request data on all those groups. How it does it is of no concern to Gnus, but it @@ -30276,20 +30276,20 @@ Optional Back End Functions group-buffer =3D *active-line / *group-status @end example =20 -@item (nnchoke-retrieve-group-data-early SERVER &optional INFOS) +@item (nnchoke-retrieve-group-data-early @code{server} &optional @code{in= fos}) =20 This is for starting an early async retrieval from @var{server} to update @var{infos}, its current group info structure list. The return value is a token for the corresponding @code{nnchoke-finish-retrieve-group-infos}. =20 -@item (nnchoke-finish-retrieve-group-infos SERVER INFOS DATA) +@item (nnchoke-finish-retrieve-group-infos @code{server} @code{infos} @co= de{data}) =20 This will be called later to conclude the async retrieval of @code{nnchoke-retrieve-group-data-early} -- whose token is passed as @var{data} -- and should update @var{infos}. =20 -@item (nnchoke-request-update-info GROUP INFO &optional SERVER) +@item (nnchoke-request-update-info @code{group} @code{info} &optional @co= de{server}) =20 A Gnus group info (@pxref{Group Info}) is handed to the back end for alterations. This comes in handy if the back end really carries all @@ -30302,7 +30302,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-type GROUP &optional ARTICLE) +@item (nnchoke-request-type @code{group} &optional @code{article}) =20 When the user issues commands for ``sending news'' (@kbd{F} in the summary buffer, for instance), Gnus has to know whether the article the @@ -30316,7 +30316,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-set-mark GROUP ACTION &optional SERVER) +@item (nnchoke-request-set-mark @code{group} @code{action} &optional @cod= e{server}) =20 Set/remove/add marks on articles. Normally Gnus handles the article marks (such as read, ticked, expired etc.)@: internally, and store them i= n @@ -30327,7 +30327,7 @@ Optional Back End Functions @var{action} is a list of mark setting requests, having this format: =20 @example -(RANGE ACTION MARK) +(@code{range} @code{action} @code{mark}) @end example =20 @var{range} is a range of articles you wish to update marks on. @@ -30357,7 +30357,7 @@ Optional Back End Functions =20 There should be no result data from this function. =20 -@item (nnchoke-request-update-mark GROUP ARTICLE MARK) +@item (nnchoke-request-update-mark @code{group} @code{article} @code{mark= }) =20 If the user tries to set a mark that the back end doesn't like, this function may change the mark. Gnus will use whatever this function @@ -30373,7 +30373,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-scan &optional GROUP SERVER) +@item (nnchoke-request-scan &optional @code{group} @code{server}) =20 This function may be called at any time (by Gnus or anything else) to request that the back end check for incoming articles, in one way or @@ -30387,7 +30387,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-group-description GROUP &optional SERVER) +@item (nnchoke-request-group-description @code{group} &optional @code{ser= ver}) =20 The result data from this function should be a description of @var{group}. @@ -30398,7 +30398,7 @@ Optional Back End Functions description =3D @end example =20 -@item (nnchoke-request-list-newsgroups &optional SERVER) +@item (nnchoke-request-list-newsgroups &optional @code{server}) =20 The result data from this function should be the description of all groups available on the server. @@ -30408,7 +30408,7 @@ Optional Back End Functions @end example =20 =20 -@item (nnchoke-request-newgroups DATE &optional SERVER) +@item (nnchoke-request-newgroups @code{date} &optional @code{server}) =20 The result data from this function should be all groups that were created after @samp{date}, which is in normal human-readable date format @@ -30425,14 +30425,14 @@ Optional Back End Functions server, it is quite likely that there can be many groups. =20 =20 -@item (nnchoke-request-create-group GROUP &optional SERVER) +@item (nnchoke-request-create-group @code{group} &optional @code{server}) =20 This function should create an empty group with name @var{group}. =20 There should be no return data. =20 =20 -@item (nnchoke-request-expire-articles ARTICLES &optional GROUP SERVER FO= RCE) +@item (nnchoke-request-expire-articles @code{articles} &optional @code{gr= oup} @code{server} @code{force}) =20 This function should run the expiry process on all articles in the @var{articles} range (which is currently a simple list of article @@ -30447,7 +30447,7 @@ Optional Back End Functions There should be no result data returned. =20 =20 -@item (nnchoke-request-move-article ARTICLE GROUP SERVER ACCEPT-FORM &opt= ional LAST) +@item (nnchoke-request-move-article @code{article} @code{group} @code{ser= ver} @code{accept-form} &optional @code{last}) =20 This function should move @var{article} (which is a number) from @var{group} by calling @var{accept-form}. @@ -30469,7 +30469,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-accept-article GROUP &optional SERVER LAST) +@item (nnchoke-request-accept-article @code{group} &optional @code{server= } @code{last}) =20 This function takes the current buffer and inserts it into @var{group}. If @var{last} in @code{nil}, that means that there will be more calls to @@ -30484,7 +30484,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-replace-article ARTICLE GROUP BUFFER) +@item (nnchoke-request-replace-article @code{article} @code{group} @code{= buffer}) =20 This function should remove @var{article} (which is a number) from @var{group} and insert @var{buffer} there instead. @@ -30492,7 +30492,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-delete-group GROUP FORCE &optional SERVER) +@item (nnchoke-request-delete-group @code{group} @code{force} &optional @= code{server}) =20 This function should delete @var{group}. If @var{force}, it should really delete all the articles in the group, and then delete the group @@ -30501,7 +30501,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-rename-group GROUP NEW-NAME &optional SERVER) +@item (nnchoke-request-rename-group @code{group} @code{new-name} &optiona= l @code{server}) =20 This function should rename @var{group} into @var{new-name}. All articles in @var{group} should move to @var{new-name}. =2D-=20 2.51.0 --=-=-= Content-Type: text/plain -- --=-=-=-- From unknown Tue Sep 23 13:12:59 2025 X-Loop: help-debbugs@gnu.org Subject: bug#79484: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add new ones Resent-From: James Thomas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 23 Sep 2025 00:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 79484 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: Eli Zaretskii Cc: 79484@debbugs.gnu.org Received: via spool by 79484-submit@debbugs.gnu.org id=B79484.175858578219653 (code B ref 79484); Tue, 23 Sep 2025 00:04:02 +0000 Received: (at 79484) by debbugs.gnu.org; 23 Sep 2025 00:03:02 +0000 Received: from localhost ([127.0.0.1]:36945 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1v0qUn-00056d-9A for submit@debbugs.gnu.org; Mon, 22 Sep 2025 20:03:02 -0400 Received: from mout.gmx.net ([212.227.15.18]:40387) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1v0qUk-000568-2L for 79484@debbugs.gnu.org; Mon, 22 Sep 2025 20:02:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net; s=s31663417; t=1758585771; x=1759190571; i=jimjoe@gmx.net; bh=c2YQUDqnuYqKU2z/E5XmPl6/hb9vteNiEdywSrNHb7k=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date: Message-ID:MIME-Version:Content-Type:cc:content-transfer-encoding: content-type:date:from:message-id:mime-version:reply-to:subject: to; b=iuY1+QT5IP02ydnbtmJ+XQ66s7aOfS8PLZ3jlrlW+mqOERMvMnbkLk5qfppAjyg6 P4waArFWkwW+eaPnSIi7UTBplvicaz1npsTCgeIuHxXcWvFcxBmQcxTbAAuVFzaXu +hNkw8tocPubljmssy8DVKln1xytsdpeGsKOzLpACe6WiPfrmsWSErCwgbp6F4x75 on3sa30jq2CMZLfyW9ZQlr9dTtuY6Pyd+gV/QAI21jlMN2ES3Bha+QTpU6q/bqlaV xvasJF2hjjSN8ezmwYHBELY0dZ5aFzpZUEb1mAHzYZp/YkKQkAHsMTOqBNTLNuloK plu1NMotXFW5dYHutg== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Received: from oldmac ([42.108.28.23]) by mail.gmx.net (mrgmx004 [212.227.17.184]) with ESMTPSA (Nemesis) id 1MTzay-1usUVU0MT4-00VnvX; Tue, 23 Sep 2025 02:02:51 +0200 From: James Thomas In-Reply-To: <7yqzvyxe5v.fsf@gmx.net> References: <7yjz1rl8uf.fsf@gmx.net> <86zfandmgx.fsf@gnu.org> <7yqzvyxe5v.fsf@gmx.net> Date: Tue, 23 Sep 2025 05:25:01 +0530 Message-ID: <7ycy7ixctm.fsf@gmx.net> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Provags-ID: V03:K1:AGcaTST6DLjI3t++kJlioz4GqlVCF3eb5uljHtUEDkG8EppzCbV 4xqRWh5qGphn2odNXrDPnr6afmR5BS+89abFj2ls40kPRL1+r/EKMrvg9i1oj7qoNHByzE7 xt8gj8ITcNpi6bzZ9kt6EVhDUwt6Tcm9QI3z3XGi5DZZkPd00+VGBN91ZTmU40HW8/Z7R94 NWSNc0PaoHjhV40u+FQrw== X-Spam-Flag: NO UI-OutboundReport: notjunk:1;M01:P0:5+1yZ8kJFgM=;47+vp4KybA97rHgMRn7benJsM69 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 X-Spam-Score: -0.7 (/) 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.7 (-) --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable James Thomas wrote: > Eli Zaretskii wrote: > >>> Date: Mon, 22 Sep 2025 04:19:28 +0530 >>> From: James Thomas via "Bug reports for GNU Emacs, >>> the Swiss army knife of text editors" >>>=20 >>> As used in gnus-start.el & gnus-int.el (for nntp & nnimap as of now). >> >> Thanks. >> >> The patch as submitted has several markup and Texinfo usage issues, >> see below. >> >> ... > > Sorry, corrected: > > > >> (Yes, I know all the rest of this node and its parent and siblings use >> this incorrect practice, but at the very least we should not >> proliferate the mistakes. Bonus points for fixing those other nodes >> as well.) > > I have done that as a separate patch, for absolution. :-) Should be better the other way round: --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-misc-gnus-texi-Fix-formatting.patch Content-Description: [PATCH] ; * doc/misc/gnus.texi Fix formatting. Content-Transfer-Encoding: quoted-printable =46rom e9b98948e0646377983a024078c5108182d2cb4b Mon Sep 17 00:00:00 2001 From: James Thomas Date: Tue, 23 Sep 2025 04:46:48 +0530 Subject: [PATCH] ; * doc/misc/gnus.texi Fix formatting. =2D-- doc/misc/gnus.texi | 55 +++++++++++++++++++++++----------------------- 1 file changed, 27 insertions(+), 28 deletions(-) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index afde6d5c4d6..80facb43752 100644 =2D-- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -30030,7 +30030,7 @@ Required Back End Functions =20 @table @code =20 -@item (nnchoke-retrieve-headers ARTICLES &optional GROUP SERVER FETCH-OLD= ) +@item (nnchoke-retrieve-headers @code{articles} &optional @code{group} @c= ode{server} @code{fetch-old}) =20 @var{articles} is either a range of article numbers or a list of @code{Message-ID}s. Current back ends do not fully support either---only @@ -30099,7 +30099,7 @@ Required Back End Functions @pxref{Headers}. =20 =20 -@item (nnchoke-open-server SERVER &optional DEFINITIONS) +@item (nnchoke-open-server @code{server} &optional @code{definitions}) =20 @var{server} is here the virtual server name. @var{definitions} is a list of @code{(VARIABLE VALUE)} pairs that define this virtual server. @@ -30112,7 +30112,7 @@ Required Back End Functions non-@code{nil} value. There should be no data returned. =20 =20 -@item (nnchoke-close-server &optional SERVER) +@item (nnchoke-close-server &optional @code{server}) =20 Close connection to @var{server} and free all resources connected to it. Return @code{nil} if the server couldn't be closed for some @@ -30131,7 +30131,7 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-server-opened &optional SERVER) +@item (nnchoke-server-opened &optional @code{server}) =20 If @var{server} is the current virtual server, and the connection to the physical server is alive, then this function should return a @@ -30141,14 +30141,14 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-status-message &optional SERVER) +@item (nnchoke-status-message &optional @code{server}) =20 This function should return the last error message from @var{server}. =20 There should be no data returned. =20 =20 -@item (nnchoke-request-article ARTICLE &optional GROUP SERVER TO-BUFFER) +@item (nnchoke-request-article @code{article} &optional @code{group} @cod= e{server} @code{to-buffer}) =20 The result data from this function should be the article specified by @var{article}. This might either be a @code{Message-ID} or a number. @@ -30169,7 +30169,7 @@ Required Back End Functions on successful article retrieval. =20 =20 -@item (nnchoke-request-group GROUP &optional SERVER FAST INFO) +@item (nnchoke-request-group @code{group} &optional @code{server} @code{f= ast} @code{info}) =20 Get data on @var{group}. This function also has the side effect of making @var{group} the current group. @@ -30204,7 +30204,7 @@ Required Back End Functions @end example =20 =20 -@item (nnchoke-close-group GROUP &optional SERVER) +@item (nnchoke-close-group @code{group} &optional @code{server}) =20 Close @var{group} and free any resources connected to it. This will be a no-op on most back ends. @@ -30212,7 +30212,7 @@ Required Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-list &optional SERVER) +@item (nnchoke-request-list &optional @code{server}) =20 Return a list of all groups available on @var{server}. And that means @emph{all}. @@ -30241,7 +30241,7 @@ Required Back End Functions (@samp{=3Dother-group}) or none of the above (@samp{y}). =20 =20 -@item (nnchoke-request-post &optional SERVER) +@item (nnchoke-request-post &optional @code{server}) =20 This function should post the current buffer. It might return whether the posting was successful or not, but that's not required. If, for @@ -30260,7 +30260,7 @@ Optional Back End Functions =20 @table @code =20 -@item (nnchoke-retrieve-groups GROUPS &optional SERVER) +@item (nnchoke-retrieve-groups @code{groups} &optional @code{server}) =20 @var{groups} is a list of groups, and this function should request data on all those groups. How it does it is of no concern to Gnus, but it @@ -30276,8 +30276,7 @@ Optional Back End Functions group-buffer =3D *active-line / *group-status @end example =20 - -@item (nnchoke-request-update-info GROUP INFO &optional SERVER) +@item (nnchoke-request-update-info @code{group} @code{info} &optional @co= de{server}) =20 A Gnus group info (@pxref{Group Info}) is handed to the back end for alterations. This comes in handy if the back end really carries all @@ -30290,7 +30289,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-type GROUP &optional ARTICLE) +@item (nnchoke-request-type @code{group} &optional @code{article}) =20 When the user issues commands for ``sending news'' (@kbd{F} in the summary buffer, for instance), Gnus has to know whether the article the @@ -30304,7 +30303,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-set-mark GROUP ACTION &optional SERVER) +@item (nnchoke-request-set-mark @code{group} @code{action} &optional @cod= e{server}) =20 Set/remove/add marks on articles. Normally Gnus handles the article marks (such as read, ticked, expired etc.)@: internally, and store them i= n @@ -30315,7 +30314,7 @@ Optional Back End Functions @var{action} is a list of mark setting requests, having this format: =20 @example -(RANGE ACTION MARK) +(@code{range} @code{action} @code{mark}) @end example =20 @var{range} is a range of articles you wish to update marks on. @@ -30345,7 +30344,7 @@ Optional Back End Functions =20 There should be no result data from this function. =20 -@item (nnchoke-request-update-mark GROUP ARTICLE MARK) +@item (nnchoke-request-update-mark @code{group} @code{article} @code{mark= }) =20 If the user tries to set a mark that the back end doesn't like, this function may change the mark. Gnus will use whatever this function @@ -30361,7 +30360,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-scan &optional GROUP SERVER) +@item (nnchoke-request-scan &optional @code{group} @code{server}) =20 This function may be called at any time (by Gnus or anything else) to request that the back end check for incoming articles, in one way or @@ -30375,7 +30374,7 @@ Optional Back End Functions There should be no result data from this function. =20 =20 -@item (nnchoke-request-group-description GROUP &optional SERVER) +@item (nnchoke-request-group-description @code{group} &optional @code{ser= ver}) =20 The result data from this function should be a description of @var{group}. @@ -30386,7 +30385,7 @@ Optional Back End Functions description =3D @end example =20 -@item (nnchoke-request-list-newsgroups &optional SERVER) +@item (nnchoke-request-list-newsgroups &optional @code{server}) =20 The result data from this function should be the description of all groups available on the server. @@ -30396,7 +30395,7 @@ Optional Back End Functions @end example =20 =20 -@item (nnchoke-request-newgroups DATE &optional SERVER) +@item (nnchoke-request-newgroups @code{date} &optional @code{server}) =20 The result data from this function should be all groups that were created after @samp{date}, which is in normal human-readable date format @@ -30413,14 +30412,14 @@ Optional Back End Functions server, it is quite likely that there can be many groups. =20 =20 -@item (nnchoke-request-create-group GROUP &optional SERVER) +@item (nnchoke-request-create-group @code{group} &optional @code{server}) =20 This function should create an empty group with name @var{group}. =20 There should be no return data. =20 =20 -@item (nnchoke-request-expire-articles ARTICLES &optional GROUP SERVER FO= RCE) +@item (nnchoke-request-expire-articles @code{articles} &optional @code{gr= oup} @code{server} @code{force}) =20 This function should run the expiry process on all articles in the @var{articles} range (which is currently a simple list of article @@ -30435,7 +30434,7 @@ Optional Back End Functions There should be no result data returned. =20 =20 -@item (nnchoke-request-move-article ARTICLE GROUP SERVER ACCEPT-FORM &opt= ional LAST) +@item (nnchoke-request-move-article @code{article} @code{group} @code{ser= ver} @code{accept-form} &optional @code{last}) =20 This function should move @var{article} (which is a number) from @var{group} by calling @var{accept-form}. @@ -30457,7 +30456,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-accept-article GROUP &optional SERVER LAST) +@item (nnchoke-request-accept-article @code{group} &optional @code{server= } @code{last}) =20 This function takes the current buffer and inserts it into @var{group}. If @var{last} in @code{nil}, that means that there will be more calls to @@ -30472,7 +30471,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-replace-article ARTICLE GROUP BUFFER) +@item (nnchoke-request-replace-article @code{article} @code{group} @code{= buffer}) =20 This function should remove @var{article} (which is a number) from @var{group} and insert @var{buffer} there instead. @@ -30480,7 +30479,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-delete-group GROUP FORCE &optional SERVER) +@item (nnchoke-request-delete-group @code{group} @code{force} &optional @= code{server}) =20 This function should delete @var{group}. If @var{force}, it should really delete all the articles in the group, and then delete the group @@ -30489,7 +30488,7 @@ Optional Back End Functions There should be no data returned. =20 =20 -@item (nnchoke-request-rename-group GROUP NEW-NAME &optional SERVER) +@item (nnchoke-request-rename-group @code{group} @code{new-name} &optiona= l @code{server}) =20 This function should rename @var{group} into @var{new-name}. All articles in @var{group} should move to @var{new-name}. =2D-=20 2.51.0 --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0002-doc-misc-gnus-texi--Optional-Back-End-Function.patch Content-Description: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add Content-Transfer-Encoding: quoted-printable =46rom 6f12c0403e770641acdefda2fc83301eb0fbc778 Mon Sep 17 00:00:00 2001 From: James Thomas Date: Mon, 22 Sep 2025 03:15:54 +0530 Subject: [PATCH] ; * doc/misc/gnus.texi (Optional Back End Functions): Add newer ones. =2D-- doc/misc/gnus.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 80facb43752..a447f1547da 100644 =2D-- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -30276,6 +30276,19 @@ Optional Back End Functions group-buffer =3D *active-line / *group-status @end example =20 +@item (nnchoke-retrieve-group-data-early @code{server} &optional @code{in= fos}) + +This is for starting an early async retrieval from @var{server} to +update @var{infos}, its current group info structure list. The return +value is a token for the corresponding +@code{nnchoke-finish-retrieve-group-infos}. + +@item (nnchoke-finish-retrieve-group-infos @code{server} @code{infos} @co= de{data}) + +This will be called later to conclude the async retrieval of +@code{nnchoke-retrieve-group-data-early} -- whose token is passed as +@var{data} -- and should update @var{infos}. + @item (nnchoke-request-update-info @code{group} @code{info} &optional @co= de{server}) =20 A Gnus group info (@pxref{Group Info}) is handed to the back end for =2D-=20 2.51.0 --=-=-= Content-Type: text/plain -- --=-=-=--