X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=HACKING;h=cf407c985d95fa3c4b8ef0992a8da1a7af99d39a;hb=609bfd753c4a813791a6f678f545940c6d331c20;hp=a502a2008742e935dd33fd4191317c40fe04da5d;hpb=f18297a5fd88f09a9e1a1330777f6db6dfe8999a;p=libsigrok.git

diff --git a/HACKING b/HACKING
index a502a200..cf407c98 100644
--- a/HACKING
+++ b/HACKING
@@ -143,6 +143,30 @@ Doxygen
    /** @endcond */, so that Doxygen doesn't include them in the output.
    Variables that are "static" don't need to be marked like this.
 
+ - Mark all public API functions (SR_API) with a @since tag which indicates
+   in which release the respective function was added. If the function has
+   existed before, but its API changed later, document this as well.
+
+   Non-public functions (static ones, and those marked SR_PRIV) don't need
+   to have @since markers.
+
+   The @since tag should be the last one, i.e. it should come after @param,
+   @return, @see, and so on.
+
+   Examples:
+
+     @since 0.1.0
+
+     @since 0.1.1 (but the API changed in 0.2.0)
+
+
+Testsuite
+---------
+
+You can run the libsigrok testsuite using:
+
+ $ make check
+
 
 Release engineering
 -------------------