From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/88189 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 11:46:55 -0700 Message-ID: <87y3av2iu8.fsf@ericabrahamsen.net> References: <877eifwe6r.fsf@portable.galex-713.eu> <87ftx3443a.fsf@ericabrahamsen.net> <87bm7rtdp2.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 1539888333 16516 195.159.176.226 (18 Oct 2018 18:45:33 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 18 Oct 2018 18:45:33 +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+M36403@lists.math.uh.edu Thu Oct 18 20:45:29 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 1gDDIW-0004AQ-RS for ding-account@gmane.org; Thu, 18 Oct 2018 20:45:28 +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 1gDDKF-0000Hl-To; Thu, 18 Oct 2018 13:47:15 -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 1gDDK8-0000Ez-KL for ding@lists.math.uh.edu; Thu, 18 Oct 2018 13:47:08 -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 1gDDK6-0005c1-SF for ding@lists.math.uh.edu; Thu, 18 Oct 2018 13:47:08 -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 1gDDK5-0008Ng-Li for ding@gnus.org; Thu, 18 Oct 2018 20:47:05 +0200 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1gDDHw-0003Ub-PH for ding@gnus.org; Thu, 18 Oct 2018 20:44:52 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 31 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:Rji5zBxS7KvQHk0tDMDAnGxabQA= X-Spam-Score: -0.9 (/) List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:88189 Archived-At: "Garreau, Alexandre" writes: > Le 18/10/2018 à 09h22, Eric Abrahamsen a écrit : >> "Garreau, Alexandre" writes: >>> 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." > > While discussing it on the emacs-devel mailing-list, I found it out > myself in the elisp manual ^^ I was going to write it out here before > reading your message x) > > Shouldn’t it be changed in Gnus so the docstring displays correctly? Probably, yes. I've opened bug bug#33090 with a patch for this. Thanks, Eric