[ELPA-diffs] /srv/bzr/emacs/elpa r192: Commentary fix for quarter-plane.el.

[Chong Yidong]

------------------------------------------------------------
revno: 192
committer: Chong Yidong <address@hidden>
branch nick: elpa
timestamp: Sat 2012-03-24 21:59:25 +0800
message:
  Commentary fix for quarter-plane.el.
modified:
  packages/csv-mode/csv-mode.el
  packages/djvu/djvu.el
  packages/quarter-plane/quarter-plane.el

=== modified file 'packages/csv-mode/csv-mode.el'
--- a/packages/csv-mode/csv-mode.el     2012-03-24 13:49:17 +0000
+++ b/packages/csv-mode/csv-mode.el     2012-03-24 13:59:25 +0000
@@ -1,4 +1,4 @@
-;;; csv-mode.el --- major mode for editing comma/char separated values
+;;; csv-mode.el --- Major mode for editing comma/char separated values
 
 ;; Copyright (C) 2003, 2004, 2012  Free Software Foundation, Inc
 

=== modified file 'packages/djvu/djvu.el'
--- a/packages/djvu/djvu.el     2011-11-01 06:58:45 +0000
+++ b/packages/djvu/djvu.el     2012-03-24 13:59:25 +0000
@@ -1,4 +1,4 @@
-;;; djvu.el --- edit and view Djvu files via djvused
+;;; djvu.el --- Edit and view Djvu files via djvused
 
 ;; Copyright (C) 2011  Free Software Foundation, Inc.
 
@@ -21,82 +21,79 @@
 
 ;;; Commentary:
 
-;; djvu.el is a front end for the command-line program djvused
-;; from DjVuLibre, see http://djvu.sourceforge.net/
-;;
-;; This code requires you have the programs djvused, djview, and ddjvu
-;; installed.
+;; This package is a front end for the command-line program djvused
+;; from DjVuLibre, see http://djvu.sourceforge.net/.  It assumes you
+;; have the programs djvused, djview, and ddjvu installed.
 ;;
 ;; A normal work flow is as follows:
 ;;
