From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Better help support for EIEIO classes and methods Date: Sun, 03 Feb 2013 22:28:41 -0500 Message-ID: References: <877gmpz9mt.fsf@engster.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1359948534 16875 80.91.229.3 (4 Feb 2013 03:28:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 4 Feb 2013 03:28:54 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Feb 04 04:29:14 2013 Return-path: Envelope-to: ged-emacs-devel@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 1U2Ck2-00020x-Hu for ged-emacs-devel@m.gmane.org; Mon, 04 Feb 2013 04:29:10 +0100 Original-Received: from localhost ([::1]:39617 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U2Cjj-0000kF-Pw for ged-emacs-devel@m.gmane.org; Sun, 03 Feb 2013 22:28:51 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:42761) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U2Cjc-0000jS-4v for emacs-devel@gnu.org; Sun, 03 Feb 2013 22:28:50 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U2Cja-0007uM-Vq for emacs-devel@gnu.org; Sun, 03 Feb 2013 22:28:44 -0500 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.182]:55393) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U2Cja-0007uI-SK for emacs-devel@gnu.org; Sun, 03 Feb 2013 22:28:42 -0500 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av4EABK/CFFFpZnt/2dsb2JhbABEvw4Xc4IeAQEEAVYoCws0EhQYDYhCBsEtjWGDKQOIYZwZgV6DFQ X-IPAS-Result: Av4EABK/CFFFpZnt/2dsb2JhbABEvw4Xc4IeAQEEAVYoCws0EhQYDYhCBsEtjWGDKQOIYZwZgV6DFQ X-IronPort-AV: E=Sophos;i="4.84,565,1355115600"; d="scan'208";a="359566" Original-Received: from 69-165-153-237.dsl.teksavvy.com (HELO ceviche.home) ([69.165.153.237]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 03 Feb 2013 22:28:42 -0500 Original-Received: by ceviche.home (Postfix, from userid 20848) id CDCD666109; Sun, 3 Feb 2013 22:28:41 -0500 (EST) In-Reply-To: <877gmpz9mt.fsf@engster.org> (David Engster's message of "Sun, 03 Feb 2013 16:42:50 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.182 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:156816 Archived-At: > In Emacs proper, if you use describe-function on an EIEIO class > constructor like `auth-source-backend', you will get > auth-source-backend is a Lisp function. as the first line, which is > not very helpful. If you know that this is actually a class > constructor, you can at least call eieio-describe-class or > eieio-describe-constructor, which will give you a much more detailed > description, but is still missing one essential feature: a link to the > filename where this class is defined, which quickly brings you to the > correct class definition. This is even more important for methods, > which can have several implementations depending on the class they're > called on. To a large extent the first line is not that important since you can add the missing info in the docstring itself. Could you give more details of the things that can't be overcome this way? Stefan