test alternative header link name

[git.ikiwiki.info.git] / doc / bugs / underlaydir_file_expose.mdwn

diff --git a/doc/bugs/underlaydir_file_expose.mdwn b/doc/bugs/underlaydir_file_expose.mdwn
index c827c6dd85b8b8d4cf7ffec25849d80df4000393..4ee30e39d9cac966e319b8619c127cda4d9e3aaf 100644 (file)
--- a/doc/bugs/underlaydir_file_expose.mdwn
+++ b/doc/bugs/underlaydir_file_expose.mdwn
@@ -1,4 +1,13 @@
 If a file in the srcdir is removed, exposing a file in the underlaydir,
 If a file in the srcdir is removed, exposing a file in the underlaydir,

-ikiwiki will notice the removal and delete the page from the destdir. The
+ikiwiki will not notice the removal, and the

 page from the underlay will not be built. (However, it will be if the wiki
 gets rebuilt.)
 page from the underlay will not be built. (However, it will be if the wiki
 gets rebuilt.)

+
+> This problem is caused by ikiwiki storing only filenames relative to
+> the srcdir or underlay, and mtime comparison not handling this case.
+
+> A related problem occurs if changing a site's theme with the
+> [[plugins/theme]] plugin. The style.css of the old and new theme
+> often has the same mtime, so ikiwiki does not update it w/o a rebuild.
+> This is worked around in theme.pm with a special-purpose needsbuild hook.
+> --[[Joey]]