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, 16 Jan 2016 10:25:39 +0200 Message-ID: <831t9iexrw.fsf@gnu.org> References: <83h9innmtv.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1452932781 31409 80.91.229.3 (16 Jan 2016 08:26:21 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 16 Jan 2016 08:26:21 +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 16 09:26:10 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 1aKMBV-0005em-SR for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jan 2016 09:26:10 +0100 Original-Received: from localhost ([::1]:50070 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aKMBV-0003Au-Ab for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jan 2016 03:26:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59378) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aKMBR-0003Ac-5V for bug-gnu-emacs@gnu.org; Sat, 16 Jan 2016 03:26:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aKMBN-0003CD-TB for bug-gnu-emacs@gnu.org; Sat, 16 Jan 2016 03:26:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33985) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aKMBN-0003C8-QH for bug-gnu-emacs@gnu.org; Sat, 16 Jan 2016 03:26:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aKMBN-0001sR-M2 for bug-gnu-emacs@gnu.org; Sat, 16 Jan 2016 03:26:01 -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, 16 Jan 2016 08:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 22336 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 22336-submit@debbugs.gnu.org id=B22336.14529327527196 (code B ref 22336); Sat, 16 Jan 2016 08:26:01 +0000 Original-Received: (at 22336) by debbugs.gnu.org; 16 Jan 2016 08:25:52 +0000 Original-Received: from localhost ([127.0.0.1]:50438 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aKMBD-0001s0-Rd for submit@debbugs.gnu.org; Sat, 16 Jan 2016 03:25:52 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:40112) by debbugs.gnu.org with esmtp (Exim 4.84) (envelope-from ) id 1aKMBD-0001rm-8p for 22336@debbugs.gnu.org; Sat, 16 Jan 2016 03:25:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aKMB5-0002vu-2W for 22336@debbugs.gnu.org; Sat, 16 Jan 2016 03:25:46 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59982) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aKMB4-0002vg-VL for 22336@debbugs.gnu.org; Sat, 16 Jan 2016 03:25:42 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1941 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aKMB0-00014D-IM for 22336@debbugs.gnu.org; Sat, 16 Jan 2016 03:25:40 -0500 In-reply-to: <83h9innmtv.fsf@gnu.org> (message from Eli Zaretskii on Sat, 09 Jan 2016 11:06:52 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:111670 Archived-At: Ping! Would someone please volunteer to write some documentation of these? > Date: Sat, 09 Jan 2016 11:06:52 +0200 > From: Eli Zaretskii > > > 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)) > > > >