update docs for the API, some minor cleanups
fix http server cache flaw that multiple requests to same url only count
as one; some additional doc comments