From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED!not-for-mail
From: Daiki Ueno <ueno@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: bug#27445: 26.0.50; Insufficient documentation for pinentry.el
Date: Tue, 21 Nov 2017 20:59:19 +0100
Message-ID: <87ine35roo.fsf-ueno@gnu.org>
References: <87vano7ihu.fsf@drachen> <878tfy15lw.fsf@web.de>
	<83vaiz63f3.fsf@gnu.org> <83zi7jgbka.fsf@gnu.org>
	<87h8tqg30t.fsf-ueno@gnu.org> <vz1bmjwvnqv.fsf@gmail.com>
	<od13757vne6.fsf-ueno@gnu.org> <83eford3rw.fsf@gnu.org>
NNTP-Posting-Host: blaine.gmane.org
Mime-Version: 1.0
Content-Type: text/plain
X-Trace: blaine.gmane.org 1511294418 8913 195.159.176.226 (21 Nov 2017 20:00:18 GMT)
X-Complaints-To: usenet@blaine.gmane.org
NNTP-Posting-Date: Tue, 21 Nov 2017 20:00:18 +0000 (UTC)
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux)
Cc: 27445@debbugs.gnu.org
To: Eli Zaretskii <eliz@gnu.org>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Nov 21 21:00:13 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 1eHEiH-0001nI-BP
	for geb-bug-gnu-emacs@m.gmane.org; Tue, 21 Nov 2017 21:00:09 +0100
Original-Received: from localhost ([::1]:36294 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 1eHEiO-0003sG-I0
	for geb-bug-gnu-emacs@m.gmane.org; Tue, 21 Nov 2017 15:00:16 -0500
Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54676)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eHEiF-0003rz-TP
	for bug-gnu-emacs@gnu.org; Tue, 21 Nov 2017 15:00:08 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1eHEiB-0000U8-2O
	for bug-gnu-emacs@gnu.org; Tue, 21 Nov 2017 15:00:07 -0500
Original-Received: from debbugs.gnu.org ([208.118.235.43]:42772)
	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 1eHEiA-0000U0-VI
	for bug-gnu-emacs@gnu.org; Tue, 21 Nov 2017 15:00: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 1eHEiA-00031n-Oh
	for bug-gnu-emacs@gnu.org; Tue, 21 Nov 2017 15:00:02 -0500
X-Loop: help-debbugs@gnu.org
Resent-From: Daiki Ueno <ueno@gnu.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Tue, 21 Nov 2017 20:00:02 +0000
Resent-Message-ID: <handler.27445.B27445.151129438511583@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 27445
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
Original-Received: via spool by 27445-submit@debbugs.gnu.org id=B27445.151129438511583
	(code B ref 27445); Tue, 21 Nov 2017 20:00:02 +0000
Original-Received: (at 27445) by debbugs.gnu.org; 21 Nov 2017 19:59:45 +0000
Original-Received: from localhost ([127.0.0.1]:51453 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1eHEht-00030k-H1
	for submit@debbugs.gnu.org; Tue, 21 Nov 2017 14:59:45 -0500
Original-Received: from eggs.gnu.org ([208.118.235.92]:35370)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <ueno@gnu.org>) id 1eHEhq-00030X-SN
	for 27445@debbugs.gnu.org; Tue, 21 Nov 2017 14:59:44 -0500
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ueno@gnu.org>) id 1eHEhg-0000Ec-V8
	for 27445@debbugs.gnu.org; Tue, 21 Nov 2017 14:59:37 -0500
Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45727)
	by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ueno@gnu.org>)
	id 1eHEhg-0000EY-Rm
	for 27445@debbugs.gnu.org; Tue, 21 Nov 2017 14:59:32 -0500
Original-Received: from du-a.org ([219.94.251.20]:40962 helo=localhost.localdomain)
	by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
	(Exim 4.82) (envelope-from <ueno@gnu.org>)
	id 1eHEhf-0001xC-G9; Tue, 21 Nov 2017 14:59:32 -0500
In-Reply-To: <83eford3rw.fsf@gnu.org> (Eli Zaretskii's message of "Tue, 21 Nov
	2017 17:56:19 +0200")
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
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:140217
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/140217>

Eli Zaretskii <eliz@gnu.org> writes:

> I don't think we can claim that it's undocumented: it has some user
> documentation in the Commentary section.
>
> My take from this discussion is that this package will become
> obsolete, but not exactly tomorrow.

Not tomorrow, but it will be just a month later.  Also note that this is
a relatively new package and no Emacs release has shipped with it.

> So I think it would be good to add some minimal verbiage to allow
> those who still need pinentry.el to use it.  I gather the required
> additions are not too large.

Sorry, I have no idea what to add to the existing documentation (the
Commentary section), really.  As I indicated in the previous post, if
pinentry.el doesn't work, it is likely to be failing in somewhere else
than Emacs (e.g. Debian packaging of GnuPG and pinentry).  It's not
obvious to me what we should suggest to the user in that case.

Regards,
-- 
Daiki Ueno