From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#14228: 24.3.50; doc of `event-start': nonsensical, incomplete, inconsistent Date: Sun, 09 Feb 2014 05:45:51 +0200 Message-ID: <83vbwpuexc.fsf@gnu.org> References: <2B7219AEF4554855BC07241B6C6A6B6B@us.oracle.com> <87zjm1sty1.fsf@building.gnus.org> <83d2ixwu8s.fsf@gnu.org> <87r47dkpzv.fsf@building.gnus.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1391917633 7591 80.91.229.3 (9 Feb 2014 03:47:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 9 Feb 2014 03:47:13 +0000 (UTC) Cc: 14228@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 09 04:47:16 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WCLMS-00060u-5f for geb-bug-gnu-emacs@m.gmane.org; Sun, 09 Feb 2014 04:47:16 +0100 Original-Received: from localhost ([::1]:49051 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCLMR-00052Z-MJ for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Feb 2014 22:47:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32975) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCLMJ-00052G-Ja for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:47:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCLME-0004UB-K3 for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:47:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:44690) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCLME-0004Tz-Gj for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:47:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCLME-0006Mw-9P for bug-gnu-emacs@gnu.org; Sat, 08 Feb 2014 22:47:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 03:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 14228 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 14228-submit@debbugs.gnu.org id=B14228.139191758124424 (code B ref 14228); Sun, 09 Feb 2014 03:47:02 +0000 Original-Received: (at 14228) by debbugs.gnu.org; 9 Feb 2014 03:46:21 +0000 Original-Received: from localhost ([127.0.0.1]:58709 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCLLV-0006Lp-W7 for submit@debbugs.gnu.org; Sat, 08 Feb 2014 22:46:21 -0500 Original-Received: from mtaout23.012.net.il ([80.179.55.175]:38670) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCLLQ-0006LZ-DP for 14228@debbugs.gnu.org; Sat, 08 Feb 2014 22:46:16 -0500 Original-Received: from conversion-daemon.a-mtaout23.012.net.il by a-mtaout23.012.net.il (HyperSendmail v2007.08) id <0N0P00J00KYPT300@a-mtaout23.012.net.il> for 14228@debbugs.gnu.org; Sun, 09 Feb 2014 05:46:10 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout23.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N0P00J7YMGXRA60@a-mtaout23.012.net.il>; Sun, 09 Feb 2014 05:46:10 +0200 (IST) In-reply-to: <87r47dkpzv.fsf@building.gnus.org> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:85030 Archived-At: > From: Lars Ingebrigtsen > Cc: drew.adams@oracle.com, 14228@debbugs.gnu.org > Date: Sat, 08 Feb 2014 17:56:52 -0800 > > >> > 2. The doc string of `event-start' specifies the form of EVENT as being > >> > either (WINDOW POS (0.0) 0) or (WINDOW AREA-OR-POS (X . Y) TIMESTAMP > >> > OBJECT POS (COL . ROW) IMAGE (DX . DY) (WIDTH . HEIGHT)). > >> > > >> > But *none* of those terms are described. What is POS? IMAGE? OBJECT? > >> > etc. Incomprehensible. > >> > >> Yeah, they might be nice to understand... > > > > The doc string of event-start says "AREA-OR-POS". And if that is > > still unclear, there's a reference to "Click Events" in the manual, > > which spells that out (except that it uses POS-OR-AREA" instead). > > I was thinking more about the more bewildering things at the end there. They are all described in "Click Events" in the ELisp manual, AFAICS.