tidy and document sl_list API