From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
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 <eliz@gnu.org>
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 <larsi@gnus.org>
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: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	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 <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	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 <Debian-debbugs@debbugs.gnu.org>) 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 <Debian-debbugs@debbugs.gnu.org>) 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 <Debian-debbugs@debbugs.gnu.org>) 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 <Debian-debbugs@debbugs.gnu.org>) 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 <eliz@gnu.org>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Sun, 09 Feb 2014 03:47:02 +0000
Resent-Message-ID: <handler.14228.B14228.139191758124424@debbugs.gnu.org>
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 <debbugs-submit-bounces@debbugs.gnu.org>)
	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 <eliz@gnu.org>) 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" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=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: <http://permalink.gmane.org/gmane.emacs.bugs/85030>

> From: Lars Ingebrigtsen <larsi@gnus.org>
> 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.