standardizing "surface-local coordinates"

Daniel Stone daniel at
Tue Apr 19 17:26:38 UTC 2016


On 19 April 2016 at 17:55, Yong Bakos <junk at> wrote:
> There was a little discussion recently about standardizing occurrences of "surface local coordinates" to the grammatically correct "surface-local coordinates." (It's a compound adjective.)
> Doing so would affect documentation in:
> wayland: protocol/wayland.xml
> wayland-protocols: pointer-constraints, tablet, xdg-shell
> weston: protocol/ivi-application.xml, compositor.c (1 comment header)
> Currently, both the dashed and dashless versions are used in description paragraphs. Standardizing this would help protocol authors adhere to one grammatically correct convention, and also improve succinctness of arg summaries. For example "x coordinate in surface local coordinates" can become "surface-local x coordinate."
> I know this contribution isn't huge, but wanted to give you the chance to discourage me from doing this before I send a handful of patches. You might suggest alternative terms entirely, but prior discussion seems to indicate that "surface-local" is concise and less susceptible to misinterpretation than alternatives (eg. "surface relative").

No, please do go for it. And also, surely 'surface relative' is in
fact 'surface-relative'? :)


More information about the wayland-devel mailing list