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
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 @node Reading Mail, Calendar/Diary, Sending Mail, Top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 @chapter Reading Mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 @cindex mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 @cindex message
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6
1648
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
7 XEmacs provides several mail-reading packages. Each one comes with
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
8 its own manual, which is included in each package.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 The recommended mail-reading package for new users is VM. VM works
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 with standard Unix-mail-format folders and was designed as a replacement
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 for the older Rmail.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 XEmacs also provides a sophisticated and comfortable front-end to the
1648
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
15 MH mail-processing system, called @samp{MH-E}. Unlike in other
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16 mail programs, folders in MH are stored as file-system directories,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 with each message occupying one (numbered) file. This facilitates
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 working with mail using shell commands, and many other features of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 MH are also designed to integrate well with the shell and with
1648
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
20 shell scripts. Keep in mind, however, that in order to use MH-E
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 you must have the MH mail-processing system installed on your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 computer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23
1648
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
24 The @dfn{Everything including the kitchen sink} package @samp{Gnus} is
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
25 also available as an XEmacs package. Gnus also handles Usenet articles
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
26 as well as mail.
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
27
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
28 @samp{MEW} (Messaging in the Emacs World) is another mail-reading
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
29 package available for XEmacs.
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
30
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
31 Finally, XEmacs provides the Rmail package. Rmail is (currently)
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
32 the only mail reading package distributed with FSF GNU Emacs, and is
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
33 powerful in its own right. However, it stores mail folders in a
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
34 special format called @samp{Babyl}, that is incompatible with all
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
35 other frequently-used mail programs. A utility program is provided
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
36 for converting Babyl folders to standard Unix-mail format; however,
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
37 unless you already have mail in Babyl-format folders, you should
712931b4b71d [xemacs-hg @ 2003-08-27 18:06:54 by youngs]
youngs
parents: 0
diff changeset
38 consider using Gnus, VM, or MH-E instead.