listdirectives: Enable use of the directives underlay.
[ikiwiki.git] / doc / plugins / listdirectives.mdwn
index 0f33855f5eb2e56a4dba2189aebfefe4ceab3504..2939ff0ee17e42a70ff58fca726ef23c110f5046 100644 (file)
@@ -1,21 +1,15 @@
 [[!template id=plugin name=listdirectives author="Will"]]
 [[!tag type/meta]]
 
-This plugin generates a list of available
-[[directives|ikiwiki/directive]].
-
-       \[[!listdirectives]]
-
-Each directive links to a wiki page with the same name. The location of the
-pages in the wiki can be controlled via the `directive_description_dir`
-setting in the setup file.
-
-There is one optional keyword argument, `generated`.  Normally the `listdirectives` directive will
-list all built in directives and directives directly registered by [[plugins]].  With this keyword,
-`listdirectives` will also list directives generated later.  For example, all [[shortcuts]] are
-directives generated in turn by the `shortcut` directive.  They will only be listed if the `generated` argument is
-supplied.
-
-    \[[!listdirectives generated]]
-
-This extended list is often quite long, and often contains many undocumented directives.
+This plugin provides the [[ikiwiki/directive/linkmap]]
+[[ikiwiki/directive]], which inserts a list of currently available
+directives into the page.
+
+Each directive links to a wiki page with the same name, that should
+document that directive. The location of these pages can be controlled via
+the `directive_description_dir` setting in the setup file, the default is
+"ikiwiki/directive/foo".
+
+When this plugin is enabled, it enables the directives underlay, which
+contains documentation about all the directives included in plugins shipped
+with ikiwiki. This adds about 200 kb to the size of your wiki.