Document full API

This adds the documentation for the remaining bits of the API and
also fixes some smaller issues. It documents:

* Rationale and options of use_give_filesystem
* given_directory_from_data
* Path elements in name parameters
Simplify code
Fix typo
Clarification about scope of test directories