documenting #list_spec