-/* Duplicate a path, with backslashes translated into forward slashes; return
- * empty string for NULL input; also strip leading and trailing slashes. */
+/*
+ * canonicalize_wim_path() - Given a user-provided path to a file within a WIM
+ * image, translate it into a "canonical" path.
+ *
+ * To do this, translate all supported path separators (is_any_path_separator())
+ * into the WIM_PATH_SEPARATOR, and strip any leading and trailing slashes. The
+ * returned string is allocated. Note that there still may be consecutive path
+ * separators within the string. Furthermore, the string may be empty, which
+ * indicates the root dentry of the WIM image.
+ */