<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Sep 29, 2015 at 12:18 PM, Derek Foreman <span dir="ltr"><<a href="mailto:derekf@osg.samsung.com" target="_blank">derekf@osg.samsung.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
> 2. Call the function "xdg_surface_raise". Because raising is exactly<br>
> what the client expects. It does not mean that it *has* to raise the<br>
> window. If you don't do this, lots of programmers are going to ask where<br>
> the raise function is, let's stop that from being added as another call<br>
> and get this right now into a single api.<br>
<br>
mumble mumble "descriptive not prescriptive", raise is an imperative.<br>
<br>
Then again "present" is too.  Not sure how far we want to bike shed this<br>
one.  xdg_surface_indicate_activity?  heh.  getting a bit long to type.<br>
<br>
Either way, we're expected to present something to the user (either an<br>
indication or the surface).  We're not necessarily going to raise<br>
anything.  So raise may be more confusing.<br></blockquote><div><br></div><div>"raise" is a very likely possible result of this. There is a non-zero chance that the result of this message will be an action that a user and programmer will call "raise". Your complaint is like saying "we can't have this function be called 'set_color' because on a black and white screen it will produce a gray shade".<br><br></div><div>My main concern is that programmers are going to search for the word "raise" to figure out how to raise windows. They are not going to search for "present" or "indicate_activity" or any other bogus word. I suspect that if you don't name this "raise" then a function called "raise" will be added as an extension very soon, and probably break all your careful plans of allowing the compositor to do something other than raise.<br><br></div></div></div></div>