From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Arash Esbati Newsgroups: gmane.emacs.bugs Subject: bug#61837: 29.0.50; [PATCH] Document Gnus backend variable `nnimap-user' Date: Mon, 27 Feb 2023 13:16:30 +0100 Message-ID: <864jr78fs1.fsf@gnu.org> References: <868rgj8nsz.fsf@gnu.org> <83356riasl.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19317"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 61837@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Feb 27 13:18:27 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1pWcSZ-0004o5-JW for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 27 Feb 2023 13:18:27 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pWcSF-0003Gl-5s; Mon, 27 Feb 2023 07:18:07 -0500 Original-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 1pWcSA-0003GI-VB for bug-gnu-emacs@gnu.org; Mon, 27 Feb 2023 07:18:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pWcSA-0005X9-MS for bug-gnu-emacs@gnu.org; Mon, 27 Feb 2023 07:18:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pWcSA-0004fY-Ig for bug-gnu-emacs@gnu.org; Mon, 27 Feb 2023 07:18:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Arash Esbati Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 27 Feb 2023 12:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61837 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 61837-submit@debbugs.gnu.org id=B61837.167750025517903 (code B ref 61837); Mon, 27 Feb 2023 12:18:02 +0000 Original-Received: (at 61837) by debbugs.gnu.org; 27 Feb 2023 12:17:35 +0000 Original-Received: from localhost ([127.0.0.1]:46301 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pWcRi-0004eh-M6 for submit@debbugs.gnu.org; Mon, 27 Feb 2023 07:17:35 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40214) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pWcRc-0004eN-OI for 61837@debbugs.gnu.org; Mon, 27 Feb 2023 07:17:32 -0500 Original-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 1pWcRX-0005TR-AZ for 61837@debbugs.gnu.org; Mon, 27 Feb 2023 07:17:23 -0500 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=bXxTbJBEuOXxRz863zgi1E6UOOmg8sgn6053cJKJDII=; b=qdCEo/JDHn0xfMeVBFl7 kdBv5uHDula8QJV0fKbLzkUCQ2h3ISDd0pZUHd/7w+nVe8jC3OiPrp+8LQCIjBUKfbCxHPmKYJhd5 YcY34fwwjNPfZWeirIzBRBB43tFLB8fvnF2VB3bG6GxURrn2mzRHn91k22XYCu7P9wfB6rrzEgx71 yxbOm6xpxDeetRIegjaDF7J2xo2FD2YH7yEh9FkKgSdPbS54R900lu56VxRu5kTGoJapF5sNCXVCd JEn1sz7CfTunK8wRG1DHmD4jcW4DNGez4a99o91kH3o1d3FBjfl87WAykIM6uR/lHMdiAE1LAEsl7 d/VGHrAideL8oQ==; Original-Received: from p5b326467.dip0.t-ipconnect.de ([91.50.100.103] helo=MUTANT) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pWcRW-0004rp-Pb; Mon, 27 Feb 2023 07:17:23 -0500 In-Reply-To: <83356riasl.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 27 Feb 2023 13:54:02 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:256876 Archived-At: --=-=-= Content-Type: text/plain Eli Zaretskii writes: > Thanks, but please add an index entry for this variable. (Yes, I know > the other variables there aren't indexed, either, but Rome wasn't > built in one day. Bonus points for adding index entries for the other > variables as well.) Next try attached seeking for bonus points as well. Best, Arash --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Add-nnimap-user-to-Gnus-manual.patch >From ca13dfa26bc6a7f23a1872790a3a9a61af0e4cb9 Mon Sep 17 00:00:00 2001 From: Arash Esbati Date: Mon, 27 Feb 2023 10:10:13 +0100 Subject: [PATCH] ; Add `nnimap-user' to Gnus manual * doc/misc/gnus.texi (Customizing the IMAP Connection): Document backend variable `nnimap-user' which was introduced with commit 5e68f8614f in 2011. Add index entries for all backend variables. (bug#61837) --- doc/misc/gnus.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index d513726979b..cf6820948ad 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -14510,13 +14510,23 @@ Customizing the IMAP Connection @table @code @item nnimap-address +@vindex nnimap-address The address of the server, like @samp{imap.gmail.com}. +@item nnimap-user +@vindex nnimap-user +Username to use for authentication to the @acronym{IMAP} server. This +corresponds to the value of the @samp{login} token in your +@file{~/.authinfo} file. Set this variable if you want to access +multiple accounts from the same @acronym{IMAP} server. + @item nnimap-server-port +@vindex nnimap-server-port If the server uses a non-standard port, that can be specified here. A typical port would be @code{"imap"} or @code{"imaps"}. @item nnimap-stream +@vindex nnimap-stream How @code{nnimap} should connect to the server. Possible values are: @table @code @@ -14547,6 +14557,7 @@ Customizing the IMAP Connection @end table @item nnimap-authenticator +@vindex nnimap-authenticator Some @acronym{IMAP} servers allow anonymous logins. In that case, this should be set to @code{anonymous}. If this variable isn't set, the normal login methods will be used. If you wish to specify a @@ -14556,6 +14567,7 @@ Customizing the IMAP Connection requires using the @file{oauth2.el} library.) @item nnimap-expunge +@vindex nnimap-expunge When to expunge deleted messages. If @code{never}, deleted articles are marked with the IMAP @code{\\Delete} flag but not automatically expunged. If @code{immediately}, deleted articles are immediately expunged @@ -14571,27 +14583,32 @@ Customizing the IMAP Connection (i.e., potentially not only the article that was just deleted). @item nnimap-streaming +@vindex nnimap-streaming Virtually all @acronym{IMAP} server support fast streaming of data. If you have problems connecting to the server, try setting this to @code{nil}. @item nnimap-fetch-partial-articles +@vindex nnimap-fetch-partial-articles If non-@code{nil}, fetch partial articles from the server. If set to a string, then it's interpreted as a regexp, and parts that have matching types will be fetched. For instance, @samp{"text/"} will fetch all textual parts, while leaving the rest on the server. @item nnimap-record-commands +@vindex nnimap-record-commands If non-@code{nil}, record all @acronym{IMAP} commands in the @samp{"*imap log*"} buffer. @item nnimap-use-namespaces +@vindex nnimap-use-namespaces If non-@code{nil}, omit the IMAP namespace prefix in nnimap group names. If your IMAP mailboxes are called something like @samp{INBOX} and @samp{INBOX.Lists.emacs}, but you'd like the nnimap group names to be @samp{INBOX} and @samp{Lists.emacs}, you should enable this option. @item nnimap-keepalive-intervals +@vindex nnimap-keepalive-intervals By default, nnimap will send occasional @samp{NOOP} (keepalive) commands to the server, to keep the connection alive. This option governs how often that happens. It is a cons of two integers, -- 2.39.2 --=-=-=--