summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn74
-rw-r--r--doc/bugs/Command-line_arguments_should_override_settings_in_the_setup_file.mdwn5
-rw-r--r--doc/bugs/Insecure_dependency_in_eval_while_running_with_-T_switch.mdwn7
-rw-r--r--doc/bugs/disabling_backlinks.mdwn3
-rw-r--r--doc/bugs/index.html__63__updated.mdwn16
5 files changed, 28 insertions, 77 deletions
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
deleted file mode 100644
index 0f623828a..000000000
--- a/doc/bugs/A_page_that_inlines_pages__61____34____42____34___results_in_unnecessary_feed_generation.mdwn
+++ /dev/null
@@ -1,74 +0,0 @@
-I noticed when generating my wiki that all of my RSS feeds were
-getting regenerated even when I edited only a page that did not affect
-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
- mkdir src/blog; echo "A blog entry" > src/blog/entry.mdwn
- echo 'use IkiWiki::Setup::Standard {
- srcdir => "src",
- destdir => "output",
- url => "http://example.com",
- templatedir => "/dev/null",
- underlaydir => "/dev/null",
- rss => 1,
- wrappers => [],
- verbose => 1,
- refresh => 1
- }' > setup
- ikiwiki --setup setup
- ls -l --time-style=full-iso output/myblog/index.rss
- 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
- ikiwiki --setup setup
- ls -l --time-style=full-iso output/myblog/index.rss
- echo "still not blogging" >> src/not-a-blog.mdwn
- ikiwiki --setup setup
- ls -l --time-style=full-iso output/myblog/index.rss
-
-Here's the tail of the output that I see for this command:
-
- $ echo "not a blog entry" > src/not-a-blog.mdwn
- $ ikiwiki --setup setup
- refreshing wiki..
- scanning not-a-blog.mdwn
- rendering not-a-blog.mdwn
- 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
- $ ikiwiki --setup setup
- refreshing wiki..
- scanning archives.mdwn
- rendering archives.mdwn
- done
- $ ls -l --time-style=full-iso output/myblog/index.rss
- -rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:37.000000000 -0700 output/myblog/index.rss
- $ echo "still not blogging" >> src/not-a-blog.mdwn
- $ ikiwiki --setup setup
- refreshing wiki..
- scanning not-a-blog.mdwn
- rendering not-a-blog.mdwn
- rendering archives.mdwn, which depends on not-a-blog
- done
- $ ls -l --time-style=full-iso output/myblog/index.rss
- -rw-r--r-- 1 cworth cworth 459 2007-06-01 06:34:38.000000000 -0700 output/myblog/index.rss
-
-It looks like the rendering of archives.mdwn is also silently
-generating myblog/index.rss.
diff --git a/doc/bugs/Command-line_arguments_should_override_settings_in_the_setup_file.mdwn b/doc/bugs/Command-line_arguments_should_override_settings_in_the_setup_file.mdwn
index 36387a8c9..c93cdc6ad 100644
--- a/doc/bugs/Command-line_arguments_should_override_settings_in_the_setup_file.mdwn
+++ b/doc/bugs/Command-line_arguments_should_override_settings_in_the_setup_file.mdwn
@@ -16,8 +16,13 @@ So two suggestions to fix this:
1. Make command-line arguments override settings in the setup file
+> This is difficult to do, since reading a setup file replaces values for
+> config items with the values in the setup file.
+
2. Comment out all settings in the example setup file that are simply
setting options to their default values. That way, the file will
still be self-documenting, but command-line arguments will at least
work for these settings while they remain commented out.
+> I've done that, I also fixed some issues with --verbose handling earlier.
+> --[[Joey]]
diff --git a/doc/bugs/Insecure_dependency_in_eval_while_running_with_-T_switch.mdwn b/doc/bugs/Insecure_dependency_in_eval_while_running_with_-T_switch.mdwn
index 201d7fbec..28b48e2c6 100644
--- a/doc/bugs/Insecure_dependency_in_eval_while_running_with_-T_switch.mdwn
+++ b/doc/bugs/Insecure_dependency_in_eval_while_running_with_-T_switch.mdwn
@@ -90,4 +90,9 @@ to break the code I distribute in my backport ;)
>> BTW, I was quite sure that you sent me the old patch via e-mail long time ago.
>> Maybe I found it at old ikiwiki home page? I don't remember it now.
>>
->> --[[Paweł|ptecza]] \ No newline at end of file
+>> --[[Paweł|ptecza]]
+
+----
+
+I'm marking this [[done]] since it only affects sarge. Sarge users should
+use the patch above. --[[Joey]]
diff --git a/doc/bugs/disabling_backlinks.mdwn b/doc/bugs/disabling_backlinks.mdwn
index 0a1963bc3..74b25f0f0 100644
--- a/doc/bugs/disabling_backlinks.mdwn
+++ b/doc/bugs/disabling_backlinks.mdwn
@@ -10,4 +10,5 @@ My first reading (and second and third) of this was that backlinks would be disa
--[[KarlMW]]
> Yes, it only controls the number of backlinks that are shown at the
-> bottom of the page vs how many are moved to the popup --[[Joey]]
+> bottom of the page vs how many are moved to the popup. I've tried to
+> improve the documentation for this. [[done]] --[[Joey]]
diff --git a/doc/bugs/index.html__63__updated.mdwn b/doc/bugs/index.html__63__updated.mdwn
index 84aac9b59..e56bd7941 100644
--- a/doc/bugs/index.html__63__updated.mdwn
+++ b/doc/bugs/index.html__63__updated.mdwn
@@ -1 +1,15 @@
-After editing a page `pagename`, ikiwiki redirects to `pagename/index.html?updated`. Ignoring for the moment that ?updated seems like a bad idea to begin with, this should at least not introduce /index.html into the URL. \ No newline at end of file
+After editing a page `pagename`, ikiwiki redirects to `pagename/index.html?updated`. Ignoring for the moment that ?updated seems like a bad idea to begin with, this should at least not introduce /index.html into the URL.
+
+> The "?updated" works around caching issues with certain broken browsers,
+> web proxys, and/or webservers. These assume that since the "?" is there,
+> the page is not static, or is a different page, thus forcing the page to
+> be reloaded and the edited version seen. So no, not a bad idea, really.
+>
+> Removing the index.html would probably break this workaround.
+> http://foo/bar/?updated will redirect to http://foo/bar/index.html, and
+> said broken software will then display its old out of date cached
+> version.
+>
+> So, not changing this. [[tag done]]
+>
+> --[[Joey]]