diff options
Diffstat (limited to 'documentation/STYLE')
-rw-r--r-- | documentation/STYLE | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/documentation/STYLE b/documentation/STYLE new file mode 100644 index 0000000..32799f6 --- /dev/null +++ b/documentation/STYLE @@ -0,0 +1,23 @@ +@@ write "t: p" instead of "t : p" or "t :p" + +@@ write $(call f,a) instead of $(call f, a) or $(call f , a) + +@@ Use '-' to separate words in function names (e.g. foo-bar); + use 'define' to define functions. + +@@ Use '_' to separate words in variable names (e.g. foo_bar); + use := to assign value to a variable. Use '=' if you know + what you are doing. + +@@ Be careful with += in target-specific variables. + +@@ Action explicitly requested by the user (which should correspond + to verbs, e.g. install, clean, configure) should perform without + regards to up-to-dateness. + +@@ Use verbs for .PHONY targets. There is one notable exception:... + +@! maybe declare `__' variable prefix reserved? + +@@ Use directory name as a default phony target in directory makefiles. + (explain why).
\ No newline at end of file |