From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Florian Beck Newsgroups: gmane.emacs.bugs Subject: bug#8297: Request: Better Emacs self-documentation for customization Date: Sun, 20 Mar 2011 01:07:46 +0100 Message-ID: <4D854552.6000509@miszellen.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1300583316 15180 80.91.229.12 (20 Mar 2011 01:08:36 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 20 Mar 2011 01:08:36 +0000 (UTC) To: 8297@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Mar 20 02:08:29 2011 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 1Q1789-00011w-6a for geb-bug-gnu-emacs@m.gmane.org; Sun, 20 Mar 2011 02:08:29 +0100 Original-Received: from localhost ([127.0.0.1]:55108 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q1788-0006lN-Fz for geb-bug-gnu-emacs@m.gmane.org; Sat, 19 Mar 2011 21:08:28 -0400 Original-Received: from [140.186.70.92] (port=55988 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q176n-00032J-VE for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 21:07:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q176l-0006U4-My for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 21:07:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:40265) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q176l-0006Tm-HT for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 21:07:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Q175m-0005AL-5T; Sat, 19 Mar 2011 21:06:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Florian Beck Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 20 Mar 2011 01:06:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 8297 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.130058314319828 (code B ref -1); Sun, 20 Mar 2011 01:06:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Mar 2011 01:05:43 +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 1Q175S-00059k-Rj for submit@debbugs.gnu.org; Sat, 19 Mar 2011 21:05:43 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Q16C8-0003ux-Oy for submit@debbugs.gnu.org; Sat, 19 Mar 2011 20:08:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q16C2-00078W-IO for submit@debbugs.gnu.org; Sat, 19 Mar 2011 20:08:27 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:44763) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q16C1-00077T-LD for submit@debbugs.gnu.org; Sat, 19 Mar 2011 20:08:26 -0400 Original-Received: from [140.186.70.92] (port=38448 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Q16Bj-0001nh-Rd for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 20:08:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Q16BR-000741-JJ for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 20:07:50 -0400 Original-Received: from mo-p00-ob.rzone.de ([81.169.146.162]:52565) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Q16BR-00073h-7y for bug-gnu-emacs@gnu.org; Sat, 19 Mar 2011 20:07:49 -0400 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; t=1300579667; l=794; s=domk; d=streitblatt.de; h=Content-Transfer-Encoding:Content-Type:Subject:To:MIME-Version:From: Date:X-RZG-CLASS-ID:X-RZG-AUTH; bh=zA1LJEnpkJxUNnopOsmt9J1tON0=; b=ocdh/KE5ZuEgViIou6VDW131dOwkGSGbRQxfEdBgOkzeYweFV2kM9idv9kBotBkwntI Zcr/7/mt5fCotnlaTBa6QBuovRRUeSoQa0MDXtYNgLPVWgNWaMhTeebZOqfUUeQePwGvz uyXjYJXfRZ3ISnhVKUG9YGqCB0GJY9tJlz4= X-RZG-AUTH: :KmALZ0mpdbGonPxw7gDkop508XQjelhLxGYn4B74/jTNdrjLjuwMuuiy8j0BYX6h4QCrsg== X-RZG-CLASS-ID: mo00 Original-Received: from [192.168.2.100] (p5499534E.dip.t-dialin.net [84.153.83.78]) by post.strato.de (mrclete mo10) (RZmta 25.8) with ESMTPA id 9068a6n2JMYJwk for ; Sun, 20 Mar 2011 01:07:46 +0100 (MET) User-Agent: Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.2.14) Gecko/20110223 Thunderbird/3.1.8 X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Mailman-Approved-At: Sat, 19 Mar 2011 21:05:41 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 19 Mar 2011 21:06:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-Mailman-Approved-At: Sat, 19 Mar 2011 21:08:22 -0400 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:45180 Archived-At: Emacs integrates any function I write into its documentation; the help function provides a link to the source. What I would like is for Emacs to track my customisations: - When I redefine an Emacs function I would like a link to the previous/original definition, `describe-function' only provides a link to the current one. - 'describe-variable', on the other hand, remembers the original definition, but doesn't remember the place where I changed the value. - `describe-key' only provides a link to the function, not to the place the key was defined. Obviously, this is not easy, because evaluations don't necessarily have a fixed place and key bindings can be defined in many ways. Regardless, I think this is something on which Emacs could improve. -- Florian Beck