From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#17832: 24.4.50; `apropos-library' behavior for a top-level library file Date: Sun, 22 Jun 2014 09:15:52 -0700 (PDT) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1403453856 16151 80.91.229.3 (22 Jun 2014 16:17:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 22 Jun 2014 16:17:36 +0000 (UTC) To: 17832@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 22 18:17:29 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WykSN-0004VT-6H for geb-bug-gnu-emacs@m.gmane.org; Sun, 22 Jun 2014 18:17:27 +0200 Original-Received: from localhost ([::1]:49616 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykSM-0004rJ-HD for geb-bug-gnu-emacs@m.gmane.org; Sun, 22 Jun 2014 12:17:26 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33411) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykS9-0004qx-IP for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:17:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WykRz-0007Y2-7K for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:17:13 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:37852) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykRz-0007Xy-3L for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:17:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WykRy-0004HT-Gp for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:17:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 22 Jun 2014 16:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 17832 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.140345379416405 (code B ref -1); Sun, 22 Jun 2014 16:17:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Jun 2014 16:16:34 +0000 Original-Received: from localhost ([127.0.0.1]:57235 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WykRU-0004GW-ON for submit@debbugs.gnu.org; Sun, 22 Jun 2014 12:16:33 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:59876) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WykRS-0004GF-Cs for submit@debbugs.gnu.org; Sun, 22 Jun 2014 12:16:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WykRD-0007HU-1O for submit@debbugs.gnu.org; Sun, 22 Jun 2014 12:16:25 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:46611) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykRC-0007HQ-Uv for submit@debbugs.gnu.org; Sun, 22 Jun 2014 12:16:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33350) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykR4-0004mA-5P for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:16:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WykQv-0007G6-AA for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:16:06 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:21926) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WykQv-0007G0-3S for bug-gnu-emacs@gnu.org; Sun, 22 Jun 2014 12:15:57 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s5MGFtip028565 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 22 Jun 2014 16:15:56 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id s5MGFtop012744 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sun, 22 Jun 2014 16:15:55 GMT Original-Received: from abhmp0004.oracle.com (abhmp0004.oracle.com [141.146.116.10]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s5MGFsx7015892 for ; Sun, 22 Jun 2014 16:15:55 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6691.5000 (x86)] X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:90667 Archived-At: 1. I have a library foo.el that just `require's a set of component libraries (files). foo.el itself defines no functions or variables. `M-x apropos-library foo' just shows this message: No apropos matches for `' Granted, the doc string of `apropos-library' says that it lists the variables and functions defined by library FILE, and there are none defined in file foo.el. But the command is called `apropos-library', not `apropos-lisp-file'. That somewhat justifies a user in thinking that it should return a list of the vars and functions defined in the _library_ as a whole, which includes all of those defined in libraries that it requires. Rather than just saying that the command is misnamed, or the name is misleading, the first part of this bug report is to request that the command live up to its name: give you a report of the functions and variables defined in the _whole library_, recursively including those of its required component libraries. 2. But before (or even without) fixing #1: The message "No apropos matches for `'" is inappropriate. The user did not explicitly provide an apropos pattern to match, and s?he certainly did not provide an empty pattern for Emacs to complain about. Instead of just blindly piggybacking on `apropos-symbols-internal', `apropos-library' should provide a reasonable message in this case. 3. When `apropos-library' calls `apropos-symbols-internal' it in fact passes these args: SYMBOLS: nil KEYS: t TEXT: "Library `foo' provides: foo and requires: foo-1 and foo-2 and foo-3 and foo-4 and foo-5 and foo-6 and foo-7 and foo-8" The TEXT arg provides useful information about library foo. It should, I think, be included in the apropos output (whether or not `apropos-library' is upgraded to show the symbols for the whole library, as this bug report (#1) requests). As a first and partial bug fix then, I propose that `apropos-library' always print TEXT (which it does when there are defined symbols in the file). If there are no functions or vars defined in the file, then, while waiting for a proper fix (#1), show buffer *Apropos* with just TEXT and a statement that no functions or variables are defined in file foo.el. Get rid of the unhelpful message No apropos matches for `'. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-06-17 on ODIEONE Bzr revision: 117359 monnier@iro.umontreal.ca-20140617193358-2t1nl1te9gc2mq= rx Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include''