From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#51712: 29.0.50; [PATCH] New function `xwidget-webkit-load-html' Date: Wed, 10 Nov 2021 14:50:28 +0200 Message-ID: <83bl2s41kb.fsf@gnu.org> References: <878rxx8w1i.fsf.ref@yahoo.com> <878rxx8w1i.fsf@yahoo.com> <83h7cl5urs.fsf@gnu.org> <87y25x5tu9.fsf@yahoo.com> <831r3p5sn4.fsf@gnu.org> <87wnlgyjcd.fsf@yahoo.com> <87r1bolvx1.fsf@gnus.org> <87czn8yii2.fsf@yahoo.com> <877ddgluzr.fsf@gnus.org> <87fss4ohjv.fsf@yahoo.com> <87sfw4h7pt.fsf@gnus.org> <87zgqcczk4.fsf@yahoo.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6678"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 51712@debbugs.gnu.org To: Po Lu Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 10 13:52:10 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mkn5G-0001Vi-4w for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 10 Nov 2021 13:52:10 +0100 Original-Received: from localhost ([::1]:55744 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mkn5F-0001rm-8K for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 10 Nov 2021 07:52:09 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:47992) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mkn4E-0008Ak-Nh for bug-gnu-emacs@gnu.org; Wed, 10 Nov 2021 07:51:06 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53926) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mkn4A-0003Vv-IG for bug-gnu-emacs@gnu.org; Wed, 10 Nov 2021 07:51:06 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mkn4A-0002rm-En for bug-gnu-emacs@gnu.org; Wed, 10 Nov 2021 07:51: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: Wed, 10 Nov 2021 12:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 51712 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 51712-submit@debbugs.gnu.org id=B51712.163654864210992 (code B ref 51712); Wed, 10 Nov 2021 12:51:02 +0000 Original-Received: (at 51712) by debbugs.gnu.org; 10 Nov 2021 12:50:42 +0000 Original-Received: from localhost ([127.0.0.1]:37239 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mkn3q-0002rE-8E for submit@debbugs.gnu.org; Wed, 10 Nov 2021 07:50:42 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:47120) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mkn3n-0002r0-BN for 51712@debbugs.gnu.org; Wed, 10 Nov 2021 07:50:41 -0500 Original-Received: from [2001:470:142:3::e] (port=56356 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mkn3h-0003Rb-La; Wed, 10 Nov 2021 07:50:33 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=8tqy9u7KXbMOxefABUkvbuCM4fMf+6l0vdwXuC6qosg=; b=KZbDtrxONXSi /g7RitO4Si4LVCthTw9EZ9A/FASxGxwZbEvBnlp/+aF4eDUNQU77xeZKC6kdBjtTkI8XL219mOUOR fFmifmwwzQqCaQ+pcldJdMy4p7D+FLZeenXR7tus0LBKo9vnd3c/VlXDezBHKrFldoqt+jkgHQ2mP AmGUgHBcsQYyqTfE5zCTevfIyMG+b83+ooOwzQWxsv8NuNiqQh/tE6cEAnRcVfX7M983duJnCBaF4 WUIXNZqStm/K5CNk7EqLTcEqRrjN6QyTa+OAkppA6jIQL42nEvHUd0G+9cMVtCkBgJKaFuESb2pLG 2qUU8b8vHgIENZoKqCV2fA==; Original-Received: from [87.69.77.57] (port=4595 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mkn3g-0004ZO-VM; Wed, 10 Nov 2021 07:50:33 -0500 In-Reply-To: <87zgqcczk4.fsf@yahoo.com> (message from Po Lu on Wed, 10 Nov 2021 14:08:59 +0800) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:219535 Archived-At: > From: Po Lu > Cc: Eli Zaretskii , 51712@debbugs.gnu.org > Date: Wed, 10 Nov 2021 14:08:59 +0800 > > > That should be \"about:blank\" instead, since it's a string and not a > > symbol. > > Thanks, how's this? Eli, does this look good to you? Almost: > +@defun xwidget-webkit-load-html xwidget text &optional base-uri > +Load @var{text}, a string, into @var{xwidget}, which should be a > +WebKit xwidget. It treats @var{text} as HTML markup, which will be > +rendered by @var{xwidget}. Instead of the last sentence: Any HTML markup in @var{text} will be processed by @var{xwidget} while rendering the text. > +Optional argument @var{base-uri}, which should be a string, specifies > +the location of web resources specified through relative links, such > +as the resource @samp{foo.png} in the HTML tag @samp{ +src="foo.png">}. It defaults to @samp{about:blank}. > +@end defun Optional argument @var{base-uri}, which should be a string, specifies the absolute location of the web resources referenced by @var{text}, to be used for resolving relative links in @var{text}. > +*** New function 'xwidget-webkit-load-html'. > +This function is used to load HTML text into WebKit xwidgets, without > +having to create a temporary file to store the markup. Here' I'd like to say something like This is in contrast with loading HTML using ... which requires to create temporary files for storing the markup. But I don't know what to write instead of "...". What was the method which existed earlier that you wanted to improve? > +BASE_URI should be a string containing a URI that is used to locate > +resources described by relative URLs, and if not specified, defaults ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ "resources with relative URLs" sounds better to me. Thanks.