README : add doc for _by_* functions