[Emacs-diffs] emacs-24 5e2951b: Improve docs of 'posn-actual-col-row' (Bug#20169)

[Eli Zaretskii]

branch: emacs-24
commit 5e2951be4ac50da48bb82e74db87930e9d9d127d
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Improve docs of 'posn-actual-col-row'  (Bug#20169)
    
     doc/lispref/commands.texi (Accessing Mouse): Expand documentation of
     'posn-actual-col-row'.
---
 doc/lispref/ChangeLog     |    2 ++
 doc/lispref/commands.texi |    8 +++++++-
 2 files changed, 9 insertions(+), 1 deletions(-)

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 1dae36a..970d163 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -2,6 +2,8 @@
 
        * commands.texi (Event Input Misc): Fix incorrect usage of @code.
        (Bug#20174)
+       (Accessing Mouse): Expand documentation of 'posn-actual-col-row'.
+       (Bug#20169)
 
 2015-03-14  Eli Zaretskii  <address@hidden>
 
diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 4b69ed3..6cb032c 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -2081,7 +2081,13 @@ Return the actual row and column in @var{position}, as a 
cons cell
 @code{(@var{col} . @var{row})}.  The values are the actual row and
 column numbers in the window given by @var{position}.  @xref{Click
 Events}, for details.  The function returns @code{nil} if
address@hidden does not include actual position values.
address@hidden does not include actual position values; in that case
address@hidden can be used to get approximate values.
+
+Note that this function doesn't account for the visual width of
+characters on display, like the number of visual columns taken by a
+tab character or an image.  If you need the coordinates in canonical
+character units, use @code{posn-col-row} instead.
 @end defun
 
 @defun posn-string position