[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