From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: transient Date: Sat, 02 May 2020 14:22:28 +0300 Message-ID: <83ftcitwcr.fsf@gnu.org> References: <87368npxw4.fsf@bernoul.li> <87v9ljo5d0.fsf@bernoul.li> <87ftcnxu5m.fsf@bernoul.li> <83y2qezlpd.fsf@gnu.org> <83tv12zjx1.fsf@gnu.org> <20200429101755.GF24737@tuxteam.de> <838sicw4do.fsf@gnu.org> <83zhaqu89z.fsf@gnu.org> <83sggiu2p9.fsf@gnu.org> <83r1w2u20y.fsf@gnu.org> <83lfmatym6.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="43529"; mail-complaints-to="usenet@ciao.gmane.io" Cc: tomas@tuxteam.de, rms@gnu.org, emacs-devel@gnu.org To: Philippe Vaucher Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat May 02 13:24:02 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 1jUqFW-000BCo-1A for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 13:24:02 +0200 Original-Received: from localhost ([::1]:35602 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUqFV-0003NA-3n for ged-emacs-devel@m.gmane-mx.org; Sat, 02 May 2020 07:24:01 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:42146) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jUqEK-0000rc-BM for emacs-devel@gnu.org; Sat, 02 May 2020 07:22:48 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:55170) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jUqEK-0002zm-0g; Sat, 02 May 2020 07:22:48 -0400 Original-Received: from [176.228.60.248] (port=1542 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jUqEA-0000ka-0C; Sat, 02 May 2020 07:22:38 -0400 In-Reply-To: (message from Philippe Vaucher on Sat, 2 May 2020 12:56:41 +0200) 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:248406 Archived-At: > From: Philippe Vaucher > Date: Sat, 2 May 2020 12:56:41 +0200 > Cc: tomas@tuxteam.de, Richard Stallman , > Emacs developers > > 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. 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. > I still think "C-h d alist", because it does not give me assq and assoc is not doing a good job. they do now. > Because alist is controversial let's take "C-h d regexp match": it does not give me string-match nor > match-string. ??? It does here. > I'm still not very satisfied about the tools you showed for listing an overview of the API to manipulate regexp, > or files, or processes (etc). What you are basically saying is that wanting to have this overview is overrated, > but for me it helps me understand the landscape of how the API works and is designed. What functions > would be available should I need them in the future, what parts is missing, etc. 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.