support mget, replace refresh with flush in tests

 - mget_doc (with a slightly strange ordering of params)
 - flush instead of refreshin tests (refresh doesn't flush!)
 - documentation patches