allow options override when retrieving list of bookmarks, doc update