move licence into licence file
 document debug mode + other README fixup