From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?utf-8?B?7KGw7ISx67mI?= Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: transient Date: Sat, 2 May 2020 21:09:11 +0900 Message-ID: References: <83ftcitwcr.fsf@gnu.org> Mime-Version: 1.0 (1.0) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="114141"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Philippe Vaucher , tomas@tuxteam.de, rms@gnu.org, Emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat May 02 14:13:40 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jUr1Y-000TaM-2b for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 14:13:40 +0200 Original-Received: from localhost ([::1]:32778 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUr1X-0002u0-1a for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 08:13:39 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56274) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUr0X-0001Ru-Qw for emacs-devel@gnu.org; Sat, 02 May 2020 08:12:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jUqxK-0006xJ-Ra for emacs-devel@gnu.org; Sat, 02 May 2020 08:12:37 -0400 Original-Received: from pv50p00im-tydg10011801.me.com ([17.58.6.52]:34270) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUqxK-0006oE-Cz for emacs-devel@gnu.org; Sat, 02 May 2020 08:09:18 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=icloud.com; s=1a1hai; t=1588421355; bh=kCI+bgb4qStGo8gyEPKLdd3TbPorBaZqLiAteEHenEU=; h=Content-Type:From:Subject:Date:Message-Id:To; b=vGdhVhQU2575JIVi50hO8YWfvsejelrQ/JR6525a/G05MehInYCEcUo+q7DiAn6oY mBe4tPoS1z+ur8kycJRKVf3SFBV2HOfu040gw8k9MIM4FHGi6WJMjy0Re+yQoaWkJB ixq279w3/sAXgNrkUCMxtGEe0D+8/RO0zBCXfx7kNINn4Ng3AaGO2xqBk5Lfl1deuN ZfLxLN6IBlj/Ek3TTTL8PYJBDoyflAfCvtdakYOWEJ1OA126fCAPzjfAYe8wWT9DgA LMmNF3eUSKc8PGuy7lERIQ7W4RxzQ/M4byLcMTlxW94B3JKUMMF0Tw/0M0ferN7P3X 6zo1kX2leYWhA== Original-Received: from [192.168.0.101] (unknown [218.153.67.143]) by pv50p00im-tydg10011801.me.com (Postfix) with ESMTPSA id AD10866077A; Sat, 2 May 2020 12:09:14 +0000 (UTC) In-Reply-To: <83ftcitwcr.fsf@gnu.org> X-Mailer: iPhone Mail (17E262) X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.138, 18.0.676 definitions=2020-05-02_06:2020-05-01, 2020-05-02 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 mlxscore=0 mlxlogscore=652 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-2002250000 definitions=main-2005020110 Received-SPF: pass client-ip=17.58.6.52; envelope-from=pcr910303@icloud.com; helo=pv50p00im-tydg10011801.me.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/02 08:09:15 X-ACL-Warn: Detected OS = Linux 3.11 and newer X-Received-From: 17.58.6.52 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:248413 Archived-At: > 2020. 5. 2. =EC=98=A4=ED=9B=84 8:24, Eli Zaretskii =EC=9E=91= =EC=84=B1: >=20 > =EF=BB=BF >>=20 >> From: Philippe Vaucher >> Date: Sat, 2 May 2020 12:56:41 +0200 >> Cc: tomas@tuxteam.de, Richard Stallman , >> Emacs developers >>=20 >> I think we are mixing two concepts here. To search for a single function,= where you already know the >> keywords, yes "C-h d" works. To get a curated list of the API of a topic,= not so much. >=20 > That's why I proposed to have a variant of "C-h d" that would only > look in the arguments and in the first line of the doc string. It > would produce less false positives. >=20 >> I still think "C-h d alist", because it does not give me assq and assoc i= s not doing a good job. >=20 > they do now. >=20 >> Because alist is controversial let's take "C-h d regexp match": it does n= ot give me string-match nor >> match-string. >=20 > ??? It does here. >=20 >> I'm still not very satisfied about the tools you showed for listing an ov= erview of the API to manipulate regexp, >> or files, or processes (etc). What you are basically saying is that wanti= ng to have this overview is overrated, >> but for me it helps me understand the landscape of how the API works and i= s designed. What functions >> would be available should I need them in the future, what parts is missin= g, etc. >=20 > For that, you should definitely read the manual, not just look at the > list of APIs. A list of the APIs will not tell enough, especially if > you are coming to a language that has a long history, with such > idiosyncratic names as cdr and assq. Isn=E2=80=99t this the problem that the proposal is trying to address? So th= at people can get more info from the function names without needing to know a= ll of the idiosyncrasies.=