Rewrite the man page for direnv-stdlib(1) and the inline doc. Fixes #76

@pwaller do you want to have a look ?

It's a rewrite of the documentation of the stdlib. Hopefully I've managed to improve the comprehensiveness and the quality of the doc.