annotate lisp/misc.el @ 70265:76465e48c749

Revision: emacs@sv.gnu.org/emacs--devo--0--patch-252 Merge from gnus--rel--5.10 Patches applied: * gnus--rel--5.10 (patch 96-97) - Update from CVS
author Miles Bader <miles@gnu.org>
date Sat, 29 Apr 2006 03:51:50 +0000
parents 3bd95f4f2941
children 8dbfc40e9ab8 c5406394f567
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
18383
11218164bc54 Add provide call.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
1 ;;; misc.el --- some nonstandard basic editing commands for Emacs
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 35
diff changeset
2
68651
3bd95f4f2941 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64762
diff changeset
3 ;; Copyright (C) 1989, 2002, 2003, 2004, 2005,
3bd95f4f2941 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64762
diff changeset
4 ;; 2006 Free Software Foundation, Inc.
845
213978acbc1e entered into RCS
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 807
diff changeset
5
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 659
diff changeset
6 ;; Maintainer: FSF
45078
829beb9a6a4b Follow coding conventions.
Pavel Janík <Pavel@Janik.cz>
parents: 38412
diff changeset
7 ;; Keywords: convenience
35
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
8
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
10
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 659
diff changeset
13 ;; the Free Software Foundation; either version 2, or (at your option)
35
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
14 ;; any later version.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
15
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
19 ;; GNU General Public License for more details.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
20
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
21 ;; You should have received a copy of the GNU General Public License
14169
83f275dcd93a Update FSF's address.
Erik Naggum <erik@naggum.no>
parents: 845
diff changeset
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
64091
6fb026ad601f Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52600
diff changeset
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
6fb026ad601f Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 52600
diff changeset
24 ;; Boston, MA 02110-1301, USA.
35
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
25
38412
253f761ad37b Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents: 18383
diff changeset
26 ;;; Commentary:
253f761ad37b Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents: 18383
diff changeset
27
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 659
diff changeset
28 ;;; Code:
35
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
29
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
30 (defun copy-from-above-command (&optional arg)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
31 "Copy characters from previous nonblank line, starting just above point.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
32 Copy ARG characters, but not past the end of that line.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
33 If no argument given, copy the entire rest of the line.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
34 The characters copied are inserted in the buffer before point."
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
35 (interactive "P")
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
36 (let ((cc (current-column))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
37 n
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
38 (string ""))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
39 (save-excursion
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
40 (beginning-of-line)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
41 (backward-char 1)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
42 (skip-chars-backward "\ \t\n")
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
43 (move-to-column cc)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
44 ;; Default is enough to copy the whole rest of the line.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
45 (setq n (if arg (prefix-numeric-value arg) (point-max)))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
46 ;; If current column winds up in middle of a tab,
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
47 ;; copy appropriate number of "virtual" space chars.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
48 (if (< cc (current-column))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
49 (if (= (preceding-char) ?\t)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
50 (progn
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
51 (setq string (make-string (min n (- (current-column) cc)) ?\ ))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
52 (setq n (- n (min n (- (current-column) cc)))))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
53 ;; In middle of ctl char => copy that whole char.
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
54 (backward-char 1)))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
55 (setq string (concat string
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
56 (buffer-substring
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
57 (point)
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
58 (min (save-excursion (end-of-line) (point))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
59 (+ n (point)))))))
63b375f17a65 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
60 (insert string)))
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 35
diff changeset
61
52600
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
62 ;; Variation of `zap-to-char'.
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
63
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
64 (defun zap-up-to-char (arg char)
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
65 "Kill up to, but not including ARG'th occurrence of CHAR.
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
66 Case is ignored if `case-fold-search' is non-nil in the current buffer.
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
67 Goes backward if ARG is negative; error if CHAR not found.
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
68 Ignores CHAR at point."
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
69 (interactive "p\ncZap up to char: ")
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
70 (let ((direction (if (>= arg 0) 1 -1)))
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
71 (kill-region (point)
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
72 (progn
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
73 (forward-char direction)
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
74 (unwind-protect
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
75 (search-forward (char-to-string char) nil nil arg)
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
76 (backward-char direction))
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
77 (point)))))
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
78
51340
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
79 ;; These were added with an eye to making possible a more CCA-compatible
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
80 ;; command set; but that turned out not to be interesting.
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
81
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
82 (defun mark-beginning-of-buffer ()
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
83 "Set mark at the beginning of the buffer."
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
84 (interactive)
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
85 (push-mark (point-min)))
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
86
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
87 (defun mark-end-of-buffer ()
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
88 "Set mark at the end of the buffer."
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
89 (interactive)
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
90 (push-mark (point-max)))
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
91
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
92 (defun upcase-char (arg)
52600
7a4a7a399a2f (upcase-char): Fix docstring.
Lute Kamstra <lute@gnu.org>
parents: 52401
diff changeset
93 "Uppercasify ARG chars starting from point. Point doesn't move."
51340
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
94 (interactive "p")
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
95 (save-excursion
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
96 (upcase-region (point) (progn (forward-char arg) (point)))))
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
97
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
98 (defun forward-to-word (arg)
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
99 "Move forward until encountering the beginning of a word.
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
100 With argument, do this that many times."
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
101 (interactive "p")
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
102 (or (re-search-forward (if (> arg 0) "\\W\\b" "\\b\\W") nil t arg)
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
103 (goto-char (if (> arg 0) (point-max) (point-min)))))
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
104
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
105 (defun backward-to-word (arg)
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
106 "Move backward until encountering the end of a word.
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
107 With argument, do this that many times."
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
108 (interactive "p")
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
109 (forward-to-word (- arg)))
bd66b46adcc8 (mark-beginning-of-buffer, mark-end-of-buffer, upcase-char, forward-to-word,
Juanma Barranquero <lekktu@gmail.com>
parents: 45078
diff changeset
110
18383
11218164bc54 Add provide call.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
111 (provide 'misc)
11218164bc54 Add provide call.
Richard M. Stallman <rms@gnu.org>
parents: 14169
diff changeset
112
52401
695cf19ef79e Add arch taglines
Miles Bader <miles@gnu.org>
parents: 51340
diff changeset
113 ;;; arch-tag: 908f7884-c19e-4388-920c-9cfa425e449b
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 35
diff changeset
114 ;;; misc.el ends here