Error handling improvement for preprocess hooks. It's now safe to call error() from...

[ikiwiki.git] / doc / plugins / recentchanges.mdwn

diff --git a/doc/plugins/recentchanges.mdwn b/doc/plugins/recentchanges.mdwn
index 69073adf08d21851811c3d6928da4a647573239e..b48dcbacfb55353d4dacc23ea3cabab1f42ea5a5 100644 (file)
--- a/doc/plugins/recentchanges.mdwn
+++ b/doc/plugins/recentchanges.mdwn
@@ -5,12 +5,22 @@ generates a page describing each recent change made to the wiki. These
 pages can be joined together with [[inline]] to generate the
 [[RecentChanges]] page.
 
-Typically only the RecentChanges page will use the plugin, but you can
-use it elsewhere too if you like. It's used like this:
+Typically only the RecentChanges page will use the pages generated by this
+plugin, but you can use it elsewhere too if you like. It's used like this:
 
-       \[[recentchanges pages="*" num=100 template=change]]
        \[[inline pages="internal(recentchanges/change_*)"
        template=recentchanges show=0]]
 
-The pages describing recent changes will be created as [[subpages|subpage]]
-of the page where the `recentchanges` directive is placed.
+Here's an example of how to show only changes to "bugs/*".
+This matches against the title of the change, which includes a list of
+modified pages.
+
+       \[[inline pages="internal(recentchanges/change_*) and title(*bugs/*)"
+       template=recentchanges show=0]]
+
+Here's an example of how to show only changes that Joey didn't make.
+(Joey commits sometimes as user `joey`, and sometimes via openid.)
+       
+       \[[inline pages="internal(recentchanges/change_*) and
+       !author(joey) and !author(http://joey.kitenet.net*)"
+       template=recentchanges show=0]]