adapt documentation with the new offset option