annotate lisp/textmodes/paragraphs.el @ 74969:3b49658358de

(dired-sort-other): Move test for dired-mode... (dired-sort-set-modeline): ...to here.
author Nick Roberts <nickrob@snap.net.nz>
date Fri, 29 Dec 2006 23:57:38 +0000
parents 925aeac78b9e
children e3694f1cb928 2ecafc6d5db7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
38412
253f761ad37b Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents: 37415
diff changeset
1 ;;; paragraphs.el --- paragraph and sentence parsing
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 269
diff changeset
2
64751
5b1a238fcbb4 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64084
diff changeset
3 ;; Copyright (C) 1985, 1986, 1987, 1991, 1994, 1995, 1996, 1997, 1999, 2000,
68648
067115a6e738 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 66422
diff changeset
4 ;; 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
845
213978acbc1e entered into RCS
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 814
diff changeset
5
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 732
diff changeset
6 ;; Maintainer: FSF
814
38b2499cb3e9 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
7 ;; Keywords: wp
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 732
diff changeset
8
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
9 ;; This file is part of GNU Emacs.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
10
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
11 ;; GNU Emacs is free software; you can redistribute it and/or modify
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
12 ;; it under the terms of the GNU General Public License as published by
804
33aaf4b71a1d *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 789
diff changeset
13 ;; the Free Software Foundation; either version 2, or (at your option)
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
14 ;; any later version.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
15
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
16 ;; GNU Emacs is distributed in the hope that it will be useful,
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
19 ;; GNU General Public License for more details.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
20
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
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: 12804
diff changeset
22 ;; along with GNU Emacs; see the file COPYING. If not, write to the
64084
a8fa7c632ee4 Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 59179
diff changeset
23 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
a8fa7c632ee4 Update FSF's address.
Lute Kamstra <lute@gnu.org>
parents: 59179
diff changeset
24 ;; Boston, MA 02110-1301, USA.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
25
2308
f287613dfc28 Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1462
diff changeset
26 ;;; Commentary:
f287613dfc28 Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1462
diff changeset
27
f287613dfc28 Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1462
diff changeset
28 ;; This package provides the paragraph-oriented commands documented in the
f287613dfc28 Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1462
diff changeset
29 ;; Emacs manual.
f287613dfc28 Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1462
diff changeset
30
789
71d052f72ac1 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 732
diff changeset
31 ;;; Code:
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
32
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
33 (defgroup paragraphs nil
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
34 "Paragraph and sentence parsing."
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
35 :group 'editing)
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
36
56941
e838a0739922 (use-hard-newlines): Make it into a permanent local.
Luc Teirlinck <teirllm@auburn.edu>
parents: 56084
diff changeset
37 (put 'use-hard-newlines 'permanent-local t)
40483
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
38 (define-minor-mode use-hard-newlines
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
39 "Minor mode to distinguish hard and soft newlines.
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
40 When active, the functions `newline' and `open-line' add the
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
41 text-property `hard' to newlines that they insert, and a line is
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
42 only considered as a candidate to match `paragraph-start' or
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
43 `paragraph-separate' if it follows a hard newline.
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
44
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
45 Prefix argument says to turn mode on if positive, off if negative.
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
46 When the mode is turned on, if there are newlines in the buffer but no hard
49599
5ade352e8d1c Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 48401
diff changeset
47 newlines, ask the user whether to mark as hard any newlines preceeding a
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
48 `paragraph-start' line. From a program, second arg INSERT specifies whether
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
49 to do this; it can be `never' to change nothing, t or `always' to force
49599
5ade352e8d1c Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents: 48401
diff changeset
50 marking, `guess' to try to do the right thing with no questions, nil
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
51 or anything else to ask the user.
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
52
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
53 Newlines not marked hard are called \"soft\", and are always internal
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
54 to paragraphs. The fill functions insert and delete only soft newlines."
48401
2928f718924e (use-hard-newlines): Add group.
Markus Rost <rost@math.uni-bielefeld.de>
parents: 47829
diff changeset
55 :group 'paragraphs
40483
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
56 :extra-args (insert)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
57 (when use-hard-newlines
16019
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
58 ;; Turn mode on
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
59 ;; Intuit hard newlines --
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
60 ;; mark as hard any newlines preceding a paragraph-start line.
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
61 (if (or (eq insert t) (eq insert 'always)
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
62 (and (not (eq 'never insert))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
63 (not (text-property-any (point-min) (point-max) 'hard t))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
64 (save-excursion
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
65 (goto-char (point-min))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
66 (search-forward "\n" nil t))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
67 (or (eq insert 'guess)
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
68 (y-or-n-p "Make newlines between paragraphs hard? "))))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
69 (save-excursion
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
70 (goto-char (point-min))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
71 (while (search-forward "\n" nil t)
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
72 (let ((pos (point)))
99cc9a8dd157 (use-hard-newlines): New minor mode function.
Richard M. Stallman <rms@gnu.org>
parents: 14378
diff changeset
73 (move-to-left-margin)
40483
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
74 (when (looking-at paragraph-start)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
75 (set-hard-newline-properties (1- pos) pos))
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
76 ;; If paragraph-separate, newline after it is hard too.
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
77 (when (looking-at paragraph-separate)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
78 (set-hard-newline-properties (1- pos) pos)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
79 (end-of-line)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
80 (unless (eobp)
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
81 (set-hard-newline-properties (point) (1+ (point)))))))))))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
82
40483
b7f7d0cc89fb (use-hard-newlines): Use define-minor-mode.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 38715
diff changeset
83 (defcustom paragraph-start "\f\\|[ \t]*$" "\
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
84 Regexp for beginning of a line that starts OR separates paragraphs.
4585
04e78c728252 (paragraph-start): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 2828
diff changeset
85 This regexp should match lines that separate paragraphs
04e78c728252 (paragraph-start): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 2828
diff changeset
86 and should also match lines that start a paragraph
04e78c728252 (paragraph-start): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 2828
diff changeset
87 \(and are part of that paragraph).
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
88
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
89 This is matched against the text at the left margin, which is not necessarily
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
90 the beginning of the line, so it should never use \"^\" as an anchor. This
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
91 ensures that the paragraph functions will work equally well within a region
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
92 of text indented by a margin setting.
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
93
4585
04e78c728252 (paragraph-start): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 2828
diff changeset
94 The variable `paragraph-separate' specifies how to distinguish
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
95 lines that start paragraphs from lines that separate them.
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
96
34655
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 27837
diff changeset
97 If the variable `use-hard-newlines' is non-nil, then only lines following a
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
98 hard newline are considered to match."
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
99 :group 'paragraphs
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
100 :type 'regexp)
69818
684aaf007d39 * files.el: Move some `safe-local-variable' declarations to the
Reiner Steib <Reiner.Steib@gmx.de>
parents: 68648
diff changeset
101 ;;;###autoload(put 'paragraph-start 'safe-local-variable 'stringp)
264
7db4ff4204a5 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 237
diff changeset
102
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
103 ;; paragraph-start requires a hard newline, but paragraph-separate does not:
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
104 ;; It is assumed that paragraph-separate is distinctive enough to be believed
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
105 ;; whenever it occurs, while it is reasonable to set paragraph-start to
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
106 ;; something very minimal, even including "." (which makes every hard newline
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
107 ;; start a new paragraph).
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
108
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
109 (defcustom paragraph-separate "[ \t\f]*$"
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
110 "Regexp for beginning of a line that separates paragraphs.
24309
92537e14b89b (paragraph-separate): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 23245
diff changeset
111 If you change this, you may have to change `paragraph-start' also.
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
112
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
113 This is matched against the text at the left margin, which is not necessarily
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
114 the beginning of the line, so it should not use \"^\" as an anchor. This
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
115 ensures that the paragraph functions will work equally within a region of
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
116 text indented by a margin setting."
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
117 :group 'paragraphs
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
118 :type 'regexp)
69818
684aaf007d39 * files.el: Move some `safe-local-variable' declarations to the
Reiner Steib <Reiner.Steib@gmx.de>
parents: 68648
diff changeset
119 ;;;###autoload(put 'paragraph-separate 'safe-local-variable 'stringp)
264
7db4ff4204a5 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 237
diff changeset
120
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
121 (defcustom sentence-end-double-space t
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
122 "Non-nil means a single space does not end a sentence.
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
123 This is relevant for filling. See also `sentence-end-without-period'
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
124 and `colon-double-space'.
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
125
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
126 This value is used by the function `sentence-end' to construct the
57405
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
127 regexp describing the end of a sentence, when the value of the variable
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
128 `sentence-end' is nil. See Info node `(elisp)Standard Regexps'."
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
129 :type 'boolean
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
130 :group 'fill)
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
131 ;;;###autoload(put 'sentence-end-double-space 'safe-local-variable 'booleanp)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
132
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
133 (defcustom sentence-end-without-period nil
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
134 "Non-nil means a sentence will end without a period.
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
135 For example, a sentence in Thai text ends with double space but
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
136 without a period.
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
137
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
138 This value is used by the function `sentence-end' to construct the
57405
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
139 regexp describing the end of a sentence, when the value of the variable
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
140 `sentence-end' is nil. See Info node `(elisp)Standard Regexps'."
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
141 :type 'boolean
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
142 :group 'fill)
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
143 ;;;###autoload(put 'sentence-end-without-period 'safe-local-variable 'booleanp)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
144
53721
40f76024a6c1 (sentence-end-without-space): New variable.
Kenichi Handa <handa@m17n.org>
parents: 52401
diff changeset
145 (defcustom sentence-end-without-space
40f76024a6c1 (sentence-end-without-space): New variable.
Kenichi Handa <handa@m17n.org>
parents: 52401
diff changeset
146 "$B!#!%!)!*$A!##.#?#!$(0!$!%!)!*$(G!$!%!)!*(B"
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
147 "String of characters that end sentence without following spaces.
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
148
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
149 This value is used by the function `sentence-end' to construct the
57405
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
150 regexp describing the end of a sentence, when the value of the variable
ba8ab430f898 (sentence-end-double-space)
Luc Teirlinck <teirllm@auburn.edu>
parents: 57282
diff changeset
151 `sentence-end' is nil. See Info node `(elisp)Standard Regexps'."
53721
40f76024a6c1 (sentence-end-without-space): New variable.
Kenichi Handa <handa@m17n.org>
parents: 52401
diff changeset
152 :group 'paragraphs
40f76024a6c1 (sentence-end-without-space): New variable.
Kenichi Handa <handa@m17n.org>
parents: 52401
diff changeset
153 :type 'string)
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
154 ;;;###autoload(put 'sentence-end-without-space 'safe-local-variable 'stringp)
53721
40f76024a6c1 (sentence-end-without-space): New variable.
Kenichi Handa <handa@m17n.org>
parents: 52401
diff changeset
155
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
156 (defcustom sentence-end nil
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
157 "Regexp describing the end of a sentence.
37415
16c36231eb5c (sentence-end): Doc fix.
Eli Zaretskii <eliz@gnu.org>
parents: 37302
diff changeset
158 The value includes the whitespace following the sentence.
2503
fb3509fdf8b7 Sat Apr 10 00:39:29 1993 Jim Blandy (jimb@totoro.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents: 2308
diff changeset
159 All paragraph boundaries also end sentences, regardless.
fb3509fdf8b7 Sat Apr 10 00:39:29 1993 Jim Blandy (jimb@totoro.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents: 2308
diff changeset
160
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
161 The value nil means to use the default value defined by the
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
162 function `sentence-end'. You should always use this function
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
163 to obtain the value of this variable."
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
164 :group 'paragraphs
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
165 :type '(choice regexp (const :tag "Use default value" nil)))
69830
196122ba0b05 * subr.el (string-or-null-p): New function.
Reiner Steib <Reiner.Steib@gmx.de>
parents: 69818
diff changeset
166 ;;;###autoload(put 'sentence-end 'safe-local-variable 'string-or-null-p)
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
167
66422
ee446efaafaf (sentence-end-base): Use real chars, so as
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66292
diff changeset
168 (defcustom sentence-end-base "[.?!][]\"'$B!I$,1r}(B)}]*"
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
169 "Regexp matching the basic end of a sentence, not including following space."
66292
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
170 :group 'paragraphs
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
171 :type 'string
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
172 :version "22.1")
69818
684aaf007d39 * files.el: Move some `safe-local-variable' declarations to the
Reiner Steib <Reiner.Steib@gmx.de>
parents: 68648
diff changeset
173 ;;;###autoload(put 'sentence-end-base 'safe-local-variable 'stringp)
66292
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
174
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
175 (defun sentence-end ()
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
176 "Return the regexp describing the end of a sentence.
24472
30ee4bf65cb3 (sentence-end): Doc fix.
Dave Love <fx@gnu.org>
parents: 24309
diff changeset
177
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
178 This function returns either the value of the variable `sentence-end'
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
179 if it is non-nil, or the default value constructed from the
66292
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
180 variables `sentence-end-base', `sentence-end-double-space',
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
181 `sentence-end-without-period' and `sentence-end-without-space'.
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
182
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
183 The default value specifies that in order to be recognized as the
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
184 end of a sentence, the ending period, question mark, or exclamation point
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
185 must be followed by two spaces, with perhaps some closing delimiters
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
186 in between. See Info node `(elisp)Standard Regexps'."
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
187 (or sentence-end
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
188 (concat (if sentence-end-without-period "\\w \\|")
66292
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
189 "\\("
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
190 sentence-end-base
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
191 (if sentence-end-double-space
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
192 "\\($\\| $\\|\t\\| \\)" "\\($\\|[\t ]\\)")
66292
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
193 "\\|[" sentence-end-without-space "]+"
15de85d4b7fe (sentence-end-base): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 64751
diff changeset
194 "\\)"
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
195 "[ \t\n]*")))
264
7db4ff4204a5 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 237
diff changeset
196
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
197 (defcustom page-delimiter "^\014"
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
198 "Regexp describing line-beginnings that separate pages."
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
199 :group 'paragraphs
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
200 :type 'regexp)
70221
1fd89e2b70fd (sentence-end-double-space, sentence-end-without-period)
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 69830
diff changeset
201 ;;;###autoload(put 'page-delimiter 'safe-local-variable 'stringp)
264
7db4ff4204a5 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 237
diff changeset
202
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
203 (defcustom paragraph-ignore-fill-prefix nil
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
204 "Non-nil means the paragraph commands are not affected by `fill-prefix'.
19475
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
205 This is desirable in modes where blank lines are the paragraph delimiters."
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
206 :group 'paragraphs
c8c9212a86a7 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 17569
diff changeset
207 :type 'boolean)
70270
925aeac78b9e (sentence-end-without-space): Fix safety predicate.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 70221
diff changeset
208 ;;;###autoload(put 'paragraph-ignore-fill-prefix 'safe-local-variable 'booleanp)
264
7db4ff4204a5 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 237
diff changeset
209
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
210 (defun forward-paragraph (&optional arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
211 "Move forward to end of paragraph.
16757
e1c2e9a44236 (forward-paragraph, backward-paragraph): Doc fixes.
Richard M. Stallman <rms@gnu.org>
parents: 16687
diff changeset
212 With argument ARG, do it ARG times;
e1c2e9a44236 (forward-paragraph, backward-paragraph): Doc fixes.
Richard M. Stallman <rms@gnu.org>
parents: 16687
diff changeset
213 a negative argument ARG = -N means move backward N paragraphs.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
214
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
215 A line which `paragraph-start' matches either separates paragraphs
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
216 \(if `paragraph-separate' matches it also) or is the first line of a paragraph.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
217 A paragraph end is the beginning of a line which is not part of the paragraph
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
218 to which the end of the previous line belongs, or the end of the buffer.
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
219 Returns the count of paragraphs left to move."
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
220 (interactive "p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
221 (or arg (setq arg 1))
26055
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
222 (let* ((opoint (point))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
223 (fill-prefix-regexp
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
224 (and fill-prefix (not (equal fill-prefix ""))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
225 (not paragraph-ignore-fill-prefix)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
226 (regexp-quote fill-prefix)))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
227 ;; Remove ^ from paragraph-start and paragraph-sep if they are there.
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
228 ;; These regexps shouldn't be anchored, because we look for them
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
229 ;; starting at the left-margin. This allows paragraph commands to
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
230 ;; work normally with indented text.
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
231 ;; This hack will not find problem cases like "whatever\\|^something".
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
232 (parstart (if (and (not (equal "" paragraph-start))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
233 (equal ?^ (aref paragraph-start 0)))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
234 (substring paragraph-start 1)
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
235 paragraph-start))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
236 (parsep (if (and (not (equal "" paragraph-separate))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
237 (equal ?^ (aref paragraph-separate 0)))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
238 (substring paragraph-separate 1)
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
239 paragraph-separate))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
240 (parsep
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
241 (if fill-prefix-regexp
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
242 (concat parsep "\\|"
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
243 fill-prefix-regexp "[ \t]*$")
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
244 parsep))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
245 ;; This is used for searching.
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
246 (sp-parstart (concat "^[ \t]*\\(?:" parstart "\\|" parsep "\\)"))
22953
fbeacfb09096 (forward-paragraph): Fix the logic for handling beginning of buffer
Richard M. Stallman <rms@gnu.org>
parents: 19527
diff changeset
247 start found-start)
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
248 (while (and (< arg 0) (not (bobp)))
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
249 (if (and (not (looking-at parsep))
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
250 (re-search-backward "^\n" (max (1- (point)) (point-min)) t)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
251 (looking-at parsep))
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
252 (setq arg (1+ arg))
12717
8e153c7bbd90 (forward-paragraph): Don't move back over a line
Richard M. Stallman <rms@gnu.org>
parents: 11235
diff changeset
253 (setq start (point))
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
254 ;; Move back over paragraph-separating lines.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
255 (forward-char -1) (beginning-of-line)
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
256 (while (and (not (bobp))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
257 (progn (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
258 (looking-at parsep)))
34655
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 27837
diff changeset
259 (forward-line -1))
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
260 (if (bobp)
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
261 nil
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
262 (setq arg (1+ arg))
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
263 ;; Go to end of the previous (non-separating) line.
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
264 (end-of-line)
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
265 ;; Search back for line that starts or separates paragraphs.
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
266 (if (if fill-prefix-regexp
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
267 ;; There is a fill prefix; it overrides parstart.
12717
8e153c7bbd90 (forward-paragraph): Don't move back over a line
Richard M. Stallman <rms@gnu.org>
parents: 11235
diff changeset
268 (let (multiple-lines)
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
269 (while (and (progn (beginning-of-line) (not (bobp)))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
270 (progn (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
271 (not (looking-at parsep)))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
272 (looking-at fill-prefix-regexp))
34655
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 27837
diff changeset
273 (unless (= (point) start)
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 27837
diff changeset
274 (setq multiple-lines t))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
275 (forward-line -1))
12717
8e153c7bbd90 (forward-paragraph): Don't move back over a line
Richard M. Stallman <rms@gnu.org>
parents: 11235
diff changeset
276 (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
277 ;; This deleted code caused a long hanging-indent line
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
278 ;; not to be filled together with the following lines.
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
279 ;; ;; Don't move back over a line before the paragraph
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
280 ;; ;; which doesn't start with fill-prefix
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
281 ;; ;; unless that is the only line we've moved over.
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
282 ;; (and (not (looking-at fill-prefix-regexp))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
283 ;; multiple-lines
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
284 ;; (forward-line 1))
12717
8e153c7bbd90 (forward-paragraph): Don't move back over a line
Richard M. Stallman <rms@gnu.org>
parents: 11235
diff changeset
285 (not (bobp)))
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
286 (while (and (re-search-backward sp-parstart nil 1)
22953
fbeacfb09096 (forward-paragraph): Fix the logic for handling beginning of buffer
Richard M. Stallman <rms@gnu.org>
parents: 19527
diff changeset
287 (setq found-start t)
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
288 ;; Found a candidate, but need to check if it is a
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
289 ;; REAL parstart.
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
290 (progn (setq start (point))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
291 (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
292 (not (looking-at parsep)))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
293 (not (and (looking-at parstart)
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
294 (or (not use-hard-newlines)
57282
a35c6f55300f (forward-paragraph): Avoid args-out-of-range error when point winds up
Luc Teirlinck <teirllm@auburn.edu>
parents: 56941
diff changeset
295 (bobp)
a35c6f55300f (forward-paragraph): Avoid args-out-of-range error when point winds up
Luc Teirlinck <teirllm@auburn.edu>
parents: 56941
diff changeset
296 (get-text-property
a35c6f55300f (forward-paragraph): Avoid args-out-of-range error when point winds up
Luc Teirlinck <teirllm@auburn.edu>
parents: 56941
diff changeset
297 (1- start) 'hard)))))
22953
fbeacfb09096 (forward-paragraph): Fix the logic for handling beginning of buffer
Richard M. Stallman <rms@gnu.org>
parents: 19527
diff changeset
298 (setq found-start nil)
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
299 (goto-char start))
22953
fbeacfb09096 (forward-paragraph): Fix the logic for handling beginning of buffer
Richard M. Stallman <rms@gnu.org>
parents: 19527
diff changeset
300 found-start)
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
301 ;; Found one.
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
302 (progn
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
303 ;; Move forward over paragraph separators.
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
304 ;; We know this cannot reach the place we started
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
305 ;; because we know we moved back over a non-separator.
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
306 (while (and (not (eobp))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
307 (progn (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
308 (looking-at parsep)))
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
309 (forward-line 1))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
310 ;; If line before paragraph is just margin, back up to there.
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
311 (end-of-line 0)
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
312 (if (> (current-column) (current-left-margin))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
313 (forward-char 1)
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
314 (skip-chars-backward " \t")
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
315 (if (not (bolp))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
316 (forward-line 1))))
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
317 ;; No starter or separator line => use buffer beg.
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
318 (goto-char (point-min))))))
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
319
5608
c4c662362d39 (forward-paragraph): If moving back we find nothing
Richard M. Stallman <rms@gnu.org>
parents: 4585
diff changeset
320 (while (and (> arg 0) (not (eobp)))
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
321 ;; Move forward over separator lines...
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
322 (while (and (not (eobp))
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
323 (progn (move-to-left-margin) (not (eobp)))
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
324 (looking-at parsep))
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
325 (forward-line 1))
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
326 (unless (eobp) (setq arg (1- arg)))
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
327 ;; ... and one more line.
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
328 (forward-line 1)
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
329 (if fill-prefix-regexp
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
330 ;; There is a fill prefix; it overrides parstart.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
331 (while (and (not (eobp))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
332 (progn (move-to-left-margin) (not (eobp)))
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
333 (not (looking-at parsep))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
334 (looking-at fill-prefix-regexp))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
335 (forward-line 1))
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
336 (while (and (re-search-forward sp-parstart nil 1)
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
337 (progn (setq start (match-beginning 0))
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
338 (goto-char start)
12804
1619fcabdb99 (forward-paragraph): Don't overlook a paragraph-start
Richard M. Stallman <rms@gnu.org>
parents: 12717
diff changeset
339 (not (eobp)))
1619fcabdb99 (forward-paragraph): Don't overlook a paragraph-start
Richard M. Stallman <rms@gnu.org>
parents: 12717
diff changeset
340 (progn (move-to-left-margin)
40485
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
341 (not (looking-at parsep)))
ca833879aa7b (sentence-end-double-space, sentence-end-without-period): Move from fill.el.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40483
diff changeset
342 (or (not (looking-at parstart))
10864
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
343 (and use-hard-newlines
33769cbeb58e (paragraph-start, paragraph-separate): Default values no longer start
Boris Goldowsky <boris@gnu.org>
parents: 10464
diff changeset
344 (not (get-text-property (1- start) 'hard)))))
10424
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
345 (forward-char 1))
6bcb93cec6f8 (forward-paragraph): Notice use-hard-newlines value.
Richard M. Stallman <rms@gnu.org>
parents: 9169
diff changeset
346 (if (< (point) (point-max))
47829
353dae5e0134 (forward-paragraph): Keep track of remaining paragraphs to skip more carefully.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 47750
diff changeset
347 (goto-char start))))
47750
75f4a9fc7b34 (forward-paragraph): Return the steps left.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 43384
diff changeset
348 (constrain-to-field nil opoint t)
75f4a9fc7b34 (forward-paragraph): Return the steps left.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 43384
diff changeset
349 ;; Return the number of steps that could not be done.
75f4a9fc7b34 (forward-paragraph): Return the steps left.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 43384
diff changeset
350 arg))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
351
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
352 (defun backward-paragraph (&optional arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
353 "Move backward to start of paragraph.
16757
e1c2e9a44236 (forward-paragraph, backward-paragraph): Doc fixes.
Richard M. Stallman <rms@gnu.org>
parents: 16687
diff changeset
354 With argument ARG, do it ARG times;
e1c2e9a44236 (forward-paragraph, backward-paragraph): Doc fixes.
Richard M. Stallman <rms@gnu.org>
parents: 16687
diff changeset
355 a negative argument ARG = -N means move forward N paragraphs.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
356
237
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
357 A paragraph start is the beginning of a line which is a
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
358 `first-line-of-paragraph' or which is ordinary text and follows a
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
359 paragraph-separating line; except: if the first real line of a
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
360 paragraph is preceded by a blank line, the paragraph starts at that
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
361 blank line.
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
362
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
363 See `forward-paragraph' for more information."
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
364 (interactive "p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
365 (or arg (setq arg 1))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
366 (forward-paragraph (- arg)))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
367
59179
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
368 (defun mark-paragraph (&optional arg allow-extend)
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
369 "Put point at beginning of this paragraph, mark at end.
41709
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
370 The paragraph marked is the one that contains point or follows point.
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
371
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
372 With argument ARG, puts mark at end of a following paragraph, so that
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
373 the number of paragraphs marked equals ARG.
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
374
df0a6a02b580 (mark-paragraph): Clarify doc. Clarify
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 40485
diff changeset
375 If ARG is negative, point is put at end of this paragraph, mark is put
43301
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
376 at beginning of this or a previous paragraph.
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
377
59179
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
378 Interactively, if this command is repeated
64751
5b1a238fcbb4 Update years in copyright notice; nfc.
Thien-Thi Nguyen <ttn@gnuvola.org>
parents: 64084
diff changeset
379 or (in Transient Mark mode) if the mark is active,
59179
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
380 it marks the next ARG paragraphs after the ones already marked."
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
381 (interactive "p\np")
43384
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
382 (unless arg (setq arg 1))
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
383 (when (zerop arg)
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
384 (error "Cannot mark zero paragraphs"))
59179
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
385 (cond ((and allow-extend
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
386 (or (and (eq last-command this-command) (mark t))
4b5e5c2f1ee0 (mark-paragraph): New arg ALLOW-EXTEND
Richard M. Stallman <rms@gnu.org>
parents: 58919
diff changeset
387 (and transient-mark-mode mark-active)))
43384
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
388 (set-mark
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
389 (save-excursion
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
390 (goto-char (mark))
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
391 (forward-paragraph arg)
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
392 (point))))
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
393 (t
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
394 (forward-paragraph arg)
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
395 (push-mark nil t t)
cc3ba2d0d471 * emacs-lisp/lisp.el (mark-defun): Don't leave multiple marks
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 43301
diff changeset
396 (backward-paragraph arg))))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
397
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
398 (defun kill-paragraph (arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
399 "Kill forward to end of paragraph.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
400 With arg N, kill forward to Nth end of paragraph;
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
401 negative arg -N means kill backward to Nth start of paragraph."
27837
46fedf13d52e (kill-paragraph, backward-kill-paragraph)
Dave Love <fx@gnu.org>
parents: 26055
diff changeset
402 (interactive "p")
7064
19a84bb30e9e (kill-paragraph): Don't use save-excursion.
Richard M. Stallman <rms@gnu.org>
parents: 5653
diff changeset
403 (kill-region (point) (progn (forward-paragraph arg) (point))))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
404
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
405 (defun backward-kill-paragraph (arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
406 "Kill back to start of paragraph.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
407 With arg N, kill back to Nth start of paragraph;
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
408 negative arg -N means kill forward to Nth end of paragraph."
27837
46fedf13d52e (kill-paragraph, backward-kill-paragraph)
Dave Love <fx@gnu.org>
parents: 26055
diff changeset
409 (interactive "p")
26055
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
410 (kill-region (point) (progn (backward-paragraph arg) (point))))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
411
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
412 (defun transpose-paragraphs (arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
413 "Interchange this (or next) paragraph with previous one."
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
414 (interactive "*p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
415 (transpose-subr 'forward-paragraph arg))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
416
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
417 (defun start-of-paragraph-text ()
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
418 (let ((opoint (point)) npoint)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
419 (forward-paragraph -1)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
420 (setq npoint (point))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
421 (skip-chars-forward " \t\n")
68
7680293d57f3 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 36
diff changeset
422 ;; If the range of blank lines found spans the original start point,
7680293d57f3 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 36
diff changeset
423 ;; try again from the beginning of it.
7680293d57f3 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 36
diff changeset
424 ;; Must be careful to avoid infinite loop
7680293d57f3 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 36
diff changeset
425 ;; when following a single return at start of buffer.
7680293d57f3 *** empty log message ***
Richard M. Stallman <rms@gnu.org>
parents: 36
diff changeset
426 (if (and (>= (point) opoint) (< npoint opoint))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
427 (progn
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
428 (goto-char npoint)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
429 (if (> npoint (point-min))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
430 (start-of-paragraph-text))))))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
431
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
432 (defun end-of-paragraph-text ()
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
433 (let ((opoint (point)))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
434 (forward-paragraph 1)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
435 (if (eq (preceding-char) ?\n) (forward-char -1))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
436 (if (<= (point) opoint)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
437 (progn
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
438 (forward-char 1)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
439 (if (< (point) (point-max))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
440 (end-of-paragraph-text))))))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
441
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
442 (defun forward-sentence (&optional arg)
2503
fb3509fdf8b7 Sat Apr 10 00:39:29 1993 Jim Blandy (jimb@totoro.cs.oberlin.edu)
Jim Blandy <jimb@redhat.com>
parents: 2308
diff changeset
443 "Move forward to next `sentence-end'. With argument, repeat.
237
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
444 With negative argument, move backward repeatedly to `sentence-beginning'.
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
445
237
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
446 The variable `sentence-end' is a regular expression that matches ends of
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
447 sentences. Also, every paragraph boundary terminates sentences as well."
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
448 (interactive "p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
449 (or arg (setq arg 1))
54977
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
450 (let ((opoint (point))
4c4f4e6f6bbf (sentence-end) <function>: New fun with default value taken
Juri Linkov <juri@jurta.org>
parents: 54014
diff changeset
451 (sentence-end (sentence-end)))
26055
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
452 (while (< arg 0)
38715
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
453 (let ((pos (point))
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
454 (par-beg (save-excursion (start-of-paragraph-text) (point))))
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
455 (if (and (re-search-backward sentence-end par-beg t)
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
456 (or (< (match-end 0) pos)
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
457 (re-search-backward sentence-end par-beg t)))
06ad87abb7a4 (forward-sentence): Avoid building
Gerd Moellmann <gerd@gnu.org>
parents: 38412
diff changeset
458 (goto-char (match-end 0))
26055
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
459 (goto-char par-beg)))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
460 (setq arg (1+ arg)))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
461 (while (> arg 0)
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
462 (let ((par-end (save-excursion (end-of-paragraph-text) (point))))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
463 (if (re-search-forward sentence-end par-end t)
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
464 (skip-chars-backward " \t\n")
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
465 (goto-char par-end)))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
466 (setq arg (1- arg)))
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
467 (constrain-to-field nil opoint t)))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
468
51159
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
469 (defun repunctuate-sentences ()
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
470 "Put two spaces at the end of sentences from point to the end of buffer.
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
471 It works using `query-replace-regexp'."
54014
6296b1d1ae51 * net/telnet.el (telnet-interrupt-subjob): Move doc string to the correct place.
Eli Zaretskii <eliz@is.elta.co.il>
parents: 53721
diff changeset
472 (interactive)
51159
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
473 (query-replace-regexp "\\([]\"')]?\\)\\([.?!]\\)\\([]\"')]?\\) +"
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
474 "\\1\\2\\3 "))
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
475
7d324048f346 (repunctuate-sentences): New function.
Richard M. Stallman <rms@gnu.org>
parents: 49949
diff changeset
476
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
477 (defun backward-sentence (&optional arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
478 "Move backward to start of sentence. With arg, do it arg times.
237
75cec14894db *** empty log message ***
Brian Preble <rassilon@gnu.org>
parents: 68
diff changeset
479 See `forward-sentence' for more information."
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
480 (interactive "p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
481 (or arg (setq arg 1))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
482 (forward-sentence (- arg)))
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
483
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
484 (defun kill-sentence (&optional arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
485 "Kill from point to end of sentence.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
486 With arg, repeat; negative arg -N means kill back to Nth start of sentence."
27837
46fedf13d52e (kill-paragraph, backward-kill-paragraph)
Dave Love <fx@gnu.org>
parents: 26055
diff changeset
487 (interactive "p")
7064
19a84bb30e9e (kill-paragraph): Don't use save-excursion.
Richard M. Stallman <rms@gnu.org>
parents: 5653
diff changeset
488 (kill-region (point) (progn (forward-sentence arg) (point))))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
489
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
490 (defun backward-kill-sentence (&optional arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
491 "Kill back from point to start of sentence.
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
492 With arg, repeat, or kill forward to Nth end of sentence if negative arg -N."
27837
46fedf13d52e (kill-paragraph, backward-kill-paragraph)
Dave Love <fx@gnu.org>
parents: 26055
diff changeset
493 (interactive "p")
26055
cf5dd9e8bf79 (forward-sentence, forward-paragraph):
Gerd Moellmann <gerd@gnu.org>
parents: 25551
diff changeset
494 (kill-region (point) (progn (backward-sentence arg) (point))))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
495
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
496 (defun mark-end-of-sentence (arg)
43301
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
497 "Put mark at end of sentence. Arg works as in `forward-sentence'.
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
498 If this command is repeated, it marks the next ARG sentences after the
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
499 ones already marked."
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
500 (interactive "p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
501 (push-mark
43301
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
502 (save-excursion
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
503 (if (and (eq last-command this-command) (mark t))
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
504 (goto-char (mark)))
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
505 (forward-sentence arg)
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
506 (point))
898b4b31410f * lisp/simple.el (mark-word): Mark more if repeated.
Kai Großjohann <kgrossjo@eu.uu.net>
parents: 41709
diff changeset
507 nil t))
36
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
508
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
509 (defun transpose-sentences (arg)
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
510 "Interchange this (next) and previous sentence."
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
511 (interactive "*p")
9697c13298e5 Initial revision
Joseph Arceneaux <jla@gnu.org>
parents:
diff changeset
512 (transpose-subr 'forward-sentence arg))
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 269
diff changeset
513
66422
ee446efaafaf (sentence-end-base): Use real chars, so as
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66292
diff changeset
514 ;; Local Variables:
ee446efaafaf (sentence-end-base): Use real chars, so as
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66292
diff changeset
515 ;; coding: iso-2022-7bit
ee446efaafaf (sentence-end-base): Use real chars, so as
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66292
diff changeset
516 ;; End:
49949
098ddf9714e8 (sentence-end): Add Chinese and Japanese characters.
Kenichi Handa <handa@m17n.org>
parents: 49599
diff changeset
517
66422
ee446efaafaf (sentence-end-base): Use real chars, so as
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 66292
diff changeset
518 ;; arch-tag: e727eb1a-527a-4464-b9d7-9d3ec0d1a575
659
505130d1ddf8 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 269
diff changeset
519 ;;; paragraphs.el ends here