From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/88186 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 18:35:53 +0200 Message-ID: <87bm7rtdp2.fsf@portable.galex-713.eu> References: <877eifwe6r.fsf@portable.galex-713.eu> <87ftx3443a.fsf@ericabrahamsen.net> 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 1539880448 23342 195.159.176.226 (18 Oct 2018 16:34:08 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 18 Oct 2018 16:34:08 +0000 (UTC) User-Agent: Gnus (5.13), GNU Emacs 25.1.1 (i686-pc-linux-gnu) Cc: ding@gnus.org To: Eric Abrahamsen Original-X-From: ding-owner+M36400@lists.math.uh.edu Thu Oct 18 18:34:04 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 1gDBFL-0005wp-Js for ding-account@gmane.org; Thu, 18 Oct 2018 18:34:03 +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 1gDBHK-0007Wg-Q6; Thu, 18 Oct 2018 11:36:06 -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 1gDBHC-0007Tw-J3 for ding@lists.math.uh.edu; Thu, 18 Oct 2018 11:35:58 -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 1gDBHA-0004LZ-M7 for ding@lists.math.uh.edu; Thu, 18 Oct 2018 11:35:58 -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 1gDBH9-0005s2-Fw for ding@gnus.org; Thu, 18 Oct 2018 18:35:55 +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 1gDBH7-0005oc-P6; Thu, 18 Oct 2018 18:35:53 +0200 X-GPG-FINGERPRINT: E109 9988 4197 D7CB B0BC 5C23 8DEB 24BA 867D 3F7F X-Accept-Language: fr, en, it, eo In-Reply-To: <87ftx3443a.fsf@ericabrahamsen.net> (Eric Abrahamsen's message of "Thu, 18 Oct 2018 09:22:33 -0700") X-Spam-Score: -1.9 (-) List-ID: Precedence: bulk Xref: news.gmane.org gmane.emacs.gnus.general:88186 Archived-At: Le 18/10/2018 =C3=A0 09h22, Eric Abrahamsen a =C3=A9crit=C2=A0: > "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', >> =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'. > > 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=E2=80=99t it be changed in Gnus so the docstring displays correctly?