From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ted Zlatanov Newsgroups: gmane.emacs.devel Subject: Re: moving more cl seq/mapping support into core Date: Thu, 07 Oct 2010 10:04:32 -0500 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <8739si11tr.fsf@lifelogs.com> References: <4CAA0FFC.5020809@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1286464520 5172 80.91.229.12 (7 Oct 2010 15:15:20 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 7 Oct 2010 15:15:20 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Oct 07 17:15:19 2010 Return-path: Envelope-to: ged-emacs-devel@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 1P3sBf-0006JI-KF for ged-emacs-devel@m.gmane.org; Thu, 07 Oct 2010 17:15:19 +0200 Original-Received: from localhost ([127.0.0.1]:35205 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P3sBS-00018W-Ph for ged-emacs-devel@m.gmane.org; Thu, 07 Oct 2010 11:15:02 -0400 Original-Received: from [140.186.70.92] (port=47162 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P3s1f-0002Dj-NH for emacs-devel@gnu.org; Thu, 07 Oct 2010 11:04:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1P3s1d-0006MT-Pc for emacs-devel@gnu.org; Thu, 07 Oct 2010 11:04:55 -0400 Original-Received: from lo.gmane.org ([80.91.229.12]:46696) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1P3s1d-0006Lg-KF for emacs-devel@gnu.org; Thu, 07 Oct 2010 11:04:53 -0400 Original-Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1P3s1X-0002vm-Jb for emacs-devel@gnu.org; Thu, 07 Oct 2010 17:04:47 +0200 Original-Received: from 38.98.147.130 ([38.98.147.130]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 07 Oct 2010 17:04:47 +0200 Original-Received: from tzz by 38.98.147.130 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 07 Oct 2010 17:04:47 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 26 Original-X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: 38.98.147.130 X-Face: bd.DQ~'29fIs`T_%O%C\g%6jW)yi[zuz6; d4V0`@y-~$#3P_Ng{@m+e4o<4P'#(_GJQ%TT= D}[Ep*b!\e,fBZ'j_+#"Ps?s2!4H2-Y"sx" User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/24.0.50 (gnu/linux) Cancel-Lock: sha1:AGide1w1BziZdzylYeZJDPQQsY8= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:131430 Archived-At: On Wed, 06 Oct 2010 19:41:13 -0400 Richard Stallman wrote: >> Meanwhile, there is a further issue. If we move these symbols into >> the standard Elisp, we need to document them in the Lisp Reference >> manual. We could certainly do that, with some work. But it would >> also make the Elisp manual bigger and more expensive. RS> There is already a manual in doc/misc/cl.texi. RS> It would need to be integrated into the Lisp Reference Manual RS> to make that manual do its job. And maybe partly rewritten RS> to make its style fit (I have not checked how much of that RS> would be needed). Many times features are either unexplained or it says to "look at the examples." For people who know CL or have experience with cl.el already it's a pretty good reference but for me the first time was a lot of back and forth browsing. In terms of organization it's pretty good. I found it very readable when I looked at it. But if it's integrated within the larger manual, many functions will need to at least get linked in the relevant sections (e.g. cl.el sequence functions should be mentioned in the "(elisp) Sequences Arrays Vectors" node). Ted