update README and add __clear__ keyword