From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#6958: Documentation: `posn-actual-col-row' is unclear Date: Tue, 31 Aug 2010 16:58:09 -0400 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: dough.gmane.org 1283289001 3342 80.91.229.12 (31 Aug 2010 21:10:01 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 31 Aug 2010 21:10:01 +0000 (UTC) To: 6958@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Aug 31 23:10:00 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OqY5e-0000iZ-W6 for geb-bug-gnu-emacs@m.gmane.org; Tue, 31 Aug 2010 23:09:59 +0200 Original-Received: from localhost ([127.0.0.1]:45595 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OqY5e-0004VD-9W for geb-bug-gnu-emacs@m.gmane.org; Tue, 31 Aug 2010 17:09:58 -0400 Original-Received: from [140.186.70.92] (port=38782 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OqY5T-0004Ot-Sg for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 17:09:52 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OqY5O-0008Ef-QB for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 17:09:47 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49907) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OqY5O-0008Ea-NB for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 17:09:42 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1OqXu6-0002eG-6L; Tue, 31 Aug 2010 16:58:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 31 Aug 2010 20:58:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 6958 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.128328822410170 (code B ref -1); Tue, 31 Aug 2010 20:58:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 31 Aug 2010 20:57:04 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OqXt9-0002dz-0z for submit@debbugs.gnu.org; Tue, 31 Aug 2010 16:57:03 -0400 Original-Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OqXt6-0002db-Ly for submit@debbugs.gnu.org; Tue, 31 Aug 2010 16:57:01 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:36105) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1OqXuh-0007CD-IX for submit@debbugs.gnu.org; Tue, 31 Aug 2010 16:58:39 -0400 Original-Received: from [140.186.70.92] (port=35366 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OqXug-0000mU-5q for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 16:58:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OqXue-0006WH-Uo for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 16:58:38 -0400 Original-Received: from mail-ww0-f49.google.com ([74.125.82.49]:55573) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OqXue-0006Vy-Qo for bug-gnu-emacs@gnu.org; Tue, 31 Aug 2010 16:58:36 -0400 Original-Received: by wwb24 with SMTP id 24so4730863wwb.30 for ; Tue, 31 Aug 2010 13:58:35 -0700 (PDT) Original-Received: by 10.227.208.85 with SMTP id gb21mr6089771wbb.167.1283288289554; Tue, 31 Aug 2010 13:58:09 -0700 (PDT) Original-Received: by 10.216.65.140 with HTTP; Tue, 31 Aug 2010 13:58:09 -0700 (PDT) X-Google-Sender-Auth: cCHm6jx3KtliSYnLs5VKrn1uCcw X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Tue, 31 Aug 2010 16:58:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:39871 Archived-At: documentation of `posn-actual-col-row' is unclear. ,---- (documentation 'posn-actual-col-row) | | Return the actual column and row in position, measured in characters. | These are the actual row number in the window and character number in that row. | Return nil if position does not contain the actual position; in that case | `posn-col-row' can be used to get approximate values. | position should be a list of the form returned by the `event-start' | and `event-end' functions. | `---- How is a position, "measured in characters."? What is a, "character number in that row"? Is this equivalent to the return value of `char-to-string'? (char-to-string (car (posn-col-row (posn-at-point (window-point (selected-window) ) (selected-window))))) ;=> ";" At the very least the following portion of doc is poorly phrased: "These are the actual row number in the window and character number in that row." ^^^^^^^^^ Should be something more like, "This is the actual row number in the window and character number in that row." ^^^^^^^ However, even then the above definition is tautological: ME: "What is `posn-actual-col-row'?" DOC: "... the actual row number ..." Also, there is no mention of which list element of the list returned by the `event-start' this procedure is an accessor of e.g.: POS (COL . ROW) Likewise, there is no indication of the order of the return value is a cons of the form: (COLUMN . ROW) -- /s_P\