* doc/lispref/positions.texi (Text Lines): Document count-words.

diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE
index 636d400f5cb4cbf75ced10ff07d345e5f528356e..99b702ad30fa8446b26e49960ccd44cca6be5a27 100644 (file)
--- a/admin/FOR-RELEASE
+++ b/admin/FOR-RELEASE
@@ -219,7 +219,7 @@ numbers.texi      cyd
 objects.texi      cyd
 os.texi           
 package.texi
-positions.texi    
+positions.texi    cyd
 processes.texi
 searching.texi    
 sequences.texi    cyd

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 51eed431ca2dc478b841d59dd1a753955fe45a75..7f11c65f9e13b6e496970de2dbab5162e4f75bc0 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2012-03-05  Chong Yidong  <cyd@gnu.org>
+
+       * positions.texi (Text Lines): Document count-words.
+
 2012-03-04  Chong Yidong  <cyd@gnu.org>
 
        * frames.texi (Frames): Remove little-used "terminal frame" and

diff --git a/doc/lispref/positions.texi b/doc/lispref/positions.texi
index 29b338369e5ffcfb1653e0208f79b4b0316355c1..99722c9390248d85267ab2132a0fe11dfea78bfe 100644 (file)
--- a/doc/lispref/positions.texi
+++ b/doc/lispref/positions.texi
@@ -372,18 +372,17 @@ This function returns the number of lines between the positions
 1, even if @var{start} and @var{end} are on the same line.  This is
 because the text between them, considered in isolation, must contain at
 least one line unless it is empty.
+@end defun
 
-Here is an example of using @code{count-lines}:
+@deffn Command count-words start end
+@cindex words in region
+This function returns the number of words between the positions
+@var{start} and @var{end} in the current buffer.
 
-@example
-@group
-(defun current-line ()
-  "Return the vertical position of point@dots{}"
-  (+ (count-lines (window-start) (point))
-     (if (= (current-column) 0) 1 0)))
-@end group
-@end example
-@end defun
+This function can also be called interactively.  In that case, it
+prints a message reporting the number of lines, words, and characters
+in the buffer, or in the region if the region is active.
+@end deffn
 
 @defun line-number-at-pos &optional pos
 @cindex line number