update readme and some of the language; allow local paths