fixed makepath creation, added/updated some documentation

makepath was broken. It only raised errors if the first directories of a full path could not be created. The last element to be created would return nil + errmsg if it failed.

Now consistent; always true on success, nil + error on failure.

additionally documented some 'pass-through' functions from lfs