clarify some bits I missed
document more internals, based on mailing list discussion

this should address #27, #28 and #29 at least at a basic level

it is mostly based on the mailing list discussion mentionned in #27,
with some reformatting and merging of different posts.
document the repo config file and more storage properties

again taken from the mailing list, mostly