X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/4a43b45f7956f1b472e0e2f2689263f2cc3e0da8..bde5f35b7bfbab8c97512a23f6ec79f5ed40a223:/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn

diff --git a/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn b/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn
index a2ec66afc..0f623828a 100644
--- a/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn
+++ b/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn
@@ -5,13 +5,19 @@ any feed.
 I found that the problem only occurs in the presence of a file that
 contains \[[inline pages="*"]].
 
+> How is this unexpected? By inlining _every_ page in the wiki, you're
+> making that page depend on every other page; any change to any page in
+> the wiki will result in the inlining page and its rss feed needing to be
+> updated to include the changed page.
+> --[[Joey]]
+
 Here's a short script for replicating the bug. Just cut and paste this
 to a shell, (it will only muck in a new /tmp/ikiwiki-test directory
 that it will create):
 
 	cd /tmp
 	mkdir ikiwiki-test; cd ikiwiki-test; mkdir src
-	echo '[[inline pages="blog/*"]]' > src/myblog.mdwn
+	echo '\[[inline pages="blog/*"]]' > src/myblog.mdwn
 	mkdir src/blog; echo "A blog entry" > src/blog/entry.mdwn
 	echo 'use IkiWiki::Setup::Standard {
 		srcdir => "src",
@@ -29,7 +35,7 @@ that it will create):
 	echo "not a blog entry" > src/not-a-blog.mdwn
 	ikiwiki --setup setup
 	ls -l --time-style=full-iso output/myblog/index.rss
-	echo '[[inline pages="*"]]' > src/archives.mdwn
+	echo '\[[inline pages="*"]]' > src/archives.mdwn
 	ikiwiki --setup setup
 	ls -l --time-style=full-iso output/myblog/index.rss
 	echo "still not blogging" >> src/not-a-blog.mdwn
@@ -46,7 +52,7 @@ Here's the tail of the output that I see for this command:
 	done
 	$ ls -l --time-style=full-iso output/myblog/index.rss
 	-rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:36.000000000 -0700 output/myblog/index.rss
-	$ echo '[[inline pages="*"]]' > src/archives.mdwn
+	$ echo '\[[inline pages="*"]]' > src/archives.mdwn
 	$ ikiwiki --setup setup
 	refreshing wiki..
 	scanning archives.mdwn