template change documentation

diff --git a/debian/NEWS b/debian/NEWS
index 983d1ae9d969044a20d2c0dff0c3150d930ab17f..9dd93c85e1aa9ece760386215ac0f92b4ba633af 100644 (file)
--- a/debian/NEWS
+++ b/debian/NEWS
@@ -1,3 +1,12 @@
+ikiwiki (2.46) unstable; urgency=low
+ 
+  There were some significant template changes in ikiwiki 2.42 (and 1.33.5).
+  If you have locally modified versions of the templates, they need to be
+  updated. Most notably, the editpage.tmpl has a new FIELD-SID added to it,
+  without which web editing will fail.
+ 
+ -- Joey Hess <joeyh@debian.org>  Tue, 06 May 2008 14:30:14 -0400
+
 ikiwiki (2.40) unstable; urgency=low
 
   ikiwiki now has an new syntax for preprocessor directives, using the

diff --git a/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn b/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
index bf0ce2de23d4ae564e97c6e70956396b882441df..d044ba57283204a7c86991f3c8e1a8e608c08170 100644 (file)
--- a/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
+++ b/doc/bugs/No___34__sid__34___in_forms_resulting_in_Error:_Your_login_session_has_expired..mdwn
@@ -34,3 +34,6 @@ View source of editing page or preview+edit page shows no "sid" input value. (I
        <p><b>This template is not up-to-date with the installed version of
        ikiwiki, and may not behave correctly until updated.</b></p>
        </TMPL_IF>
+
+> Well, that don't look like as good an idea today.. I've documented the
+> recent template change. --[[Joey]]

diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 82e443beabb41ac7e85055677e4e6eb1e86f3139..745f97cce4c246e14fcdc36676ee08c8b4276a33 100644 (file)
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -113,6 +113,11 @@ configuration options of their own.
   build time. If the templatedir is changed, missing templates will still
   be searched for in the default location as a fallback.
 
+  Note that if you choose to copy and modify ikiwiki's templates, you will need
+  to be careful to keep them up to date when upgrading to new versions of
+  ikiwiki. Old versions of templates do not always work with new ikiwiki
+  versions.
+
 * --underlaydir
 
   Specify the directory that is used to underlay the source directory.