X-Git-Url: https://sigrok.org/gitweb/?a=blobdiff_plain;f=HACKING;h=faac0a8c0da22a4bcf900efa8ccddb87f2703a20;hb=ee7e9bee5d943261d866f92cb8b81584e290df01;hp=9c422a328bce348a1832b9223ea838a85d94cb4d;hpb=2bba3dd3a836f4a6d497709d321557a48e6425a3;p=libsigrok.git

diff --git a/HACKING b/HACKING
index 9c422a32..faac0a8c 100644
--- a/HACKING
+++ b/HACKING
@@ -115,6 +115,18 @@ Random notes
    should end with "_all", e.g. "_remove_all", "_get_all", and so on.
    Use "_remove_all" in favor of "_clear" for consistency.
 
+ - All enums should generally use an explicit start number of 10000.
+   If there are multiple "categories" in the enum entries, each category
+   should be 10000 entries apart from the next one. The start of categories
+   are thus 10000, 20000, 30000, and so on.
+
+   Adding items to an enum MUST always append to a "category", never add
+   items in the middle of a category. The order of items MUST NOT be changed.
+   Any of the above would break the ABI.
+
+   The enum item 0 is special and is used as terminator in some lists, thus
+   enums should not use this for "valid" entries (and start at 10000 instead).
+
 
 Doxygen
 -------
@@ -132,6 +144,14 @@ Doxygen
    Variables that are "static" don't need to be marked like this.
 
 
+Testsuite
+---------
+
+You can run the libsigrok testsuite using:
+
+ $ make check
+
+
 Release engineering
 -------------------