# HG changeset patch
# User Mads Kiilerich <mads@kiilerich.com>
# Date 2020-05-22 15:10:00
# Node ID 0f3a584edcb382e8426dd85443fd7dc85326b31c
# Parent  642e6d7d18c4740b9aa4c7d15bf7720bc0f956da

ini: explain how % must be escaped as %% (Issue #375)

Gearbox / paste would fail with:
  configparser.InterpolationSyntaxError: '%' must be followed by '%' or '('

The special handling of % is standard configparser behaviour, unless explicitly
fetching raw settings.

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>#################################################################################