Here I copied the blog post announcing the library, because it describes
it very well, and not everyone who discovers the library will know where
to look for such a comprehensive description.
http://chrisdone.com/posts/path-package
I've made two edits to that post to reflect new things:
1. On line 123 there is a mention of ‘fromAbsDir’ and other similar
functions.
2. On line 363 I've put a link to my ‘path-io’ package that provides
well-typed interface to ‘directory’ and ‘temporary’. I've written the
package for my personal needs, because I was tired of the endless
conversion and I wanted things like recursive copying of
directories. When I published it, someone opened an issue asking to
add some functions from Stack's ‘Path.IO’ — that's what I'm going to
do. I expect it will be able to replace ‘Path.IO’ in Stack soon. I've
talked to Stack maintainers and they like the package and have
nothing against the switch.
This helps to “double check” programmers' assumptions about what kind of
path he is converting into ‘FilePath’. Without these synonyms it's
possible to silently convert wrong type of path into ‘FilePath’.
The properties for stripDir and parent used the name 'parent' as a
variable.
The properties for filename and dirname seemed to be wrong and also used
'parent' as a variable.