Changes between Version 16 and Version 17 of EFLWebKitCodingStyle

Timestamp:

Sep 13, 2012 12:21:48 AM (12 years ago)

Author:

Christophe Dumez

Comment:

--

EFLWebKitCodingStyle

@@ -10 +10 @@
  * Use '''NULL''' in public C headers instead of 0
  * Use a double negation '''(!!)''' when you modify or compare with a Eina Bool member variable which stores a value in a bit field.
+ * *_ref() functions should return the ref'd object
 
 = Example =
@@ -249 +250 @@
 }
 }}}
+
+== *_ref() functions should return the ref'd object. ==
+
+This makes them more convenient to use and results in less code.
+
+=== Right ===
+{{{
+#!cpp
+EAPI Ewk_Web_Resource *ewk_web_resource_ref(Ewk_Web_Resource *resource);
+[...]
+resources.add(resourceID, ewk_web_resource_ref(ewkResource));
+}}}
+=== Wrong ===
+{{{
+#!cpp
+EAPI void ewk_web_resource_ref(Ewk_Web_Resource *resource);
+[...]
+ewk_web_resource_ref(ewkResource)
+resources.add(resourceID, ewkResource);
+}}}