Mercurial > hg > xemacs-beta
view man/xemacs/fixit.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 | 376386a54a3c |
children |
line wrap: on
line source
@node Fixit, Files, Search, Top @chapter Commands for Fixing Typos @cindex typos @cindex mistakes, correcting This chapter describes commands that are especially useful when you catch a mistake in your text just after you have made it, or when you change your mind while composing text on line. @menu * Kill Errors:: Commands to kill a batch of recently entered text. * Transpose:: Exchanging two characters, words, lines, lists... * Fixing Case:: Correcting case of last word entered. * Spelling:: Apply spelling checker to a word, or a whole file. @end menu @node Kill Errors, Transpose, Fixit, Fixit @section Killing Your Mistakes @table @kbd @item @key{DEL} Delete last character (@code{delete-backward-char}). @item M-@key{DEL} Kill last word (@code{backward-kill-word}). @item C-x @key{DEL} Kill to beginning of sentence (@code{backward-kill-sentence}). @end table @kindex DEL @findex delete-backward-char The @key{DEL} character (@code{delete-backward-char}) is the most important correction command. When used among graphic (self-inserting) characters, it can be thought of as canceling the last character typed. @kindex M-DEL @kindex C-x DEL @findex backward-kill-word @findex backward-kill-sentence When your mistake is longer than a couple of characters, it might be more convenient to use @kbd{M-@key{DEL}} or @kbd{C-x @key{DEL}}. @kbd{M-@key{DEL}} kills back to the start of the last word, and @kbd{C-x @key{DEL}} kills back to the start of the last sentence. @kbd{C-x @key{DEL}} is particularly useful when you are thinking of what to write as you type it, in case you change your mind about phrasing. @kbd{M-@key{DEL}} and @kbd{C-x @key{DEL}} save the killed text for @kbd{C-y} and @kbd{M-y} to retrieve. @xref{Yanking}.@refill @kbd{M-@key{DEL}} is often useful even when you have typed only a few characters wrong, if you know you are confused in your typing and aren't sure exactly what you typed. At such a time, you cannot correct with @key{DEL} except by looking at the screen to see what you did. It requires less thought to kill the whole word and start over. @node Transpose, Fixing Case, Kill Errors, Fixit @section Transposing Text @table @kbd @item C-t Transpose two characters (@code{transpose-chars}). @item M-t Transpose two words (@code{transpose-words}). @item C-M-t Transpose two balanced expressions (@code{transpose-sexps}). @item C-x C-t Transpose two lines (@code{transpose-lines}). @end table @cindex transposition @kindex C-t @findex transpose-chars The common error of transposing two adjacent characters can be fixed with the @kbd{C-t} command (@code{transpose-chars}). Normally, @kbd{C-t} transposes the two characters on either side of point. When given at the end of a line, @kbd{C-t} transposes the last two characters on the line, rather than transposing the last character of the line with the newline, which would be useless. If you catch a transposition error right away, you can fix it with just @kbd{C-t}. If you catch the error later, move the cursor back to between the two transposed characters. If you transposed a space with the last character of the word before it, the word motion commands are a good way of getting there. Otherwise, a reverse search (@kbd{C-r}) is often the best way. @xref{Search}. @kindex C-x C-t @findex transpose-lines @kindex M-t @findex transpose-words @kindex C-M-t @findex transpose-sexps @kbd{Meta-t} (@code{transpose-words}) transposes the word before point with the word after point. It moves point forward over a word, dragging the word preceding or containing point forward as well. The punctuation characters between the words do not move. For example, @w{@samp{FOO, BAR}} transposes into @w{@samp{BAR, FOO}} rather than @samp{@w{BAR FOO,}}. @kbd{C-M-t} (@code{transpose-sexps}) is a similar command for transposing two expressions (@pxref{Lists}), and @kbd{C-x C-t} (@code{transpose-lines}) exchanges lines. It works like @kbd{M-t} but in determines the division of the text into syntactic units differently. A numeric argument to a transpose command serves as a repeat count: it tells the transpose command to move the character (word, sexp, line) before or containing point across several other characters (words, sexps, lines). For example, @kbd{C-u 3 C-t} moves the character before point forward across three other characters. This is equivalent to repeating @kbd{C-t} three times. @kbd{C-u - 4 M-t} moves the word before point backward across four words. @kbd{C-u - C-M-t} would cancel the effect of plain @kbd{C-M-t}.@refill A numeric argument of zero transposes the character (word, sexp, line) ending after point with the one ending after the mark (otherwise a command with a repeat count of zero would do nothing). @node Fixing Case, Spelling, Transpose, Fixit @section Case Conversion @table @kbd @item M-- M-l Convert last word to lower case. Note that @kbd{Meta--} is ``Meta-minus.'' @item M-- M-u Convert last word to all upper case. @item M-- M-c Convert last word to lower case with capital initial. @end table @findex downcase-word @findex upcase-word @findex capitalize-word @kindex M-@t{-} M-l @kindex M-@t{-} M-u @kindex M-@t{-} M-c @cindex case conversion @cindex words A common error is to type words in the wrong case. Because of this, the word case-conversion commands @kbd{M-l}, @kbd{M-u}, and @kbd{M-c} do not move the cursor when used with a negative argument. As soon as you see you have mistyped the last word, you can simply case-convert it and continue typing. @xref{Case}.@refill @node Spelling,, Fixing Case, Fixit @section Checking and Correcting Spelling @cindex spelling @c doublewidecommands @table @kbd @item M-$ Check and correct spelling of word (@code{spell-word}). @item M-x spell-buffer Check and correct spelling of each word in the buffer. @item M-x spell-region Check and correct spelling of each word in the region. @item M-x spell-string Check spelling of specified word. @end table @kindex M-$ @findex spell-word To check the spelling of the word before point, and optionally correct it, use the command @kbd{M-$} (@code{spell-word}). This command runs an inferior process containing the @code{spell} program to see whether the word is correct English. If it is not, it asks you to edit the word (in the minibuffer) into a corrected spelling, and then performs a @code{query-replace} to substitute the corrected spelling for the old one throughout the buffer. If you exit the minibuffer without altering the original spelling, it means you do not want to do anything to that word. In that case, the @code{query-replace} is not done. @findex spell-buffer @kbd{M-x spell-buffer} checks each word in the buffer the same way that @code{spell-word} does, doing a @code{query-replace} for every incorrect word if appropriate.@refill @findex spell-region @kbd{M-x spell-region} is similar to @code{spell-buffer} but operates only on the region, not the entire buffer. @findex spell-string @kbd{M-x spell-string} reads a string as an argument and checks whether that is a correctly spelled English word. It prints a message giving the answer in the echo area.