summaryrefslogtreecommitdiff
path: root/doc/coding-style.txt
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2015-03-27 19:58:40 +0100
committerChristian Grothoff <christian@grothoff.org>2015-03-27 19:58:40 +0100
commiteae1896a4bfc02b5d7586f81bbedfea69b29acc8 (patch)
treec3927c09435b74fb547a37fe0c75d01dd7b7f234 /doc/coding-style.txt
parent7730a083494c0d49705f87b32fc85dfa6ed6809a (diff)
downloadexchange-eae1896a4bfc02b5d7586f81bbedfea69b29acc8.tar.gz
exchange-eae1896a4bfc02b5d7586f81bbedfea69b29acc8.tar.bz2
exchange-eae1896a4bfc02b5d7586f81bbedfea69b29acc8.zip
major rename-fest for more constent symbol names
Diffstat (limited to 'doc/coding-style.txt')
-rw-r--r--doc/coding-style.txt6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/coding-style.txt b/doc/coding-style.txt
index e9c3a3138..093e14d31 100644
--- a/doc/coding-style.txt
+++ b/doc/coding-style.txt
@@ -43,13 +43,17 @@ Naming conventions:
+ must start with TALER_[SUBSYSTEMNAME]_ where SUBSYSTEMNAME
MUST match the subdirectory of src/ in which the symbol is defined
+ from libtalerutil start just with TALER_, without subsystemname
+ + if scope is ONE binary and symbols are not in a shared library,
+ use binary-specific prefix (such as TMH = taler-mint-httpd) for
+ globals, possibly followed by the subsystem (TMH_DB_xxx).
* structs:
+ structs that are 'packed' and do not contain pointers and are
thus suitable for hashing or similar operations are distinguished
by adding a "P" at the end of the name. (NEW) Note that this
convention does not hold for the GNUnet-structs (yet).
-
+ + structs that are used with a purpose for signatures, additionally
+ get an "S" at the end of the name.
* private (library-internal) symbols (including structs and macros)
+ must not start with TALER_ or any other prefix