cleanup, docs

site/doc/pages/dirname.txt

@@ -2,14 +2,16 @@
 String dirname(String fn)
 
 :params
-fn : raw filename
-return value : the directory's name
+fn : a path
+return value : the directory portion of the path
+
+:content
+Returns everything in a path except the final component — i.e. the containing directory.
+
+:example
+print(dirname("/var/www/site/index.uce"), "\n");
 
 :see
 >sys
-
-:content
-Isolates the directory component from a path or file name.
-
-:example
-print("dirname example\n");
+basename
+path_join