I now realise that one of trail's modes is a bit flawed...

diff --git a/doc/plugins/contrib/trail.mdwn b/doc/plugins/contrib/trail.mdwn
index 52dea52d6b92ab7a7924ff0eaf38bc8b0171903b..eb233e095f8262bae9207e2d1c6cfe258d1c6f68 100644 (file)
--- a/doc/plugins/contrib/trail.mdwn
+++ b/doc/plugins/contrib/trail.mdwn
@@ -13,6 +13,17 @@ This plugin can benefit from
 [[another_of_my_branches|todo/inline_plugin:_specifying_ordered_page_names]]
 but does not require it.
 
+Bugs:
+
+* \[[!inline pages="..." trail=yes]] currently tries to work out
+  what pages are in the trail, and their order, at scan time. That
+  won't work, because matching a pagespec at scan time is
+  unreliable - pages we want might not have been scanned yet! I
+  haven't worked out a solution for this. I think
+  \[[!inline pagenames="..." trail=yes]]
+  ([[patch_required|todo/inline_plugin:_specifying_ordered_page_names]])
+  would be safe, though.
+
 ----
 
 [[!template id=plugin name=trail author="[[Simon_McVittie|smcv]]"]]