added invocant option. +tests +docs.