From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Initial documentation for xwidgets Date: Sat, 30 Jan 2016 10:13:03 +0200 Message-ID: <83y4b7wkmo.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1454141627 18253 80.91.229.3 (30 Jan 2016 08:13:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 30 Jan 2016 08:13:47 +0000 (UTC) Cc: emacs-devel@gnu.org To: joakim@verona.se Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jan 30 09:13:46 2016 Return-path: Envelope-to: ged-emacs-devel@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 1aPQfC-0002E9-6S for ged-emacs-devel@m.gmane.org; Sat, 30 Jan 2016 09:13:46 +0100 Original-Received: from localhost ([::1]:37874 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aPQf7-0006Ee-NU for ged-emacs-devel@m.gmane.org; Sat, 30 Jan 2016 03:13:41 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56547) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aPQf4-0006CE-J0 for emacs-devel@gnu.org; Sat, 30 Jan 2016 03:13:39 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aPQf0-0006gH-EG for emacs-devel@gnu.org; Sat, 30 Jan 2016 03:13:38 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:35727) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aPQf0-0006gD-Av; Sat, 30 Jan 2016 03:13:34 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1404 helo=HOME-C4E4A596F7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aPQez-0000n8-O1; Sat, 30 Jan 2016 03:13:34 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:199030 Archived-At: I've pushed commit ef760b8, which is the initial attempt to document the xwidget features. The user manual mentions a single command and the mode it enters. The section in the ELisp manual mentions some of the primitives I thought were important to document. The particular selection I decided to document, and the ones I decided to omit might not make sense, which is OK -- the whole issue makes very little sense to me for now, and the (abysmally inadequate, IMO) GTK documentation of the APIs used by xwidget.c doesn't help at all. The result cannot be good enough by any measure. Still, IMO it's better than no documentation at all, and at least a seasonal WebKit programmer should be able to figure the stuff out. Please review and comment on functions/commands that should be added to the documentation, and also on the correctness of the text. Thanks.