Annotation of 43BSD/contrib/emacs/lisp/paragraphs.el, revision 1.1

1.1     ! root        1: ;; Paragraph and sentence parsing.
        !             2: ;; Copyright (C) 1985 Richard M. Stallman.
        !             3: 
        !             4: ;; This file is part of GNU Emacs.
        !             5: 
        !             6: ;; GNU Emacs is distributed in the hope that it will be useful,
        !             7: ;; but WITHOUT ANY WARRANTY.  No author or distributor
        !             8: ;; accepts responsibility to anyone for the consequences of using it
        !             9: ;; or for whether it serves any particular purpose or works at all,
        !            10: ;; unless he says so in writing.  Refer to the GNU Emacs General Public
        !            11: ;; License for full details.
        !            12: 
        !            13: ;; Everyone is granted permission to copy, modify and redistribute
        !            14: ;; GNU Emacs, but only under the conditions described in the
        !            15: ;; GNU Emacs General Public License.   A copy of this license is
        !            16: ;; supposed to have been given to you along with GNU Emacs so you
        !            17: ;; can know your rights and responsibilities.  It should be in a
        !            18: ;; file named COPYING.  Among other things, the copyright notice
        !            19: ;; and this notice must be preserved on all copies.
        !            20: 
        !            21: 
        !            22: (defun forward-paragraph (&optional arg)
        !            23:   "Move forward to end of paragraph.  With arg, do it arg times.
        !            24: A line which  paragraph-start  matches either separates paragraphs
        !            25: \(if  paragraph-separate  matches it also) or is the first line of a paragraph.
        !            26: A paragraph end is the beginning of a line which is not part of the paragraph
        !            27: to which the end of the previous line belongs, or the end of the buffer."
        !            28:   (interactive "p")
        !            29:   (or arg (setq arg 1))
        !            30:   (let* ((fill-prefix-regexp
        !            31:          (and fill-prefix (not (equal fill-prefix ""))
        !            32:               (regexp-quote fill-prefix)))
        !            33:         (paragraph-separate
        !            34:          (if fill-prefix-regexp
        !            35:              (concat paragraph-separate "\\|^"
        !            36:                      fill-prefix-regexp "[ \t]*$")
        !            37:            paragraph-separate)))
        !            38:     (while (< arg 0)
        !            39:       (if (and (not (looking-at paragraph-separate))
        !            40:               (re-search-backward "^\n" (max (1- (point)) (point-min)) t))
        !            41:          nil
        !            42:        (forward-char -1) (beginning-of-line)
        !            43:        (while (and (not (bobp)) (looking-at paragraph-separate))
        !            44:          (forward-line -1))
        !            45:        (end-of-line)
        !            46:        ;; Saerch back for line that starts or separates paragraphs.
        !            47:        (if (if (and fill-prefix (not (equal fill-prefix "")))
        !            48:                ;; There is a fill prefix; it overrides paragraph-start.
        !            49:                (progn
        !            50:                 (while (progn (beginning-of-line)
        !            51:                               (and (not (bobp))
        !            52:                                    (not (looking-at paragraph-separate))
        !            53:                                    (looking-at fill-prefix-regexp)))
        !            54:                   (forward-line -1))
        !            55:                 (not (bobp)))
        !            56:              (re-search-backward paragraph-start nil t))
        !            57:            ;; Found one.
        !            58:            (progn
        !            59:              (while (looking-at paragraph-separate)
        !            60:                (forward-line 1))
        !            61:              (if (eq (char-after (- (point) 2)) ?\n)
        !            62:                  (forward-line -1)))
        !            63:          ;; No starter or separator line => use buffer beg.
        !            64:          (goto-char (point-min))))
        !            65:       (setq arg (1+ arg)))
        !            66:     (while (> arg 0)
        !            67:       (beginning-of-line)
        !            68:       (while (prog1 (and (not (eobp))
        !            69:                         (looking-at paragraph-separate))
        !            70:                    (forward-line 1)))
        !            71:       (if (and fill-prefix (not (equal fill-prefix "")))
        !            72:          ;; There is a fill prefix; it overrides paragraph-start.
        !            73:          (while (and (not (eobp))
        !            74:                      (not (looking-at paragraph-separate))
        !            75:                      (looking-at fill-prefix-regexp))
        !            76:            (forward-line 1))
        !            77:        (if (re-search-forward paragraph-start nil t)
        !            78:            (goto-char (match-beginning 0))
        !            79:          (goto-char (point-max))))
        !            80:       (setq arg (1- arg)))))
        !            81: 
        !            82: (defun backward-paragraph (&optional arg)
        !            83:   "Move backward to start of paragraph.  With arg, do it arg times.
        !            84: A paragraph start is the beginning of a line which is a first-line-of-paragraph
        !            85: or which is ordinary text and follows a paragraph-separating line; except:
        !            86: if the first real line of a paragraph is preceded by a blank line,
        !            87: the paragraph starts at that blank line.
        !            88: See forward-paragraph for more information."
        !            89:   (interactive "p")
        !            90:   (or arg (setq arg 1))
        !            91:   (forward-paragraph (- arg)))
        !            92: 
        !            93: (defun mark-paragraph ()
        !            94:   "Put point at beginning of this paragraph, mark at end."
        !            95:   (interactive)
        !            96:   (forward-paragraph 1)
        !            97:   (set-mark (point))
        !            98:   (backward-paragraph 1))
        !            99: 
        !           100: (defun kill-paragraph (arg)
        !           101:   "Kill to end of paragraph."
        !           102:   (interactive "p")
        !           103:   (kill-region (point) (progn (forward-paragraph arg) (point))))
        !           104: 
        !           105: (defun backward-kill-paragraph (arg)
        !           106:   "Kill back to start of paragraph."
        !           107:   (interactive "p")
        !           108:   (kill-region (point) (progn (backward-paragraph arg) (point))))
        !           109: 
        !           110: (defun transpose-paragraphs (arg)
        !           111:   "Interchange this (or next) paragraph with previous one."
        !           112:   (interactive "p")
        !           113:   (transpose-subr 'forward-paragraph arg))
        !           114: 
        !           115: (defun start-of-paragraph-text ()
        !           116:   (let ((opoint (point)) npoint)
        !           117:     (forward-paragraph -1)
        !           118:     (setq npoint (point))
        !           119:     (skip-chars-forward " \t\n")
        !           120:     (if (>= (point) opoint)
        !           121:        (progn
        !           122:          (goto-char npoint)
        !           123:          (if (> npoint (point-min))
        !           124:              (start-of-paragraph-text))))))
        !           125: 
        !           126: (defun end-of-paragraph-text ()
        !           127:   (let ((opoint (point)))
        !           128:     (forward-paragraph 1)
        !           129:     (if (eq (preceding-char) ?\n) (forward-char -1))
        !           130:     (if (<= (point) opoint)
        !           131:        (progn
        !           132:          (forward-char 1)
        !           133:          (if (< (point) (point-max))
        !           134:              (end-of-paragraph-text))))))
        !           135: 
        !           136: (defun forward-sentence (&optional arg)
        !           137:   "Move forward to next sentence-end.  With argument, repeat.
        !           138: With negative argument, move backward repeatedly to sentence-beginning.
        !           139: Sentence ends are identified by the value of sentence-end
        !           140: treated as a regular expression.  Also, every paragraph boundary
        !           141: terminates sentences as well."
        !           142:   (interactive "p")
        !           143:   (or arg (setq arg 1))
        !           144:   (while (< arg 0)
        !           145:     (let ((par-beg (save-excursion (start-of-paragraph-text) (point))))
        !           146:       (if (re-search-backward (concat sentence-end "[^ \t\n]") par-beg t)
        !           147:          (goto-char (1- (match-end 0)))
        !           148:        (goto-char par-beg)))
        !           149:     (setq arg (1+ arg)))
        !           150:   (while (> arg 0)
        !           151:     (let ((par-end (save-excursion (end-of-paragraph-text) (point))))
        !           152:       (if (re-search-forward sentence-end par-end t)
        !           153:          (skip-chars-backward " \t\n")
        !           154:        (goto-char par-end)))
        !           155:     (setq arg (1- arg))))
        !           156: 
        !           157: (defun backward-sentence (&optional arg)
        !           158:   "Move backward to start of sentence.  With arg, do it arg times.
        !           159: See forward-sentence for more information."
        !           160:   (interactive "p")
        !           161:   (or arg (setq arg 1))
        !           162:   (forward-sentence (- arg)))
        !           163: 
        !           164: (defun kill-sentence (&optional arg)
        !           165:   "Kill from point to end of sentence.
        !           166: With arg, repeat, or backward if negative arg."
        !           167:   (interactive "p")
        !           168:   (let ((beg (point)))
        !           169:     (forward-sentence arg)
        !           170:     (kill-region beg (point))))
        !           171: 
        !           172: (defun backward-kill-sentence (&optional arg)
        !           173:   "Kill back from point to start of sentence.
        !           174: With arg, repeat, or forward if negative arg."
        !           175:   (interactive "p")
        !           176:   (let ((beg (point)))
        !           177:     (backward-sentence arg)
        !           178:     (kill-region beg (point))))
        !           179: 
        !           180: (defun mark-end-of-sentence (arg)
        !           181:   "Put mark at end of sentence.  Arg works as in forward-sentence."
        !           182:   (interactive "p")
        !           183:   (push-mark
        !           184:     (save-excursion
        !           185:       (forward-sentence arg)
        !           186:       (point))))
        !           187: 
        !           188: (defun transpose-sentences (arg)
        !           189:   "Interchange this (next) and previous sentence."
        !           190:   (interactive "p")
        !           191:   (transpose-subr 'forward-sentence arg))

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.