emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Initial documentation for xwidgets


From: joakim
Subject: Re: Initial documentation for xwidgets
Date: Fri, 12 Feb 2016 22:40:35 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.90 (gnu/linux)

address@hidden writes:

> Eli Zaretskii <address@hidden> writes:
>
>>> From: address@hidden
>>> Cc: address@hidden
>>> 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



reply via email to

[Prev in Thread] Current Thread [Next in Thread]