update README with options documentation and current caveats status