From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#19767: 25.0.50; cl-defgeneric docs Date: Wed, 04 Feb 2015 10:32:13 -0500 Message-ID: References: <87d25pyifw.fsf@lifelogs.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1423063997 23508 80.91.229.3 (4 Feb 2015 15:33:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 4 Feb 2015 15:33:17 +0000 (UTC) Cc: 19767@debbugs.gnu.org To: Teodor Zlatanov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Feb 04 16:33:15 2015 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 1YJ1x3-00053l-UL for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Feb 2015 16:33:14 +0100 Original-Received: from localhost ([::1]:36942 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YJ1x3-0004ie-Eo for geb-bug-gnu-emacs@m.gmane.org; Wed, 04 Feb 2015 10:33:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42083) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YJ1wy-0004dk-4r for bug-gnu-emacs@gnu.org; Wed, 04 Feb 2015 10:33:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YJ1ws-0000Ym-DU for bug-gnu-emacs@gnu.org; Wed, 04 Feb 2015 10:33:08 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42783) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YJ1ws-0000Yf-B7 for bug-gnu-emacs@gnu.org; Wed, 04 Feb 2015 10:33:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YJ1ws-0003hv-2d for bug-gnu-emacs@gnu.org; Wed, 04 Feb 2015 10:33:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 04 Feb 2015 15:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19767 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 19767-submit@debbugs.gnu.org id=B19767.142306393814193 (code B ref 19767); Wed, 04 Feb 2015 15:33:01 +0000 Original-Received: (at 19767) by debbugs.gnu.org; 4 Feb 2015 15:32:18 +0000 Original-Received: from localhost ([127.0.0.1]:34023 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YJ1w9-0003gr-MY for submit@debbugs.gnu.org; Wed, 04 Feb 2015 10:32:17 -0500 Original-Received: from chene.dit.umontreal.ca ([132.204.246.20]:38327) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YJ1w7-0003gj-Lg for 19767@debbugs.gnu.org; Wed, 04 Feb 2015 10:32:16 -0500 Original-Received: from pastel.home (lechon.iro.umontreal.ca [132.204.27.242]) by chene.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id t14FWEAA007965; Wed, 4 Feb 2015 10:32:14 -0500 Original-Received: by pastel.home (Postfix, from userid 20848) id F36911758; Wed, 4 Feb 2015 10:32:13 -0500 (EST) In-Reply-To: <87d25pyifw.fsf@lifelogs.com> (Teodor Zlatanov's message of "Wed, 04 Feb 2015 07:22:59 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-NAI-Spam-Flag: NO X-NAI-Spam-Level: * X-NAI-Spam-Threshold: 5 X-NAI-Spam-Score: 1 X-NAI-Spam-Rules: 2 Rules triggered URI_HTM_MEDS_1HTTP=1, RV5207=0 X-NAI-Spam-Version: 2.3.0.9393 : core <5207> : inlines <2030> : streams <1384666> : uri <1846249> 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:99032 Archived-At: > I see lisp/emacs-lisp/cl-generic.el was added recently, and that's great. > But the CL manual hasn't been updated, I think? Indeed, that's the main missing part of cl-generic right now. > I could try to help here, but I haven't used this facility before so I > need some pointers. cl-generic tries to implement generic function part of CLOS (CLOS is the set of object-oriented features of Common-Lisp, and it includes the definition of objects&classes as well as the definition of methods which use the "generic function" approach). I tried to follow CLOS pretty closely for all the things where CLOS seemed sane (i.e. that excludes method-combinations). So there's existing docs ain the form of the "Common Lisp Hyperspec", such as http://www.lispworks.com/documentation/HyperSpec/Body/07_fb.htm but the copyright status of this is kind of murky (for example, the GCL doc includes it, but Debian took it out from its gcl-doc package because of this legal uncertainty), so we can't just use that, sadly. Stefan