From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/88183 Path: news.gmane.org!.POSTED!not-for-mail From: "Garreau\, Alexandre" Newsgroups: gmane.emacs.gnus.general Subject: Re: `gnus-build-sparse-threads' docstring Date: Thu, 18 Oct 2018 16:14:29 +0200 Message-ID: <87va5zuyt6.fsf@portable.galex-713.eu> References: <877eifwe6r.fsf@portable.galex-713.eu> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1539871970 27129 195.159.176.226 (18 Oct 2018 14:12:50 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 18 Oct 2018 14:12:50 +0000 (UTC) User-Agent: Gnus (5.13), GNU Emacs 25.1.1 (i686-pc-linux-gnu) To: ding@gnus.org Original-X-From: ding-owner+M36397@lists.math.uh.edu Thu Oct 18 16:12:46 2018 Return-path: Envelope-to: ding-account@gmane.org Original-Received: from lists1.math.uh.edu ([129.7.128.208]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gD92b-0006xD-NF for ding-account@gmane.org; Thu, 18 Oct 2018 16:12:45 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.math.uh.edu) by lists1.math.uh.edu with smtp (Exim 4.90_1) (envelope-from ) id 1gD94V-0006G2-LY; Thu, 18 Oct 2018 09:14:43 -0500 Original-Received: from mx2.math.uh.edu ([129.7.128.33]) by lists1.math.uh.edu with esmtps (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.90_1) (envelope-from ) id 1gD94N-0006DA-DE for ding@lists.math.uh.edu; Thu, 18 Oct 2018 09:14:35 -0500 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx2.math.uh.edu with esmtps (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.90_1) (envelope-from ) id 1gD94K-0003IP-Aj for ding@lists.math.uh.edu; Thu, 18 Oct 2018 09:14:35 -0500 Original-Received: from portable.galex-713.eu ([89.234.186.82]) by quimby.gnus.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gD94J-0003vu-1h for ding@gnus.org; Thu, 18 Oct 2018 16:14:31 +0200 Original-Received: from localhost ([::1] helo=portable.galex-713.eu) by portable.galex-713.eu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1gD94H-0005NA-Cr for ding@gnus.org; Thu, 18 Oct 2018 16:14:30 +0200 X-GPG-FINGERPRINT: E109 9988 4197 D7CB B0BC 5C23 8DEB 24BA 867D 3F7F X-Accept-Language: fr, en, it, eo In-Reply-To: <877eifwe6r.fsf@portable.galex-713.eu> (Alexandre Garreau's message of "Thu, 18 Oct 2018 15:57:00 +0200") X-Spam-Score: -1.9 (-) List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:88183 Archived-At: On 2018/10/18 at 15:57, Garreau, Alexandre wrote: > > When putting a raw symbol, not to be evaluated, in docstring, > `describe-variable' highlights these as links to same-name symbol > description (`describe-symbol'). Yet in `gnus-build-sparse-threads', > =E2=80=9C'some=E2=80=9D doesn=E2=80=99t refer to `some' (the cl function,= alias for `cl-some'), > so I guess it would be more correctly written as =E2=80=9C'some=E2=80=9D = or 'some > directly, instead of `some'. Also I find the docstring rather less explanative about the use of =E2=80=9C'all=E2=80=9D/t (what=E2=80=99s the difference with =E2=80=9Cmore= =E2=80=9D?), see afterwards: Docstring: "*If non-nil, fill in the gaps in threads. If `some', only fill in the gaps that are needed to tie loose threads together. If `more', fill in all leaf nodes that Gnus can find. If non-nil and non-`some', fill in all gaps that Gnus manages to guess." Manual: Fetching old headers can be slow. A low-rent similar effect can be gotten by setting this variable to =E2=80=98some=E2=80=99. Gnus will = then look at the complete =E2=80=98References=E2=80=99 headers of all articles and = try to string together articles that belong in the same thread. This will leave =E2=80=9Cgaps=E2=80=9D in the threading display where Gnus guesses tha= t an article is missing from the thread. (These gaps appear like normal summary lines. If you select a gap, Gnus will try to fetch the article in question.) If this variable is =E2=80=98t=E2=80=99, Gnus will display= all these =E2=80=9Cgaps=E2=80=9D without regard for whether they are useful for = completing the thread or not. Finally, if this variable is =E2=80=98more=E2=80= =99, Gnus won=E2=80=99t cut off sparse leaf nodes that don=E2=80=99t lead anywhere. This vari= able is =E2=80=98nil=E2=80=99 by default.