flags and readme modification to including escaping guide