From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#22336: 25.0.50; cl-generic.el features are not documented in ELisp manual Date: Sat, 09 Jan 2016 11:06:52 +0200 Message-ID: <83h9innmtv.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1452330502 15133 80.91.229.3 (9 Jan 2016 09:08:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 9 Jan 2016 09:08:22 +0000 (UTC) To: 22336@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jan 09 10:08:11 2016 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 1aHpVK-0004vF-N5 for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jan 2016 10:08:10 +0100 Original-Received: from localhost ([::1]:39776 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpVJ-0006OL-OG for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jan 2016 04:08:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58310) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpVG-0006O1-Ba for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:08:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHpVC-0006gN-7x for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:08:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:55386) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpVC-0006gJ-4J for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:08:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aHpVC-0006in-1Q for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:08:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 09 Jan 2016 09:08:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 22336 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.145233042625774 (code B ref -1); Sat, 09 Jan 2016 09:08:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 9 Jan 2016 09:07:06 +0000 Original-Received: from localhost ([127.0.0.1]:43606 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHpUI-0006hd-CV for submit@debbugs.gnu.org; Sat, 09 Jan 2016 04:07:06 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:38861) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aHpUH-0006h8-G2 for submit@debbugs.gnu.org; Sat, 09 Jan 2016 04:07:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHpUB-0006Yl-Aa for submit@debbugs.gnu.org; Sat, 09 Jan 2016 04:07:00 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:38605) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpUB-0006Yh-7k for submit@debbugs.gnu.org; Sat, 09 Jan 2016 04:06:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58060) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpUA-00067l-0L for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:06:59 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aHpU4-0006YE-Sn for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:06:57 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:55924) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aHpU4-0006YA-Q1 for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:06:52 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2224 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aHpU4-0004tV-6U for bug-gnu-emacs@gnu.org; Sat, 09 Jan 2016 04:06:52 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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:111411 Archived-At: It looks like the new features, implemented by cl-generic.el and used quite a lot in our sources, are not documented in any manual. Their doc strings are impenetrable to anyone who isn't already familiar with CLOS multiple-dispatch generics, as they use terminology ("specializers", "generalizers", "dispatch", etc.) not explained anywhere. NEWS has this to say about them: ** cl-generic.el provides CLOS-style multiple-dispatch generic functions. That's the entire text of the entry. It diesn't even mention the 2 entry points, 'cl-defgeneric' and 'cl-defmethod'. The generics should be prominently documented either in the ELisp manual. Emacs 25.1 should have them documented, due to their wide usage in the core packages and elsewhere. In GNU Emacs 25.0.50.281 (i686-pc-mingw32) of 2016-01-08 built on HOME-C4E4A596F7 Repository revision: 1a6b0846b5fbf08aa4288ae9e47c59cfca30459f Windowing system distributor 'Microsoft Corp.', version 5.1.2600 Configured using: 'configure --prefix=/d/usr --enable-checking=yes,glyphs --with-wide-int --with-modules 'CFLAGS=-O0 -gdwarf-4 -g3'' Configured features: XPM JPEG TIFF GIF PNG RSVG SOUND NOTIFY ACL GNUTLS LIBXML2 ZLIB TOOLKIT_SCROLL_BARS MODULES Important settings: value of $LANG: ENU locale-coding-system: cp1255 Major mode: Lisp Interaction Minor modes in effect: tooltip-mode: t global-eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message dired format-spec rfc822 mml mml-sec epg epg-config gnus-util mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util help-fns help-mode easymenu cl-loaddefs pcase cl-lib mail-prsvr mail-utils time-date mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel dos-w32 ls-lisp disp-table w32-win w32-vars term/common-win tool-bar dnd fontset image regexp-opt fringe tabulated-list newcomment elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese charscript case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote w32notify w32 multi-tty make-network-process emacs) Memory information: ((conses 16 92854 5930) (symbols 56 20660 0) (miscs 48 36 107) (strings 16 17691 6375) (string-bytes 1 438680) (vectors 16 12303) (vector-slots 8 418992 3863) (floats 8 162 76) (intervals 40 261 118) (buffers 856 11))