[RFC weston 3/4] XXX: README: Mention bits that we really want for libweston

Emil Velikov emil.l.velikov at gmail.com
Fri Jun 3 13:27:38 UTC 2016


From: Emil Velikov <emil.velikov at collabora.com>

---
 README | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README b/README
index b8aa2e0..e411343 100644
--- a/README
+++ b/README
@@ -161,3 +161,15 @@ major ABI-versions, except those explicitly mentioned.
 
 Weston's build may not sanely allow this yet, but this is the
 intention.
+
+XXX: Document the versioning scheme properly
+What breaks, what doesn't. When do we bump major, minor and patch.
+
+XXX: Note why should new symbols (API) be guarded by LIBWESTON_API_VERSION >= $VERSION macros.
+
+It allows us to add new features/API without any risk of being breaking things.
+
+broke when I reverted to version X" because they have explicitly requested.
+What/how ? Simple, anyone that uses the new API explicitly annotates the verion
+they which to use. Thus there won't be any issues of the sort "things broke
+when I reverted to using version X-Y" as they _explicitly_ request version X ;-)
-- 
2.8.2



More information about the wayland-devel mailing list