No subject
Mon Jul 9 10:09:07 PDT 2012
n WebKit. Prefixing the Region class with "CSS" could prove confusing.
Regards,
Andrei.
From: Alan Stearns <stearns at adobe.com<mailto:stearns at adobe.com>>
Date: Thursday, July 12, 2012 7:39 PM
To: Adam Barth <abarth at webkit.org<mailto:abarth at webkit.org>>, Andrei Bucur =
<abucur at adobe.com<mailto:abucur at adobe.com>>
Cc: "webkit-dev at lists.webkit.org<mailto:webkit-dev at lists.webkit.org>" <webk=
it-dev at lists.webkit.org<mailto:webkit-dev at lists.webkit.org>>
Subject: Re: [webkit-dev] Web APIs and class name collisions
The spec itself consistently and deliberately calls them "CSS Regions," so =
a CSS prefix could be appropriate.
Thanks,
Alan
From: Adam Barth <abarth at webkit.org<mailto:abarth at webkit.org>>
To: Andrei Bucur <abucur at adobe.com<mailto:abucur at adobe.com>>
Cc: "webkit-dev at lists.webkit.org<mailto:webkit-dev at lists.webkit.org>" <webk=
it-dev at lists.webkit.org<mailto:webkit-dev at lists.webkit.org>>
Subject: Re: [webkit-dev] Web APIs and class name collisions
One common thing we do is prefix "DOM" to DOM-level concepts. For example,=
DOMWindow and DOMFileSystem. I'm not sure if we have an established conve=
ntion for CSS-level concepts.
Adam
On Thu, Jul 12, 2012 at 9:18 AM, Andrei Bucur <abucur at adobe.com<mailto:abuc=
ur at adobe.com>> wrote:
Hello Webkittens!
While implementing the Region interface ( http://dev.w3.org/csswg/css3-regi=
ons/#the-region-interface ) I've noticed that the name "Region" is already =
taken by a class in platform/graphics. I'd like to know what's the best app=
roach in these kind of situations:
1. Rename the existing WebCore class to something else and use the name "=
Region" for the Web API so there's parity between the implementation and th=
e spec
2. Somehow prefix the Web API implementation class name?
As the Web APIs expand I suppose this situation may occur again in the futu=
re and I suppose there should be a rule describing what's the best approach=
to take.
Thanks!
Andrei.
_______________________________________________
webkit-dev mailing list
webkit-dev at lists.webkit.org<mailto:webkit-dev at lists.webkit.org>
http://lists.webkit.org/mailman/listinfo/webkit-dev
--_000_CC24DDB036185abucuradobecom_
Content-Type: text/html; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
<html><head></head><body style=3D"word-wrap: break-word; -webkit-nbsp-mode:=
space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-si=
ze: 14px; font-family: Calibri, sans-serif; "><div>From my knowledge the "C=
SS" prefix is reserved for the CSS engine classes in WebKit. Prefixing the =
Region class with "CSS" could prove confusing.</div><div><br></div><div>Reg=
ards,</div><div>Andrei.</div><div><br></div><span id=3D"OLK_SRC_BODY_SECTIO=
N"><div style=3D"font-family:Calibri; font-size:11pt; text-align:left; colo=
r:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTT=
OM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt sol=
id; BORDER-RIGHT: medium none; PADDING-TOP: 3pt"><span style=3D"font-weight=
:bold">From: </span> Alan Stearns <<a href=3D"mailto:stearns at adobe.com">=
stearns at adobe.com</a>><br><span style=3D"font-weight:bold">Date: </span>=
Thursday, July 12, 2012 7:39 PM<br><span style=3D"font-weight:bold">To: </=
span> Adam Barth <<a href=3D"mailto:abarth at webkit.org">abarth at webkit.org=
</a>>, Andrei Bucur <<a href=3D"mailto:abucur at adobe.com">abucur at adobe=
.com</a>><br><span style=3D"font-weight:bold">Cc: </span> "<a href=3D"ma=
ilto:webkit-dev at lists.webkit.org">webkit-dev at lists.webkit.org</a>" <<a h=
ref=3D"mailto:webkit-dev at lists.webkit.org">webkit-dev at lists.webkit.org</a>&=
gt;<br><span style=3D"font-weight:bold">Subject: </span> Re: [webkit-dev] W=
eb APIs and class name collisions<br></div><div><br></div><div><meta http-e=
quiv=3D"Content-Type" content=3D"text/html; charset=3Dutf-8"><div style=3D"=
word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-=
white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sa=
ns-serif; "><div>The spec itself consistently and deliberately calls them "=
CSS Regions," so a CSS prefix could be appropriate.</div><div><br></div><di=
v>Thanks,</div><div><br></div><div>Alan</div><div><br></div><div><br></div>=
<span id=3D"OLK_SRC_BODY_SECTION"><div style=3D"font-family:Calibri; font-s=
ize:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-=
LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0=
in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: =
3pt"><span style=3D"font-weight:bold">From: </span>Adam Barth <<a href=
=3D"mailto:abarth at webkit.org">abarth at webkit.org</a>><br><span style=3D"f=
ont-weight:bold">To: </span>Andrei Bucur <<a href=3D"mailto:abucur at adobe=
.com">abucur at adobe.com</a>><br><span style=3D"font-weight:bold">Cc: </sp=
an>"<a href=3D"mailto:webkit-dev at lists.webkit.org">webkit-dev at lists.webkit.=
org</a>" <<a href=3D"mailto:webkit-dev at lists.webkit.org">webkit-dev at list=
s.webkit.org</a>><br><span style=3D"font-weight:bold">Subject: </span>Re=
: [webkit-dev] Web APIs and class name collisions<br></div><div><br></div><=
div><div>One common thing we do is prefix "DOM" to DOM-level concepts. &nbs=
p;For example, DOMWindow and DOMFileSystem. I'm not sure if we h=
ave an established convention for CSS-level concepts.
<div><br></div><div>Adam</div><div><br><br><div class=3D"gmail_quote">On Th=
u, Jul 12, 2012 at 9:18 AM, Andrei Bucur <span dir=3D"ltr">
<<a href=3D"mailto:abucur at adobe.com" target=3D"_blank">abucur at adobe.com<=
/a>></span> wrote:<br><blockquote class=3D"gmail_quote" style=3D"margin:=
0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style=3D"font-=
size:14px;font-family:Calibri,sans-serif;word-wrap:break-word"><div>Hello W=
ebkittens!</div><div><br></div><div>While implementing the Region interface=
( <a href=3D"http://dev.w3.org/csswg/css3-regions/#the-region-interfa=
ce" target=3D"_blank">http://dev.w3.org/csswg/css3-regions/#the-region-inte=
rface</a> ) I've noticed that the name "Region" is already taken by a =
class
in platform/graphics. I'd like to know what's the best approach in these k=
ind of situations:</div><ol><li>Rename the existing WebCore class to someth=
ing else and use the name "Region" for the Web API so there's parity betwee=
n the implementation and the spec</li><li>Somehow prefix the Web API implem=
entation class name? </li></ol><div>As the Web APIs expand I suppose this s=
ituation may occur again in the future and I suppose there should be a rule=
describing what's the best approach to take.</div><div><br></div><div>Than=
ks!</div><span class=3D"HOEnZb"><font color=3D"#888888"><div>Andrei.</div><=
/font></span></div><br>
_______________________________________________<br>
webkit-dev mailing list<br><a href=3D"mailto:webkit-dev at lists.webkit.org">w=
ebkit-dev at lists.webkit.org</a><br><a href=3D"http://lists.webkit.org/mailma=
n/listinfo/webkit-dev" target=3D"_blank">http://lists.webkit.org/mailman/li=
stinfo/webkit-dev</a><br><br></blockquote></div><br></div></div></div></spa=
n></div></div></span></body></html>
--_000_CC24DDB036185abucuradobecom_--
More information about the webkit-dev
mailing list