Merge commit 'remotes/smcv/ready/inline-pagenames' into staging

[ikiwiki.git] / doc / ikiwiki / directive / tag.mdwn

diff --git a/doc/ikiwiki/directive/tag.mdwn b/doc/ikiwiki/directive/tag.mdwn
index a6e1833a44baa14df10c20868800e62d58a3f53e..64736f8cddfd0ec31ad05231a19f01e7df28dfc6 100644 (file)
--- a/doc/ikiwiki/directive/tag.mdwn
+++ b/doc/ikiwiki/directive/tag.mdwn
@@ -1,4 +1,4 @@
-The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag]] plugin.
+The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag desc=tag]] plugin.
 
 These directives allow tagging pages. List tags as follows:
 
@@ -21,6 +21,10 @@ located under a base directory, such as "tags/". This is a useful way to
 avoid having to write the full path to tags, if you want to keep them
 grouped together out of the way.
 
+Bear in mind that specifying a tagbase means you will need to incorporate it
+into the `link()` [[ikiwiki/PageSpec]] you use: e.g., if your tagbase is
+`tag`, you would match pages tagged "foo" with `link(tag/foo)`.
+
 If you want to override the tagbase for a particular tag, you can use
 something like this: