Improve `normalize` docs
@@ -216,9 +216,11 @@ normalize = toHsFnPrecursor Path.normalise
#? T.unlines
[ "Normalizes a path."
, ""
- , "- `//` outside of the drive can be made blank"
- , "- `/` becomes the `path.separator`"
- , "- `./` -> \'\'"
+ , " - `//` makes sense only as part of a (Windows) network drive;"
+ , " elsewhere, multiple slashes are reduced to a single"
+ , " `path.separator` (platform dependent)."
+ , " - `/` becomes `path.separator` (platform dependent)."
+ , " - `./` is removed."
, " - an empty path becomes `.`"
]
