From unknown Sun Jun 22 17:13:51 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9693: gnus-summary-read-group: undocumented parameters... and more! Resent-From: Dave Abrahams Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bugs@gnus.org Resent-Date: Fri, 07 Oct 2011 15:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9693 X-GNU-PR-Package: gnus X-GNU-PR-Keywords: To: 9693@debbugs.gnu.org X-Debbugs-Original-To: submit@debbugs.gnu.org (The Gnus Bugfixing Girls + Boys) Received: via spool by submit@debbugs.gnu.org id=B.13180000526387 (code B ref -1); Fri, 07 Oct 2011 15:08:02 +0000 Received: (at submit) by debbugs.gnu.org; 7 Oct 2011 15:07:32 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RCC1I-0001et-2i for submit@debbugs.gnu.org; Fri, 07 Oct 2011 11:07:32 -0400 Received: from mail-vw0-f44.google.com ([209.85.212.44]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RCC1A-0001eU-Tn for submit@debbugs.gnu.org; Fri, 07 Oct 2011 11:07:25 -0400 Received: by vws5 with SMTP id 5so3239143vws.3 for ; Fri, 07 Oct 2011 08:07:00 -0700 (PDT) Received: by 10.52.141.116 with SMTP id rn20mr3048102vdb.27.1318000020840; Fri, 07 Oct 2011 08:07:00 -0700 (PDT) Received: from pluto.luannocracy.com (207-172-223-249.c3-0.smr-ubr3.sbo-smr.ma.static.cable.rcn.com. [207.172.223.249]) by mx.google.com with ESMTPS id ey9sm8981651vdc.19.2011.10.07.08.06.59 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 07 Oct 2011 08:07:00 -0700 (PDT) Received: by pluto.luannocracy.com (Postfix, from userid 501) id 9096210953EB; Fri, 7 Oct 2011 11:06:58 -0400 (EDT) From: Dave Abrahams Date: Fri, 07 Oct 2011 11:06:58 -0400 Message-ID: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/23.3 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -3.9 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.9 (---) --8<---------------cut here---------------start------------->8--- (defun gnus-summary-read-group (group &optional show-all no-article kill-buffer no-display backward select-articles) "Start reading news in newsgroup GROUP. If SHOW-ALL is non-nil, already read articles are also listed. If NO-ARTICLE is non-nil, no article is selected initially. If NO-DISPLAY, don't generate a summary buffer." --8<---------------cut here---------------end--------------->8--- Needs a description for KILL-BUFFER, BACKWARD, and SELECT-ARTICLES. gnus-summary-read-group-1 should at least make reference to gnus-summary-read-group in its docstring, for the meaning of its variables, and the difference in its semantics should be documented. Also it would be very good to be more explicit about what it means to "start reading news in" a group without generating a summary buffer. That's quite non-obvious. No Gnus v0.18 GNU Emacs 23.3.1 (x86_64-apple-darwin10.8.0, Carbon Version 1.6.0 AppKit 1038.36) of 2011-09-12 on pluto.luannocracy.com 200 Leafnode NNTP Daemon, version 1.11.8 running at localhost (my fqdn: pluto.boostpro.com) 500 Unknown command -- Dave Abrahams BoostPro Computing http://www.boostpro.com From unknown Sun Jun 22 17:13:51 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9693: gnus-summary-read-group: undocumented parameters... and more! Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bugs@gnus.org Resent-Date: Sat, 07 Jan 2012 01:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9693 X-GNU-PR-Package: gnus X-GNU-PR-Keywords: To: Dave Abrahams Cc: 9693@debbugs.gnu.org Received: via spool by 9693-submit@debbugs.gnu.org id=B9693.132589907815421 (code B ref 9693); Sat, 07 Jan 2012 01:18:02 +0000 Received: (at 9693) by debbugs.gnu.org; 7 Jan 2012 01:17:58 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RjKuz-00040f-Jj for submit@debbugs.gnu.org; Fri, 06 Jan 2012 20:17:58 -0500 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RjKux-00040Y-J3 for 9693@debbugs.gnu.org; Fri, 06 Jan 2012 20:17:56 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjKrK-000808-V9; Sat, 07 Jan 2012 02:14:10 +0100 From: Lars Magne Ingebrigtsen References: X-Now-Playing: The Black Dog's _Liber Dogma_ Date: Sat, 07 Jan 2012 02:14:10 +0100 In-Reply-To: (Dave Abrahams's message of "Fri, 07 Oct 2011 11:06:58 -0400") Message-ID: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1RjKrK-000808-V9 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326503651.02136@966tn7dZsBEnvhfMnYK0OQ X-Spam-Status: No X-Spam-Score: -2.6 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) Dave Abrahams writes: > (defun gnus-summary-read-group (group &optional show-all no-article > kill-buffer no-display backward > select-articles) > "Start reading news in newsgroup GROUP. > If SHOW-ALL is non-nil, already read articles are also listed. > If NO-ARTICLE is non-nil, no article is selected initially. > If NO-DISPLAY, don't generate a summary buffer." > Needs a description for KILL-BUFFER, BACKWARD, and SELECT-ARTICLES. I've now added those. > gnus-summary-read-group-1 should at least make reference to > gnus-summary-read-group in its docstring, for the meaning of its > variables, and the difference in its semantics should be documented. The -1 function is even more internal that the other function, so I don't really think there's a need. > Also it would be very good to be more explicit about what it means to > "start reading news in" a group without generating a summary buffer. I've clarified the NO-DISPLAY parameter. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Fri Jan 06 20:18:00 2012 Received: (at control) by debbugs.gnu.org; 7 Jan 2012 01:18:00 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RjKv2-00040s-Ce for submit@debbugs.gnu.org; Fri, 06 Jan 2012 20:18:00 -0500 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RjKv0-00040g-IS for control@debbugs.gnu.org; Fri, 06 Jan 2012 20:17:58 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjKrO-00080H-1Q for control@debbugs.gnu.org; Sat, 07 Jan 2012 02:14:14 +0100 Date: Sat, 07 Jan 2012 02:14:13 +0100 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #9693 X-MailScanner-ID: 1RjKrO-00080H-1Q X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326503654.78502@5K3udN5XxIG2qofD+CBNCw X-Spam-Status: No X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) tags 9693 fixed close 9693 24.1 From unknown Sun Jun 22 17:13:51 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9693: gnus-summary-read-group: undocumented parameters... and more! Resent-From: Dave Abrahams Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bugs@gnus.org Resent-Date: Sat, 07 Jan 2012 04:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9693 X-GNU-PR-Package: gnus X-GNU-PR-Keywords: fixed To: Lars Magne Ingebrigtsen Cc: 9693@debbugs.gnu.org Received: via spool by 9693-submit@debbugs.gnu.org id=B9693.13259091154642 (code B ref 9693); Sat, 07 Jan 2012 04:06:01 +0000 Received: (at 9693) by debbugs.gnu.org; 7 Jan 2012 04:05:15 +0000 Received: from localhost ([127.0.0.1]:47414 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjNWt-0001Cp-DN for submit@debbugs.gnu.org; Fri, 06 Jan 2012 23:05:15 -0500 Received: from mail-qy0-f172.google.com ([209.85.216.172]:54512) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjNWr-0001Cb-Gk for 9693@debbugs.gnu.org; Fri, 06 Jan 2012 23:05:15 -0500 Received: by qcsf15 with SMTP id f15so1186373qcs.3 for <9693@debbugs.gnu.org>; Fri, 06 Jan 2012 20:05:07 -0800 (PST) Received: by 10.224.168.84 with SMTP id t20mr11077246qay.2.1325909107851; Fri, 06 Jan 2012 20:05:07 -0800 (PST) Received: from pluto.luannocracy.com (207-172-223-249.c3-0.smr-ubr3.sbo-smr.ma.static.cable.rcn.com. [207.172.223.249]) by mx.google.com with ESMTPS id cf18sm75329222qab.9.2012.01.06.20.05.07 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 06 Jan 2012 20:05:07 -0800 (PST) Received: by pluto.luannocracy.com (Postfix, from userid 501) id 67C7C1E05D73; Fri, 6 Jan 2012 23:05:06 -0500 (EST) From: Dave Abrahams References: Date: Fri, 06 Jan 2012 23:05:06 -0500 In-Reply-To: (Lars Magne Ingebrigtsen's message of "Sat, 07 Jan 2012 02:14:10 +0100") Message-ID: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.92 (darwin) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) on Fri Jan 06 2012, Lars Magne Ingebrigtsen wrote: > Dave Abrahams writes: > >> (defun gnus-summary-read-group (group &optional show-all no-article >> kill-buffer no-display backward >> select-articles) >> "Start reading news in newsgroup GROUP. >> If SHOW-ALL is non-nil, already read articles are also listed. >> If NO-ARTICLE is non-nil, no article is selected initially. >> If NO-DISPLAY, don't generate a summary buffer." >> Needs a description for KILL-BUFFER, BACKWARD, and SELECT-ARTICLES. > > I've now added those. > >> gnus-summary-read-group-1 should at least make reference to >> gnus-summary-read-group in its docstring, for the meaning of its >> variables, and the difference in its semantics should be documented. > > The -1 function is even more internal that the other function, so I > don't really think there's a need. If you want other people to work on the code, and contribute features and bugfixes, there's arguably a need. >> Also it would be very good to be more explicit about what it means to >> "start reading news in" a group without generating a summary buffer. > > I've clarified the NO-DISPLAY parameter. Thanks. -- Dave Abrahams BoostPro Computing http://www.boostpro.com