Doc fix.

3 files changed, 18 insertions, 15 deletions

diff --git a/lisp/subr.el b/lisp/subr.el
index b866c920e2d..54db5f17420 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -410,9 +410,9 @@ and then modifies one entry in it."
 
 
 (defmacro lambda (&rest cdr)
-  "Macro which allows one to write (lambda ...) for anonymous functions
-instead of having to write (function (lambda ...)) or '(lambda ...), the
-latter of which won't get byte-compiled."
+  "Macro which allows one to write (lambda ...) for anonymous functions.
+This is instead of having to write (function (lambda ...)) or
+'(lambda ...), the latter of which won't get byte-compiled."
   (` (function (lambda (,@ cdr)))))
 
 ;;; subr.el ends here
diff --git a/lisp/superyank.el b/lisp/superyank.el
index 7c83885821c..f76e6c7c3bf 100644
--- a/lisp/superyank.el
+++ b/lisp/superyank.el
@@ -1136,11 +1136,12 @@ sy-use-only-preference-p   (default: nil)
 ;; attribution if none could be found from the paragraph.
 ;;
 (defun sy-fill-paragraph-manually (arg)
-  "Fill paragraph containing or following point, automatically finding
-the sy-cite-regexp and using it as the prefix.  If the sy-cite-regexp
-is not in the first line of the paragraph, it makes a guess at what
-the fill-prefix for the paragraph should be by looking at the first
-line and taking anything up to the first alphanumeric character.
+  "Fill paragraph containing or following point.
+This automatically finds the sy-cite-regexp and uses it as the prefix.
+If the sy-cite-regexp is not in the first line of the paragraph, it
+makes a guess at what the fill-prefix for the paragraph should be by
+looking at the first line and taking anything up to the first
+alphanumeric character.
 
 Prefix arg means justify both sides of paragraph as well.
 
@@ -1207,7 +1208,8 @@ attribution string used to cite lines."
 ;; insert the persistant attribution at point
 ;;
 (defun sy-insert-persist-attribution ()
-  "Insert the persistant attribution at the beginning of the line that
+  "Insert the persistant attribution.
+This inserts the peristant attribution at the beginning of the line that
 point is on.  This string is the last attribution confirmed and used
 in the yanked reply buffer."
   (interactive)
@@ -1222,9 +1224,9 @@ in the yanked reply buffer."
 ;; open a line putting the attribution at the beginning
 
 (defun sy-open-line (arg)
-  "Insert a newline and leave point before it.  Also inserts the
-persistant attribution at the beginning of the line.  With arg,
-inserts that many newlines."
+  "Insert a newline and leave point before it.
+Also inserts the persistant attribution at the beginning of the line.
+With argument, inserts ARG newlines."
   (interactive "p")
   (save-excursion
     (let ((start (point)))
diff --git a/lisp/term/sun-mouse.el b/lisp/term/sun-mouse.el
index a6227ea3249..0ed1c3360a8 100644
--- a/lisp/term/sun-mouse.el
+++ b/lisp/term/sun-mouse.el
@@ -642,8 +642,8 @@ CODE values: 13 = Tool-Position, 14 = Size-in-Pixels, 18 = Size-in-Chars."
 ;;;  primative functions are defined in sunfns.c
 ;;;
 (defun sun-yank-selection ()
-  "Set mark and yank the contents of the current sunwindows selection
-into the current buffer at point."
+  "Set mark and yank the contents of the current sunwindows selection.
+Insert contents into the current buffer at point."
   (interactive "*")
   (set-mark-command nil)
   (insert-string (sun-get-selection)))
@@ -658,7 +658,8 @@ into the current buffer at point."
 ;;; This closes the window instead of stopping emacs.
 ;;;
 (defun suspend-emacstool (&optional stuffstring)
-  "If running under as a detached process emacstool,
+  "Suspend emacstool.
+If running under as a detached process emacstool,
 you don't want to suspend  (there is no way to resume), 
 just close the window, and wait for reopening."
   (interactive)