Preparing stable version
[geeqie.git] / CODING
diff --git a/CODING b/CODING
index 7750c14..2b443df 100644 (file)
--- a/CODING
+++ b/CODING
@@ -1,3 +1,16 @@
+Log Window:
+
+DEBUG_0()
+Use DEBUG_0() only for temporary debugging i.e. not in code in the repository.
+The user will then not see irrelevant debug output when the default
+debug level = 0 is used.
+
+log_printf()
+If the first word of the message is "error" or "warning" (case insensitive)
+the message will be color-coded appropriately.
+
+--------------------------------------------------------------------------------
+
 GPL header, in every file, like this:
 
 /** \file
@@ -11,7 +24,7 @@ GPL header, in every file, like this:
 
 /*
  *  This file is a part of Geeqie project (http://www.geeqie.org/).
- *  Copyright (C) 2008 - 2012 The Geeqie Team
+ *  Copyright (C) 2008 - 2016 The Geeqie Team
  *
  *  This program is free software; you can redistribute it and/or modify it
  *  under the terms of the GNU General Public License as published by the Free
@@ -26,10 +39,15 @@ GPL header, in every file, like this:
 
 --------------------------------------------------------------------------------
 
-svn change-log:
+git change-log:
 
+If referencing a Geeqie GitHub issue, include the issue number in the summary line.
 Start with a short summary in the first line (without a dot at the end) followed
-by a empty line. Use whole sentences begins with Capital letter. For each
+by a empty line.
+
+If referencing a Geeqie GitHub issue, include a hyperlink to the GitHub issue page
+in the message body.
+Use whole sentences begins with Capital letter. For each
 modification use new line. Or you can write the theme, colon and then every
 change on new line, begin with "- ".
 
@@ -45,6 +63,8 @@ Example:
    - the interface was modified
    - new functions were added
 
+Also please use your full name and a working e-mail address as author for any contribution.
+
 --------------------------------------------------------------------------------
 
 sources: