recovered contents of manual as of commit 8c467c4e76d3f33df83d4bd276e0843db2a66af5 into readme.md