Mercurial > hg > xemacs-beta
annotate man/xemacs/reading.texi @ 4995:8431b52e43b1
Move the various map* functions to C; add #'map-into.
src/ChangeLog addition:
2010-01-31 Aidan Kehoe <kehoea@parhasard.net>
Move #'mapcar*, #'mapcan, #'mapc, #'map, #'mapl, #'mapcon to C;
extend #'mapvector, #'mapconcat, #'mapcar to support more
SEQUENCES; have them all error with circular lists.
* fns.c (Fsubseq): Call CHECK_SEQUENCE here; Flength can return
from the debugger if it errors with a non-sequence, leading to a
crash in Fsubseq if sequence really is *not* a sequence.
(mapcarX): Rename mapcar1 to mapcarX; rework it comprehensively to
take an optional lisp output argument, and a varying number of
sequences.
Special-case a single list argument, as we used to, saving its
elements in the stack space for the results before calling
FUNCTION, so FUNCTION can corrupt the list all it
wants. dead_wrong_type_argument() in the other cases if we
encounter a non-cons where we expected a cons.
(Fmapconcat):
Accept further SEQUENCES after separator here. Special-case
the idiom (mapconcat 'identity SEQUENCE), don't even funcall.
(FmapcarX): Rename this from Fmapcar. Accept optional SEQUENCES.
(Fmapvector): Accept optional SEQUENCES.
(Fmapcan, Fmapc, Fmap): Move these here from cl-extra.el.
(Fmap_into): New function, as specified by Common Lisp.
(maplist): New function, the guts of the implementation of
Fmaplist and Fmapl.
(Fmaplist, Fmapl, Fmapcon): Move these from cl-extra.el.
(syms_of_fns):
Add a few needed symbols here, for the type tests
used by #'map. Add the new subrs, with aliases for #'mapc-internal
and #'mapcar.
* general-slots.h: Declare Qcoerce here, now it's used in both
indent.c and fns.c
* indent.c (syms_of_indent): Qcoerce is gone from here.
* lisp.h: Add ARRAYP(), SEQUENCEP(), and the corresponding CHECK_*
macros. Declare Fbit_vector, Fstring, FmapcarX, now other files
need to use them.
* data.c (Farrayp, Fsequencep): Use ARRAYP and SEQUENCEP, just
added to lisp.h
* buffer.c (Fbuffer_list): Now Fmapcar has been renamed FmapcarX
and takes MANY arguments, update this function to reflect that.
lisp/ChangeLog addition:
2010-01-31 Aidan Kehoe <kehoea@parhasard.net>
* cl.el (mapcar*): Delete; this is now in fns.c.
Use #'mapc, not #'mapc-internal in a couple of places.
* cl-macs.el (mapc, mapcar*, map): Delete these compiler macros
now the corresponding functions are in fns.c; there's no run-time
advantage to the macros.
* cl-extra.el (coerce): Extend the possible conversions here a
little; it's not remotely comprehensive yet, though it does allow
running slightly more Common Lisp code than previously.
(cl-mapcar-many): Delete.
(map, maplist, mapc, mapl, mapcan, mapcon): Move these to fns.c.
* bytecomp.el (byte-compile-maybe-mapc):
Use #'mapc itself, not #'mapc-internal, now the former is in C.
(mapcar*): Use #'byte-compile-maybe-mapc as this function's
byte-compile method, now a #'mapc that can take more than one
sequence is in C.
* obsolete.el (cl-mapc): Move this compatibility alias to this file.
* update-elc.el (do-autoload-commands): Use #'mapc, not
#'mapc-internal here.
author | Aidan Kehoe <kehoea@parhasard.net> |
---|---|
date | Sun, 31 Jan 2010 18:29:48 +0000 |
parents | 712931b4b71d |
children |
rev | line source |
---|---|
0 | 1 |
2 @node Reading Mail, Calendar/Diary, Sending Mail, Top | |
3 @chapter Reading Mail | |
4 @cindex mail | |
5 @cindex message | |
6 | |
1648 | 7 XEmacs provides several mail-reading packages. Each one comes with |
8 its own manual, which is included in each package. | |
0 | 9 |
10 The recommended mail-reading package for new users is VM. VM works | |
11 with standard Unix-mail-format folders and was designed as a replacement | |
12 for the older Rmail. | |
13 | |
14 XEmacs also provides a sophisticated and comfortable front-end to the | |
1648 | 15 MH mail-processing system, called @samp{MH-E}. Unlike in other |
0 | 16 mail programs, folders in MH are stored as file-system directories, |
17 with each message occupying one (numbered) file. This facilitates | |
18 working with mail using shell commands, and many other features of | |
19 MH are also designed to integrate well with the shell and with | |
1648 | 20 shell scripts. Keep in mind, however, that in order to use MH-E |
0 | 21 you must have the MH mail-processing system installed on your |
22 computer. | |
23 | |
1648 | 24 The @dfn{Everything including the kitchen sink} package @samp{Gnus} is |
25 also available as an XEmacs package. Gnus also handles Usenet articles | |
26 as well as mail. | |
27 | |
28 @samp{MEW} (Messaging in the Emacs World) is another mail-reading | |
29 package available for XEmacs. | |
30 | |
31 Finally, XEmacs provides the Rmail package. Rmail is (currently) | |
32 the only mail reading package distributed with FSF GNU Emacs, and is | |
33 powerful in its own right. However, it stores mail folders in a | |
34 special format called @samp{Babyl}, that is incompatible with all | |
35 other frequently-used mail programs. A utility program is provided | |
36 for converting Babyl folders to standard Unix-mail format; however, | |
37 unless you already have mail in Babyl-format folders, you should | |
38 consider using Gnus, VM, or MH-E instead. |