adapted example and extended usage text