add warnings about using map, inline, etc with the sidebar causing

[ikiwiki.git] / 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 a2ec66afc81cac72f89e06a1a5ac2d5c1be5b472..0f623828a6c29a835bf5d008e1bea69d49f43a24 100644 (file)
--- 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