HACKING

   1 Naming conventions:
   2
   3 include files:
   4 - _lib: library without need for a process
   5 - _service: library that needs a service process
   6 - _plugin: plugin definition
   7 - _protocol: structs used in network protocol
   8 - exceptions:
   9   * GNUNET_config.h      --- generated // FIXME: decapitalize
  10   * platform.h           --- first included
  11   * plibc.h              --- external library
  12   * gnunet_common.h      --- fundamental routines
  13   * gnunet_directories.h --- generated
  14   * gettext.h            --- external library
  15
  16 configuration:
  17 - paths (that are substituted in all filenames) are in PATHS (have as few as possible)
  18 - globals for the daemon are in [gnunetd] (for now, have as few as possible!)
  19 - all options for a particular module (src/MODULE) are under [MODULE]
  20 - options for a plugin of a module are under [MODULE-PLUGINNAME]
  21 - options only for debugging / testing / profiling are under [TESTING],
  22   together with the options for the testing module itself
  23
  24
  25
  26 exported symbols:
  27 - must start with "GNUNET_modulename_" and be defined in "modulename.c"
  28 - exceptions: those defined in gnunet_common.h
  29
  30
  31 testcases:
  32 - must be called "test_module-under-test_case-description.c"
  33 - "case-description" maybe omitted if there is only one test
  34
  35
  36 performance tests:
  37 - must be called "perf_module-under-test_case-description.c"
  38 - "case-description" maybe omitted if there is only one performance test
  39
  40
  41
  42 src/ directories:
  43 - gnunet-NAME: end-user applications (i.e., gnunet-search, gnunet-arm)
  44 - gnunet-service-NAME: service processes with accessor library (i.e., gnunet-service-arm)
  45 - libgnunetNAME: accessor library (_service.h-header) or standalone library (_lib.h-header)
  46 - gnunet-daemon-NAME: daemon process without accessor library (i.e., gnunet-daemon-hostlist) and no GNUnet management port
  47 - libgnunet_plugin_DIR_NAME: loadable plugins (i.e., libgnunet_plugin_transport_tcp)
  48
  49
  50
  51 Minimum file-sharing system (in order of dependency):
  52 gnunet-service-arm
  53 gnunet-service-transport
  54 gnunet-service-core
  55 gnunet-daemon-hostlist
  56 gnunet-daemon-topology
  57 gnunet-service-datastore
  58 gnunet-service-statistics
  59 gnunet-service-dv
  60 gnunet-service-dht
  61 gnunet-service-fs (or just lib?)