X-Git-Url: https://sigrok.org/gitweb/?p=libsigrok.git;a=blobdiff_plain;f=HACKING;h=d89f4a32b8ec1a70a8987e1c2021f8c3a57dd322;hp=cd7e26556d010ec6034e2c45fcecf9c2f79ca9f7;hb=b4bd70889f3009f5d836a9bf701725a6aceac039;hpb=5b30cca719b737fed96c00e1b7a5094770d9d815

diff --git a/HACKING b/HACKING
index cd7e2655..d89f4a32 100644
--- a/HACKING
+++ b/HACKING
@@ -71,10 +71,22 @@ Random notes
    should end with "_all", e.g. "_remove_all", "_get_all", and so on.
    Use "_remove_all" in favor of "_clear" for consistency.
 
+
+Doxygen
+-------
+
  - In Doxygen comments, put an empty line between the block of @param lines
    and the final @return line. The @param lines themselves (if there is more
    than one) are not separated by empty lines.
 
+ - Mark private functions (SR_PRIV) with /** @private */, so that Doxygen
+   doesn't include them in the output. Functions that are "static" anyway
+   don't need to be marked like this.
+
+ - Mark private variables/#defines with /** @cond PRIVATE */ and
+   /** @endcond */, so that Doxygen doesn't include them in the output.
+   Variables that are "static" don't need to be marked like this.
+
 
 Release engineering
 -------------------