manual errata; added a comparison between query types
split the commandline utilities help from the API documentation; minor clarifications to record handling