--- wikisrc/templates/man.mdwn	2009/10/21 20:12:11	1.13
+++ wikisrc/templates/man.mdwn	2009/11/08 23:00:30	1.14
@@ -1,9 +1,28 @@
 <TMPL_IF NAME="name">[<TMPL_VAR NAME="name"><TMPL_IF NAME="section">\(<TMPL_VAR NAME="section">\)</TMPL_IF>](http://netbsd.gw.com/cgi-bin/man-cgi?<TMPL_VAR ESCAPE=URL NAME="name">+<TMPL_IF NAME="section"><TMPL_VAR ESCAPE=URL NAME="section"></TMPL_IF><TMPL_IF NAME="arch">.<TMPL_VAR ESCAPE=URL NAME="arch"></TMPL_IF>+<TMPL_VAR ESCAPE=URL NAME="collection" DEFAULT="NetBSD-current">)<TMPL_ELSE>
-Use this template to create a manpage link. The template can use four parameters:
-<ul>
-<li>`name` - This required parameter is the name of the manpage.</li>
-<li>`section` - This recommended parameter is the manpage section.</li>
-<li>`arch` - This optional parameter is the machine architecture.</li>
-<li>`collection` - This optional parameter refers to the NetBSD version and defaults to "NetBSD-current".</li>
-</ul>
+## Description
+
+Use this template to create a man page link. The template can use four parameters:
+
+* *name* - This required parameter is the name of the manpage.</li>
+* *section* - This recommended parameter is the manpage section.</li>
+* *arch* - This optional parameter is the machine architecture.</li>
+* *collection* - This optional parameter refers to the NetBSD version and defaults to "NetBSD-current".</li>
+
+## Examples
+
+Link to [[!template id=man name="ls"]] man page:
+
+        \[[!template id=man name="ls"]]
+
+Link to [[!template id=man name="ls" section="1"]] man page, with section:
+
+        \[[!template id=man name="ls" section="1"]]
+
+Link to [[!template id=man name="ls" section="1" arch="i386"]] man page, specifying section and architecture:
+
+        \[[!template id=man name="ls" section="1" arch="i386"]]
+
+Link to [[!template id=man name="ls" section="1" arch="i386" collection="NetBSD-5.0"]] man page, specifying section, architecture and collection:
+
+        \[[!template id=man name="ls" section="1" arch="i386" collection="NetBSD-5.0"]]
 </TMPL_IF>