-;; To visit a djvu file use `fjvu-find-file'. This command is the
-;; only entry point to this package. You may want to bind this command
-;; to a key you like. I use
+;; To visit a djvu file type M-x fjvu-find-file.  This command is the
+;; only entry point to this package.  You may want to bind this
+;; command to a key you like.  I use
 ;;
 ;;   (global-set-key "\C-cd" 'djvu-find-file)
 ;;
-;; If you use this command to visit file foo.djvu, it puts you into the
-;; (not editable) buffer address@hidden Normally, this buffer is all you
+;; If you use this command to visit file foo.djvu, it puts you into
+;; the (read-only) buffer address@hidden  Normally, this buffer is all you
 ;; need.
 ;;
 ;; The menu bar of this buffer lists most of the commands with their
-;; repsective key bindings. For example, you can:
+;; repsective key bindings.  For example, you can:
 ;;
 ;; - Use `g' to go to the page you want. (Yes, this package operates on
 ;;   one page at a time. I guess that anything else would be too slow
 ;;   for large documents.)
 ;;
 ;; - Use `v' to (re)start djview using the position in foo.djvu
-;;   matching where point is in address@hidden (I find djview fast enough
+;;   matching where point is in address@hidden  (I find djview fast enough
 ;;   for this, even for larger documents.)
 ;;
-;; - To highlight a region in foo.djvu mark the corresponding region in
-;;   address@hidden (as usual, `transient-mark-mode' comes handy for this).
-;;   Then type `h' and add a comment in the minibuffer if you like.
-;;   Type C-x C-s to save this editing. Then type `v' to (re)start
-;;   djview to show what you have done.
+;; - To highlight a region in foo.djvu mark the corresponding region
+;;   in address@hidden (as usual, `transient-mark-mode' comes handy for
+;;   this).  Then type `h' and add a comment in the minibuffer if you
+;;   like.  Type C-x C-s to save this editing.  Then type `v' to
+;;   (re)start djview to show what you have done.
 ;;
 ;; - Type i to enable `djvu-image-mode', a minor mode displaying the
-;;   current page as an image. Then
+;;   current page as an image.  Then
 ;;     drag-mouse-1 defines a region where to put a comment,
 ;;     C-drag-mouse-1 defines a region where to put a pushpin comment,
 ;;     S-drag-mouse-1 defines a region to highlight
 ;;
 ;; - The editing of the text, annotation and outline (bookmark) layers
 ;;   really happens in the buffers address@hidden, address@hidden, and
-;;   address@hidden (The djvused syntax used in these buffers is so
+;;   address@hidden  (The djvused syntax used in these buffers is so
 ;;   close to elisp that it was natural to give these buffers a
 ;;   djvu-edit-mode that is derived from emacs-lisp-mode.)
 ;;
-;;   You can check what is happening by switching to these buffers. The
-;;   respective switching commands put point in these buffers such that
-;;   it matches where you were in address@hidden
+;;   You can check what is happening by switching to these buffers.
+;;   The respective switching commands put point in these buffers such
+;;   that it matches where you were in address@hidden
 ;;
 ;;   In these buffers, the menu bar lists a few low-level commands
-;;   available for editing these buffers directly. If you know the
+;;   available for editing these buffers directly.  If you know the
 ;;   djvused syntax, sometimes it can also be helpful to do such
 ;;   editing "by hand".
 ;;
-;; But wait: The syntax in the annotations buffer address@hidden is a
-;; slightly modified djvused syntax. djvused can only highlight
-;; rectangles. So the highlighting of larger regions of text must
-;; use multiple rectangles (i.e., multiple djvused "mapareas").
-;; To make editing easier, these are combined in the buffer address@hidden
+;; But wait: the syntax in the annotations buffer address@hidden is a
+;; slightly modified djvused syntax.  djvused can only highlight
+;; rectangles.  So the highlighting of larger regions of text must use
+;; multiple rectangles (i.e., multiple djvused "mapareas").  To make
+;; editing easier, these are combined in the buffer address@hidden
 ;; (Before saving these things, they are converted using the proper
 ;; djvused syntax.)
 ;;
-;; When you visit a djvu file, djvu-mode recognizes mapareas
-;; belonging together by checking that "everything else in these
-;; mapareas except for the rects" is the same. So if you entered a
-;; (unique) comment, this allows djvu-mode to combine all the
-;; mapareas when you visit such a file the second time. Without a
-;; comment, this fails!
+;; When you visit a djvu file, djvu-mode recognizes mapareas belonging
+;; together by checking that "everything else in these mapareas except
+;; for the rects" is the same.  So if you entered a (unique) comment,
+;; this allows djvu-mode to combine all the mapareas when you visit
+;; such a file the second time.  Without a comment, this fails!
 ;;
 ;; A second difference between what is displayed in the djvu buffers
-;; and the input/output of djvused refers to nonascii characters.
-;; I am using djvused from DjVuLibre-3.5.22 which handles utf-8 by
-;; backslash sequences. So djvu mode converts these backslash
-;; sequences into the corresponding utf-8 characters. (More recent
+;; and the input/output of djvused refers to nonascii characters.  I
+;; am using djvused from DjVuLibre-3.5.22 which handles utf-8 by
+;; backslash sequences.  So djvu mode converts these backslash
+;; sequences into the corresponding utf-8 characters.  (More recent
 ;; versions of djvused can do this conversion, too.)
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

=== modified file 'packages/quarter-plane/quarter-plane.el'
--- a/packages/quarter-plane/quarter-plane.el   2011-09-23 15:20:45 +0000
+++ b/packages/quarter-plane/quarter-plane.el   2012-03-24 13:59:25 +0000
@@ -1,4 +1,4 @@
-;;; quarter-plane.el --- editing using quarter-plane screen model
+;;; quarter-plane.el --- Minor mode for quarter-plane style editing
 
 ;; Copyright (C) 2011  Free Software Foundation, Inc.
 
@@ -21,10 +21,17 @@
 
 ;;; Commentary:
 
-;; This code provides a minor mode to enable the some of picture-mode
-;; commands documented in the Emacs manual in order to treat the
-;; screen as a semi-infinite quarter-plane, without changing the
-;; buffer's major mode.
+;; This package provides Quarter Plane mode, a minor mode which
+;; provides Picture mode style editing (treating the screen as a
+;; semi-infinite quarter-plane).  Unlike Picture mode, it is a minor
+;; modes (see the Emacs manual for the documentation of Picture mode).
+;; Type M-x quarter-plane-mode to enable Quarter Plane mode in the
+;; current buffer, and M-x global-quarter-plane-mode to enable it
+;; globally.
+
+;; In Quarter Plane mode, the commands `right-char', `forward-char',
+;; `previous-line', `next-line', and `mouse-set-point' are rebound to
+;; Quarter Plane commands.
 
 ;; Known issues: