From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/88185 Path: news.gmane.org!.POSTED!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.gnus.general Subject: Re: `gnus-build-sparse-threads' docstring Date: Thu, 18 Oct 2018 09:22:33 -0700 Message-ID: <87ftx3443a.fsf@ericabrahamsen.net> 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: 8bit X-Trace: blaine.gmane.org 1539879686 328 195.159.176.226 (18 Oct 2018 16:21:26 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 18 Oct 2018 16:21:26 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: ding@gnus.org Original-X-From: ding-owner+M36399@lists.math.uh.edu Thu Oct 18 18:21:22 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 1gDB34-0008PO-9p for ding-account@gmane.org; Thu, 18 Oct 2018 18:21:22 +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 1gDB4X-0007MU-PW; Thu, 18 Oct 2018 11:22:53 -0500 Original-Received: from mx1.math.uh.edu ([129.7.128.32]) by lists1.math.uh.edu with esmtps (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.90_1) (envelope-from ) id 1gDB4P-0007Jf-Fl for ding@lists.math.uh.edu; Thu, 18 Oct 2018 11:22:45 -0500 Original-Received: from quimby.gnus.org ([80.91.231.51]) by mx1.math.uh.edu with esmtps (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128) (Exim 4.90_1) (envelope-from ) id 1gDB4N-0004DU-RA for ding@lists.math.uh.edu; Thu, 18 Oct 2018 11:22:45 -0500 Original-Received: from [195.159.176.226] (helo=blaine.gmane.org) by quimby.gnus.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gDB4M-0005hu-Io for ding@gnus.org; Thu, 18 Oct 2018 18:22:42 +0200 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1gDB2E-0007bR-Jw for ding@gnus.org; Thu, 18 Oct 2018 18:20:30 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 20 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:fZytUXxxQrzVvG9RBAWwdh0XDR8= X-Spam-Score: 1.0 (+) X-Spam-Report: SpamAssassin (3.4.2 2018-09-13) analysis follows Bayesian score: 0.1542 Ham tokens: 0.000-41--1524h-0s--0d--H*M:fsf, 0.000-39--1471h-0s--0d--nodes, 0.000-33--1216h-0s--0d--H*UA:Emacs, 0.000-32--1195h-0s--0d--H*u:Emacs, 0.000-26--956h-0s--0d--H*UA:Gnus Spam tokens: 0.997-33016--608h-26775s--0d--H*r:quimby.gnus.org, 0.995-34012--1022h-27898s--0d--HTo:D*gnus.org, 0.994-1690--56h-1390s--0d--Hx-spam-relays-external:quimby.gnus.org, 0.994-1690--56h-1390s--0d--H*RU:quimby.gnus.org, 0.993-35014--1318h-28932s--0d--Hx-spam-relays-internal:80.91.231.51 Autolearn status: no autolearn_force=no -0.0 BAYES_20 BODY: Bayes spam probability is 5 to 20% [score: 0.1542] 0.2 HEADER_FROM_DIFFERENT_DOMAINS From and EnvelopeFrom 2nd level mail domains are different 0.8 RDNS_NONE Delivered to internal network by a host with no rDNS List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:88185 Archived-At: "Garreau, Alexandre" writes: > Hi, > > 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', > “'some” doesn’t refer to `some' (the cl function, alias for `cl-some'), > so I guess it would be more correctly written as “'some” or 'some > directly, instead of `some'. The automatic hyperlinking can be disabled when inappropriate by having the word "symbol" in front of the actual symbol. Here's a version that creates no hyperlinks, though it's a tiny bit strained: "If non-nil, fill in the gaps in threads. If set to the symbol `some', only fill in the gaps that are needed to tie loose threads together. If the symbol `more', fill in all leaf nodes that Gnus can find. If neither nil nor the symbol `some', fill in all gaps that Gnus manages to guess."