clarify when to use utlto and when to use htmlpage

suggestion from smcv

diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn
index 349a8a1ed3048915918426b1cd7555f82e88acd8..1cdea6a774b87a7eee6ef1aa2e4a619c312cafb9 100644 (file)
--- a/doc/plugins/write.mdwn
+++ b/doc/plugins/write.mdwn
@@ -522,6 +522,9 @@ parameters are passed to `HTML::Template->new`.
 Passed a page name, returns the base name that will be used for a the html
 page created from it. (Ie, it appends ".html".)
 
+Use this when constructing the filename of a html file. Use `urlto` when
+generating a link to a page.
+
 #### `add_depends($$)`
 
 Makes the specified page depend on the specified [[ikiwiki/PageSpec]].