From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#7346: `load-file-name' undocumented Date: Sat, 6 Nov 2010 16:11:33 -0400 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: dough.gmane.org 1289074430 18172 80.91.229.12 (6 Nov 2010 20:13:50 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 6 Nov 2010 20:13:50 +0000 (UTC) To: 7346@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Nov 06 21:13:43 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 1PEp8x-00063o-9i for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Nov 2010 21:13:43 +0100 Original-Received: from localhost ([127.0.0.1]:43892 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PEp8w-0007gF-NL for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Nov 2010 16:13:42 -0400 Original-Received: from [140.186.70.92] (port=51611 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PEp8s-0007fv-La for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:13:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PEp8r-00046S-Pq for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:13:38 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54307) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PEp8r-00046M-Mx for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:13:37 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PEp3S-00034v-Fr; Sat, 06 Nov 2010 16:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Nov 2010 20:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7346 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.128907402611817 (code B ref -1); Sat, 06 Nov 2010 20:08:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 6 Nov 2010 20:07:06 +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 1PEp2Y-00034Y-EV for submit@debbugs.gnu.org; Sat, 06 Nov 2010 16:07:06 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PEp2W-00034C-Ak for submit@debbugs.gnu.org; Sat, 06 Nov 2010 16:07:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PEp6v-0003jK-FR for submit@debbugs.gnu.org; Sat, 06 Nov 2010 16:11:38 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:45221) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PEp6v-0003jG-Da for submit@debbugs.gnu.org; Sat, 06 Nov 2010 16:11:37 -0400 Original-Received: from [140.186.70.92] (port=50523 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PEp6u-00072c-KC for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:11:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PEp6t-0003j1-GQ for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:11:36 -0400 Original-Received: from mail-ww0-f49.google.com ([74.125.82.49]:34857) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PEp6t-0003ip-CU for bug-gnu-emacs@gnu.org; Sat, 06 Nov 2010 16:11:35 -0400 Original-Received: by wwe15 with SMTP id 15so4508587wwe.30 for ; Sat, 06 Nov 2010 13:11:33 -0700 (PDT) Original-Received: by 10.216.176.20 with SMTP id a20mr3598848wem.14.1289074293636; Sat, 06 Nov 2010 13:11:33 -0700 (PDT) Original-Received: by 10.216.37.69 with HTTP; Sat, 6 Nov 2010 13:11:33 -0700 (PDT) X-Google-Sender-Auth: KMVgTUDtRlh9wTZMs3G6kVz_5w0 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: Sat, 06 Nov 2010 16:08:02 -0400 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:41414 Archived-At: Despite it being exceedingly useful, I'm unable to find reference/documentation of the `load-file-name' variable in the manuals. It is quite unfortunate that this particular feature hasn't been better advertised to users. AFAICT Emacs 23.2 lisp reference manual does not provide any documentation of this variable. This said, as of Bzr-102222 `load-file-file-name' is passingly referenced by lisp manual in /doc/lispref/package.texi Other than that, its only other appearance is in a lisp example in /doc/misc/viper.texi Future manuals should provide discussion of this variable in at least one other location _other than_ w/re packages. At very least, the documentation of Emacs' Vi compatibility should not be given to appear more knowledgeable about this feature than the Emacs lisp manual! -- /s_P\