-/* 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, we 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.
+ */