* lisp/textmodes/page-ext.el: Improve Commentary.

This commit is contained in:
Stefan Kangas 2022-09-16 12:14:33 +02:00
parent 5543aea1b2
commit 520b041b54

View file

@ -1,7 +1,6 @@
;;; page-ext.el --- extended page handling commands -*- lexical-binding:t -*- ;;; page-ext.el --- extended page handling commands -*- lexical-binding:t -*-
;; Copyright (C) 1990-1991, 1993-1994, 2001-2022 Free Software ;; Copyright (C) 1990-2022 Free Software Foundation, Inc.
;; Foundation, Inc.
;; Author: Robert J. Chassell <bob@gnu.org> ;; Author: Robert J. Chassell <bob@gnu.org>
;; (according to ack.texi) ;; (according to ack.texi)
@ -32,13 +31,13 @@
;; The current page commands are: ;; The current page commands are:
;; forward-page C-x ] ;; `forward-page' C-x ]
;; backward-page C-x [ ;; `backward-page' C-x [
;; narrow-to-page C-x p ;; `narrow-to-page' C-x p
;; count-lines-page C-x l ;; `count-lines-page' C-x l
;; mark-page C-x C-p (change this to C-x C-p C-m) ;; `mark-page' C-x C-p (change this to C-x C-p C-m)
;; sort-pages not bound ;; `sort-pages' not bound
;; what-page not bound ;; `what-page' not bound
;; The new page handling commands all use `C-x C-p' as a prefix. This ;; The new page handling commands all use `C-x C-p' as a prefix. This
;; means that the key binding for `mark-page' must be changed. ;; means that the key binding for `mark-page' must be changed.
@ -47,15 +46,15 @@
;; New page handling commands: ;; New page handling commands:
;; pages-next-page C-x C-p C-n ;; `pages-next-page' C-x C-p C-n
;; pages-previous-page C-x C-p C-p ;; `pages-previous-page' C-x C-p C-p
;; pages-search C-x C-p C-s ;; `pages-search' C-x C-p C-s
;; pages-add-new-page C-x C-p C-a ;; `pages-add-new-page' C-x C-p C-a
;; pages-sort-buffer C-x C-p s ;; `pages-sort-buffer' C-x C-p s
;; pages-set-delimiter C-x C-p C-l ;; `pages-set-delimiter' C-x C-p C-l
;; pages-directory C-x C-p C-d ;; `pages-directory' C-x C-p C-d
;; pages-directory-for-addresses C-x C-p d ;; `pages-directory-for-addresses' C-x C-p d
;; pages-directory-goto C-c C-c ;; `pages-directory-goto' C-c C-c
;;; Using the page commands ;;; Using the page commands
@ -103,8 +102,8 @@
;; ;;
;; 2. The first line of text in each entry is the `heading line'; it ;; 2. The first line of text in each entry is the `heading line'; it
;; will appear in the pages-directory-buffer which is constructed ;; will appear in the pages-directory-buffer which is constructed
;; using the `C-x C-p C-d' (pages-directory) command or the `C-x ;; using the `C-x C-p C-d' (`pages-directory') command or the
;; C-p d' (pages-directory-for-addresses) command. ;; `C-x C-p d' (`pages-directory-for-addresses') command.
;; ;;
;; The heading line may be on the same line as the page-delimiter ;; The heading line may be on the same line as the page-delimiter
;; or it may follow after. It is the first non-blank line on the ;; or it may follow after. It is the first non-blank line on the
@ -163,17 +162,18 @@
;; `pages-previous-page', `pages-add-new-page', `mark-page', and `pages-search' ;; `pages-previous-page', `pages-add-new-page', `mark-page', and `pages-search'
;; commands. ;; commands.
;; You may use either the `C-x C-p d' (pages-directory-for-addresses) ;; You may use either the `C-x C-p d' (`pages-directory-for-addresses')
;; or the `C-x C-p C-d' (pages-directory) command to construct and ;; or the `C-x C-p C-d' (`pages-directory') command to construct and
;; display a directory of all the heading lines. ;; display a directory of all the heading lines.
;; In the directory, you may position the cursor over a heading line ;; In the directory, you may position the cursor over a heading line
;; and type `C-c C-c' (pages-directory-goto) to go to the entry to ;; and type `C-c C-c' (`pages-directory-goto') to go to the entry to
;; which it refers in the pages buffer. ;; which it refers in the pages buffer.
;; You can type `C-c C-p C-a' (pages-add-new-page) to add a new entry in the ;; You can type `C-c C-p C-a' (`pages-add-new-page') to add a new
;; pages buffer or address file. This is the same command you use to ;; entry in the pages buffer or address file. This is the same
;; add a new entry when you are in the pages buffer or address file. ;; command you use to add a new entry when you are in the pages buffer
;; or address file.
;; If you wish, you may create several different directories, ;; If you wish, you may create several different directories,
;; one for each different buffer. ;; one for each different buffer.