From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Damien Cassou Newsgroups: gmane.emacs.bugs Subject: bug#30025: 26.0.90; [Documentation][26.1] Docstring for epa-pinentry-mode shows erroneous link Date: Mon, 08 Jan 2018 16:39:01 +0100 Message-ID: <87r2r0e4x6.fsf@cassou.me> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1515425904 16359 195.159.176.226 (8 Jan 2018 15:38:24 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 8 Jan 2018 15:38:24 +0000 (UTC) Cc: rms@gnu.org To: 30025@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 08 16:38:20 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eYZV8-0003Zl-3u for geb-bug-gnu-emacs@m.gmane.org; Mon, 08 Jan 2018 16:38:14 +0100 Original-Received: from localhost ([::1]:41035 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYZX7-0000C2-LX for geb-bug-gnu-emacs@m.gmane.org; Mon, 08 Jan 2018 10:40:17 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40301) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYZWw-00008e-OK for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:40:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eYZWs-0004ND-Qq for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:40:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:60988) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eYZWs-0004N3-Mr for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:40:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eYZWs-0005AO-Cx for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:40:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Damien Cassou Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 08 Jan 2018 15:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 30025 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.151542596819814 (code B ref -1); Mon, 08 Jan 2018 15:40:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 8 Jan 2018 15:39:28 +0000 Original-Received: from localhost ([127.0.0.1]:41436 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eYZWK-00059W-4k for submit@debbugs.gnu.org; Mon, 08 Jan 2018 10:39:28 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:49112) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eYZWJ-00059D-5D for submit@debbugs.gnu.org; Mon, 08 Jan 2018 10:39:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eYZWC-0003xy-OP for submit@debbugs.gnu.org; Mon, 08 Jan 2018 10:39:21 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:41752) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eYZWC-0003xo-Ke for submit@debbugs.gnu.org; Mon, 08 Jan 2018 10:39:20 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40029) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eYZWB-00084a-3x for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:39:20 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eYZW7-0003tl-6d for bug-gnu-emacs@gnu.org; Mon, 08 Jan 2018 10:39:19 -0500 Original-Received: from mail.choca.pics ([62.210.108.126]:59120) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eYZW6-0003nK-TM; Mon, 08 Jan 2018 10:39:15 -0500 Original-Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 7912F232FE91; Mon, 8 Jan 2018 16:39:06 +0100 (CET) Original-Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id DGs-BMUL_XeK; Mon, 8 Jan 2018 16:39:05 +0100 (CET) Original-Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 6EF45232FE92; Mon, 8 Jan 2018 16:39:05 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.10.3 mail.choca.pics 6EF45232FE92 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cassou.me; s=9EA44F5C-DEF4-11E6-A83F-A08DF322D8FB; t=1515425945; bh=VGcn2L1BZDeKbejn3Mjdr1J0Ap6UzyyIgIA+snPyZQ4=; h=From:To:Date:Message-ID:MIME-Version; b=Zef9fNzds5oCKVM0HA+rd5W4j9Z2Qkn11ySGJUyD3szLdYIgKQ95iyt+t8lLtW9A4 ADRu88iQcpU5q+Pg98on4mn0ox9PTKer2CeHznjtDP2SpVADWP6UaPuGRRchcqxRIP jfc128VQQ+WRG7Ux/P8Lq537EBvU2hQc0GtP+ZQcEFbpUhxvisHuOadUfEGfi2TxcP wKY7MqkrAKpfm2dtl80sHgfAS+TRxXF0VsazjqypeKhHShf9iJzDz5IyvFCjm82/Cm J2Gl08+nyaYeBn7gT8oFrKp1RQTJ7KgRIggcu4aDj36FqHQ/i4BkE2gKMy4d/DkOXh TinIdcORlMo+A== X-Virus-Scanned: amavisd-new at choca.pics Original-Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id YAk8K_GFvBf3; Mon, 8 Jan 2018 16:39:05 +0100 (CET) Original-Received: from luz4 (20-44-190-109.dsl.ovh.fr [109.190.44.20]) by mail.choca.pics (Postfix) with ESMTPSA id 066F0232FE91; Mon, 8 Jan 2018 16:39:04 +0100 (CET) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:141899 Archived-At: How to reproduce: 1. C-h v epa-pinentry-mode RET Expected: the word "error" should be represented as a keyword, not as a link Actual: the word "error" is a link to the function of the same name. The docstring of epa-pinentry-mode describes 4 possible symbols for the value. These symbols only make sense in the context of the variable. In particular, they are not function or variable names. Still, the word error is represented as a link to the function of the same name. What is best practice to describe symbols in docstring? Best, -- Damien Cassou http://damiencassou.seasidehosting.st "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill