From: Christian Grothoff <christian@grothoff.org>
Date: Mon, 10 Oct 2011 13:28:26 +0000 (+0000)
Subject: new convention
X-Git-Tag: initial-import-from-subversion-38251~16660
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=95602b60adc7adfe634f67ee74f6dc08dbae678c;p=oweals%2Fgnunet.git

new convention
---

diff --git a/HACKING b/HACKING
index 82de084c9..bdbfd96bd 100644
--- a/HACKING
+++ b/HACKING
@@ -22,6 +22,17 @@ binaries:
 - libgnunet_plugin_xxx_yyy.so: plugin for API xxx
 - libgnunetxxx.so: library for API xxx
 
+logging:
+- services and daemons use their directory name in GNUNET_log_setup (i.e. 'core')
+  and log using plain 'GNUNET_log'.
+- command-line tools use their full name in GNUNET_log_setup (i.e. 'gnunet-publish')
+  and log using plain 'GNUNET_log'.
+- service access libraries log using 'GNUNET_log_from' and use 
+  'DIRNAME-api' for the component (i.e. 'core-api')
+- pure libraries (without associated service) use 'GNUNET_log_from' with
+  the component set to their library name (without lib
+  or '.so'), which should also be their directory name (i.e. 'nat')
+
 
 configuration:
 - paths (that are substituted in all filenames) are in PATHS (have as few as possible)