[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100268: Doc fix for posn-* functions (Bug#7471).

[Chong Yidong]

------------------------------------------------------------
revno: 100268
committer: Chong Yidong <address@hidden>
branch nick: emacs-23
timestamp: Sat 2010-12-04 19:43:18 -0500
message:
  Doc fix for posn-* functions (Bug#7471).
  
  * lisp/subr.el (posn-x-y, posn-object-x-y, posn-object-width-height):
  Doc fix (Bug#7471).
modified:
  lisp/ChangeLog
  lisp/subr.el

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2010-12-04 22:43:51 +0000
+++ b/lisp/ChangeLog    2010-12-05 00:43:18 +0000
@@ -1,3 +1,8 @@
+2010-12-05  Chong Yidong  <address@hidden>
+
+       * subr.el (posn-x-y, posn-object-x-y, posn-object-width-height):
+       Doc fix (Bug#7471).
+
 2010-12-04  Martin Rudalics  <address@hidden>
 
        * dired.el (dired-pop-to-buffer): Bind pop-up-frames to nil

=== modified file 'lisp/subr.el'
--- a/lisp/subr.el      2010-11-13 21:07:58 +0000
+++ b/lisp/subr.el      2010-12-05 00:43:18 +0000
@@ -916,8 +916,9 @@
 
 (defsubst posn-x-y (position)
   "Return the x and y coordinates in POSITION.
-POSITION should be a list of the form returned by the `event-start'
-and `event-end' functions."
+The return value has the form (X . Y), where X and Y are given in
+pixels.  POSITION should be a list of the form returned by
+`event-start' and `event-end'."
   (nth 2 position))
 
 (declare-function scroll-bar-scale "scroll-bar" (num-denom whole))
@@ -997,14 +998,15 @@
 
 (defsubst posn-object-x-y (position)
   "Return the x and y coordinates relative to the object of POSITION.
-POSITION should be a list of the form returned by the `event-start'
-and `event-end' functions."
+The return value has the form (DX . DY), where DX and DY are
+given in pixels.  POSITION should be a list of the form returned
+by `event-start' and `event-end'."
   (nth 8 position))
 
 (defsubst posn-object-width-height (position)
   "Return the pixel width and height of the object of POSITION.
-POSITION should be a list of the form returned by the `event-start'
-and `event-end' functions."
+The return value has the form (WIDTH . HEIGHT).  POSITION should
+be a list of the form returned by `event-start' and `event-end'."
   (nth 9 position))