web commit by joey
[ikiwiki] / doc / bugs.mdwn
1 * Has bugs updating things if the bestlink of a page changes due to
2   adding/removing a page. For example, if Foo/Bar links to "Baz", which is
3   Foo/Baz, and Foo/Bar/Baz gets added, it will update the links in Foo/Bar
4   to point to it, but will forget to update the linkbacks in Foo/Baz.
5   
6 * And if Foo/Bar/Baz is then removed, it forgets to update Foo/Bar to link
7   back to Foo/Baz.
8
9     -- is this still true? (Yes (as of 1.0))
10
11 * If I try to do a web commit, to a svn+ssh repo, it fails with
12   "Host key verification failed."
13   I think that the setuid isn't fully taking; it should be running as me,
14   but commit log shows www-data. So maybe it has the wrong username? Or
15   EUID/Real UID screwage.
16 * Can't put the source in a directory named .source; the page finder skips
17   that due to too broad exclusion of any dotfile in a path.
18 * [[ikiwiki]] should go to the same place as [[index]] (on this wiki).
19 * Web browsers don't word-wrap lines in submitted text, which makes editing a
20   page that someone wrote in a web browser annoying (`gqip` is vim user's
21   friend here). Is there any way to improve this?
22 * The diff links in RecentChanges go to a viewcvs backtrace if the rev in question is when the page was added. Is this a viewcvs bug, or a behavior ikiwiki needs to work around?
23     - As a special case, there should certianly be no history link for
24       pages generated from the underlaydir as it can never work for them.
25 * If a page stops inlining anthing, its rss feed file
26   will linger around and not be deleted.
27 * RSS output contains relative links. Ie. http://kitenet.net/~joey/blog/index.rss contains a link to http://kitenet.net/~joey/blog/../blog.html
28 * If a file in the srcdir is removed, exposing a file in the underlaydir,
29   ikiwiki will not notice the change and rebuild it until the file in the
30   underlaydir gets a mtime newer than the mtime the removed file had.
31 * ikiwiki will generate html formatted error messages to the command
32   line if --cgi is set, even if it's not yet running as a cgi
33 * if a page containing an rss feed happens to show up in an rss feed,
34   the preprocessor directives won't be expanded (good) but are left in
35   raw rather than removed (bad).
36 * add_depends() needs work. If there are two preprocessor directives on a page,   and one calls add_depends("foo"), while the other calls add_depends("* !foo"), the second one wins, page foo will not be matched by the appended globlist.
37
38   What it needs to do is be smarter about merging depends, so if "foo" is added to "!foo", it should yeild "foo"; adding "!foo" to "foo" should again yeild "foo". That's easy, what's hard is when there are globs involved and potentially partially overlapping included and excluded subsets..
39
40   A basic heuristic might be, when merging two globlists, if either contains negated expressions, remove those expressions. This is not ideal, it does avoid it skipping pages that should be in the merged list though.
41
42   A slightly smarter heuristic: When merging two globlists, find negated expressions, de-negate them, and test them to see if they match anything in the other globlist. If so, remove the negated expression, if not, keep. This would probably be good enough.