document the querying interfaces