docs

diff --git a/doc/ikiwiki/directive/trailitems.mdwn b/doc/ikiwiki/directive/trailitems.mdwn
index 387b403b9f6b8cbee7637d5e0937a7f287161d19..821b40ecd0c11c4c5e3e7e2fc96d6beca9a0378d 100644 (file)
--- a/doc/ikiwiki/directive/trailitems.mdwn
+++ b/doc/ikiwiki/directive/trailitems.mdwn
@@ -7,6 +7,9 @@ on that page.
 
     \[[!trailitems pagenames="a b c"]]
 
+Note that if the directive includes the current page in the trail, a trail
+will be produced that has forward and back links, but no link "up".
+
 Options are similar to [[!iki ikiwiki/directive/inline desc=inline]]:
 
 * `pages`: adds pages that match a [[ikiwiki/PageSpec]] to the trail