Self-review...

diff --git a/doc/plugins/contrib/album.mdwn b/doc/plugins/contrib/album.mdwn
index f550ca64cbc54309c7439368950f7af3e2204ec2..395c99bcecdc57b626c2c175bb166a6e3d5173da 100644 (file)
--- a/doc/plugins/contrib/album.mdwn
+++ b/doc/plugins/contrib/album.mdwn
@@ -65,6 +65,13 @@ The next/previous links are themselves implemented by
 photo, using a special template (by default `albumnext.tmpl`
 or `albumprev.tmpl`), in `archive`/`quick` mode.
 
+> With hindsight, using an inline here is wrong - I should just
+> run hooks and fill in the template within the album plugin.
+> inline has some specialized functionality that's overkill
+> here, and its delayed HTML substitution breaks the ability
+> to have previous/up/next links both above and below the
+> photo, for instance. --[[smcv]]
+
 ## Writing the album
 
 The album contains one `\[[!album]]` directive. It may also