From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: apropos for packages [was: plz -> curl?] Date: Tue, 17 May 2022 19:48:52 +0300 Message-ID: <8335h8gl57.fsf@gnu.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3903"; mail-complaints-to="usenet@ciao.gmane.io" Cc: adam@alphapapa.net, luangruo@yahoo.com, larsi@gnus.org, rms@gnu.org, philipk@posteo.net, mardani29@yahoo.es, emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue May 17 19:08:53 2022 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 1nr0gn-0000hi-4o for ged-emacs-devel@m.gmane-mx.org; Tue, 17 May 2022 19:08:53 +0200 Original-Received: from localhost ([::1]:60060 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nr0gl-0007RN-Q4 for ged-emacs-devel@m.gmane-mx.org; Tue, 17 May 2022 13:08:51 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34616) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nr0Nd-0001ZO-Sd for emacs-devel@gnu.org; Tue, 17 May 2022 12:49:06 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:36382) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nr0Nb-0006pT-31; Tue, 17 May 2022 12:49:04 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=unkc8t2IzqmuGSHleSpCHEPIQGtfLYV3AXCzfrvqH3A=; b=osXpSobr2QGkKITPeIkr aqwY7A7qxmYw593kYihpcB1+UuIPFbZWYcZi+IQbdr/mkKcD7ox6ywqO9AnwVpGejBRi/RI8i3IIr GjScRAHjzoNBhbPujDzyP4gX9yb166QW2eaTJsGC+hFrfYPiFL7fVwLanG1juzwnVpCmjeXpfaV7h AkQp3gQZPQ3bvyj/NbVMUW8/oYtf8l2b3IkpHpfvkZJ4mkX5Zse3xYjy9MYbNcmX3F1ybE75QsKuU GNKgsNJlThdPhQU2LUlfT00LyWa78irD/meaCtmzQdnrFEz96CphTomtp8Lrsn5q8gqPAgmCA/H97 YpP0rdefulNg7w==; Original-Received: from [87.69.77.57] (port=2382 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nr0Na-0005gA-7s; Tue, 17 May 2022 12:49:02 -0400 In-Reply-To: (message from Drew Adams on Tue, 17 May 2022 16:23:20 +0000) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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:289862 Archived-At: > From: Drew Adams > CC: Lars Ingebrigtsen , Richard Stallman , Philip > Kaludercic , "mardani29@yahoo.es" , > emacs-devel > Date: Tue, 17 May 2022 16:23:20 +0000 > > I wrote: > > > 2. It would be good to update `apropos-documentation', > > if this has not already been done, to include the > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > > doc of packages. > > It seems that, at least as recently as Emacs 27.2, > this has not been done, in spite of the doc of > `apropos-documentation' saying this: > > With C-u prefix, or if ‘apropos-do-all’ is non-nil, > it searches all currently defined documentation > strings. > > For example, `C-u C-h d backtrace' doesn't show an > entry for package `backtrace', even though the pkg > doc string mentions "backtrace". (Emacs 27.2) You are taking that text out of its context. The doc string _really_ says this: Show symbols whose documentation contains matches for PATTERN. And now we understand why you don't see the package backtrace.el: it's because it is not a symbol. > If this has still not been fixed in Emacs 28, do we > need a bug filed for this, or can it just please be > fixed without a bug? I don't think it would make sense to add packages to apropos-documentation. That command is supposed to search doc strings of symbols: variables, functions, faces, etc. Adding packages to that would cause the results to show completely unrelated stuff. So I'm against this. Packages should have (and already do have) specialized commands that search their descriptions, keywords, etc.