summaryrefslogtreecommitdiff
path: root/doc/plugins
diff options
context:
space:
mode:
authorJoey Hess <joey@gnu.kitenet.net>2010-04-07 00:01:38 -0400
committerJoey Hess <joey@gnu.kitenet.net>2010-04-07 00:09:22 -0400
commitd58444a3e956e329cea4cbcdddcba99664ee585e (patch)
tree356d5da8e3ba12e42246f299e97291aa595d7147 /doc/plugins
parent196851d4e2ff608e80855ae6ba12178a24595e5b (diff)
note about sort and dependency types
There's a gotcha where pagespec_match_list is used with a dependency type that is not a full content dependency, and so ikiwiki does not know that a content change to a page that sorted too low to match needs to trigger a rebuild, since its sort order may have changed. Inline is mostly ok re this, as it does use content dependencies. Except for in the case of raw mode. But then, page metadata is documented to not be loaded, so it doesn't make sense to use sortspecs that depend on metadata. I hope. :)
Diffstat (limited to 'doc/plugins')
-rw-r--r--doc/plugins/write.mdwn5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn
index 05ddf2215..707622956 100644
--- a/doc/plugins/write.mdwn
+++ b/doc/plugins/write.mdwn
@@ -734,7 +734,10 @@ Additional named parameters can be specified:
* `filter` is a reference to a function, that is called and passed a page,
and returns true if the page should be filtered out of the list.
* `sort` specifies a sort order for the list. See
- [[ikiwiki/PageSpec/sorting]] for the avilable sort methods.
+ [[ikiwiki/PageSpec/sorting]] for the avilable sort methods. Note that
+ if a sort method is specified that depends on the
+ page content (such as 'meta(foo)'), the deptype needs to be set to
+ a content dependency.
* `reverse` if true, sorts in reverse.
* `num` if nonzero, specifies the maximum number of matching pages that
will be returned.