changeset 5707:5fd1b9a95531

Improve description of `mark-defun'.
author Stephen J. Turnbull <stephen@xemacs.org>
date Fri, 28 Dec 2012 23:11:32 +0900
parents 44b0b4ea5cae
children 8ca881999349
files man/ChangeLog man/xemacs/programs.texi
diffstat 2 files changed, 15 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/man/ChangeLog	Fri Dec 28 17:23:25 2012 +0900
+++ b/man/ChangeLog	Fri Dec 28 23:11:32 2012 +0900
@@ -1,3 +1,8 @@
+2012-12-28  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* xemacs/programs.texi (Defuns): Improve description of `mark-defun'.
+	Thanks to Steven Mitchell for the suggestion.
+
 2012-12-28  Byrel Mitchell  <byrel.mitchell@gmail.com>
 
 	* lispref/menus.texi (Menu Format):
--- a/man/xemacs/programs.texi	Fri Dec 28 17:23:25 2012 +0900
+++ b/man/xemacs/programs.texi	Fri Dec 28 23:11:32 2012 +0900
@@ -297,13 +297,18 @@
   The commands to move to the beginning and end of the current defun are
 @kbd{C-M-a} (@code{beginning-of-defun}) and @kbd{C-M-e} (@code{end-of-defun}).
 
-   To operate on the current defun, use @kbd{C-M-h} (@code{mark-defun})
+  To operate on the current defun, use @kbd{C-M-h} (@code{mark-defun})
 which puts point at the beginning and the mark at the end of the current
 or next defun.  This is the easiest way to prepare for moving the defun
-to a different place.  In C mode, @kbd{C-M-h} runs the function
-@code{mark-c-function}, which is almost the same as @code{mark-defun},
-but which backs up over the argument declarations, function name, and
-returned data type so that the entire C function is inside the region.
+to a different place.  In Lisp modes, a ``defun'' is merely any sexp
+starting in column 1.  In other modes, a defun is a syntactic unit
+defining an entity, and these modes often bind @kbd{C-M-h} to a
+different function.  For example, in CC Mode's C mode, @kbd{C-M-h} runs
+the function @code{c-mark-function}, which is almost the same as
+@code{mark-defun}, but which backs up over the argument declarations,
+function name, and returned data type so that the entire C function is
+inside the region.  It also knows about struct definitions, macro
+definitions, and many other constructs.
 
 @findex compile-defun
 To compile and evaluate the current defun, use @kbd{M-x compile-defun}.