diff --git a/development.ini b/development.ini
--- a/development.ini
+++ b/development.ini
@@ -2,7 +2,8 @@
 ###################################################################################
 ## Kallithea config file generated with kallithea-config                         ##
 ##                                                                               ##
-## The %(here)s variable will be replaced with the parent directory of this file ##
+## The %(here)s variable will generally be replaced with the parent directory of ##
+## this file. Other use of % must be escaped as %% .                             ##
 ###################################################################################
 ###################################################################################
 
diff --git a/kallithea/lib/paster_commands/template.ini.mako b/kallithea/lib/paster_commands/template.ini.mako
--- a/kallithea/lib/paster_commands/template.ini.mako
+++ b/kallithea/lib/paster_commands/template.ini.mako
@@ -3,7 +3,8 @@
 <%text>##</%text>#################################################################################
 <%text>##</%text> Kallithea config file generated with kallithea-config ${'%-24s' % version    }##
 <%text>##</%text>                                                                               ##
-<%text>##</%text> The %(here)s variable will be replaced with the parent directory of this file ##
+<%text>##</%text> The %(here)s variable will generally be replaced with the parent directory of ##
+<%text>##</%text> this file. Other use of % must be escaped as %% .                             ##
 <%text>##</%text>#################################################################################
 <%text>##</%text>#################################################################################