X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=HACKING;h=ecd9e6adb1b8769c3eea63d570173eb234dd7edb;hb=f417e32084ea739718d57e58cb7e39ae7795581f;hp=5008b49ce2507502015486837f61517d4504094c;hpb=4f64cda2fd1594d6fcb419707e652d0811111086;p=oweals%2Fgnunet.git

diff --git a/HACKING b/HACKING
index 5008b49ce..ecd9e6adb 100644
--- a/HACKING
+++ b/HACKING
@@ -6,13 +6,23 @@ include files:
 - _plugin: plugin definition
 - _protocol: structs used in network protocol
 - exceptions:
-  * GNUNET_config.h      --- generated // FIXME: decapitalize
+  * gnunet_config.h      --- generated
   * platform.h           --- first included
   * plibc.h              --- external library
   * gnunet_common.h      --- fundamental routines
   * gnunet_directories.h --- generated
   * gettext.h            --- external library
 
+
+binaries:
+- gnunet-service-xxx: service process (has listen socket)
+- gnunet-daemon-xxx: daemon process (no listen socket)
+- gnunet-helper-xxx[-yyy]: SUID helper for module xxx
+- gnunet-yyy: command-line tool for end-users
+- libgnunet_plugin_xxx_yyy.so: plugin for API xxx
+- libgnunetxxx.so: library for API xxx
+
+
 configuration:
 - paths (that are substituted in all filenames) are in PATHS (have as few as possible)
 - globals for the daemon are in [gnunetd] (for now, have as few as possible!)
@@ -22,11 +32,11 @@ configuration:
   together with the options for the testing module itself
 
 
-
 exported symbols:
 - must start with "GNUNET_modulename_" and be defined in "modulename.c"
 - exceptions: those defined in gnunet_common.h
 
+
 private (library-internal) symbols (including structs & macros):
 - must NOT start with any prefix
 - must not be exported in a way that linkers could use them or
@@ -43,7 +53,7 @@ testcases:
 performance tests:
 - must be called "perf_module-under-test_case-description.c"
 - "case-description" maybe omitted if there is only one performance test
-
+- Must only be run if HAVE_BENCHMARKS is satisfied
 
 
 src/ directories:
@@ -54,6 +64,36 @@ src/ directories:
 - libgnunet_plugin_DIR_NAME: loadable plugins (i.e., libgnunet_plugin_transport_tcp)
 
 
+Coding style:
+- GNU guidelines apply
+- declare only one variable per line, so 
+
+  int i;
+  int j;
+
+  instead of
+
+  int i,j;
+
+
+Build-system:
+
+If you have code that is likely not to compile or build rules you might want to not
+trigger for most developers, use "if HAVE_EXPERIMENTAL" in your Makefile.am.  Then
+it is OK to (temporarily) add non-compiling (or known-to-not-port) code.
+
+If you want to compile all testcases but NOT run them, run configure with the
+--enable-test-suppression option.
+
+If you want to run all testcases, including those that take a while, run configure with the
+--enable-expensive-testcases option.
+
+If you want to compile and run benchmarks, run configure with the
+--enable-benchmarks option.
+
+If you want to obtain code coverage results, run configure with the
+--enable-coverage option and run the coverage.sh script in contrib/.
+
 
 Minimum file-sharing system (in order of dependency):
 gnunet-service-arm
@@ -61,8 +101,8 @@ gnunet-service-transport
 gnunet-service-core
 gnunet-daemon-hostlist
 gnunet-daemon-topology
-gnunet-service-datastore
 gnunet-service-statistics
-gnunet-service-dv
+gnunet-service-datastore
+gnunet-service-datacache
 gnunet-service-dht
-gnunet-service-fs (or just lib?)
+gnunet-service-fs