Hi, On 19 April 2016 at 17:55, Yong Bakos <[email protected]> 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.) > > https://lists.freedesktop.org/archives/wayland-devel/2016-April/028241.html > > 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'? :) Cheers, Daniel _______________________________________________ wayland-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/wayland-devel
