# HG changeset patch
# User Thomas Waldmann <tw AT waldmann-edv DOT de>
# Date 1393684940 -3600
# Node ID a3900f360ad07828114ff6b79f8987b67a201e76
# Parent  784455464e93f5ea687ae8c0b542b94f9552a1c3
mail notification template string configuration: add examples

diff -r 784455464e93 -r a3900f360ad0 docs/CHANGES
--- a/docs/CHANGES	Sat Mar 01 02:27:26 2014 +0100
+++ b/docs/CHANGES	Sat Mar 01 15:42:20 2014 +0100
@@ -95,6 +95,30 @@
     * If you overwrite the strings in your configuration moin will still try to
       translate your strings, but it will only find translations if you add them
       to the gettext catalogs, too.
+    * Examples:
+
+      a) notification mail body: you don't want the rendered diff, you don't
+         want to link to the diff, but to the full page view on your wiki.
+
+      # original (default) value
+      mail_notify_page_text = '%(intro)s%(difflink)s\n\n%(comment)s%(diff)s'
+      # put this in your wiki config
+      mail_notify_page_text = '%(intro)s%(pagelink)s\n\n%(comment)s'
+
+      b) notification mail subject:
+      # original (default) value
+      mail_notify_page_changed_subject = '[%(sitename)s] %(trivial)sUpdate of "%(pagename)s" by %(username)s'
+
+      c) notification mail intro:
+      # original (default) value
+      mail_notify_page_changed_intro = \
+          ("Dear Wiki user,\n\n"
+           'You have subscribed to a wiki page or wiki category on "%(sitename)s" for change notification.\n\n'
+           'The "%(pagename)s" page has been changed by %(editor)s:\n')
+
+      Note: if you change "*_page_changed_*", you likely also want to change
+      "*_page_deleted_*" and "*_page_renamed_*", maybe even "*_att_added_*"
+      and "*_att_removed_*".
 
   Fixes:
   * do not create empty pagedirs (with empty edit-log). To clean up all the