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:40:35 +0100 Message-ID: References: <83y4b7wkmo.fsf@gnu.org> <838u2p7h9o.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1455313295 20947 80.91.229.3 (12 Feb 2016 21:41:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 12 Feb 2016 21:41:35 +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:41:24 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 1aULSt-0008GV-55 for ged-emacs-devel@m.gmane.org; Fri, 12 Feb 2016 22:41:23 +0100 Original-Received: from localhost ([::1]:36508 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aULSp-0002gf-0O for ged-emacs-devel@m.gmane.org; Fri, 12 Feb 2016 16:41:19 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58071) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aULSa-0002gL-4q for emacs-devel@gnu.org; Fri, 12 Feb 2016 16:41:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aULSZ-0006Fp-18 for emacs-devel@gnu.org; Fri, 12 Feb 2016 16:41:04 -0500 Original-Received: from mx6.bahnhof.se ([213.80.101.16]:46651) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aULST-0006CS-8h; Fri, 12 Feb 2016 16:40:57 -0500 Original-Received: from localhost (mf.bahnhof.se [213.80.101.20]) by mx6-reinject (Postfix) with ESMTP id 12E21418ED; Fri, 12 Feb 2016 22:40:55 +0100 (CET) X-Virus-Scanned: by amavisd-new using ClamAV at bahnhof.se (MF4) Original-Received: from mf4.bahnhof.se ([127.0.0.1]) by localhost (mf4.bahnhof.se [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id pch8wgXzGwJU; Fri, 12 Feb 2016 22:40:49 +0100 (CET) Original-Received: from mta.verona.se (h-235-62.a149.priv.bahnhof.se [85.24.235.62]) by mf4.bahnhof.se (Postfix) with ESMTP id 6BB853D7876; Fri, 12 Feb 2016 22:40:49 +0100 (CET) Original-Received: from localhost (unknown [127.0.0.1]) by mta.verona.se (Postfix) with ESMTP id 331294EA627; Fri, 12 Feb 2016 21:40:49 +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 KL8EVE6ysy-b; Fri, 12 Feb 2016 22:40:35 +0100 (CET) Original-Received: from exodia.verona.se (www.verona.se [192.168.200.15]) by mta.verona.se (Postfix) with ESMTP id BB5134E19ED; Fri, 12 Feb 2016 22:40:35 +0100 (CET) In-Reply-To: (joakim@verona.se's message of "Fri, 12 Feb 2016 22:35:19 +0100") 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:199838 Archived-At: joakim@verona.se writes: > Eli Zaretskii writes: > >>> From: joakim@verona.se >>> Cc: emacs-devel@gnu.org >>> Date: Fri, 12 Feb 2016 22:08:03 +0100 >>> >>> I finally read the documentation you wrote for xwidgets, and it was really good thanks! >> >> Are you sure? I cannot imagine I was that lucky. There are some >> functions I didn't document, some of them in xwidget.c, others in >> xwidget.el -- did I decide correctly which ones should be documented >> and which shouldn't? > > I think you did a better job than I would have done. But let me have an > extra look. > >> >>> 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. >> >> Examples could help. Can you provide examples of URIs that are >> neither URLs nor file names? >> >>> - 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? >> >> We can still change it, it's not too late. > > Ok, I will change it then. > > BTW, when will it be too late to make these kind of changes? I think > this is the only api change, the other requested changes were more of > the bugfix kind. Sorry, there was the proposed change to remove unused arguments from make-xwidget as well. So two api changes. > > (let's assume I'm stuck in a time warp bubble where time moves quite > slowly as compared to the outside) > >> Thanks. -- Joakim Verona