comment

1 files changed, 8 insertions, 0 deletions

diff --git a/src/path.rs b/src/path.rs
index 7a81873..56855ac 100644
--- a/src/path.rs
+++ b/src/path.rs
@@ -1,3 +1,11 @@
+/*
+ *   We implement most aspects of paths independently, not relying on
+ * std::path, on the theory that path syntax is such an important part of a
+ * shell that it doesn't make sense to try to integrate with non-Unix syntaxes.
+ * However, we do use std::path to print individual path components, in order
+ * to get the benefit of its functionality for handling non-Unicode filenames.
+ */
+
 use crate::prelude::*;
 
 lalrpop_mod!(pub parser, "/path/parser.rs");