Mercurial > emacs
annotate lisp/textmodes/page.el @ 110317:50478146a2e1
10-09-13
author | Robert J. Chassell <bob@gnu.org> |
---|---|
date | Mon, 13 Sep 2010 10:14:52 +0000 |
parents | 280c8ae2476d |
children | f52a8c72912b |
rev | line source |
---|---|
110317 | 1 ;; (push-mark (point) t) needed at the end of forward-page |
2 ;; The documentation in simple.el for set-mark says | |
3 ;; To remember a location for internal use in the Lisp program, | |
4 ;; store it in a Lisp variable. Example: | |
5 ;; (let ((beg (point))) (forward-line 1) (delete-region beg (point)))." | |
6 | |
7 | |
38412
253f761ad37b
Some fixes to follow coding conventions in files maintained by FSF.
Pavel Janík <Pavel@Janik.cz>
parents:
20068
diff
changeset
|
8 ;;; page.el --- page motion commands for Emacs |
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
236
diff
changeset
|
9 |
74509 | 10 ;; Copyright (C) 1985, 2001, 2002, 2003, 2004, 2005, |
106815 | 11 ;; 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. |
846
20674ae6bf52
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
807
diff
changeset
|
12 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
659
diff
changeset
|
13 ;; Maintainer: FSF |
38697
a19197c6442f
Keyword added and FSF specified as Maintainer.
Pavel Janík <Pavel@Janik.cz>
parents:
38412
diff
changeset
|
14 ;; Keywords: wp convenience |
110015
280c8ae2476d
Add "Package:" file headers to denote built-in packages.
Chong Yidong <cyd@stupidchicken.com>
parents:
106815
diff
changeset
|
15 ;; Package: emacs |
36 | 16 |
17 ;; This file is part of GNU Emacs. | |
18 | |
94670
f4a69fedbd46
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
19 ;; GNU Emacs is free software: you can redistribute it and/or modify |
36 | 20 ;; it under the terms of the GNU General Public License as published by |
94670
f4a69fedbd46
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
21 ;; the Free Software Foundation, either version 3 of the License, or |
f4a69fedbd46
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
22 ;; (at your option) any later version. |
36 | 23 |
24 ;; GNU Emacs is distributed in the hope that it will be useful, | |
25 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
26 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
27 ;; GNU General Public License for more details. | |
28 | |
29 ;; You should have received a copy of the GNU General Public License | |
94670
f4a69fedbd46
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
93975
diff
changeset
|
30 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
36 | 31 |
2308
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
1080
diff
changeset
|
32 ;;; Commentary: |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
1080
diff
changeset
|
33 |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
1080
diff
changeset
|
34 ;; This code provides the page-oriented movement and selection commands |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
1080
diff
changeset
|
35 ;; documented in the Emacs manual. |
f287613dfc28
Added or corrected Commentary sections
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
1080
diff
changeset
|
36 |
807
4f28bd14272c
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
659
diff
changeset
|
37 ;;; Code: |
36 | 38 |
39 (defun forward-page (&optional count) | |
40 "Move forward to page boundary. With arg, repeat, or go back if negative. | |
236 | 41 A page boundary is any line whose beginning matches the regexp |
42 `page-delimiter'." | |
36 | 43 (interactive "p") |
44 (or count (setq count 1)) | |
45 (while (and (> count 0) (not (eobp))) | |
1080 | 46 ;; In case the page-delimiter matches the null string, |
47 ;; don't find a match without moving. | |
48 (if (bolp) (forward-char 1)) | |
36 | 49 (if (re-search-forward page-delimiter nil t) |
50 nil | |
51 (goto-char (point-max))) | |
52 (setq count (1- count))) | |
53 (while (and (< count 0) (not (bobp))) | |
14160
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
54 ;; In case the page-delimiter matches the null string, |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
55 ;; don't find a match without moving. |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
56 (and (save-excursion (re-search-backward page-delimiter nil t)) |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
57 (= (match-end 0) (point)) |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
58 (goto-char (match-beginning 0))) |
36 | 59 (forward-char -1) |
14160
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
60 (if (re-search-backward page-delimiter nil t) |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
61 ;; We found one--move to the end of it. |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
62 (goto-char (match-end 0)) |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
63 ;; We found nothing--go to beg of buffer. |
d85151c5699d
(forward-page): Simplify how we avoid getting stuck when moving backwards.
Richard M. Stallman <rms@gnu.org>
parents:
8751
diff
changeset
|
64 (goto-char (point-min))) |
36 | 65 (setq count (1+ count)))) |
66 | |
67 (defun backward-page (&optional count) | |
68 "Move backward to page boundary. With arg, repeat, or go fwd if negative. | |
236 | 69 A page boundary is any line whose beginning matches the regexp |
70 `page-delimiter'." | |
36 | 71 (interactive "p") |
72 (or count (setq count 1)) | |
73 (forward-page (- count))) | |
74 | |
75 (defun mark-page (&optional arg) | |
76 "Put mark at end of page, point at beginning. | |
77 A numeric arg specifies to move forward or backward by that many pages, | |
78 thus marking a page other than the one point was originally in." | |
79 (interactive "P") | |
80 (setq arg (if arg (prefix-numeric-value arg) 0)) | |
81 (if (> arg 0) | |
82 (forward-page arg) | |
83 (if (< arg 0) | |
84 (forward-page (1- arg)))) | |
85 (forward-page) | |
2825
bddd28afcc26
(mark-page): Activate the mark.
Richard M. Stallman <rms@gnu.org>
parents:
2308
diff
changeset
|
86 (push-mark nil t t) |
36 | 87 (forward-page -1)) |
88 | |
89 (defun narrow-to-page (&optional arg) | |
90 "Make text outside current page invisible. | |
91 A numeric arg specifies to move forward or backward by that many pages, | |
92 thus showing a page other than the one point was originally in." | |
93 (interactive "P") | |
94 (setq arg (if arg (prefix-numeric-value arg) 0)) | |
95 (save-excursion | |
96 (widen) | |
97 (if (> arg 0) | |
98 (forward-page arg) | |
99 (if (< arg 0) | |
16525
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
100 (let ((adjust 0) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
101 (opoint (point))) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
102 ;; If we are not now at the beginning of a page, |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
103 ;; move back one extra time, to get to the start of this page. |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
104 (save-excursion |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
105 (beginning-of-line) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
106 (or (and (looking-at page-delimiter) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
107 (eq (match-end 0) opoint)) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
108 (setq adjust 1))) |
521d5794ac2b
(narrow-to-page): With negative arg, move back one extra
Richard M. Stallman <rms@gnu.org>
parents:
14169
diff
changeset
|
109 (forward-page (- arg adjust))))) |
36 | 110 ;; Find the end of the page. |
20068
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
111 (set-match-data nil) |
36 | 112 (forward-page) |
113 ;; If we stopped due to end of buffer, stay there. | |
114 ;; If we stopped after a page delimiter, put end of restriction | |
115 ;; at the beginning of that line. | |
20068
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
116 ;; Before checking the match that was found, |
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
117 ;; verify that forward-page actually set the match data. |
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
118 (if (and (match-beginning 0) |
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
119 (save-excursion |
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
120 (goto-char (match-beginning 0)) ; was (beginning-of-line) |
9c4fd611c3ec
(narrow-to-page): Check whether forward-page
Karl Heuer <kwzh@gnu.org>
parents:
16525
diff
changeset
|
121 (looking-at page-delimiter))) |
65435
f869318329b5
(narrow-to-page): Exclude _entire_ multi-line delimiter from the region
Eli Zaretskii <eliz@gnu.org>
parents:
64751
diff
changeset
|
122 (goto-char (match-beginning 0))) ; was (beginning-of-line) |
36 | 123 (narrow-to-region (point) |
124 (progn | |
125 ;; Find the top of the page. | |
126 (forward-page -1) | |
127 ;; If we found beginning of buffer, stay there. | |
128 ;; If extra text follows page delimiter on same line, | |
129 ;; include it. | |
130 ;; Otherwise, show text starting with following line. | |
131 (if (and (eolp) (not (bobp))) | |
132 (forward-line 1)) | |
133 (point))))) | |
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
236
diff
changeset
|
134 (put 'narrow-to-page 'disabled t) |
36 | 135 |
136 (defun count-lines-page () | |
137 "Report number of lines on current page, and how many are before or after point." | |
138 (interactive) | |
139 (save-excursion | |
140 (let ((opoint (point)) beg end | |
141 total before after) | |
142 (forward-page) | |
143 (beginning-of-line) | |
144 (or (looking-at page-delimiter) | |
145 (end-of-line)) | |
146 (setq end (point)) | |
147 (backward-page) | |
148 (setq beg (point)) | |
149 (setq total (count-lines beg end) | |
150 before (count-lines beg opoint) | |
151 after (count-lines opoint end)) | |
152 (message "Page has %d lines (%d + %d)" total before after)))) | |
153 | |
154 (defun what-page () | |
155 "Print page and line number of point." | |
156 (interactive) | |
157 (save-restriction | |
158 (widen) | |
159 (save-excursion | |
160 (let ((count 1) | |
161 (opoint (point))) | |
105018
589ca5b7f8cc
(what-page): Don't move to beginning of line.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
100908
diff
changeset
|
162 (goto-char (point-min)) |
36 | 163 (while (re-search-forward page-delimiter opoint t) |
105045
92f324954126
(what-page): Make sure we don't inf-loop if
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
105018
diff
changeset
|
164 (if (= (match-beginning 0) (match-end 0)) |
92f324954126
(what-page): Make sure we don't inf-loop if
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
105018
diff
changeset
|
165 (forward-char 1)) |
36 | 166 (setq count (1+ count))) |
167 (message "Page %d, line %d" | |
168 count | |
169 (1+ (count-lines (point) opoint))))))) | |
5022 | 170 |
171 ;;; Place `provide' at end of file. | |
172 (provide 'page) | |
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
236
diff
changeset
|
173 |
93975
1e3a407766b9
Fix up comment convention on the arch-tag lines.
Stefan Monnier <monnier@iro.umontreal.ca>
parents:
79719
diff
changeset
|
174 ;; arch-tag: e8d7a0bd-8655-4b6e-b852-f2ee25316a1d |
659
505130d1ddf8
*** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents:
236
diff
changeset
|
175 ;;; page.el ends here |