From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED!not-for-mail
From: Andy Moreton <andrewjmoreton@gmail.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#27445: 26.0.50; Insufficient documentation for pinentry.el
Date: Mon, 20 Nov 2017 17:55:20 +0000
Message-ID: <vz1bmjwvnqv.fsf@gmail.com>
References: <87vano7ihu.fsf@drachen> <878tfy15lw.fsf@web.de>
	<83vaiz63f3.fsf@gnu.org> <83zi7jgbka.fsf@gnu.org>
	<87h8tqg30t.fsf-ueno@gnu.org>
NNTP-Posting-Host: blaine.gmane.org
Mime-Version: 1.0
Content-Type: text/plain
X-Trace: blaine.gmane.org 1511200630 7623 195.159.176.226 (20 Nov 2017 17:57:10 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Mon, 20 Nov 2017 17:57:10 +0000 (UTC)
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.90 (windows-nt)
To: 27445@debbugs.gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 20 18:57:06 2017
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1eGqJd-0001hZ-EF
	for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 Nov 2017 18:57:05 +0100
Original-Received: from localhost ([::1]:58669 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1eGqJk-000825-Se
	for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 Nov 2017 12:57:12 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42950)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGqJe-00081i-3J
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:57:06 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGqJa-0007TJ-2L
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:57:06 -0500
Original-Received: from debbugs.gnu.org ([208.118.235.43]:40626)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1eGqJZ-0007Sx-VS
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:57:02 -0500
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eGqJZ-00031c-MI
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:57:01 -0500
X-Loop: help-debbugs@gnu.org
In-Reply-To: <87vano7ihu.fsf@drachen>
Resent-From: Andy Moreton <andrewjmoreton@gmail.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Mon, 20 Nov 2017 17:57:01 +0000
Resent-Message-ID: <handler.27445.B.151120056311541@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 27445
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.151120056311541
	(code B ref -1); Mon, 20 Nov 2017 17:57:01 +0000
Original-Received: (at submit) by debbugs.gnu.org; 20 Nov 2017 17:56:03 +0000
Original-Received: from localhost ([127.0.0.1]:49306 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1eGqIc-0002zx-4b
	for submit@debbugs.gnu.org; Mon, 20 Nov 2017 12:56:03 -0500
Original-Received: from eggs.gnu.org ([208.118.235.92]:51373)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <geb-bug-gnu-emacs@m.gmane.org>) id 1eGqIa-0002ze-O0
	for submit@debbugs.gnu.org; Mon, 20 Nov 2017 12:56:00 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <geb-bug-gnu-emacs@m.gmane.org>) id 1eGqIU-0006or-Tu
	for submit@debbugs.gnu.org; Mon, 20 Nov 2017 12:55:55 -0500
Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:54707)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <geb-bug-gnu-emacs@m.gmane.org>)
	id 1eGqIU-0006ok-RG
	for submit@debbugs.gnu.org; Mon, 20 Nov 2017 12:55:54 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42327)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <geb-bug-gnu-emacs@m.gmane.org>) id 1eGqIT-0007Hz-HK
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:55:54 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <geb-bug-gnu-emacs@m.gmane.org>) id 1eGqIP-0006km-IZ
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:55:53 -0500
Original-Received: from [195.159.176.226] (port=35179 helo=blaine.gmane.org)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <geb-bug-gnu-emacs@m.gmane.org>)
	id 1eGqIP-0006hz-Bj
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 12:55:49 -0500
Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2)
	(envelope-from <geb-bug-gnu-emacs@m.gmane.org>) id 1eGqI9-0004hq-R5
	for bug-gnu-emacs@gnu.org; Mon, 20 Nov 2017 18:55:33 +0100
X-Injected-Via-Gmane: http://gmane.org/
Original-Lines: 31
Original-X-Complaints-To: usenet@blaine.gmane.org
Cancel-Lock: sha1:hrkHkPpa0revf5CImq7FOk2Ge2o=
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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs/>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: "bug-gnu-emacs"
	<bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.bugs:140147
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/140147>

On Sun 19 Nov 2017, Daiki Ueno wrote:

> Eli Zaretskii <eliz@gnu.org> writes:
>
>> Ping!
>
> Sorry for not responding to it earlier.
>
>>> Daiki, could you please add some user-level documentation about this
>>> package?
>
> I would rather not document it, because the package should be
> transparent to user.  If it doesn't work, you are using either GnuPG 2.0
> or some stupid distro package neglecting upstream's default (only
> Debian, as far as I know).

How on earth is a user meant to diagnose a non-working setup without
adequate documentation ?

> Fortunately, GnuPG 2.0 will be unsupported in the next month.  After
> that we should be able to obsolete or remove the package.

Just because upstream remove support for something does not mean that
all downstream distros or users systems are fully up to date.

While it is sensible to encourage users to use the latest package
version and to install security fixes, there will be many people with
systems using older package versions for some time. Those users will
need documentation to guide them.

    AndyM