emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: moving more cl seq/mapping support into core


From: Ted Zlatanov
Subject: Re: moving more cl seq/mapping support into core
Date: Thu, 07 Oct 2010 10:04:32 -0500
User-agent: Gnus/5.110011 (No Gnus v0.11) Emacs/24.0.50 (gnu/linux)

On Wed, 06 Oct 2010 19:41:13 -0400 Richard Stallman <address@hidden> 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




reply via email to

[Prev in Thread] Current Thread [Next in Thread]