* Patch based on a patch from Ethan to support relative matching in

[ikiwiki.git] / basewiki / pagespec.mdwn

diff --git a/basewiki/pagespec.mdwn b/basewiki/pagespec.mdwn
index 0890e399f1b429676553427bf2862920a00799e8..53519e7f02d798976311c847beca3c8e188e1891 100644 (file)
--- a/basewiki/pagespec.mdwn
+++ b/basewiki/pagespec.mdwn
@@ -1,6 +1,6 @@
 To select a set of pages, such as pages that are locked, pages
 whose commit emails you want subscribe to, or pages to combine into a
-[[blog]], the wiki uses a PageSpec. This is an expression that matches
+blog, the wiki uses a PageSpec. This is an expression that matches
 a set of pages.
 
 The simplest PageSpec is a simple list of pages. For example, this matches
@@ -45,6 +45,12 @@ of two tags, use:
 
        blog/* and (link(tag/foo) or link(tag/bar))
 
+Note that page names in PageSpecs are matched against the absolute
+filenames of the pages in the wiki, so a pagespec "foo" used on page
+"a/b" will not match a page named "a/foo" or "a/b/foo". To match
+relative to the directory of the page containing the pagespec, you can
+use "./". For example, "./foo" on page "a/b" matches page "a/foo".
+
 ## Old syntax
 
 The old PageSpec syntax was called a "GlobList", and worked differently in