From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: emacs18@gmail.com Newsgroups: gmane.emacs.bugs Subject: bug#7757: 24.0.50; list-load-path-shadows should be documented in lispref manual Date: Wed, 29 Dec 2010 10:56:57 -0800 Message-ID: Reply-To: emacs18@gmail.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1293650687 23121 80.91.229.12 (29 Dec 2010 19:24:47 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 29 Dec 2010 19:24:47 +0000 (UTC) To: 7757@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 29 20:24:42 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PY1cz-0003Lr-R5 for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Dec 2010 20:24:42 +0100 Original-Received: from localhost ([127.0.0.1]:52081 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1cd-0008Jo-AG for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Dec 2010 14:23:43 -0500 Original-Received: from [140.186.70.92] (port=33737 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1cS-0008Da-3y for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:33 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1cP-0007Uc-NH for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:30 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42724) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1cP-0007UX-Ib for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 14:23:29 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PY18w-0000Td-55; Wed, 29 Dec 2010 13:53:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Kim Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 29 Dec 2010 18:53:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7757 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.12936487741799 (code B ref -1); Wed, 29 Dec 2010 18:53:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Dec 2010 18:52:54 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PY18n-0000Sy-O6 for submit@debbugs.gnu.org; Wed, 29 Dec 2010 13:52:53 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PY18m-0000Sm-1d for submit@debbugs.gnu.org; Wed, 29 Dec 2010 13:52:52 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1FP-0002o5-T6 for submit@debbugs.gnu.org; Wed, 29 Dec 2010 13:59:45 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:58927) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1FP-0002n7-Pj for submit@debbugs.gnu.org; Wed, 29 Dec 2010 13:59:43 -0500 Original-Received: from [140.186.70.92] (port=42957 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PY1Co-0006zJ-F6 for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 13:57:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PY1Cn-000283-FE for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 13:57:02 -0500 Original-Received: from mail-iy0-f169.google.com ([209.85.210.169]:37755) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PY1Cn-00027x-B3 for bug-gnu-emacs@gnu.org; Wed, 29 Dec 2010 13:57:01 -0500 Original-Received: by iyj17 with SMTP id 17so10266477iyj.0 for ; Wed, 29 Dec 2010 10:57:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:from:to:subject:reply-to :date:message-id:mime-version:content-type; bh=fx/Y1uqMlNENGxeigyYoTMm2//lXaRy5oNBwTONkdI0=; b=jIQmd2EXjwbo2uiDvwR9pogOlI2EfOlfSz4lfRs8ymNunZ7OxRvyRWCu0O9+GDdObm +hPOBPCmr54v3MR06ndUUwceS9RUXsO6nOV5St9wJwU07RhRxQmi6XjhzbRqaQdNsfUS pcC8n6Bg8+WlGoqbva9Bls8AfPZl7mIYaqB74= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:reply-to:date:message-id:mime-version:content-type; b=Dn6FTD6ngOuXjmVonh6rMBCYp/3ecS9KYnhmMJsN9meqxXDqjUr+qn/alhFwctYb1p 3pYthqMXIeFiQ9sDoHofUlp4PwO3t6tEl3y6DeZPrhIlk/I2yLPUTa/7aPswQSnMsVAZ xHffpeFj6tK6KKF4VnV3fbcIiEhZZgfqavuCE= Original-Received: by 10.42.177.202 with SMTP id bj10mr15459322icb.16.1293649020451; Wed, 29 Dec 2010 10:57:00 -0800 (PST) Original-Received: from dad-laptop (pool-96-225-218-44.ptldor.fios.verizon.net [96.225.218.44]) by mx.google.com with ESMTPS id 34sm13460253ibi.8.2010.12.29.10.56.58 (version=TLSv1/SSLv3 cipher=RC4-MD5); Wed, 29 Dec 2010 10:56:59 -0800 (PST) Original-From: Richard Kim X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 29 Dec 2010 13:53:02 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:42921 Archived-At: I recently stumbled onto list-load-path-shadows command defined in shadow.el. This is a very useful command, but it is not mentioned in the lispref manual. I took a stab at adding it to the manual as shown by the diff below which adds a few lines at the end of the "Library Search" node in the manual just after the documentation of locate-library. === modified file 'doc/lispref/loading.texi' --- doc/lispref/loading.texi 2010-11-18 03:54:14 +0000 +++ doc/lispref/loading.texi 2010-12-29 18:50:23 +0000 @@ -363,6 +363,20 @@ tells @code{locate-library} to display the file name in the echo area. @end deffn +@deffn Command list-load-path-shadows &optional stringp +Display a list of Emacs Lisp files that shadow other files. + +If @var{stringp} is non-@code{nil}, returns any shadows as a string. +Otherwise, if interactive shows any shadows in a ``*Shadows*'' buffer; +else prints messages listing any shadows. + +This function lists potential load path problems. Directories in +the @var{load-path} variable are searched, in order, for Emacs Lisp +files. When a previously encountered file name is found again, a +message is displayed indicating that the later file is ``hidden'' by +the earlier. +@end deffn + @node Loading Non-ASCII @section Loading Non-@acronym{ASCII} Characters