cleanup, docs

site/doc/pages/expand_path.txt

@@ -2,15 +2,17 @@
 String expand_path(String path, String relative_to_path = "")
 
 :params
-path : a relative path
-relative_to_path : optional, expand relative to this path (if not given, the current path is used)
-return value : expanded version of the 'path'
+path : path to expand
+relative_to_path : base directory a relative `path` is resolved against
+return value : the expanded path
+
+:content
+Expands a path: a relative `path` is resolved against `relative_to_path` (or the current unit's directory when that is empty), producing a normalized path you can hand to the file APIs.
+
+:example
+print(expand_path("sub/page.uce", "/var/www/site"), "\n");
 
 :see
 >sys
-
-:content
-Converts a relative path name into an absolute path, using the current working directory as a base when `relative_to_path` is not provided.
-
-:example
-print("expand_path example\n");
+path_join
+path_real