]> git.eshelyaron.com Git - emacs.git/commitdiff
* lisp/simple.el (cycle-spacing--context, cycle-spacing): Doc tweaks.
authorGlenn Morris <rgm@gnu.org>
Mon, 31 Mar 2014 00:35:12 +0000 (17:35 -0700)
committerGlenn Morris <rgm@gnu.org>
Mon, 31 Mar 2014 00:35:12 +0000 (17:35 -0700)
Include restoring manual line-breaks to state before 2014-03-28T16:26:15Z!mina86@mina86.com.

lisp/ChangeLog
lisp/simple.el

index 15dc7cec5a4ea89218cc333d60d01ac2a9040aeb..fe2361c689525dbde88f0d27028676ba75f4ad4b 100644 (file)
@@ -1,3 +1,7 @@
+2014-03-31  Glenn Morris  <rgm@gnu.org>
+
+       * simple.el (cycle-spacing--context, cycle-spacing): Doc tweaks.
+
 2014-03-31  Reto Zimmermann  <reto@gnu.org>
 
        Sync with upstream vhdl mode v3.35.2.
 
        * simple.el (cycle-spacing): Never delete spaces on first run by
        default, but do so in a new 'fast mode and if there are already
-       N spaces (the previous behaviour).
+       N spaces (the previous behavior).
        Compare N with its value in previous invocation so that changing
        prefix argument restarts `cycle-spacing' sequence.
        The idea is that with this change, binding M-SPC to
-       `cycle-spacing' should not introduce any changes in behaviour of
+       `cycle-spacing' should not introduce any changes in behavior of
        the binding so long as users do not type M-SPC twice in a raw with
        the same prefix argument or lack thereof.
 
index eee9c9b968907a9e2afcf25598982bbfd9216773..bc92a9ab24b9bba3b58e282a13ee504e309b5933 100644 (file)
@@ -805,33 +805,32 @@ See also `cycle-spacing'."
 
 (defvar cycle-spacing--context nil
   "Store context used in consecutive calls to `cycle-spacing' command.
-The first time this function is run, it saves N argument, the
-original point position and original spacing around the point in
-this variable.")
+The first time `cycle-spacing' runs, it saves in this variable:
+its N argument, the original point position, and the original spacing
+around point.")
 
 (defun cycle-spacing (&optional n preserve-nl-back mode)
   "Manipulate whitespace around point in a smart way.
-In interactive use, this function behaves differently in
-successive consecutive calls.
+In interactive use, this function behaves differently in successive
+consecutive calls.
 
-The first call in a sequence acts like `just-one-space'.  It
-deletes all spaces and tabs around point, leaving one space \(or
-N spaces).  N is the prefix argument.  If N is negative, it
-deletes newlines as well leaving -N spaces.  (If PRESERVE-NL-BACK
-is non-nil, it does not delete newlines before point.)
+The first call in a sequence acts like `just-one-space'.
+It deletes all spaces and tabs around point, leaving one space
+\(or N spaces).  N is the prefix argument.  If N is negative,
+it deletes newlines as well, leaving -N spaces.
+\(If PRESERVE-NL-BACK is non-nil, it does not delete newlines before point.)
 
 The second call in a sequence deletes all spaces.
 
-The third call in a sequence restores the original
-whitespace (and point).
+The third call in a sequence restores the original whitespace (and point).
 
-If MODE is 'single-shot only the first step is performed.  If
-MODE is 'fast and the first step did not result in any
-change (i.e. there was exactly (abs N) spaces around point)
-function goes to the second step immediately.
+If MODE is `single-shot', it only performs the first step in the sequence.
+If MODE is `fast' and the first step would not result in any change
+\(i.e., there are exactly (abs N) spaces around point),
+the function goes straight to the second step.
 
-Running the function with different N arguments initiates a new
-sequence each time."
+Repeatedly calling the function with different values of N starts a
+new sequence each time."
   (interactive "*p")
   (let ((orig-pos       (point))
        (skip-characters (if (and n (< n 0)) " \t\n\r" " \t"))