added doc and changed the default ordering to be by -id.