From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: joakim@verona.se Newsgroups: gmane.emacs.devel Subject: Re: Initial documentation for xwidgets Date: Fri, 12 Feb 2016 22:08:03 +0100 Message-ID: References: <83y4b7wkmo.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1455311345 22779 80.91.229.3 (12 Feb 2016 21:09:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 12 Feb 2016 21:09:05 +0000 (UTC) Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 12 22:08:54 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 1aUKxP-00010D-9l for ged-emacs-devel@m.gmane.org; Fri, 12 Feb 2016 22:08:51 +0100 Original-Received: from localhost ([::1]:36281 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aUKxO-00032x-9q for ged-emacs-devel@m.gmane.org; Fri, 12 Feb 2016 16:08:50 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38989) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aUKxA-00032k-IW for emacs-devel@gnu.org; Fri, 12 Feb 2016 16:08:37 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aUKx9-0004oP-Ie for emacs-devel@gnu.org; Fri, 12 Feb 2016 16:08:36 -0500 Original-Received: from mx6.bahnhof.se ([213.80.101.16]:46081) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aUKx4-0004kd-RN; Fri, 12 Feb 2016 16:08:30 -0500 Original-Received: from localhost (mf.bahnhof.se [213.80.101.20]) by mx6-reinject (Postfix) with ESMTP id A86B84317F; Fri, 12 Feb 2016 22:08:27 +0100 (CET) X-Virus-Scanned: by amavisd-new using ClamAV at bahnhof.se (MF2) Original-Received: from mf2.bahnhof.se ([127.0.0.1]) by localhost (mf2.bahnhof.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HrF8jTRlYHPS; Fri, 12 Feb 2016 22:08:18 +0100 (CET) Original-Received: from mta.verona.se (h-235-62.a149.priv.bahnhof.se [85.24.235.62]) by mf2.bahnhof.se (Postfix) with ESMTP id C759494011C; Fri, 12 Feb 2016 22:08:18 +0100 (CET) Original-Received: from localhost (unknown [127.0.0.1]) by mta.verona.se (Postfix) with ESMTP id 89CAB4E19F1; Fri, 12 Feb 2016 21:08:18 +0000 (UTC) X-Virus-Scanned: amavisd-new at verona.se Original-Received: from mta.verona.se ([127.0.0.1]) by localhost (exodia.verona.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 50Kn9IOV-OBw; Fri, 12 Feb 2016 22:08:03 +0100 (CET) Original-Received: from exodia.verona.se (www.verona.se [192.168.200.15]) by mta.verona.se (Postfix) with ESMTP id 4F5164E19ED; Fri, 12 Feb 2016 22:08:03 +0100 (CET) In-Reply-To: <83y4b7wkmo.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 30 Jan 2016 10:13:03 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.90 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 213.80.101.16 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:199834 Archived-At: Eli Zaretskii writes: > 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. I finally read the documentation you wrote for xwidgets, and it was really good thanks! I have just two things. - This fixme, I dont really have a good answer. @c FIXME: What else can a URI specify in this context? The uri is just any ury webkit accepts, which isnt a very helpful explanation of course. - When I read the documentation I noticed the term 'webkit-osr'. -osr stands for 'off screen rendering'. There used to be different types of widgets, that weren't rendered off-screen. I don't think I will re-introduce those widgets because they were unreliable. So, there will likely only ever be osr widgets, which makes the osr suffix redundant. I guess people might have started tinkering with xwidget-osr. What do you think, should I change this, or does it not matter? -- Joakim Verona