document all options, fix offset and limit